Pular para o conteúdo
MDL

Regras MDL 2.0

As regras de desenho da notação MDL 2.0

Uma notação focada em tornar o desenvolvimento e a arquitetura de software simples para todos. Mantido pela ArcH, empresa que faz arquitetura e desenvolvimento de software com IA.

Fale com a ArcH

Um resumo prático das regras para desenhar em MDL 2.0: elementos, link, pontas, linha tracejada, cross link e cores. O texto completo da notação está na especificação do MDL 2.0; os diagramas prontos estão nos exemplos por uso.

Elementos

O MDL é livre e simples: poucos elementos, um só conector, e qualquer coisa liga com qualquer coisa, desde que faça sentido. Vai do negócio à modelagem de dados no mesmo desenho, em níveis de abstração diferentes.

Elementos do MDL 2.0
ElementoFormaO que representa
userElemento user do MDL: o bonequinhobonequinho, como no caso de usoQualquer ator que atua no sistema: pessoa, robô, IA, agente.
front-endElemento front-end do MDL: o paralelogramoparalelogramo (o “lápis”)Tela ou interface, client-side ou não, web ou não.
back-endElemento back-end do MDL: a elipseelipse ou círculoCore, serviço, API, BFF, microserviço. Também um processo ou um contexto (DDD).
dataElemento data do MDL: o cilindrocilindroQualquer repositório de dados: banco, cache, até FTP.
partElemento part do MDL: o retânguloretângulo sem preenchimento forteUma parte: detalha por dentro ou por fora qualquer elemento. Tiers, layers, cloud, nó, camadas de um core (facade, filtros, DTO, dados), regiões de uma tela (wireframe), tabela de banco (campos), até a estrutura de uma IA.
boundaryElemento boundary do MDL: o retângulo tracejadoretângulo tracejadoLimite ou fronteira: um contexto, um grupo, um ambiente.
black-boxElemento black-box do MDL: o retângulo sólidoretângulo preenchido sólido, com texto claroAlgo que não se quer detalhar: legado, ferramenta de mercado (Cloudflare, fila, gateway), componente grande. É sempre um retângulo: se for bola ou lápis, não é black-box. O clássico é preto com texto branco.
comentárioretângulo serrilhado (hachurado)Nota ou especificação: explica o que o elemento é ou como é por dentro. Liga em qualquer elemento.

Composição por contenção

Um elemento dentro do outro faz parte dele: uma tela dentro de outra tela, bolinhas pequenas dentro de uma grande (um serviço composto), camadas dentro de um core, tabelas dentro do banco.

Rótulo de tipo

O tipo vem entre <<…>> sob o nome, por exemplo <<bff>>, <<api>>, <<database>>, <<table>> e <<postgre>>. Uma tabela é um retângulo com o nome, <<table>> e a lista de fields, como + codigo long, pk.

Cores

A paleta é o padrão da ArcH. Os elementos são claros (exceto o black-box), com texto e borda no tom escuro da mesma cor.

Cores do MDL 2.0
DomínioAmostraCor
front-end / usuárioRoxo claro no elemento. Roxo escuro no nome, no usuário e na seta que nasce dele.
core / back-endAzul claro.
segurançaVerde: escuro se for black-box, claro se não for.
dados / banco / camada de dadosAmarelo.
externoCinza.
black-boxSólido escuro, o clássico é preto, com texto branco.
desvio de fluxo / cross linkVermelho.
  • Cor do link: é a da origem. A seta que sai do front é roxa; a que sai de um black-box verde é verde.
  • Camadas: quanto mais externa, um pouco mais escura; quanto mais interna, mais clara. A sub-sub-camada pode ter fundo branco com borda na cor da camada: o contraste mostra a profundidade.
  • Molduras externas (título, moldura escura) são enfeite, não fazem parte da notação.

Fale com a ArcH

Quer aplicar o MDL na sua equipe?

Treinamento, arquitetura e desenvolvimento de software com MDL. Deixe seus dados e um arquiteto da ArcH entra em contato.