Uma pessoa informa dados do veículo, recebe um preço da seguradora e salva a cotação. Vamos ampliar a mesma solução progressivamente, sem trocar de problema a cada diagrama.
O que é C4? Um modelo de documentação visual: Contexto, Contêineres, Componentes e Código. Não é um framework de desenvolvimento nem obriga o uso de microsserviços.
LEGENDA · NOTAÇÃO VISUAL DESTA PÁGINA
COMO LER O C4
O modelo C4 não obriga cores ou tipos de linha específicos. Este estudo usa convenções próprias para facilitar a leitura.
▣Verde · Elemento internoSistema, API, componente ou classe sob estudo.
☁Roxo · Integração externaDependência de terceiros; no C3, o adapter é interno e integra com serviço externo.
▤Âmbar · Dados / persistênciaBanco de dados, repositório ou porta de persistência.
────────→
Seta contínua: interação ou chamada na direção indicada, com descrição sobre a linha.
┄┄┄┄┄→
Seta pontilhada: dependência de contrato/abstração no exemplo de código C4. Não significa necessariamente tráfego de rede.
C1: contexto · C2: aplicações e armazenamento · C3: componentes · C4: código. As cores representam papéis definidos para este estudo, não um padrão obrigatório do C4.
C1 · CONTEXTO / 04
Quem usa o sistema e com quais serviços ele conversa?
Mostra o Portal de Cotação como uma caixa única, seus usuários e dependências externas.
C1 não mostra frameworks, classes nem banco de dados. O foco é a fronteira do sistema e as pessoas envolvidas.
C2 · CONTÊINERES / 04
Quais aplicações e armazenamentos compõem o portal?
Aqui “contêiner” significa unidade executável ou armazenamento, não necessariamente Docker.
Decisão ilustrativa: um frontend, uma API e um banco. Para esse escopo, não é necessário introduzir microsserviços.
C3 · COMPONENTES / 04
Como a API de Cotação é organizada internamente?
Amplia somente o backend mostrado em C2; não tenta detalhar o sistema inteiro.
C3 representa componentes lógicos e suas responsabilidades, sem exigir um serviço de rede para cada componente.
C4 · CÓDIGO / 04
Como as responsabilidades aparecem no código?
Exemplo de classes e contratos do caso de uso CalcularCotacao.
C4 é opcional na prática. Mostre código apenas quando o detalhe ajudar uma decisão técnica.
O que aprendemos?
O C4 apresenta a mesma solução em quatro escalas. O primeiro nível ajuda pessoas de negócio; os níveis seguintes aprofundam decisões de implementação. Não é obrigatório produzir todos os níveis em todos os projetos.