Decisões Arquiteturais Devem Ser Auditáveis
O Salesforce corporativo não se resume a "construir e executar". Trata-se de "construir, executar e comprovar".
ARQUITETURA
5/1/20261 min read


As auditorias não se limitam à segurança; elas visam comprovar a lógica das decisões, os limites de acesso
e o tratamento de dados.
Mantenha Registros de Decisões Arquiteturais (RDAs): explique por que você escolheu o padrão, as
restrições, os riscos e as medidas de mitigação.
Vincule os RDAs às evidências de implementação: configurações, modelos de permissão, contratos de
integração e estratégia de teste.
Monitore a deriva das decisões: quando as restrições mudam, você revisa a arquitetura ou acumula
exceções?
Decisões auditáveis permitem uma integração mais rápida, refatorações mais seguras e menos debates
políticos.
Uma organização madura consegue explicar o "porquê" com a mesma facilidade que explica o "o quê".
O que capturar (ADR)
• Opções + critérios
• Recomendações + compensações
• Riscos + mitigações
• Operabilidade + métricas
• Cadência de revisão + gatilhos
Por que isso importa: Os sistemas corporativos devem comprovar o "porquê" das decisões tomadas,
especialmente em segurança, dados e automação.
Diretrizes
• ADRs: opções, critérios, decisão, compensações
• Riscos/mitigações + plano operacional + métricas
• Vínculos de evidência: configurações, contratos, testes, manuais de operação
• Gatilhos de revisão: mudança de volume, mudança de regulamentação, incidente, fusões e aquisições
Anticordôs
• Arquitetura baseada em conhecimento tácito
• Ausência de rastreabilidade da decisão à implementação
• Exceções sem justificativa ou responsável
Métrica a ser observada: % de mudanças significativas com ADR + tempo de integração de um novo
arquiteto
Em resumo: Documentação não é burocracia, é controle arquitetural.
📌 Se não for defensável, não está feito.
