Hub de conteúdo
Arquitetura de Software, sem enrolação
Um único ponto de partida para tudo o que envolve documentar e comunicar arquitetura hoje: C4 Model, ADRs, diagrama como código, documentação viva e as ferramentas que realmente entregam. Guias curados por engenheiros que já mantiveram (e sofreram com) documentação desatualizada.
Fundamentos
A base conceitual. Se você nunca desenhou um diagrama de arquitetura na vida, comece por aqui — quatro leituras curtas resolvem.
Práticas de documentação
Do "o que documentar" ao "como impedir que a documentação apodreça". Estes guias transformam arquitetura em artefato mantido, não em PDF esquecido no Confluence.
Diagrama como código
Por que texto versionado venceu ferramentas visuais em times de engenharia.
Ler guiaDocumentação viva
O que documentar, o que ignorar e como impedir que a doc apodreça.
Ler guiaADR (Architecture Decision Record)
Template MADR + exemplo real para registrar o 'por quê' das decisões.
Ler guiaDocumentação de microserviços
Padrão service.md, service catalog e event catalog em escala.
Ler guiaComparativos de ferramentas
Análise honesta de cada ferramenta popular do mercado: onde brilha, onde falha e quando a resposta é combinar mais de uma.
Alternativas a diagramas online
Comparativo direto entre as principais ferramentas do mercado.
Ler guiaExcahub vs Lucidchart
Diagramas de arrastar-e-soltar com colaboração em tempo real.
Ler guiaExcahub vs Draw.io
Editor visual open-source, gratuito, com storage no Google Drive ou local.
Ler guiaExcahub vs Miro
Whiteboard infinito para workshops, brainstorming e diagramas colaborativos.
Ler guiaExcahub vs Mermaid
Sintaxe textual open-source para gerar diagramas em Markdown.
Ler guiaExcahub vs Excalidraw
Whiteboard open-source com estética desenhada à mão.
Ler guiaPerguntas frequentes
Por onde começar a documentar a arquitetura de um sistema?
Comece pelo Diagrama de Contexto (nível 1 do C4): uma caixa representando seu sistema, cercada por usuários e sistemas externos. Em uma tarde você resolve 80% das dúvidas de onboarding e integração.
Qual a diferença entre arquitetura de software e design de software?
Arquitetura trata das decisões estruturais difíceis de reverter — como divisão em serviços, escolha de banco, protocolo de comunicação. Design trata de como você escreve o código dentro dessas fronteiras. A regra prática: se mudar dói por semanas, é arquitetura.
Preciso desenhar UML para documentar arquitetura?
Não. UML tem 14+ tipos de diagrama e quase ninguém domina todos. O C4 Model resolve o mesmo problema com 4 níveis e notação livre, e é o padrão de facto em times modernos.
Como manter a documentação de arquitetura atualizada?
Tratando o diagrama como código: um arquivo texto versionado no Git, revisado em pull request junto com o código que ele descreve. Quando a mudança de arquitetura passa pelo mesmo review do código, a doc deixa de envelhecer.
Da teoria ao repositório, sem escalas.
O Excahub transforma tudo o que você lê nestes guias em prática: C4 como código, colaboração em tempo real, ADRs versionados e IA que entende o que é um bounded context.