# evo-ai-crm-community

Ruby 3.4.4 / Rails 7.1 (API mode) · porta 3000

API principal — conversas, contatos, inboxes, mensageria multi-canal e
tempo real via ActionCable. Autenticação via Devise + JWT.

## Tech stack

- PostgreSQL (conversas, contatos, usuários).
- Redis + Sidekiq (cache/jobs).
- ActionCable (WebSocket).
- Storage: AWS S3, Google Cloud Storage, Azure Blob.

Segue a mesma estrutura em camadas do `evo-auth-service-community` (ver
[página do Auth](evo-auth.md)) — Service Objects, Wisper, Pundit,
serializers em Plain Ruby.

## Setup

```bash
cd evo-ai-crm-community
bundle install
bundle exec rails db:setup
bundle exec rails db:migrate
```

## Rodando

```bash
pnpm dev       # Rails + Sidekiq juntos (via scripts de conveniência)
pnpm start     # só Rails
pnpm sidekiq   # só Sidekiq
```

## Integração WhatsApp (evolution-api/evolution-go)

Canal configurável por instância (URL + API key inseridos na UI), consumido
via `app/services/whatsapp/providers/evolution_service.rb` e
`Whatsapp::EvolutionGoHandlers::MessagesUpsert` — não é uma chamada
hardcoded a um serviço local, por isso não aparece em `docker-compose.yml`.

```{seealso}
Site de Operação → **Troubleshooting → Divergências conhecidas** — bugs já
diagnosticados neste serviço (schema.rb dessincronizado,
facebook_webhook_logger.rb quebrando boot com static files desabilitado).
```