-
Andre authored
Cria grupo 24 dedicado a manuais de leitura externa - documentos escritos para clientes B2B, integradores e parceiros, com linguagem clara, exemplos copy-paste e validacao acessivel. Primeiro manual: configuracao de SPF e DMARC para parceiros que enviam notificacoes via AR-Online com seu proprio dominio (from: @cliente.com). Decisao tecnica chave: usar include:ar-infra.email + include:aronline.email ao inves de listar IPs especificos. Vantagens: - Quando a AR muda de IPs, parceiro nao precisa atualizar DNS - Padrao de mercado (AWS SES, SendGrid, Mailgun fazem assim) - Reducao de incidentes operacionais nos parceiros Estrutura do manual (10 secoes): 1. Por que SPF/DKIM/DMARC importam 2. Pre-requisitos 3. SPF (incluindo combinacao com outros sistemas + cuidado com 10 DNS lookups limit + -all vs ~all) 4. DKIM (chave individual fornecida pela AR via suporte) 5. DMARC com adocao em 3 etapas (none -> quarantine -> reject) 6. Validacao (mxtoolbox, dmarcian, mail-tester + comandos dig) 7. Troubleshooting comum (6 cenarios) 8. Resumo dos 3 registros 9. Suporte 10. Checklist final de 11 itens Tambem cria README do grupo 24 com: - Principios editoriais (autocontido, pt-BR, validacao acessivel, canal de suporte) - Tabela de manuais disponiveis - Backlog de proximos manuais (DKIM detalhado, webhook, API, shortlinks ar-sms.com, troubleshooting spam) - Procedimento de atualizacao Origem: aprendizado do postmortem 2026-05-25 (spoofing CN em smtp.ar-infra.email) - melhor estrategia de SPF/DMARC vira manual publico para os parceiros antes que eles tenham o mesmo problema. README raiz atualizado com Grupo 24. PDF gerado. Co-Authored-By:Claude Opus 4.7 (1M context) <noreply@anthropic.com>
92669521
Loading