AyronSantos/chatc2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
chatc2/CONTEXTO.md
T
AyronSantos ae629d1dc2 Migração para PostgreSQL multi-driver + correções de segurança 
- Camada de banco unificada (src/database.js): drivers Postgres/Firebird,
  tradutor de SQL, suporte a schema e pool de conexões
- Conexões: novo_local (Postgres externo) e firebird_local (legado)
- Tela de rotas da API redesenhada (auth, params, exemplos de body)
- Correções de segurança (críticos/altos/médios/baixos): XSS no chat,
  escalonamento de privilégio, mídia autenticada, SQL restrito a gerente,
  JWT sem fallback + issuer, IDOR em conversas, CORS por allowlist,
  rate-limit no login, limites de corpo por rota
- Deploy alinhado: install.sh grava .env com PG_*, migracoes.js driver-aware

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 10:02:59 -03:00

177 lines
7.6 KiB
Markdown
Raw Permalink Blame History

a # Chatc2 - Contexto do Projeto
_Arquivo gerado em 05/06/2026 para retomada em qualquer computador._
---
## 📋 Missão Atual
Plataforma multi-empresa de atendimento com WhatsApp (Evolution API) + Firebase Firebird, incluindo:
- Chat com atendimento humano e triagem automatizada
- Geração de boletos em PDF via API externa
- Transcrição de áudio com Whisper.cpp (local)
- Fluxo de atendimento personalizado por empresa (submenus, etiquetas)
- Breve: integração com Asterisk para ligações telefônicas
---
## 🗂️ Estrutura de Arquivos (49 arquivos)
```
src/
├── app.js # Express app setup
├── server.js # Entry point (porta 3000)
├── database.js # Conexão Firebird (query, execute, readBlob)
├── config/
│ ├── databases.js # Conexões estáticas + custom (JSON)
│ ├── databases_custom.json # Conexões adicionadas via API
│ ├── database.js # Config padrão do banco
│ └── auth.js # JWT secret/expires
├── middlewares/
│ └── auth.js # JWT + USU_TOKEN dual auth
├── controllers/
│ ├── authController.js # Login, /me, dashboard
│ ├── chatController.js # Conversas, mensagens, mídia, Evolution send
│ ├── clientController.js # CRUD clientes, carnês, dependentes, convalescentes, listcarne
│ ├── configController.js # Config empresa, equipes, etiquetas, instâncias
│ ├── evolutionController.js # Webhook Evolution, QR Code, instâncias
│ ├── genericController.js # Health, tables, query, aliases
│ ├── menuController.js # CRUD CHATC2_MENUS_EMPRESA (submenus do fluxo)
│ ├── triageController.js # Fluxo de triagem (sendMenu, processResponse, boleto)
│ ├── databaseController.js # CRUD de conexões de banco (custom JSON)
│ ├── routesController.js # Descoberta automática de rotas
│ ├── empresaController.js # Logo da empresa
│ └── transcriber.js # Whisper.cpp para transcrição de áudio
├── routes/
│ ├── index.js # Agregador de rotas
│ ├── authRoutes.js, chatRoutes.js, configRoutes.js
│ ├── genericRoutes.js, menuRoutes.js, databaseRoutes.js
└── public/
├── login.html, dashboard.html, chat.html, client-list.html
├── client-detail.html, settings.html, routes.html
├── admin-conversations.html, csat.html
├── css/dark-mode.css, css/main.css
└── js/dark-mode.js
scripts/
├── migracoes.js # 19 migrações de banco (controle via CHATC2_CONTROLE_MIGRACOES)
├── criar_tabelas_chat.js # Script original de criação de tabelas
├── gerar-token-jwt.js, gerar-token-usuario.js
├── habilitar-acesso-web.js, definir-senha-web.js
└── listar-tokens.js
deploy/
├── cloud-init.yml # Deploy automático Ubuntu 22.04
├── setup.sh # Instalação manual
└── README_INSTALACAO.md # Guia completo
```
---
## 🔥 Principais Funcionalidades Implementadas
### 1. Autenticação
- JWT + USU_TOKEN (dual auth)
- Login com USU_LOGIN + USU_SENHA (ou USU_SENHA_WEB)
- Roles: Agente (A) e Gerente/Admin (G) via USU_TIPO_CHAT
- `/app/:alias/me` retorna dados do usuário
### 2. Webhook Evolution API (v2.3.7)
- URL: `POST /api/webhook/evolution` (sem alias na URL)
- Detecta alias automaticamente pelo nome da instância
- Cria conversas novas ou reusa existentes (últimos 8 dígitos)
- Busca cliente por telefone (CLI_CELULAR, CLI_FONE1, CLI_FONE2, DEPENDENTES_CLI)
- Sempre corrige CON_CLIENTE_ID pelo telefone (novas + existentes)
- Mídia: tenta download via URL, depois /chat/getMedia/, depois base64 embutido
### 3. Chat (Tempo Real)
- Sidebar: Minhas / Sem Atendimento / Equipe / Todas (com contagens)
- Painel central com mensagens
- Painel direito: atendente, equipe, etiquetas
- Envio de texto, imagem, áudio (MediaRecorder → base64), documento
- Prévia do áudio antes de enviar
- Transcrição de áudio via Whisper.cpp (exibida abaixo do player)
### 4. Triagem / Fluxo Automático
- Menu principal = Equipes (ordenadas por EQU_ORDEM) + Boleto (fixo)
- **Ao escolher equipe: CON_EQUIPE_ID atribuído IMEDIATAMENTE**
- Submenus via CHATC2_MENUS_EMPRESA (M=submenu, T=texto, R=rota)
- Navegação multi-nível com "0 - Voltar"
- Etiquetas associadas a cada submenu (adicionadas automaticamente)
- Boleto: lista títulos → seleciona → gera PDF via API externa → envia via Evolution → pergunta "continuar?"
### 5. Boleto
- Geração: `POST https://cobpagweb.com.br/boleto/cliente/index.php?base64`
- Payload: `{ empresa: {EMP_NOME, EMP_CNPJ, EMP_FOTO}, Cliente: {...}, Carnes: [...] }`
- Envio Evolution: `/message/sendMedia/` com `mediatype: 'document'`
- Fallback: texto com dados do boleto quando PDF não gerado
- Nome do arquivo: `<MATRICULA> - <VENCIMENTO>.pdf`
### 6. Whisper.cpp (Transcrição de Áudio)
- Instalado em `whisper/` (main.exe/main + modelo tiny)
- Transcreve áudios recebidos via webhook
- Salva transcrição em `MAT_TRANSCRICAO` (BLOB SUB_TYPE TEXT)
- Exibe no chat: player + transcrição abaixo
- **Limitação: Evolution API v2.3.7 não fornece áudio válido para download**
- Funcionará quando atualizar a Evolution API (> v2.5.0)
### 7. Settings (Configurações)
- Abas: Equipe, Fluxo, Empresa, Etiquetas, Conexão
- Fluxo: CRUD de submenus por equipe (árvore), com tipos e etiquetas
- Empresa: saudação, triagem, CSAT, foto, nome do usuário
- Etiquetas: nome + cor
- Conexão: instâncias WhatsApp (criar, editar, QR Code)
### 8. Banco de Dados (Migrações)
- Script: `scripts/migracoes.js` — 19 migrações
- Tabelas: CHATC2_INSTANCIAS, CHATC2_EQUIPES, CHATC2_USU_EQUIPES, CHATC2_ETIQUETAS
- CHATC2_CONVERSAS, CHATC2_CONVERSAS_MENSAGENS, CHATC2_MENSAGENS_ATENDIMENTOS
- CHATC2_CONVERSAS_ETIQUETAS, CHATC2_CSAT_AVALIACOES, CHATC2_CONFIGURACOES_EMPRESA
- CHATC2_MENUS_EMPRESA (com MNE_ACAO_ROTA, MNE_ETIQUETA_IDS)
- Controle via `CHATC2_CONTROLE_MIGRACOES` (cada migração roda uma vez)
---
## 🎯 Próximos Passos (quando retomar)
1. **Aguardar**: Usuário vai contratar SIP Trunk e instalar Asterisk
2. **Implementar**: Módulo Voice (AMI) para fazer ligações + transcrição
3. **Atualizar**: Evolution API (> v2.5.0) para download de mídia funcionar
4. **Corrigir pendências da conversa**:
- Etiquetas em submenus (não estava persistindo - adicionar logs `[Menu]` no console)
- Transcrição só funciona para áudio do agente (aguardando Evolution atualizar)
---
## 🔗 URLs Importantes
| Recurso | URL |
|---------|-----|
| Login | `/app/:alias/login` |
| Chat | `/app/:alias/company/:empresaId/conversation/:conversaId` |
| Clientes | `/app/:alias/clients` |
| Settings | `/app/:alias/settings` |
| Rotas | `/app/:alias/routes` |
| CSAT | `/app/:alias/csat` |
| Webhook | `POST /api/webhook/evolution` |
| Rotas API | `GET /api/routes` |
| Bancos | `GET /api/:alias/databases` |
| Carnê | `GET /api/:alias/clients/:id/listcarne` |
| Convalescentes | `GET /api/:alias/clients/:id/convalescentes` |
## 🔑 Testes
| Usuário | Senha | Base | Tipo |
|---------|-------|------|------|
| SUPORTE | 123456 | lajedo | Admin (G) |
| SUPORTE | 123456 | novo_local | Admin (G) |
## ☁️ Deploy
Arquivos em `deploy/`:
- `cloud-init.yml` — cloud-init (DigitalOcean, Vultr, etc.)
- `setup.sh` — instalação manual
- `README_INSTALACAO.md` — guia completo
## 📦 Backup
`ponto_1/` contém snapshot completo do código fonte.
Reference in New Issue View Git Blame Copy Permalink