Visualize a arquitetura do seu sistema com C4 Model

C4 Model

website: https://c4model.com/
author: Simon Brown

Inspirado em UML e 4+1 Model, foi criado e melhorado ao longo do tempo para ajudar a visualizar a arquitetura de sistemas e aproximar o modelo do sistema com o código.

Principais lemas

Foco nas estruturas estáticas (componentes)

Abstrações e não notações (mapas)

Engenharia e não arte, não use visio use plantuml

Quem usa UML?

Desculpas

"Nem todos sabem UML no time"
"Vou parecer velho"
"Ferramentars ruins"
"Muito detalhado"
"É uma bela forma de perder tempo"
"Agile não precisa documentar"
"O valor ta na conversa", daí a conversa é só sobre ficar até mais tarde...
"O valor tá no código", daí vc olha o código e...

Com a chegada das metodologias ágeis as pessoas tem buscado simplificar e usar formas mais simples de modelagem.

Use um quadro branco! alt text

O problema é que faltou tempo e/ou ferramenta adequada! alt text

Problemas dos diagramas atuais

Tamanhos, cores diferentes
Falta de legenda e descrição
Não padronização
Abreviações
Falta de títulos

Por quê?

Troca de pessoas, rotatividade = informação pro ralo

Visualização!

Peça para um arquiteto desenhar a sua casa, o que terá? Sim, a planta baixa da sua casa.

Você, uma pessoa que não é formada em arquitetura conseguirá entender todo contexto, principais idéias da planta. Consegue se localizar e localizar portas, janelas etc.

"Boa comunicação = times melhores"

Público

Temos que ter em mente que o público de nossos diagramas pode ser amplo, desde um presidente e um diretor da companhia até seu colega que acabou de entrar na firma.

Mapas

Olhe o mapa da sua cidade ou imagine ele.
O que vai notar?

Igrejas

Hospitais

Ferrovias

Estradas

Estações de metrô

Museus

Olhe o mapa de outra cidade e perceba como as mesmas abstrações estarão presentes, apenas com notações diferentes (fontes, linhas cores, formatos)

Como funciona?

Abstrações hierárquicas / Agrupamentos

Contamos uma história linear de C1 até C4 , ou seja a história continua ao dar o zoom.

O C4 Model é uma estrutura estática, uma vez definido pode-se por exemplo criar outras documentações mais específicas caso necessário, como: diagramas de sequência, ER, BP, etc.

4Cs