How mariomatheuspombal/rabbitmq-sistemasdistribuidos works
Para criar um diagrama de arquitetura preciso e completo deste projeto de “Sistema Distribuído com RabbitMQ, Node.js e Socket.IO”, siga os passos abaixo, adaptando cada ponto ao contexto específico dos diretórios e componentes identificados no seu repositório.
Identificação do tipo de projeto e propósito
• Trata-se de uma aplicação distribuída, demonstrando um fluxo assíncrono de mensagens entre 4 serviços Node.js (Interface web, API, Worker, Notifier) coordenados por um broker RabbitMQ.
• Objetivo: enviar “jobs” via HTTP, processá-los assincronamente, e notificar em tempo real o front-end via Socket.IO.
Componentes principais
a. Interface Web
• index.html + socket.io-client
• Responsabilidade: formulário de envio de jobs, escuta de eventos em tempo real.
b. API Service (api/src/server.js)
• Express + amqplib + cors + uuid
• Recebe POST /jobs, gera jobId e publica em fila “jobs”.
c. Worker (api/worker.js)
• amqplib
• Consome fila “jobs”, executa a tarefa (simulada), publica em fila “job_events”.
d. Notifier Service (notifier/src/server.js)
• Express + socket.io + amqplib
• Consome “job_events” e emite eventos via Socket.IO para o navegador.
e. RabbitMQ Broker (docker-compose ou container rabbitmq:3-management)
• Filas: jobs, job_events
• Portas: 5672 (AMQP), 15672 (management)
Relacionamentos e fluxos de dados
• A Interface Web faz HTTP POST → API
• API publica mensagem → RabbitMQ (fila “jobs”)
• Worker consome “jobs”, processa e publica → RabbitMQ (fila “job_events”)
• Notifier consome “job_events” e faz push via WebSocket (Socket.IO) → Interface
• RabbitMQ atua como hub de mensagens, isolando produtores e consumidores
Padrões e princípios arquiteturais
• Arquitetura orientada a eventos / Message-Driven Architecture
• Serviços independentes (microservices leves) – cada um com seu próprio processo Node.js
• Desacoplamento via broker (fila)
• Separação clara de responsabilidades: entrada → processamento → notificação
• Opção de orquestrar via Docker Compose para ambiente de integração
Tecnologias-chave a destacar no diagrama
• Node.js (cada serviço)
• Express (API, Notifier)
• amqplib (conexão AMQP)
• socket.io / socket.io-client (notificações em tempo real)
• Docker / Docker Compose (infraestrutura de RabbitMQ)
Diretrizes para criação do diagrama
a. Desenhe retângulos individuais para cada componente:
• “Web UI” (index.html)
• “API Service”
• “Worker”
• “Notifier Service”
• “RabbitMQ Broker” (use um cilindro ou ícone de broker)
b. Adicione setas direcionais:
• Web UI → (HTTP POST) → API Service
• API Service → (AMQP publish to jobs) → RabbitMQ
• RabbitMQ → (AMQP consume jobs) → Worker
• Worker → (AMQP publish job_events) → RabbitMQ
• RabbitMQ → (AMQP consume job_events) → Notifier Service
• Notifier Service → (WebSocket/Socket.IO) → Web UI
c. Use cores e formas para diferenciar:
• Azul para serviços HTTP (API, Notifier)
• Verde para processamento (Worker)
• Laranja para frontend (Web UI)
• Cinza ou cilindro para RabbitMQ
d. Etiquete cada conexão com o canal/fila ou protocolo:
• HTTP POST /jobs
• AMQP queue “jobs”
• AMQP queue “job_events”
• WebSocket (Socket.IO)
Ajustes finais e detalhes
• Inclua nos cantos: porta de cada serviço (3000, 3001).
• Indique variáveis de ambiente (RABBIT_URL, EVENT_QUEUE) ao lado dos serviços que as utilizam.
• Se usar Docker Compose, agrupe todos os serviços junto ao ícone do broker dentro de um contorno “docker-compose network”.
Seguindo estas instruções, você obterá um diagrama claro, detalhado e fiel à estrutura do repositório, permitindo visualizar instantaneamente cada componente, suas responsabilidades e interações assíncronas.