# Topologia de microsserviços com gateway de API e mensageria assíncrona · Yila

> Os caminhos de requisição síncrona ficam à esquerda, atrás de um gateway de API; os consumidores orientados a eventos ficam à direita, em volta de um broker de mensagens; linhas azuis contínuas e laranja tracejadas separam os dois estilos. Serve a artigos de sistemas e ao ensino de engenharia de software.

URL: https://yila.ai/pt/templates/microservice-system-topology-network-figure

O diagrama modela um pequeno backend de comércio eletrônico. Os clientes externos falam apenas com um gateway de API, que cuida da entrada, da segurança e autenticação, do roteamento e da limitação de taxa antes de fazer chamadas HTTP ou gRPC bloqueantes aos serviços de usuário, produto e pedido, cada um com seu próprio banco de dados. O serviço de pedidos publica eventos em tópicos e filas de um broker de mensagens; os serviços de estoque, notificação e análise os consomem de forma assíncrona, atualizando o estoque, enviando confirmações por uma API externa de notificação e alimentando um data warehouse. O leitor deve sair sabendo quais chamadas seguram uma requisição, que trabalho vai desacoplado para segundo plano e por que cada serviço é dono dos seus dados.

- **Clientes externos**: Ícones de celular e de notebook na extrema esquerda; nomeie os tipos de cliente e mantenha todas as setas de requisição apontando para o gateway.
- **Gateway de API**: Bloco azul alto dividido em ponto de entrada, segurança e autenticação, roteamento e limitação de taxa; ajuste a lista às funções do seu sistema.
- **Serviços síncronos e bancos**: Caixas verdes dos serviços de usuário, produto e pedido, cada uma sobre o seu cilindro de banco de dados; escreva o protocolo nas setas de ligação.
- **Publicação assíncrona de eventos**: Linha laranja tracejada do serviço de pedidos até o broker, anotada como publicação de evento para se distinguir das requisições.
- **Tópicos e filas do broker**: Bloco laranja grande com tópicos e filas nomeados; cada nome deve corresponder a exatamente um publicador e aos seus assinantes.
- **Consumidores de eventos**: Caixas laranja de estoque, notificação e análise, com a função de cada uma: atualiza estoque, envia confirmações, gera métricas e relatórios.
- **Sistema externo e data warehouse**: Caixa cinza tracejada para a API externa de notificação e um cilindro no canto inferior direito para o data warehouse de análise.
- **Legenda**: Separa comunicação síncrona bloqueante da assíncrona não bloqueante e define as formas de microsserviço, banco de dados e sistema externo.

- Figura de mecanismo para artigo, Slides de defesa, Material de aula, Pôster acadêmico

- **Semântica de entrega**: Os pareceristas vão perguntar se o caminho assíncrono garante entrega pelo menos uma vez ou exatamente uma vez, se os consumidores são idempotentes e para onde vão as mensagens envenenadas, como uma fila de mensagens mortas.
- **Consistência entre bancos**: A gravação do pedido e a publicação do evento são atômicas? Como se compensa uma atualização de estoque que falhou? Se você usa outbox ou saga, marque onde ele fica na topologia.
- **Nomes de tópicos e filas**: O exemplo lista duas vezes a mesma fila de pagamento concluído, e nenhum serviço de pagamento no diagrama a publica. Todo tópico deve ter um produtor claro e pelo menos um consumidor.
- **Retorno e tratamento de falhas**: Só o serviço de produto mostra seta de resposta; as chamadas de usuário e de pedido parecem de mão única. Informe tempos limite, novas tentativas ou circuit breaker nas chamadas síncronas para que não pareçam disparos sem resposta.

## FAQ

### Este diagrama de arquitetura pode ir direto para um artigo de sistemas?

Use-o como primeira versão. É uma ilustração gerada por IA, com serviços e tópicos genéricos. Troque pelos componentes que você realmente implantou, tire o nome de fila duplicado e confirme o sentido e o estilo de comunicação de cada seta antes da submissão.

### Posso incluir ou remover serviços, ou refazer uma ligação?

A imagem não se edita elemento por elemento e não é vetorial. Continue conversando com a Yila, pedindo por exemplo um serviço de pagamento que publique eventos de pagamento, ou uma camada de cache no gateway, e a topologia inteira é gerada de novo a partir da descrição.

### Qual é o formato de saída?

Uma imagem PNG gerada por IA em quadro paisagem 4:3, que cabe num slide ou numa figura de coluna única. Se o modelo da conferência exigir gráficos vetoriais, use a divisão em zonas do PNG como planta e redesenhe na sua ferramenta de diagramas.

### É gratuito?

Ver esta página e o exemplo não tem custo. Gerar um diagrama na Yila, e cada revisão depois, consome créditos. Contas novas recebem 2.500 créditos, o suficiente para uma primeira versão e para depois ajustar nomes de serviços, tópicos e setas ao seu sistema.

### Dá para mostrar um service mesh ou uma implantação em várias zonas?

Descreva proxies sidecar, um plano de controle ou limites de zonas de disponibilidade no prompt, e a Yila reorganiza o layout. O espaço lota depressa, então considere uma figura para a topologia lógica e outra para a visão de implantação.

### Posso comparar este desenho com um monólito ou uma versão só síncrona?

Peça um painel de comparação lado a lado. A Yila pode desenhar uma segunda topologia, mais simples, ao lado desta, para o leitor ver o que o gateway e o broker mudam, o que ajuda na seção de motivação de um artigo de arquitetura.

---

- [Topologia de microsserviços com gateway de API e mensageria assíncrona](https://yila.ai/pt/templates/microservice-system-topology-network-figure)
- [llms.txt](https://yila.ai/pt/llms.txt)
