Boas práticas de desenvolvimento NEO

Boas práticas em NEO nascem da combinação entre metadados, backend robusto e front-end disciplinado.

Organização

• mantenha o domínio no app;

• use módulos claros;

• evite lógica crítica apenas em Client Script;

• versione patches, fixtures e assets;

• documente hooks e rotas relevantes.

Modelagem

• modele entidades explicitamente;

• use Link para relações reais;

• use Child Table para composição;

• não superlote um DocType com múltiplos conceitos;

• pense em form, list, API e report ao definir campos.

Backend

• trate o controller como fonte da verdade;

• use serviços auxiliares para lógica reutilizável;

• use neo.db com critério;

• minimize ignore_permissions;

• mova tarefas longas para background.

Front-end

• use Client Script para ergonomia;

• mantenha assets no menor escopo possível;

• prefira Page quando o fluxo não couber no formulário;

• cuide de listas e filtros;

• garanta feedback claro ao usuário.

Segurança

• valide permissões no backend;

• não exponha secrets em assets;

• revise endpoints usados pelo front-end;

• trate uploads e HTML com cuidado.

Sustentação

• torne jobs observáveis;

• tenha relatórios de apoio;

• valide release com usuário real ou perfil equivalente;

• preserve rastreabilidade operacional.

Checklist de projeto saudável

• apps organizados por domínio;

• hooks com propósito claro;

• UI com escopo correto;

• dados e permissões consistentes;

• migração previsível;

• documentação viva no repositório.