Core Docs
Desenvolvimento

Desenvolvimento

Padrões para evoluir o GNOQ Core sem quebrar contratos.

Antes de implementar uma mudança, responda:

  1. Qual regra de negócio está mudando?
  2. Ela afeta backend, frontend ou ambos?
  3. Há permissão nova ou mudança de visibilidade?
  4. Há impacto em auditoria, soft delete, cache ou e-mail?
  5. Esta documentação precisa ser atualizada?

Rotina recomendada

  1. Leia a página do módulo afetado em Módulos.
  2. Confira a referência técnica em Backend ou Frontend.
  3. Implemente seguindo os padrões existentes do repositório.
  4. Rode validações locais.
  5. Atualize a documentação no mesmo PR.

Regras de manutenção

  • Não trate UI como segurança. Permissão sensível precisa existir no backend.
  • Não altere permissões do sistema como se fossem cadastro comum.
  • Não crie validação só no frontend quando o backend também precisa proteger o dado.
  • Não invalide cache inteiro quando a mudança tem escopo claro.
  • Não altere fluxo de vaga/candidatura sem conferir os eventos de domínio.

On this page