Neste artigo vou demonstrar como utilizar um diagrama de sequência para o desenho do fluxo de uma aplicação de notificações. Já escrevi um artigo explicando da importância de se utilizar diagramas de sequência em projetos de software. Neste iremos aprofundar em como criar estes diagramas.
Vamos utilizar o PlantUML para desenhar o diagrama utilizando somente texto.
Escrever diagramas UML, C4 ou outros é importante para demostrar de forma gráfica diversos aspectos dos sistemas que trabalhamos. Podemos documentar desde um módulo do sistema até mesmo os fluxos que o sistema possuí. Hoje existem diversas ferramentas para se criar UML, cada uma com suas vantagens e desvantagens.
Vou apresentar uma delas que é o PlantUML. Neste artigo vou abordar os pontos positivos e negativos que enxergo na ferramenta e também exemplificar com alguns diagramas de exemplo utilizando ela.
Quem já trabalhou com micro serviços, já deve ter passado por alguma situação onde seja necessário chamar outros sistemas e esse sistemas chamam outros, que chamam outros e assim por diante. Em algumas situações existe uma ordem para chamar os sistemas de tal forma a passar os dados adequadamente para cada um deles. Neste artigo vou falar um pouco mais sobre como criar diagramas de sequencia para representar o fluxo de chamadas dentro de uma arquitetura de micro serviços.
Ao criarmos um sistema é bem comum também criarmos uma documentação junto com este sistema. Se pensarmos na documentação dos endpoints usando, por exemplo, um Swagger podemos utilizar uma das diversas ferramentas que geram essa documentação para nós, porém não devemos utiliza-las!! Neste artigo vou falar mais um pouco sobre isso, explicar qual a motivação de não usa-las e dar alguns exemplos do que passei na minha carreira.
