Ambiente de desenvolvimento com neoc

O CLI neoc é o principal ponto de entrada para criação do ambiente, gestão de sites, instalação de apps, migrações, execução local e manutenção técnica.

Pré-requisitos

Em geral, o ambiente envolve:

• Python compatível com a versão do NEO;

• Node.js e ferramentas de build;

• Redis;

• banco suportado pelo projeto;

• dependências do sistema operacional.

Inicialização de ambiente

mkdir meu-ambiente
cd meu-ambiente

neoc init .
neoc start

Dependendo da organização, o bootstrap pode ser mais automatizado, mas o princípio é o mesmo: criar estrutura, instalar dependências e iniciar os serviços.

Criação de app e site

neoc new-app biblioteca
neoc new-site biblioteca.local
neoc --site biblioteca.local install-app biblioteca

Modo desenvolvedor

neoc set-config -g developer_mode true

Esse modo normalmente é usado para geração e versionamento de artefatos do app.

Relação do neoc com o front-end

Para o desenvolvedor de UI, o neoc participa diretamente do fluxo de:

• build de assets;

• watch local;

• subida do Desk;

• limpeza de cache;

• migração de metadados que afetam formulários;

• instalação de apps que injetam JS e CSS.

Situações comuns

Alteração em DocType não apareceu

Geralmente falta migração, limpeza de cache ou o site certo não está ativo.

Script cliente não refletiu

Pode haver cache do navegador, asset não recompilado ou hook não carregado.

Página não carrega

Verifique rota, hooks, build de assets e instalação do app.

Checklist local antes de commitar

• migração executada;

• DocTypes versionados;

• patches criados quando necessário;

• JS/CSS incluídos pelo mecanismo correto;

• comportamento validado no Desk.