Developer Onboarding

As Regras de Ouro (MANDATÓRIO)

Como Engenheiro de Software na DevCod, você deve seguir estritamente as seguintes regras arquiteturais:

• Regra Zero Hardcoded (Tolerância Zero): É proibido chumbear limites de tokens, chaves de API, segredos de webhook, modelos de IA ou cores hexadecimais no código fonte. Todos os parâmetros devem ser dinâmicos (lidos do banco via RLS) e estilos devem usar tokens CSS do Design System.
• Zero 'any' e Tipagem Forte: O uso de any, ts-ignore ou tipos genéricos fracos causará rejeição no build. Interfaces e retornos de funções devem ser declarados com precisão.
• Arquitetura Orientada a Eventos (EDA): Componentes assíncronos e pipelines devem se comunicar por eventos (Outbox, worker queues) para desacoplamento e resiliência.

Testes e Validação Integrados

Antes de qualquer commit, merge ou deploy, a integridade do sistema deve ser validada por nossa suíte automatizada:

{`
Executar auditoria local completa:
$ python .agent/scripts/checklist.py .
          `}

Esse script analisa vulnerabilidades, executa varredura de segurança de dependências, roda linters TypeScript e executa a pirâmide de testes unitários e de integração.

Qualidade de Código & Clean Code

Regras para submissão de PRs (Pull Requests):

• Pragmatismo: Escreva código simples, legível e enxuto. Evite sobredesenho de soluções ou infraestrutura desnecessária.
• Sanitização de Inputs: Todos os dados recebidos em requisições de API devem ser sanitizados usando schemas Zod antes de qualquer processamento ou persistência no banco.
• Isolamento de Tenant: Sempre utilize a instância isolada do DevCod ORM através de getTenantPrisma(siteId) para impedir vazamento de dados.