📊 Cap 08: Arquitetura como Código (C4)

Docs-as-Code • Padronização e Níveis de Zoom Arquitetural

🗺️ A Morte dos Diagramas Estáticos em PNG

flowchart LR
    subgraph VELHO ["Abordagem Tradicional (Visio / PNG Estático)"]
        V1["Desenho manual -> Exporta PNG -> Cola no Word/Confluence\n(Fica desatualizado na próxima sprint, impossível de dar diff!) 🚨"]
    end

    subgraph NOVO ["Architecture-as-Code (AaC em Markdown)"]
        N1["Código C4/Mermaid direto no repositório Git!\n(Versionável, auditável via PR e renderizado no portal com CI/CD!) ⚡"]
    end

    VELHO -.-> |"Evolução Docs-as-Code"| NOVO

    style VELHO fill:#ffebee,stroke:#d32f2f,stroke-width:2px
    style NOVO fill:#e8f5e9,stroke:#4caf50,stroke-width:2px

🎯 Slide 1: O Que é o Modelo C4?

• Criado pelo engenheiro Simon Brown para substituir diagramas ambíguos.

• 4 Níveis de Zoom:
  1. Contexto: Visão de satélite (atores e fronteira do sistema).
  2. Containers: Divisão técnica executável (frontend, APIs, bancos).
  3. Componentes: Blocos internos de um container específico.
  4. Código: Classes e métodos de implementação.

🎯 Slide 2: Primitivas Mermaid C4

• Person(id, nome, desc): Define um ser humano ou perfil.
• System(id, nome, desc): O sistema que sua equipe constrói.
• System_Ext(id, nome, desc): Serviços legados ou APIs de terceiros.
• Rel(origem, destino, label, protocolo): Comunicações rotuladas.

🎯 Slide 3: Benefícios para Equipes de Engenharia

• Revisão por Pull Request: Mudanças na arquitetura são discutidas como diff de código em PRs do GitHub.

• Zero Lock-in: O diagrama é texto puro, podendo ser compilado por CLI, integrado a wikis ou transformado em PDF via Pandoc!