Olume Chat — atendimento por WhatsApp, multi-empresa

Status: em produção (https://olumechat.com.br, API em https://api.olumechat.com.br). Staging em https://staging.olumechat.com.br.

Stack: React 18 e Vite no client/, Express no server/, Postgres no Neon, mídia no Cloudflare R2, deploy na VPS com Coolify.

Dono: Filippe.

Como rodar (dev)

PowerShell, na raiz do repositório. É preciso um server/.env com DATABASE_URL de uma branch Neon descartável (copie de server/.env.example).

Copy-Item server\.env.example server\.env
Copy-Item client\.env.example client\.env
cd server
npm install
npm run migrar
npm run dev

Outro terminal:

cd client
npm install
npm run dev

O painel abre em http://localhost:5173. A API escuta na porta 3001. O Vite encaminha /api para lá.

Antes de abrir PR, na raiz:

npm run verify

Isso roda a suíte do server e o teste mais o build do client.

O merge na main sobe staging. Produção é promoção manual da mesma imagem. Runbook: docs/operacao.md e docs/AMBIENTES.md.

Pasta	O que é
`client/`	Telas
`server/`	API, webhook, fila, IA
`docs/`	Funcionalidades, arquitetura, operação, decisões
`.github/workflows/`	CI, imagem no GHCR, staging e promoção