Pular para o conteúdo
MDL

MDL 2.0 — Minimalist Development Language Specification

Minimalist Development Language Specification

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

SOBRE O MDL 2.0

O MDL (Minimalist Development Language Specification) possui mais de 10 anos de existência e desde sua concepção teve pouquíssimas evoluções. Alinhado às necessidades da ArcH, que aplica com muita frequência o MDL em seu dia a dia, e após avaliar as considerações de diversos alunos e clientes, criamos a versão 2.0 do MDL.

POR QUE MDL?

Para desenhar toda a equipe, desenhe de forma colaborativa a estrutura e o comportamento de um aplicativo em um papel ou quadro branco para que todos os envolvidos (usuários, desenvolvedores, analistas de infraestrutura, etc.) possam entender, usá-lo como documentação oficial do projeto. A simplicidade do diagrama permite que você faça um novo design para substituir o antigo em vez de ajustá-lo.

COMPONENTES MDL 2.0

Atualmente o MDL possui 7 componentes. São eles:

  • Elemento da notação MDL: USER

    USER

    Esse elemento pode representar tanto usuários físicos (pessoas, áreas) quanto bots uma IA.

  • Elemento da notação MDL: DATA

    DATA

    Representa qualquer fonte de dados existente nas nossas aplicações.

  • Elemento da notação MDL: BACK-END

    BACK-END

    Elemento geral para back-end, a grande mudança foi no fato de que antes esse elemento era usado somente para descrever API'S, BFF'S e serviços, mas agora qualquer sistema backend é descrito com este elemento.

  • Elemento da notação MDL: FRONT-END

    FRONT-END

    Esse é um elemento novo no MDL 2.0, sempre que for necessário representar uma tela/interface o elemento usado é o front-end.

  • Elemento da notação MDL: BLACK-BOX

    BLACK-BOX

    Esse elemento tem como principal propósito abstrair um componente que você não queira entrar nos detalhes dentro do seu desenho, tirando a necessidade de explicar detalhes às vezes "desnecessários" para determinado desenho arquitetural.

  • Elemento da notação MDL: PART

    PART

    Possui a finalidade de representar sub-componentes, ou seja, representar partes de um componente. Pode ser usado, por exemplo, caso você possua uma interface e queira representar as partes que a compõem, ou caso você tenha um microsserviço e queira representar partes dele, ou possui um database e queira representar tabelas. O nível de abstração é você quem decide. A Part recebeu o mesmo formato da Layer e o mesmo formato do Front-End. Além disso, a Part pode representar Tiers e Layers. Dessa forma, quando quisermos representar uma grande camada, ou uma camada interna, usamos a Part. Isso nos ajuda a manter um único nível, um único contexto de diagrama, podendo variar o nível de abstração.

  • Elemento da notação MDL: BOUNDARY

    BOUNDARY

    É igual a Tier. Possui a finalidade de separar contextos, isolar pedaços do diagrama, delimitar uma fronteira. Serve para delimitar um espaço funcional ou um espaço de componentes técnicos, é uma forma de organizar melhor o diagrama.

CONECTORES

O MDL 2.0 possui somente o link, mas é possível representá-lo com uma composição, herança ou com o conexão que sempre ocorre (always link). É possível colocar a seta na ponta oposta do conector indicando a direção do fluxo da informação. A ausência da seta no lado oposto de uma representação de composição, herança ou conexão contínua indica que a direção da conexão é a mesma da herança, composição ou conexão contínua, ou seja eles passam por cima da seta.

  • Elemento da notação MDL: LINK

    Indica uma conexão e a relação direta entre elementos. Também se destina a indicar a sequência e o significado da comunicação. É fortemente indicado utilizar descrições em linguagem ubíqua nele para macroizar o negócio e número para indicar a sequência em que o fluxo do negócio (ou técnico) acontece. Esse conector aceita o uso de representação ou especialização por composição na outra extremidade, indicando especialização e vínculo ou composição e vínculo.

  • Elemento da notação MDL: ALWAYS LINK

    Se tem algo que sempre acontece, como conexão ao banco de dados, registro de serviço ou validação de segurança, é recomendado o uso de um link com um círculo com fundo preenchido em uma das pontas e a seta do link na outra indicando que a interação de link entre dois "sempre" elementos ocorre da mesma forma. Nesse caso um texto explicativo ubíquo deve ser usado com o conector, porém sem números de sequência.

  • Elemento da notação MDL: ESPECIALIZAÇÃO

    ESPECIALIZAÇÃO

    Indica a herança de todas as características do elemento pai, caso a outra extremidade não contenha a ponta de link (caracterizando especialização e link), não é permitido adicionar descrições e números de sequência.

  • Elemento da notação MDL: VIRTUAL LINK

    Indica que a conexão entre os elementos é fraca. Por exemplo, um link virtual ou tabelas de um banco de dados onde a relação entre elas não seja uma FK (Foreign Key) verdadeira.

  • Elemento da notação MDL: COMPOSIÇÃO

    COMPOSIÇÃO

    Indica que o elemento que recebe a ponta é composto por elementos relacionados, ou seja, é um macro-componente (talvez até abstrato) composto pelos demais, se a outra extremidade não contenha a ponta de link (caracterizando composição e link), não é permitido adicionar descrições e números de sequência.

