promovaweb Laravel
Fluxo
- Ler as instruções, a spec ativa e os manifests do projeto consumidor.
- Descobrir versões e extensões em
composer.jsonecomposer.lock. - Mapear a requisição até domínio, persistência, efeitos assíncronos e resposta.
- Localizar convenções em arquivos irmãos e testes existentes.
- Definir autorização, validação, transação, idempotência e falhas antes do código.
- Materializar o teste focal, implementar a menor fatia e refatorar.
- Executar testes, análise estática, formatter e verificação operacional disponíveis.
Padrões
- Manter controllers finos e regras de negócio no boundary já adotado.
- Usar Form Requests, policies, resources e bindings quando forem contratos locais.
- Tratar Eloquent como acesso a dados, sem esconder consultas caras ou N+1.
- Projetar jobs idempotentes, com timeout, tentativas, backoff e tratamento de falha.
- Preparar migrations compatíveis com o volume, lock esperado, rollback e deploy misto.
- Nunca confiar em validação do cliente nem autorizar somente na interface.
- Não criar abstração, pacote ou evento sem consumidor e benefício verificável.
Validação
- Cobrir caminho feliz, autorização, validação, efeitos e falhas relevantes.
- Inspecionar queries quando cardinalidade ou latência importar.
- Verificar queues, scheduler, cache, config e variáveis no ambiente alvo.
- Registrar riscos de dados e comandos operacionais sem executá-los sem autorização.
Leia references/standards.md para padrões detalhados e fontes oficiais conforme a área alterada.