Documentação

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.