Visão Geral

Uma prova de conceito criada para resolver uma dor real: orquestrar múltiplos microsserviços espalhados em repositórios diferentes. Este projeto valida uma arquitetura onde um monorepo central gerencia serviços independentes através de submódulos Git, todos orquestrados com Docker.

O Problema

Trabalhar com microsserviços em repositórios separados gera atrito — orquestração local não é confiável, alinhamento de dependências vira tarefa manual, deploys sincronizados ficam complexos e testes end-to-end exigem esforço demais.

A Solução

• Um monorepo central que puxa cada microsserviço como submódulo Git
• Cada serviço tem seu próprio Dockerfile e endpoint /ping para healthcheck
• Docker Compose orquestra todos os containers com gerenciamento de dependências
• Gateway NGINX atua como ponto de entrada único, roteando tráfego para o serviço correto
• Healthchecks garantem que todos os serviços estejam prontos antes do gateway aceitar requisições

Arquitetura

Stack Técnica

A infraestrutura é construída com Docker e Docker Compose para orquestração de containers. NGINX cuida do proxy reverso e roteamento. Cada microsserviço roda em Express.js com seu próprio container isolado. Submódulos Git mantêm os serviços independentes enquanto permitem desenvolvimento local unificado.