EXEMPLOS

Diagrama de exemplo em MDL, 1 de 5: solução escolar com duas APIs e a camada de dados
O diagrama acima representa em alto nível de abstração uma solução composta por duas APIs, uma delas lista, registra e altera notas de alunos enquanto a outra tem o objetivo somente de consulta. O desenho também representa a camada de dados envolvida na solução.
Diagrama de exemplo em MDL, 2 de 5: tabelas de um micro banco de dados
Diagrama de exemplo em MDL, 3 de 5: segmentação de camadas
O diagrama acima ilustra a segmentação de camadas "Tiers" e "Layers", exibindo as principais sub-camadas e a relação entre: Usuário, Aplicação (Front-End), e Back-End, incluindo os databases envolvidos e os principais componentes arquiteturais.
Diagrama de exemplo em MDL, 4 de 5: modelo físico de dados
O diagrama acima ilustra um exemplo de modelagem de dados física representando a relação entre databases relacionais e não relacionais, fazendo uso de MDL 2.0.
Diagrama de exemplo em MDL, 5 de 5: modelo lógico de dados
O diagrama acima ilustra um exemplo de modelagem de dados lógica representando a relação entre databases relacionais e não relacionais, fazendo uso de MDL 2.0.

NOVIDADES DA VERSÃO 2.0

O QUE MUDOU? Deixaram de existir

  • Contextos comportamental e estrutural: Agora temos apenas um contexto único, de forma em que tudo poderá ser representado nele.
  • Micro Batches: Este elemento era pouco utilizado, principalmente quando se falava em microsserviços. Assim, para não haver diferenças entre microsserviços, API's ou qualquer outro tipo de core, tudo foi sintetizado em um único elemento.
  • Layer e Tier: Não haverá mais a diferenciação entre Tier's e Layer's, que também foram sintetizadas em um único elemento.

O QUE FOI ALTERADO?

  • forma de representar camadas: Agora podemos usar o Part para representar as camadas (Tiers e Layers), além de poder ser utilizado para compor qualquer elemento. Isso possibilita uma maior facilidade e flexibilidade.
  • A forma de representar o frontend: frontend A mudança foi feita para não confundirmos Part e Frontend, sendo escolhido um componente comum em praticamente todos os editores de diagrama, de forma que a mudança não gerará nenhum ônus.
  • Conectores: Os conectores foram mantidos, mas agora podem ser utilizados em TODOS os elementos, inclusive nas Parts. Há também um maior incentivo para o uso de mais textos nos conectores, de forma a serem melhor "interpretáveis". Menor necessidade de conectores de "volta", desde que seja claro o entendimento do desenho.
  • Possibilidade de uso de imagens e ícones para design dos componentes.
  • Uso de "[" e "]" entre condições e expressões lógicas, ou seja, de que forma ocorre o link entre 2 elementos.
  • Tudo em uma única visão: Finalidade de possibilitar um desenho evolutivo. Diagramas podem nascer funcionais e serem evoluídos, continuados para serem mais abrangentes e cobrirem a estrutura. Todos os elementos podem usar um "#"+ texto ou "<<"+texto+">>" para indicar o que é o elemento. Por exemplo: um sistema, uma instância de dados, uma tabela, uma tecnologia, etc.

A COMPLEXIDADE VAI AUMENTAR?

Uma pergunta que sempre surge quando falamos em mudanças. A complexidade vai aumentar? Não, na verdade haverão menos elementos e o MDL terá apenas um único contexto, e não mais um contexto comportamental e um contexto estrutural. Portanto, o MDL será ainda mais simplificado.

AS POSSIBILIDADES FORAM EXPANDIDAS OU REDUZIDAS?

Outro ponto que pode gerar preocupação são as possibilidades de design, se teremos mais restrições com a nova versão. Podemos afirmar que as possibilidades serão expandidas, o MDL ficou mais simples e mais poderoso, sendo possível utilizá-lo de mais formas que a versão anterior. Além disso, o MDL não perdeu a sua essência minimalista, continua tendo poucos elementos e poucos conectores, e com a mesma flexibilidade.

COMUNIDADE

Junte-se à nossa comunidade no ArchOne.

Click aqui para participar

Possui um caso de MDA?

Entre em contato, pode nos ajudar a melhorar a abordagem.

[email protected]

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.