# Visão geral

Última atualização: 20/08/2026

O `enterprise-evo-crm-community` é um stack multi-serviço orquestrado via
Docker Compose, composto por:

| Serviço | Stack | Porta interna | Papel |
|---|---|---|---|
| `evo-auth` | Ruby/Rails 7.1 | 3001 | Autenticação, RBAC, JWT/OAuth 2.0 |
| `evo-auth-sidekiq` | Ruby/Rails 7.1 | — | Worker de fila do Auth |
| `evo-crm` | Ruby/Rails 7.1 | 3000 | Conversas, contatos, catch-all da API |
| `evo-crm-sidekiq` | Ruby/Rails 7.1 | — | Worker de fila do CRM |
| `evo-core` | Go/Gin | 5555 | Agentes de IA, chaves API, folders |
| `evo-processor` | Python/FastAPI | 8000 | Orquestração de agentes, sessões, chat |
| `evo-bot-runtime` | Go/Gin | 8080 | Pipeline de bots |
| `evo-frontend` | React/Nginx | 80 | Dashboard web |

Todos os serviços compartilham a rede Docker `app-network` (externa,
pré-criada) e são roteados publicamente via **Traefik**, com dois domínios:

- `evocrm-api.vya.digital` — API (auth, crm, core, processor, bot-runtime), roteada por `PathPrefix`/`PathRegexp`.
- `evo-crm.vya.digital` — frontend, roteado só por `Host`.

Os workers Sidekiq (`evo-auth-sidekiq`, `evo-crm-sidekiq`) não servem HTTP e
não são expostos pelo Traefik.

## Ambiente de produção

O stack roda em um único host (`wfdb01`), acessado por um túnel SSH com
autorização prévia (SPA/fwknop) — ver
[Acesso ao servidor de produção](../runbooks/acesso-producao.md).

## Próximos passos

- [Infraestrutura e Traefik](../deploy/infraestrutura.md)
- [Variáveis de ambiente](../deploy/variaveis-de-ambiente.md)