Skip to content
  • Andre's avatar
    docs(24-manuais): cria grupo de manuais para parceiros + manual SPF/DMARC · 92669521
    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: default avatarClaude Opus 4.7 (1M context) <noreply@anthropic.com>
    92669521
Loading