Arquitetura do Kodus

​

Visão Geral

Este documento descreve a arquitetura que sustenta a infraestrutura do Kodus. Nosso sistema é construído sobre uma arquitetura distribuída que utiliza contêinerização e segmentação de rede para garantir máxima escalabilidade, segurança e manutenibilidade.

​

Redes e Componentes Principais

A infraestrutura é dividida em redes Docker que separam o acesso público do tráfego interno entre serviços:

• shared-network: Serviços públicos e roteamento de borda
• kodus-backend-services: Comunicação interna entre serviços
• monitoring-network: Tráfego de métricas e observabilidade (opcional)

​

Componentes

​

1. Aplicação Web do Kodus

Nossa plataforma frontend é construída com Next.js, oferecendo uma experiência de usuário fluida por meio de comunicação direta com nossa camada de API.

​

2. Serviços de Backend Principais

O stack 2.0 divide as responsabilidades do backend em serviços dedicados:

• API: Camada de serviço central responsável pela lógica de negócios e processamento de requisições
• Worker: Processamento assíncrono para filas e tarefas em segundo plano
• Webhooks: Serviço dedicado para webhooks de provedores Git

​

3. MCP Manager

O MCP Manager cataloga provedores e integrações, e os disponibiliza para o Kodus para que as equipes possam instalar MCPs pela tela de Plugins.

​

4. Armazenamentos de Dados

O Kodus utiliza dois bancos de dados:

• Postgres: Dados relacionais e metadados de embeddings
• MongoDB: Armazenamento flexível de documentos

​

5. Mensageria e Observabilidade

O RabbitMQ é obrigatório na versão 2.0, fornecendo comunicação assíncrona confiável entre a API, o worker e os webhooks. Prometheus e Grafana são opcionais e utilizados para monitoramento e visualização.

​

6. Serviços Auxiliares (Kodus Cloud)

O Kodus Cloud inclui serviços auxiliares de código fechado (faturamento, analytics e integrações de chat) que não são necessários para implantações self-hosted.

​

Próximos Passos