◆ CHIHUAHUAS STUDIOS
PrivacidadeDados locais
◆ CHIHUAHUAS STUDIOS← ARQUITETURA DE SOLUÇÕES

MODELO C4 / ESTUDO DE CASO SIMPLIFICADO

UMA COTAÇÃO. QUATRO ZOOMS.

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.

♙Azul · Pessoa / clienteUsuário ou interface cliente, simplificada neste exemplo.
▣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.

SolicitaConsulta preçoEnvia aviso♙ClienteSolicita cotação▣Portal de CotaçãoSistema em estudo☁SeguradoraRegras e preços☁Serviço de E-mailEntrega confirmação

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.

HTTPS / JSONHTTPSSQL♙NavegadorInterface web▣API de CotaçãoBackend REST▤Banco de DadosCotações persistidas☁API da SeguradoraPrecificação externa

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.

ChamaConsultaSalva▣ControllerPOST /cotacoes▣CalcularCotacaoOrquestra regras☁PricingAdapterConsulta seguradora▤CotacaoRepositoryPersiste proposta

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.

UsaContratoContrato▣CotacaoControllerreceberPedido()▣CalcularCotacaoexecutar()▣PricingPortobterPreco()▤CotacaoPortsalvar()

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.