Segundo Cerebro ZPRO CRM — reidozap.com.br
Producao: crm.reidozap.com.br | Obsidian Web: obsidian.reidozap.com.br
Atualizado: 2026-05-29 | 21 notas | 2182 linhas
Deploy seguro: pm2 reload zpro-frontend-novo (NUNCA restart em horario comercial)
STATUS DO MAPEAMENTO
| Area | Cobertura |
|---|
| Paginas (175 total) | 100% — todas documentadas |
| Services (80+ arquivos) | 100% — todos catalogados |
| Stores Zustand (22) | 100% — mapeados com padroes |
| Hooks (43) | 100% — incluindo race conditions |
| Componentes criados por nos | 100% |
| Integracoes externas | 100% |
| Banco de dados (tabelas) | 100% — queries criticas incluidas |
| FlowBuilder/Chatbot | 100% — estrutura JSON documentada |
| i18n namespaces criticos | 100% — verificacao Python incluida |
Mapas do Sistema
- mapa-crm — Arquitetura geral, fluxo de mensagem, cluster Baileys
- mapa-paginas — TODAS as 175 paginas agrupadas por categoria
- mapa-componentes — Componentes criados por nos vs vendor
- mapa-servicos — Todos os 80+ services com endpoints criticos
- mapa-stores — Todos os 22 stores Zustand (padroes de uso)
- mapa-hooks — Todos os 43 hooks (incl. race condition uso-socket-chat)
- mapa-i18n — Namespaces + verificacao Python automatica
- mapa-integracoes — WhatsApp, Meta, WABA, RCS, WaVoIP, WorkBuscas
- mapa-banco-dados — Tabelas PostgreSQL, relacoes, queries criticas
- mapa-flows-chatbot — FlowBuilder: nos, interacoes, JSON format, keyword
Troubleshooting (Acesso rapido)
Decisoes Arquiteturais
Skills de Atualizacao (pos-update do fornecedor)
Templates
Top 8 Armadilhas (nao repetir esses erros)
| # | Sintoma | Causa | Fix rapido |
|---|
| 1 | ”Algo deu errado” ao abrir conversa | Prop no tipo mas nao no destructuring | Adicionar tagsList, no destructuring ({...tagsList,...}) |
| 2 | UI mostra atendimentoChatExtra.callWaba | Key no namespace errado | Adicionar em atendimentoChatExtra, nao em ticketDetail |
| 3 | Sessao loop conflict:replaced a cada 5s | resetBaileysConnection em sessoes CONNECTED | Nunca tocar CONNECTED — usar menu individual |
| 4 | Logout forcado ao abrir o sistema | fetchPrivateGroups sem token no localStorage | setTimeout(500ms) + check token antes da chamada |
| 5 | Module not found no build | Modulos massa ausentes | Copiar de frontNovo/src/lib e frontNovo/src/components/massa |
| 6 | Syntax Error na pagina de SMS | Dialog dentro do grid | Dialog fora do grid wrapper |
| 7 | Identifier already declared | useTicketStore declarado 2x no ChatHeader | Remover a segunda declaracao |
| 8 | useSpyMessages nao encontrado | Funcoes sem export | Adicionar export antes das funcoes no spy-contact-messages-dialog |
Arquitetura em 30 segundos
Frontend: Next.js 14 + TypeScript + Tailwind + Shadcn/UI (porta 4444)
Backend: Node.js cluster 6 workers OBFUSCADO (porta 3000)
DB: PostgreSQL 17 externo (72.62.137.163:7544)
Realtime: Socket.IO + Redis adapter (cluster)
WhatsApp: Baileys (@whiskeysockets/baileys) + Signal Protocol
WABA: Meta Cloud API v19.0 (tokenAPI = phoneNumberId, bmToken = access token)
Auth: JWT no localStorage, refresh token, interceptor axios
CDN: Nginx no host → proxy para containers
Obsidian: SilverBullet Docker (porta 3007) → nginx → obsidian.reidozap.com.br