Clean Code
Código limpo é código que outra pessoa entende rápido (incluindo você daqui a seis meses). Na Gevtech, isso reduz bug em produção e acelera onboarding.
Princípios que usamos
- Nomes que revelam intenção — variáveis, funções e pastas autoexplicativas.
- Funções pequenas — uma responsabilidade por função/método.
- Poucos níveis de indentação — se passou de três, considere extrair função.
- Duplicação zero tolerada (DRY) — mas sem abstração prematura.
- Comentários só onde o “por quê” não está óbvio — o “o quê” deve estar no código.
- Tratamento explícito de erro — não engolir exceções; mensagens úteis em log.
- Testes onde o risco justifica — regras de negócio e integrações críticas.