[Conceito] - Desenhos de Arquitetura: Estruturais e Comportamentais

Contedo original nessa thread do Twitter

Dev,

Vamos trocar uma ideia sobre DESENHOS DE ARQUITETURA?

Com frequncia, vejo diagramas confusos que precisam de algum explicando pra enteder com clareza. Vou dar uma dica super simples que pode deix-los muito mais expressivos e claros!

Bora?

Vou direto ao ponto:

Desenhos bons diferenciam com clareza ESTRUTURA de COMPORTAMENTO.

Estrutura a viso esttica e comportamento o fluxo de informaes.

O que esse diagrama abaixo comunica?

Mesmo com muitas coisas, tenta acompanhar alguma coias a. D uma ateno especial s setas.

Intuitivamente, possvel inferir que este diagrama comunica comportamento.

Bom, pelo menos as setas apontadas para as filas dizem isso, pois nenhum middleware de mensageria depende de seus consumidores ou publicadores j o oposto verdadeiro.

O problema desse desenho (assumindo que esteja realmente comunicando um fluxo) que no d pra saber a ordem das coisas. O fluxo comea com COM, com XYZ ou com ACME? Existe paralelismo? Termina onde?

A parte boa que t fcil resolver isso. Basta colocar a ordem das coisas!

(As descries no esto boas, mas) o fluxo est claro.

Geralmente, os diagramas comportamentais so os mais interessantes, eles do a ideia do runtime da coisa viva.

Os estruturais so bons para entender dependncias. Olha como poderia ser o diagrama estrutural dessa soluo. No h fluxo descrito, apenas uma viso esttica.

Uma alternativa para comunicar comportamento usar diagramas de sequncia (que particularmente gosto). Voc no precisa (e nem deveria) esquentar muito com os padres de UML (seta vazada, preenchida, etc.). UML t caindo em desuso, mas deixou um legado til.

Nesse diagrama, a ordem das coisas de cima para baixo. As coisas de cima vm primeiro linhas verticais so linhas do tempo.

D pra colocar numerao nas mensagens, mas acho desnecessrio, sinceramente.

Quando o retorno das mensagens for importante, vale inclu-lo tambm.

Voltando para os diagramas estruturais.

Hoje em dia, o uso da notao C4 est crescendo e sendo mais adotada por empresas.

Essa notao interessante, pois serve para comunicao com pessoas tcnicas e no tcnicas. O criador do C4 o
@simonbrown (https://c4model.com)

Uma obervao importante: diagramas comportamentais precisam ter um mnimo de estrutura pra serem capazes de comunicar fluxo, mas desenhos estruturais no precisam conter fluxo.

Sempre tenha em mente qual o objetivo do seu desenho. Fluxo ou estrutura?

Claro, desenhos muito simples podem at no serem explcitos em relao estrutura/comportamento e mesmo assim comunicarem com clareza seu objetivo. Questo de bom senso.

isso o que queria falar. Deixe claro o que comportamento e estrutura nos seus desenhos mais elaborados.

O importante dos desenhos comunicar com clareza seu objetivo! Evite comunicar muita coisa num desenho s.

Valeu pela moral de ter lido at aqui!