Log de Dev: Honestidade do Sistema
Construa sistemas que digam a verdade.
Um sistema é tão bom quanto os seus sinais. Se as suas consultas escondem desperdícios, se os seus health checks mentem ou se as suas ferramentas repetem trabalho, o seu sistema é desonesto.
Passei o dia trabalhando em quatro frentes técnicas diferentes. Cada uma segue um único tema: tornar o sistema honesto.
- Performance de Banco de Dados Pare de buscar dados que você não utiliza.
- Use um detector de N+1 no seu ambiente de desenvolvimento. Ele transforma lazy-loads ocultos em uma lista de tarefas clara.
- Remova eager loads não utilizados. Se a sua view não utiliza uma coluna, não a busque.
- Faça o memoize de constantes por requisição. Não recompute o mesmo valor várias vezes em um único ciclo.
- Agrupe as consultas do dashboard. Substitua vinte pequenas chamadas de contagem por uma única consulta agrupada.
- Health Checks Reais Uma verificação que apenas valida se uma configuração existe não é um health check. É uma verificação de configuração.
- Um health check real deve provar a alcançabilidade.
- Abra um socket para o host e a porta de destino.
- Use um contrato ou interface para alternar entre sondas TCP, HTTP ou TLS.
- Execute cada sonda em sua própria conexão. Um serviço lento não deve travar toda a sua ferramenta de monitoramento.
- Ferramentas de IA mais Seguras (MCP) Quando você dá acesso de um agente de IA ao seu sistema, deve assumir que ele cometerá erros.
- Use chaves de idempotência. Se um agente tentar uma requisição novamente, o servidor deve retornar o mesmo resultado em vez de criar um duplicado.
- Limpe dados pessoais na saída. Trate o caminho de resposta como um limite público.
- Use códigos de erro tipados. Não envie strings puras. Um agente precisa de códigos estruturados como "not_found" para agir corretamente.
- Identidade e Redefinição de Senhas A ordem importa quando você mexe em múltiplos sistemas.
- Se uma redefinição de senha afetar múltiplos diretórios, escolha uma única fonte da verdade.
- Escreva no diretório autoritativo primeiro.
- Documente a sequência. "Funcionou quando eu testei" não é uma garantia de sucesso durante uma falha.
O objetivo não é construir funcionalidades chamativas. O objetivo é construir um sistema que permaneça confiável quando você não estiver olhando para ele.