.aider.chat.history.md

@@ -1,24 +0,0 @@
-
-# aider chat started at 2026-03-23 12:27:25
-
-> You can skip this check with --no-gitignore  
-> Add .aider* to .gitignore (recommended)? (Y)es/(N)o [Yes]: y  
-> Added .aider* to .gitignore  
-> /home/ubuntu/.local/bin/aider --message liste os arquivos principais do projeto em uma linha cada  
-> Warning: ollama/deepseek-r1:14b expects these environment variables  
-> - OLLAMA_API_BASE: Not set  
-> Warning for ollama/deepseek-r1:14b: Unknown context window size and costs, using sane defaults.  
-> You can skip this check with --no-show-model-warnings  
-> https://aider.chat/docs/llms/warnings.html  
-> Open documentation url for more info? (Y)es/(N)o/(D)on't ask again [Yes]: y  
-> Aider v0.86.2  
-> Model: ollama/deepseek-r1:14b with diff edit format  
-> Git repo: .git with 5,113 files  
-> Warning: For large repos, consider using --subtree-only and .aiderignore  
-> See: https://aider.chat/docs/faq.html#can-i-use-aider-in-a-large-mono-repo  
-> Repo-map: using 1024 tokens, auto refresh  
-
-#### liste os arquivos principais do projeto em uma linha cada  
-> Initial repo scan can be slow in larger repos, but only happens once.  
-> litellm.APIConnectionError: OllamaException - [Errno 111] Connection refused  
-> Retrying in 0.2 seconds...  

.aider.input.history

@@ -1,6 +0,0 @@
-
-# 2026-03-23 12:27:36.139575
-+liste os arquivos principais do projeto em uma linha cada
-
-# 2026-03-23 12:27:36.139669
-+liste os arquivos principais do projeto em uma linha cada

.deployignore

@@ -1,25 +0,0 @@
-metabase/
-attached_assets/
-.git/
-.cache/
-.upm/
-.config/
-.local/
-.pythonlibs/
-uploads/
-plus/
-whatsapp-sessions/
-migrations/
-docs/
-scripts/
-server/python/
-python-service/
-*.tar.gz
-*.zip
-*.sql
-*.log
-*.docx
-plus_backup_*/
-RELATORIO_TECNICO_RETAIL.md
-MAPA_GERAL_RETAIL.md
-PLANO_EVOLUCAO_ARCADIA.docx

.dockerignore

@@ -1,47 +0,0 @@
-node_modules
-dist
-.git
-*.zip
-*.log
-.env
-.replit
-replit.nix
-.cache
-.config
-.upm
-
-# MetaSet - Apache Superset source code (não necessário para build do app principal)
-server/bi/metaset/superset-src/
-server/bi/metaset/venv/
-
-# Python cache
-__pycache__/
-*.pyc
-*.pyo
-*.pyd
-.Python
-*.so
-
-# Logs e dados
-data/
-logs/
-*.log
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Testes
-.pytest_cache/
-.playwright-mcp/
-coverage/
-
-# Docker
-.docker/
-
-# Outros - exceto attached_assets que são necessários
-*.md
-!attached_assets/
-docs/

.env

@@ -1,17 +0,0 @@
-PGPASSWORD=afefb610090de1646944b537f3054715ad5755665c90036c2bcd258c9ab52dd8
-SESSION_SECRET=092a26dcbebd6f7f5e7b9e020bdc4d4e966286c9780ef72e3426f437eb8d608b
-SSO_SECRET=fbb87d1c5a14a6623d4e3dcc2b679bd68c46e59afb48dd6abd42b95cac945856
-LITELLM_API_KEY=e396b827cbeb5e77d85cce4eb9da0521114f57a8e799f7aa8febad08d776c07e
-WEBUI_SECRET_KEY=76c7fc044f9e8d6e5eb60b67c82832b67e84739da4827ce1fa7c101ae1a055df
-DOMAIN=suite.onboardbi.com.br
-OLLAMA_BASE_URL=http://ollama-ia1upsekrad96at5hq97e4qa:11434
-
-# ── Superset BI ───────────────────────────────────────────────
-SUPERSET_SECRET_KEY=421274b5ba360778a5398d528116a45ea962d1197e3dfc99f36a372ff1025a63
-SUPERSET_ADMIN_USERNAME=admin
-SUPERSET_ADMIN_PASSWORD=arcadia1337
-SUPERSET_ADMIN_EMAIL=engenharia@ometas.com.br
-COMPOSE_PROFILES=bi
-
-SUPERSET_HOST=superset
-SUPERSET_PORT=8088

.env.example

@@ -27,11 +27,7 @@ CONTABIL_PYTHON_URL=http://localhost:8003
 BI_PYTHON_URL=http://localhost:8004
 AUTOMATION_PYTHON_URL=http://localhost:8005
 FISCO_PYTHON_URL=http://localhost:8002
-# ── Embeddings / Learning Service ──────────────────────────────────────────────
+PYTHON_SERVICE_URL=http://localhost:8001
-# IMPORTANTE: Usar porta 8000 (não 8001) - o serviço escuta na porta 8000
-# Em Docker: http://arcadia-prod-embeddings-1:8000
-# Em dev local: http://localhost:8000
-PYTHON_SERVICE_URL=http://localhost:8000
 
 # ── IA — OpenAI ───────────────────────────────────────────────────────────────
 # Deixe vazio se usar apenas Ollama (soberania total)
@@ -53,8 +49,13 @@ AI_INTEGRATIONS_OPENAI_API_KEY=arcadia-internal
 # Se Ollama está em outro servidor:        OLLAMA_BASE_URL=http://IP_DO_SERVIDOR:11434
 OLLAMA_BASE_URL=http://localhost:11434
 
+# ── IA — LLMFit (modelos fine-tuned locais — habilitar quando disponível) ─────
+# LLMFit turbocharge: modelos treinados com dados do seu negócio
+# Deixe vazio para desabilitar (LiteLLM cai para Ollama automaticamente)
+LLMFIT_BASE_URL=
+
 # ── IA — Providers externos (opt-in — soberania: dados não saem sem configurar)
-# Deixe vazio para operação 100% soberana (apenas Ollama)
+# Deixe vazio para operação 100% soberana (apenas Ollama + LLMFit)
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=
 GROQ_API_KEY=
@@ -67,15 +68,9 @@ PLUS_URL=http://localhost:8080
 PLUS_PORT=8080
 PLUS_API_TOKEN=
 
-# ── Superset (BI avançado — Arcádia Insights) ────────────────────────────────
+# ── Superset (BI avançado) ────────────────────────────────────────────────────
-SUPERSET_HOST=superset
+SUPERSET_SECRET_KEY=troque-por-string-aleatoria-segura
 SUPERSET_PORT=8088
-SUPERSET_SECRET_KEY=troque-por-string-aleatoria-segura  # openssl rand -hex 32
-SUPERSET_ADMIN_USER=admin
-SUPERSET_ADMIN_EMAIL=admin@arcadia.app
-SUPERSET_ADMIN_PASSWORD=troque-senha-forte-em-prod
-# URL do banco Arcádia para o Superset acessar os dados (idealmente read-only)
-ARCADIA_DATABASE_URL=postgresql://arcadia:arcadia123@db:5432/arcadia
 
 # ── Redis ─────────────────────────────────────────────────────────────────────
 REDIS_URL=redis://localhost:6379
@@ -83,20 +78,8 @@ REDIS_URL=redis://localhost:6379
 # ── Domínio (produção) ────────────────────────────────────────────────────────
 DOMAIN=seudominio.com.br
 
-# ── ERPNext ────────────────────────────────────────────────────────────────────
+# ── Integrações externas (opcional) ──────────────────────────────────────────
-# Modo 1 — ERPNext em container Docker (perfil erpnext)
+# ERPNext
-# Sobe com: docker compose --profile erpnext up
-# Proxy ativado automaticamente em DOCKER_MODE=true
-ERPNEXT_PROXY_ENABLED=false          # true para forçar proxy mesmo fora do Docker
-ERPNEXT_CONTAINER_HOST=erpnext       # nome do serviço no docker-compose
-ERPNEXT_CONTAINER_PORT=8080
-ERPNEXT_DB_ROOT_PASSWORD=erpnext-root-2026   # senha root do MariaDB
-ERPNEXT_DB_PASSWORD=frappe2026               # senha do usuário frappe
-ERPNEXT_ADMIN_PASSWORD=admin2026             # senha do Administrator no site
-
-# Modo 2 — ERPNext externo (instância existente)
-# Em Docker: ERPNEXT_URL=http://erpnext:8080  (aponta pro container)
-# Externo:   ERPNEXT_URL=https://meuerpnext.com
 ERPNEXT_URL=
 ERPNEXT_API_KEY=
 ERPNEXT_API_SECRET=

.gitignore

@@ -1,6 +1,9 @@
 node_modules/
 dist/
 .DS_Store
+.env
+.env.local
+.env.production
 
 # Replit specific
 .cache/
@@ -61,12 +64,3 @@ attached_assets/
 # Package lock (regenerated on install)
 package-lock.json
 .claude/
-
-# MetaSet - Apache Superset fork (não versionar código fonte completo)
-server/bi/metaset/superset-src/
-server/bi/metaset/venv/
-server/bi/metaset/superset
-
-# Backups gerados durante deploy
-docker-compose.yml.backup.*
-server/kernel/config/services.json.backup.*

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "server/modules/openclaw"]
-	path = server/modules/openclaw
-	url = https://github.com/miaoxworld/OpenClawInstaller.git

.playwright-mcp/page-2026-04-08T15-57-28-475Z.yml

@@ -1,26 +0,0 @@
-- generic [ref=e2]:
-  - region "Notifications (F8)":
-    - list
-  - generic [ref=e5]:
-    - generic [ref=e6]:
-      - img "Arcadia" [ref=e7]
-      - heading "Arcádia Suite" [level=1] [ref=e8]
-    - generic [ref=e9]:
-      - tablist [ref=e10]:
-        - tab "Login" [selected] [ref=e11]
-        - tab "Criar Conta" [ref=e12]
-      - tabpanel "Login" [ref=e13]:
-        - generic [ref=e14]:
-          - generic [ref=e15]:
-            - generic [ref=e16]: Bem-vindo de volta
-            - generic [ref=e17]: Entre com suas credenciais para acessar o sistema
-          - generic [ref=e19]:
-            - generic [ref=e20]:
-              - text: Usuário
-              - textbox "Usuário" [ref=e21]:
-                - /placeholder: Digite seu usuário
-            - generic [ref=e22]:
-              - text: Senha
-              - textbox "Senha" [ref=e23]:
-                - /placeholder: Digite sua senha
-            - button "Entrar" [ref=e24]

.playwright-mcp/page-2026-04-08T15-58-19-679Z.yml

@@ -1,34 +0,0 @@
-- generic [ref=e2]:
-  - region "Notifications (F8)":
-    - list [ref=e26]:
-      - status [ref=e27]:
-        - generic [ref=e28]:
-          - generic [ref=e29]: Login failed
-          - generic [ref=e30]: Invalid username or password
-        - button [ref=e31]:
-          - img [ref=e32]
-  - generic [ref=e5]:
-    - generic [ref=e6]:
-      - img "Arcadia" [ref=e7]
-      - heading "Arcádia Suite" [level=1] [ref=e8]
-    - generic [ref=e9]:
-      - tablist [ref=e10]:
-        - tab "Login" [selected] [ref=e11]
-        - tab "Criar Conta" [ref=e12]
-      - tabpanel "Login" [ref=e13]:
-        - generic [ref=e14]:
-          - generic [ref=e15]:
-            - generic [ref=e16]: Bem-vindo de volta
-            - generic [ref=e17]: Entre com suas credenciais para acessar o sistema
-          - generic [ref=e19]:
-            - generic [ref=e20]:
-              - text: Usuário
-              - textbox "Usuário" [ref=e21]:
-                - /placeholder: Digite seu usuário
-                - text: admin
-            - generic [ref=e22]:
-              - text: Senha
-              - textbox "Senha" [ref=e23]:
-                - /placeholder: Digite sua senha
-                - text: admin
-            - button "Entrar" [ref=e24]

.playwright-mcp/page-2026-04-08T15-58-26-731Z.yml

@@ -1,28 +0,0 @@
-- generic [ref=e2]:
-  - region "Notifications (F8)":
-    - list
-  - generic [ref=e5]:
-    - generic [ref=e6]:
-      - img "Arcadia" [ref=e7]
-      - heading "Arcádia Suite" [level=1] [ref=e8]
-    - generic [ref=e9]:
-      - tablist [ref=e10]:
-        - tab "Login" [selected] [ref=e11]
-        - tab "Criar Conta" [ref=e12]
-      - tabpanel "Login" [ref=e13]:
-        - generic [ref=e14]:
-          - generic [ref=e15]:
-            - generic [ref=e16]: Bem-vindo de volta
-            - generic [ref=e17]: Entre com suas credenciais para acessar o sistema
-          - generic [ref=e19]:
-            - generic [ref=e20]:
-              - text: Usuário
-              - textbox "Usuário" [ref=e21]:
-                - /placeholder: Digite seu usuário
-                - text: admin
-            - generic [ref=e22]:
-              - text: Senha
-              - textbox "Senha" [ref=e23]:
-                - /placeholder: Digite sua senha
-                - text: admin
-            - button "Entrar" [ref=e24]

.playwright-mcp/page-2026-04-08T15-58-47-519Z.yml

@@ -1,30 +0,0 @@
-- generic [ref=e2]:
-  - region "Notifications (F8)":
-    - list
-  - generic [ref=e5]:
-    - generic [ref=e6]:
-      - img "Arcadia" [ref=e7]
-      - heading "Arcádia Suite" [level=1] [ref=e8]
-    - generic [ref=e9]:
-      - tablist [ref=e10]:
-        - tab "Login" [selected] [ref=e11]
-        - tab "Criar Conta" [ref=e12]
-      - tabpanel "Login" [ref=e13]:
-        - generic [ref=e14]:
-          - generic [ref=e15]:
-            - generic [ref=e16]: Bem-vindo de volta
-            - generic [ref=e17]: Entre com suas credenciais para acessar o sistema
-          - generic [ref=e19]:
-            - generic [ref=e20]:
-              - text: Usuário
-              - textbox "Usuário" [ref=e21]:
-                - /placeholder: Digite seu usuário
-                - text: admin
-            - generic [ref=e22]:
-              - text: Senha
-              - textbox "Senha" [ref=e23]:
-                - /placeholder: Digite sua senha
-                - text: admin
-            - button "Entrando..." [disabled]:
-              - img
-              - text: Entrando...

.playwright-mcp/page-2026-04-08T15-58-53-177Z.yml

@@ -1,28 +0,0 @@
-- generic [ref=e2]:
-  - region "Notifications (F8)":
-    - list
-  - generic [ref=e5]:
-    - generic [ref=e6]:
-      - img "Arcadia" [ref=e7]
-      - heading "Arcádia Suite" [level=1] [ref=e8]
-    - generic [ref=e9]:
-      - tablist [ref=e10]:
-        - tab "Login" [selected] [ref=e11]
-        - tab "Criar Conta" [ref=e12]
-      - tabpanel "Login" [ref=e13]:
-        - generic [ref=e14]:
-          - generic [ref=e15]:
-            - generic [ref=e16]: Bem-vindo de volta
-            - generic [ref=e17]: Entre com suas credenciais para acessar o sistema
-          - generic [ref=e19]:
-            - generic [ref=e20]:
-              - text: Usuário
-              - textbox "Usuário" [ref=e21]:
-                - /placeholder: Digite seu usuário
-                - text: admin
-            - generic [ref=e22]:
-              - text: Senha
-              - textbox "Senha" [ref=e23]:
-                - /placeholder: Digite sua senha
-                - text: admin
-            - button "Entrar" [ref=e24]

CLAUDE.md

@@ -20,7 +20,7 @@ server/
 client/                   # 66 páginas React
 shared/schema.ts          # Schema do banco (7317 linhas, Drizzle ORM)
 docker/
-  litellm-config.yaml     # Roteamento de LLMs (TIER 1: Ollama local, TIER 2: externos)
+  litellm-config.yaml     # Roteamento de LLMs (TIER 1: LLMFit, TIER 2: Ollama, TIER 3: externos)
 ```
 
 ## Arquitetura de IA
@@ -29,8 +29,9 @@ Manus / Agents / Embeddings
         │  AI_INTEGRATIONS_OPENAI_BASE_URL
         ▼
    LiteLLM :4000  (gateway unificado, loga tudo no banco)
-        ├──► Ollama :11434 (TIER 1 — local, padrão)
+        ├──► LLMFit (TIER 1 — fine-tuned, soberano) [slot pronto, comentado]
-        └──► OpenAI/Anthropic/Groq (TIER 2 — opt-in, só se API key configurada)
+        ├──► Ollama :11434 (TIER 2 — local, padrão)
+        └──► OpenAI/Anthropic/Groq (TIER 3 — opt-in, só se API key configurada)
 ```
 
 **Variáveis chave do Manus:**
@@ -44,46 +45,9 @@ AI_INTEGRATIONS_OPENAI_API_KEY=${LITELLM_API_KEY}
 - `PLANO_EVOLUCAO_ARCADIA.md` — roadmap e evolução
 - `MAPA_SISTEMA_ARCADIA.md` — mapa do sistema
 
-## Git e Deploy
+## Branch de desenvolvimento
-
+Sempre commitar em: `claude/analyze-project-0mXjP`
-### Remote canônico
+Push: `git push -u origin claude/analyze-project-0mXjP`
-- **Remote principal:** `gitea` → `http://10.0.1.7:3000/arcadia-admin/arcadiasuite` (Gitea interno)
-- **Branch de produção:** `main`
-- **Push de deploy:** `git push gitea Servidor:main`
-
-> O Coolify monitora o Gitea (`https://git.onboardbi.com.br/arcadia-admin/arcadiasuite`, branch `main`).
-> Push para `gitea` → Coolify detecta → build automático → rolling deploy.
-> O remote `origin` (GitHub) é backup secundário — push opcional para manter sincronizado.
-> O desenvolvimento local ocorre na branch `Servidor` — fazer push para `main` no Gitea ao deployar.
-
-### Deploy em produção
-**Fluxo normal (CI/CD automático):**
-```bash
-cd /opt/arcadia_merged
-git push gitea Servidor:main
-```
-O Coolify faz o build e deploy automaticamente (~3-5 min).
-
-**Deploy manual (emergência):**
-```bash
-cd /opt/arcadia_merged
-docker compose -f docker-compose.prod.yml build app
-docker compose -f docker-compose.prod.yml up -d app
-```
-- Reconstrói só o container `app` (~3-5 min)
-- Banco, Redis, MiroFlow, Python services **não são afetados**
-- Downtime: ~30 segundos durante a troca do container
-
-### Serviços em execução (não mexer sem necessidade)
-```
-arcadia-prod-app-1        porta 5000  → suite.onboardbi.com.br (Traefik)
-arcadia-prod-db-1         PostgreSQL  (dados em volume Docker)
-arcadia-prod-redis-1      Redis
-arcadia-prod-miroflow-1   MiroFlow agente
-arcadia-prod-litellm-1    LiteLLM gateway
-arcadia-prod-superset-1   Superset BI
-arcadia-prod-{contabil,bi,automation,fisco,embeddings}-1  Python services
-```
 
 ## O que está implementado
 - ✅ Manus (agente autônomo, 30+ ferramentas)
@@ -95,11 +59,11 @@ arcadia-prod-{contabil,bi,automation,fisco,embeddings}-1  Python services
 - ✅ Docker dev + prod, LiteLLM gateway
 
 ## O que ainda falta
+- ❌ LLMFit: slot pronto em `litellm-config.yaml`, só habilitar quando disponível
 - ❌ Testes automatizados / CI-CD
 - ❌ Monitoramento (APM, Sentry, métricas)
 - ❌ Multi-tenancy completo
 - ❌ Rate limiting em todos os endpoints (parcial)
-- ❌ Fine-tuning de modelos locais (dados do Arcádia)
 
 ## Comandos úteis
 ```bash
@@ -121,6 +85,7 @@ npm run build
 ```
 SESSION_SECRET, SSO_SECRET          # gerar strings seguras em prod
 AI_INTEGRATIONS_OPENAI_BASE_URL     # aponta para LiteLLM
+LLMFIT_BASE_URL                     # LLMFit quando disponível
 OLLAMA_BASE_URL                     # Ollama host ou container
 OPENAI_API_KEY                      # opcional (soberania: deixar vazio)
 ```

Dockerfile

@@ -1,33 +1,33 @@
+# ─── Stage 1: Build ───────────────────────────────────────────────────────────
 FROM node:20-alpine AS builder
 
 WORKDIR /app
 
-COPY package.json package-lock.json* ./
+COPY package*.json ./
-RUN NODE_ENV=development npm install --legacy-peer-deps
+RUN npm ci --ignore-scripts
 
 COPY . .
 RUN npm run build
 
+# ─── Stage 2: Production ──────────────────────────────────────────────────────
 FROM node:20-alpine AS runner
 
-RUN apk add --no-cache p7zip
-
 WORKDIR /app
 
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/node_modules ./node_modules
-COPY --from=builder /app/package.json ./
-COPY --from=builder /app/migrations ./migrations
-COPY --from=builder /app/drizzle.config.ts ./drizzle.config.ts
-COPY --from=builder /app/shared ./shared
-COPY --from=builder /app/tsconfig.json ./tsconfig.json
-
 ENV NODE_ENV=production
-ENV PORT=5000
+
+# Deps de produção apenas
+COPY package*.json ./
+RUN npm ci --omit=dev --ignore-scripts
+
+# Artefatos do build
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/shared ./shared
+COPY --from=builder /app/migrations ./migrations
 
 EXPOSE 5000
 
 HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
-  CMD wget -qO- http://127.0.0.1:5000/ || exit 1
+  CMD wget -qO- http://localhost:5000/api/health || exit 1
 
 CMD ["node", "dist/index.cjs"]

Dockerfile.miroflow

@@ -1,24 +0,0 @@
-FROM python:3.11-slim
-
-WORKDIR /app
-
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    gcc \
-    && rm -rf /var/lib/apt/lists/*
-
-# Instalar MiroFlow e suas dependências direto do submodule
-COPY server/modules/miroflow/ ./server/modules/miroflow/
-RUN pip install --no-cache-dir -e ./server/modules/miroflow/
-
-# Copiar o service script
-COPY server/python/miroflow_service.py ./server/python/miroflow_service.py
-
-ENV MIROFLOW_PORT=8006
-ENV OLLAMA_BASE_URL=http://host.docker.internal:11434
-
-EXPOSE 8006
-
-HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
-  CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8006/health')" || exit 1
-
-CMD ["python", "server/python/miroflow_service.py"]

INTEGRACAO_IA.md

@@ -1,6 +1,6 @@
-# Integração de IA — Ollama no Servidor
+# Integração de IA — Ollama + LLMFit no Servidor
 
-Guia para conectar o Arcádia Suite à IA local em produção.
+Guia para conectar o Arcádia Suite às IAs locais em produção.
 
 ---
 
@@ -13,11 +13,11 @@ Arcádia Suite (Manus, Agents, Embeddings)
         ▼
    LiteLLM (porta 4000) — gateway único
         │
-        ├──► Ollama  (modelos open source locais) [TIER 1 — padrão]
+        ├──► LLMFit  (seus modelos fine-tuned)   [TIER 1 — prioridade]
-        └──► OpenAI/Anthropic/Groq (opt-in)       [TIER 2 — externo]
+        └──► Ollama  (modelos open source locais) [TIER 2 — padrão/fallback]
 ```
 
-Nenhum serviço do Arcádia chama Ollama diretamente.
+Nenhum serviço do Arcádia chama Ollama ou LLMFit diretamente.
 Tudo passa pelo LiteLLM — que roteia, loga e faz fallback automaticamente.
 
 ---
@@ -89,6 +89,66 @@ docker exec -it $(docker ps -qf "name=ollama") ollama pull deepseek-r1:7b
 
 ---
 
+## Configuração do LLMFit
+
+### 1. Pré-requisito
+
+O LLMFit deve expor uma API compatível com OpenAI (formato `/v1/chat/completions`).
+Verifique se está respondendo:
+```bash
+curl http://IP_DO_LLMFIT:PORTA/v1/models
+```
+
+### 2. Configurar variável no Coolify
+
+```
+LLMFIT_BASE_URL=http://IP_DO_LLMFIT:PORTA
+```
+
+### 3. Ativar no LiteLLM config
+
+Edite `docker/litellm-config.yaml` e **descomente** o bloco TIER 1:
+
+```yaml
+model_list:
+
+  # TIER 1 — LLMFit (fine-tuned, prioridade máxima)
+  - model_name: arcadia-finetuned
+    litellm_params:
+      model: openai/NOME_DO_SEU_MODELO   # substitua pelo nome real
+      api_base: os.environ/LLMFIT_BASE_URL
+      api_key: llmfit-internal
+
+  # Modelo de embeddings fine-tuned (se disponível)
+  - model_name: arcadia-embed
+    litellm_params:
+      model: openai/NOME_DO_MODELO_EMBED
+      api_base: os.environ/LLMFIT_BASE_URL
+      api_key: llmfit-internal
+```
+
+### 4. Definir LLMFit como modelo padrão do Arcádia
+
+No mesmo arquivo, atualize o `arcadia-default`:
+
+```yaml
+  - model_name: arcadia-default
+    litellm_params:
+      model: openai/NOME_DO_SEU_MODELO
+      api_base: os.environ/LLMFIT_BASE_URL
+      api_key: llmfit-internal
+    model_info:
+      fallbacks: ["llama3.3"]   # cai para Ollama se LLMFit falhar
+```
+
+### 5. Reiniciar o LiteLLM para aplicar
+
+```bash
+docker compose -f docker-compose.prod.yml restart litellm
+```
+
+---
+
 ## Variáveis de ambiente — resumo completo
 
 Configure todas no Coolify antes do deploy:
@@ -114,6 +174,9 @@ AI_INTEGRATIONS_OPENAI_API_KEY=${LITELLM_API_KEY}
 # Ollama em container: http://ollama:11434
 OLLAMA_BASE_URL=http://host-gateway:11434
 
+# ── LLMFit (deixar vazio até estar disponível) ────────────────────────────────
+LLMFIT_BASE_URL=
+
 # ── Providers externos (deixar vazio para soberania total) ───────────────────
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=
@@ -139,7 +202,7 @@ curl http://localhost:4000/v1/chat/completions \
 ### 2. Testar Manus via interface
 
 Acesse `https://seudominio.com.br` → abra o Manus → envie uma mensagem simples.
-O Manus deve responder via Ollama.
+O Manus deve responder via Ollama (ou LLMFit se configurado).
 
 ### 3. Ver logs em tempo real
 
@@ -190,6 +253,10 @@ docker exec $(docker ps -qf "name=ollama") ollama pull nomic-embed-text
 → O modelo referenciado em `litellm-config.yaml` não foi baixado no Ollama.
 → Execute `ollama pull NOME_DO_MODELO`
 
+**LLMFit não está sendo chamado**
+→ Confirme que `LLMFIT_BASE_URL` está definido e o serviço está respondendo.
+→ Reinicie o LiteLLM após alterar o config: `docker compose restart litellm`
+
 **Ollama no host não é alcançado de dentro do Docker**
 → Tente `OLLAMA_BASE_URL=http://172.17.0.1:11434` (IP padrão do docker0)
 → Ou use o IP real da interface de rede: `ip addr show` para descobrir

MAPA_SISTEMA_ARCADIA.md

@@ -46,27 +46,15 @@
 
 ## Mapa de Portas
 
-| Porta | Serviço | Tecnologia | Observação |
+| Porta | Serviço | Tecnologia |
-|-------|---------|-----------|------------|
+|-------|---------|-----------|
-| 5000 | API Principal + Frontend | Express.js + React | Exposta publicamente |
+| 5000 | API Principal + Frontend | Express.js + React |
-| 5001 | **Arcadia Kernel** | Node.js/Express | Dashboard interno (mesmo container) |
+| 8002 | Motor Fiscal (Fisco) | FastAPI (Python) |
-| 8002 | Motor Fiscal (Fisco) | FastAPI (Python) | Via Docker network |
+| 8003 | Motor Contábil | FastAPI (Python) |
-| 8003 | Motor Contábil | FastAPI (Python) | Via Docker network |
+| 8004 | Motor BI (Insights) | FastAPI (Python) |
-| 8004 | Motor BI (Insights) | FastAPI (Python) | Via Docker network |
+| 8005 | Motor Automação | FastAPI (Python) |
-| 8005 | Motor Automação | FastAPI (Python) | Via Docker network |
+| 8006 | Motor Comunicação | Node.js/Express |
-| 8006 | Motor Comunicação | Node.js/Express | Via Docker network |
+| 8080 | Arcádia Plus (Laravel) | PHP/Laravel |
-| 8080 | Arcádia Plus (Laravel) | PHP/Laravel | Via Docker network |
-
-### Sobre o Kernel (Porta 5001)
-
-O **Arcadia Kernel** é o sistema operacional nativo que roda **dentro do mesmo container** da aplicação principal (porta 5000). Ele não é acessível externamente, mas fornece:
-
-- **Service Registry**: Catálogo central de todos os serviços
-- **Discovery Automático**: Detecta serviços via Coolify API, Docker, DNS
-- **Health Monitoring**: Verifica saúde dos serviços periodicamente
-- **Casa de Máquinas**: Acessa o Registry via memória (não HTTP)
-
-A Casa de Máquinas (na porta 5000) consulta o Kernel via **acesso direto à memória** (`global.arcadiaKernelRegistry`), não via HTTP.
 
 ---
 

client/src/App.tsx

@@ -1,5 +1,5 @@
-import { Switch, Route, useLocation } from "wouter";
+import { Switch, Route } from "wouter";
-import { lazy, Suspense, useEffect, useState } from "react";
+import { lazy, Suspense } from "react";
 import { queryClient } from "./lib/queryClient";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { Toaster } from "@/components/ui/toaster";
@@ -9,8 +9,6 @@ import { SoeMotorProvider } from "@/contexts/SoeMotorContext";
 import { ProtectedRoute } from "@/lib/protected-route";
 import { CommandPalette } from "@/components/CommandPalette";
 import { KnowledgeCollectorInit } from "@/components/KnowledgeCollectorInit";
-import { OpenClawWidget } from "@/components/openclaw/OpenClawWidget";
-import { ErrorBoundary } from "@/components/ErrorBoundary";
 import NotFound from "@/pages/not-found";
 import AuthPage from "@/pages/auth-page";
 
@@ -69,60 +67,14 @@ const XosAutomations = lazy(() => import("@/pages/XosAutomations"));
 const XosSites = lazy(() => import("@/pages/XosSites"));
 const XosGovernance = lazy(() => import("@/pages/XosGovernance"));
 const XosPipeline = lazy(() => import("@/pages/XosPipeline"));
-const XosSupervisor = lazy(() => import("@/pages/XosSupervisor"));
+
-const XosReports = lazy(() => import("@/pages/XosReports"));
-const XosProtocols = lazy(() => import("@/pages/XosProtocols"));
 
 function LoadingFallback() {
-  const [showSlowLoading, setShowSlowLoading] = useState(false);
-  const [showError, setShowError] = useState(false);
-
-  useEffect(() => {
-    // Show "slow loading" message after 3 seconds
-    const slowTimer = setTimeout(() => setShowSlowLoading(true), 3000);
-    // Show error hint after 10 seconds
-    const errorTimer = setTimeout(() => setShowError(true), 10000);
-    
-    return () => {
-      clearTimeout(slowTimer);
-      clearTimeout(errorTimer);
-    };
-  }, []);
-
   return (
-    <div style={{ display: "flex", justifyContent: "center", alignItems: "center", height: "100vh", flexDirection: "column" }}>
+    <div style={{ display: "flex", justifyContent: "center", alignItems: "center", height: "100vh" }}>
       <div style={{ textAlign: "center" }}>
         <div style={{ width: 40, height: 40, border: "3px solid #e5e7eb", borderTopColor: "#3b82f6", borderRadius: "50%", animation: "spin 1s linear infinite", margin: "0 auto" }} />
         <p style={{ marginTop: 16, color: "#6b7280" }}>Carregando...</p>
-        
-        {showSlowLoading && (
-          <p style={{ marginTop: 8, color: "#9ca3af", fontSize: 14 }}>
-            Isso está demorando mais que o esperado...
-          </p>
-        )}
-        
-        {showError && (
-          <div style={{ marginTop: 16, padding: 12, backgroundColor: "#fef3c7", borderRadius: 6, maxWidth: 300 }}>
-            <p style={{ color: "#92400e", fontSize: 13, margin: 0 }}>
-              A página pode ter um erro. Tente recarregar ou volte para a página anterior.
-            </p>
-            <button 
-              onClick={() => window.location.reload()}
-              style={{ 
-                marginTop: 8, 
-                padding: "6px 12px", 
-                backgroundColor: "#f59e0b", 
-                color: "white", 
-                border: "none", 
-                borderRadius: 4,
-                cursor: "pointer",
-                fontSize: 13
-              }}
-            >
-              Recarregar Página
-            </button>
-          </div>
-        )}
       </div>
       <style>{`@keyframes spin { to { transform: rotate(360deg) } }`}</style>
     </div>
@@ -131,74 +83,69 @@ function LoadingFallback() {
 
 function Router() {
   return (
-    <ErrorBoundary>
+    <Suspense fallback={<LoadingFallback />}>
-      <Suspense fallback={<LoadingFallback />}>
+    <Switch>
-        <Switch>
+      <ProtectedRoute path="/" component={Cockpit} />
-          <ProtectedRoute path="/" component={Cockpit} />
+      <ProtectedRoute path="/agent" component={Agent} />
-          <ProtectedRoute path="/agent" component={Agent} />
+      <ProtectedRoute path="/admin" component={Admin} />
-          <ProtectedRoute path="/admin" component={Admin} />
+      <ProtectedRoute path="/chat" component={Chat} />
-          <ProtectedRoute path="/chat" component={Chat} />
+      <ProtectedRoute path="/whatsapp" component={WhatsApp} />
-          <ProtectedRoute path="/whatsapp" component={WhatsApp} />
+      <ProtectedRoute path="/comunicacao" component={XosInbox} />
-          <ProtectedRoute path="/comunicacao" component={XosInbox} />
+      <ProtectedRoute path="/automations" component={Automations} />
-          <ProtectedRoute path="/automations" component={Automations} />
+      <ProtectedRoute path="/insights" component={BiWorkspace} />
-          <ProtectedRoute path="/insights" component={BiWorkspace} />
+      <ProtectedRoute path="/compass" component={ProcessCompass} />
-          <ProtectedRoute path="/compass" component={ProcessCompass} />
+      <ProtectedRoute path="/crm" component={Crm} />
-          <ProtectedRoute path="/crm" component={Crm} />
+      <ProtectedRoute path="/production" component={Production} />
-          <ProtectedRoute path="/production" component={Production} />
+      <ProtectedRoute path="/support" component={Support} />
-          <ProtectedRoute path="/support" component={Support} />
+      <ProtectedRoute path="/valuation" component={Valuation} />
-          <ProtectedRoute path="/valuation" component={Valuation} />
+      <ProtectedRoute path="/canvas" component={Canvas} />
-          <ProtectedRoute path="/canvas" component={Canvas} />
+      <ProtectedRoute path="/ide" component={IDE} />
-          <ProtectedRoute path="/ide" component={IDE} />
+      <ProtectedRoute path="/scientist" component={Scientist} />
-          <ProtectedRoute path="/scientist" component={Scientist} />
+      <ProtectedRoute path="/knowledge" component={Knowledge} />
-          <ProtectedRoute path="/knowledge" component={Knowledge} />
+      <ProtectedRoute path="/central-apis" component={CentralApis} />
-          <ProtectedRoute path="/central-apis" component={CentralApis} />
+      <ProtectedRoute path="/api-tester" component={ApiTesterPage} />
-          <ProtectedRoute path="/api-tester" component={ApiTesterPage} />
+      <ProtectedRoute path="/api-hub" component={ApiHub} />
-          <ProtectedRoute path="/api-hub" component={ApiHub} />
+      <ProtectedRoute path="/fisco" component={Fisco} />
-          <ProtectedRoute path="/fisco" component={Fisco} />
+      <ProtectedRoute path="/people" component={People} />
-          <ProtectedRoute path="/people" component={People} />
+      <ProtectedRoute path="/contabil" component={Contabil} />
-          <ProtectedRoute path="/contabil" component={Contabil} />
+      <ProtectedRoute path="/soe" component={SOE} />
-          <ProtectedRoute path="/soe" component={SOE} />
+      <ProtectedRoute path="/erp" component={SOE} />
-          <ProtectedRoute path="/erp" component={SOE} />
+      <ProtectedRoute path="/financeiro" component={Financeiro} />
-          <ProtectedRoute path="/financeiro" component={Financeiro} />
+      <ProtectedRoute path="/communities" component={Communities} />
-          <ProtectedRoute path="/communities" component={Communities} />
+      <ProtectedRoute path="/quality" component={QualityModule} />
-          <ProtectedRoute path="/quality" component={QualityModule} />
+      <ProtectedRoute path="/commercial-env" component={CommercialEnv} />
-          <ProtectedRoute path="/commercial-env" component={CommercialEnv} />
+      <ProtectedRoute path="/field-ops" component={FieldOperations} />
-          <ProtectedRoute path="/field-ops" component={FieldOperations} />
+      <ProtectedRoute path="/technical" component={TechnicalModule} />
-          <ProtectedRoute path="/technical" component={TechnicalModule} />
+      <ProtectedRoute path="/suppliers" component={SuppliersPortal} />
-          <ProtectedRoute path="/suppliers" component={SuppliersPortal} />
+      <ProtectedRoute path="/nps" component={NPSSurvey} />
-          <ProtectedRoute path="/nps" component={NPSSurvey} />
+      <ProtectedRoute path="/engineering" component={EngineeringHub} />
-          <ProtectedRoute path="/engineering" component={EngineeringHub} />
+      <ProtectedRoute path="/development" component={DevelopmentModule} />
-          <ProtectedRoute path="/development" component={DevelopmentModule} />
+      <ProtectedRoute path="/retail" component={ArcadiaRetail} />
-          <ProtectedRoute path="/retail" component={ArcadiaRetail} />
+      <ProtectedRoute path="/plus" component={Plus} />
-          <ProtectedRoute path="/plus" component={() => { const [, nav] = useLocation(); useEffect(() => nav("/soe"), []); return null; }} />
+      <ProtectedRoute path="/super-admin" component={SuperAdmin} />
-          <ProtectedRoute path="/super-admin" component={SuperAdmin} />
+      <ProtectedRoute path="/marketplace" component={Marketplace} />
-          <ProtectedRoute path="/marketplace" component={Marketplace} />
+      <ProtectedRoute path="/lms" component={LMS} />
-          <ProtectedRoute path="/lms" component={LMS} />
+      <ProtectedRoute path="/apps" component={AppCenter} />
-          <ProtectedRoute path="/apps" component={AppCenter} />
+      <ProtectedRoute path="/xos" component={XosCentral} />
-          <ProtectedRoute path="/xos" component={XosCentral} />
+      <ProtectedRoute path="/xos/crm" component={XosCrm} />
-          <ProtectedRoute path="/xos/crm" component={XosCrm} />
+      <ProtectedRoute path="/xos/inbox" component={XosInbox} />
-          <ProtectedRoute path="/xos/inbox" component={XosInbox} />
+      <ProtectedRoute path="/xos/tickets" component={XosTickets} />
-          <ProtectedRoute path="/xos/tickets" component={XosTickets} />
+      <ProtectedRoute path="/xos/campaigns" component={XosCampaigns} />
-          <ProtectedRoute path="/xos/campaigns" component={XosCampaigns} />
+      <ProtectedRoute path="/xos/automations" component={XosAutomations} />
-          <ProtectedRoute path="/xos/automations" component={XosAutomations} />
+      <ProtectedRoute path="/xos/sites" component={XosSites} />
-          <ProtectedRoute path="/xos/sites" component={XosSites} />
+      <ProtectedRoute path="/xos/governance" component={XosGovernance} />
-          <ProtectedRoute path="/xos/governance" component={XosGovernance} />
+      <ProtectedRoute path="/xos/pipeline" component={XosPipeline} />
-          <ProtectedRoute path="/xos/pipeline" component={XosPipeline} />
-          <ProtectedRoute path="/xos/supervisor" component={XosSupervisor} />
-          <ProtectedRoute path="/xos/reports" component={XosReports} />
-          <ProtectedRoute path="/xos/protocols" component={XosProtocols} />
 
-          <ProtectedRoute path="/doctype-builder" component={DocTypeBuilder} />
+      <ProtectedRoute path="/doctype-builder" component={DocTypeBuilder} />
-          <ProtectedRoute path="/page-builder" component={PageBuilder} />
+      <ProtectedRoute path="/page-builder" component={PageBuilder} />
-          <ProtectedRoute path="/migration" component={Migration} />
+      <ProtectedRoute path="/migration" component={Migration} />
-          <ProtectedRoute path="/dev-center" component={DevCenter} />
+      <ProtectedRoute path="/dev-center" component={DevCenter} />
-          <ProtectedRoute path="/page/:id" component={WorkspacePage} />
+      <ProtectedRoute path="/page/:id" component={WorkspacePage} />
-          <ProtectedRoute path="/app/:id" component={AppViewer} />
+      <ProtectedRoute path="/app/:id" component={AppViewer} />
-          <Route path="/auth" component={AuthPage} />
+      <Route path="/auth" component={AuthPage} />
-          <Route component={NotFound} />
+      <Route component={NotFound} />
-        </Switch>
+    </Switch>
-      </Suspense>
+    </Suspense>
-    </ErrorBoundary>
   );
 }
 
@@ -211,7 +158,6 @@ function App() {
             <KnowledgeCollectorInit />
             <Toaster />
             <CommandPalette />
-            <OpenClawWidget />
             <Router />
           </TooltipProvider>
         </SoeMotorProvider>

client/src/components/Browser/BrowserFrame.tsx

@@ -91,7 +91,7 @@ function CompactNavigationBar() {
           </div>
           <span className="hidden md:inline">Insights</span>
         </div>
-        <div
+        <div 
           className="flex items-center gap-1 hover:bg-muted px-2 py-1.5 rounded cursor-pointer transition-colors flex-shrink-0"
           onClick={() => navigateTo("/compass", "Compass")}
           data-testid="bookmark-compass"

client/src/components/ChartRenderer.tsx

@@ -1,146 +0,0 @@
-import { lazy, Suspense } from "react";
-
-interface ChartData {
-  type: "bar" | "line" | "pie" | "area";
-  title: string;
-  data: Record<string, any>[];
-  xKey: string;
-  yKeys: string[];
-  colors: string[];
-}
-
-// Lazy load do recharts para não pesar o bundle inicial
-const RechartsComponents = lazy(() =>
-  import("recharts").then((module) => ({
-    default: function RechartsWrapper({ chart }: { chart: ChartData }) {
-      const {
-        BarChart,
-        Bar,
-        LineChart,
-        Line,
-        PieChart,
-        Pie,
-        AreaChart,
-        Area,
-        XAxis,
-        YAxis,
-        CartesianGrid,
-        Tooltip,
-        Legend,
-        ResponsiveContainer,
-        Cell,
-      } = module;
-
-      const renderChart = () => {
-        switch (chart.type) {
-          case "bar":
-            return (
-              <BarChart data={chart.data}>
-                <CartesianGrid strokeDasharray="3 3" />
-                <XAxis dataKey={chart.xKey} />
-                <YAxis />
-                <Tooltip />
-                <Legend />
-                {chart.yKeys.map((key, index) => (
-                  <Bar
-                    key={key}
-                    dataKey={key}
-                    fill={chart.colors[index % chart.colors.length]}
-                  />
-                ))}
-              </BarChart>
-            );
-          case "line":
-            return (
-              <LineChart data={chart.data}>
-                <CartesianGrid strokeDasharray="3 3" />
-                <XAxis dataKey={chart.xKey} />
-                <YAxis />
-                <Tooltip />
-                <Legend />
-                {chart.yKeys.map((key, index) => (
-                  <Line
-                    key={key}
-                    type="monotone"
-                    dataKey={key}
-                    stroke={chart.colors[index % chart.colors.length]}
-                  />
-                ))}
-              </LineChart>
-            );
-          case "area":
-            return (
-              <AreaChart data={chart.data}>
-                <CartesianGrid strokeDasharray="3 3" />
-                <XAxis dataKey={chart.xKey} />
-                <YAxis />
-                <Tooltip />
-                <Legend />
-                {chart.yKeys.map((key, index) => (
-                  <Area
-                    key={key}
-                    type="monotone"
-                    dataKey={key}
-                    stroke={chart.colors[index % chart.colors.length]}
-                    fill={chart.colors[index % chart.colors.length]}
-                    fillOpacity={0.6}
-                  />
-                ))}
-              </AreaChart>
-            );
-          case "pie":
-            return (
-              <PieChart>
-                <Tooltip />
-                <Legend />
-                <Pie
-                  data={chart.data}
-                  dataKey={chart.yKeys[0]}
-                  nameKey={chart.xKey}
-                  cx="50%"
-                  cy="50%"
-                  outerRadius={80}
-                  label
-                >
-                  {chart.data.map((_, index) => (
-                    <Cell
-                      key={`cell-${index}`}
-                      fill={chart.colors[index % chart.colors.length]}
-                    />
-                  ))}
-                </Pie>
-              </PieChart>
-            );
-          default:
-            return null;
-        }
-      };
-
-      return (
-        <div className="w-full h-64">
-          <ResponsiveContainer width="100%" height="100%">
-            {renderChart()}
-          </ResponsiveContainer>
-        </div>
-      );
-    },
-  }))
-);
-
-interface ChartRendererProps {
-  chart: ChartData;
-}
-
-export function ChartRenderer({ chart }: ChartRendererProps) {
-  return (
-    <Suspense
-      fallback={
-        <div className="w-full h-64 flex items-center justify-center bg-muted/20 rounded">
-          <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-primary" />
-        </div>
-      }
-    >
-      <RechartsComponents chart={chart} />
-    </Suspense>
-  );
-}

client/src/components/ErrorBoundary.tsx

@@ -1,90 +0,0 @@
-import { Component, ReactNode } from "react";
-import { AlertCircle, RefreshCw } from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
-
-interface Props {
-  children: ReactNode;
-  fallback?: ReactNode;
-}
-
-interface State {
-  hasError: boolean;
-  error?: Error;
-}
-
-export class ErrorBoundary extends Component<Props, State> {
-  constructor(props: Props) {
-    super(props);
-    this.state = { hasError: false };
-  }
-
-  static getDerivedStateFromError(error: Error): State {
-    return { hasError: true, error };
-  }
-
-  componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
-    console.error("[ErrorBoundary] Erro capturado:", error);
-    console.error("[ErrorBoundary] Info:", errorInfo);
-  }
-
-  handleRetry = () => {
-    this.setState({ hasError: false, error: undefined });
-    window.location.reload();
-  };
-
-  handleGoHome = () => {
-    this.setState({ hasError: false, error: undefined });
-    window.location.href = "/";
-  };
-
-  render() {
-    if (this.state.hasError) {
-      // Fallback customizado ou padrão
-      if (this.props.fallback) {
-        return this.props.fallback;
-      }
-
-      return (
-        <div className="min-h-screen flex items-center justify-center bg-slate-50 p-4">
-          <Card className="max-w-lg w-full">
-            <CardHeader className="text-center">
-              <div className="mx-auto w-16 h-16 bg-red-100 rounded-full flex items-center justify-center mb-4">
-                <AlertCircle className="w-8 h-8 text-red-600" />
-              </div>
-              <CardTitle className="text-xl">Ops! Algo deu errado</CardTitle>
-              <CardDescription>
-                Não foi possível carregar esta página. O módulo pode estar incompleto ou com erro.
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="space-y-4">
-              {this.state.error && (
-                <div className="bg-slate-100 p-3 rounded text-sm font-mono text-slate-600 overflow-auto max-h-32">
-                  {this.state.error.message}
-                </div>
-              )}
-              
-              <div className="flex gap-3 justify-center">
-                <Button 
-                  variant="outline" 
-                  onClick={this.handleGoHome}
-                >
-                  Voltar ao Início
-                </Button>
-                <Button 
-                  onClick={this.handleRetry}
-                  className="gap-2"
-                >
-                  <RefreshCw className="w-4 h-4" />
-                  Tentar Novamente
-                </Button>
-              </div>
-            </CardContent>
-          </Card>
-        </div>
-      );
-    }
-
-    return this.props.children;
-  }
-}

client/src/components/MiroFlowControl.tsx

@@ -1,277 +0,0 @@
-import { useState } from "react";
-import { useMutation } from "@tanstack/react-query";
-import { apiRequest } from "@/lib/queryClient";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
-import { Textarea } from "@/components/ui/textarea";
-import { Badge } from "@/components/ui/badge";
-import { ScrollArea } from "@/components/ui/scroll-area";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@/components/ui/select";
-import { Brain, Loader2 } from "lucide-react";
-
-interface AnalyzeRequest {
-  agent: "statistician" | "fiscal_auditor" | "researcher";
-  task: string;
-  context?: Record<string, unknown>;
-}
-
-interface AnalyzeResponse {
-  agent: string;
-  model: string;
-  result: string;
-  execution_id: string;
-  duration_ms: number;
-}
-
-const AGENTS = [
-  {
-    value: "statistician",
-    label: "Statistician",
-    model: "llama3.1:8b",
-    placeholder:
-      "Ex: Analise a distribuição de vendas por região no último trimestre",
-  },
-  {
-    value: "fiscal_auditor",
-    label: "Fiscal Auditor",
-    model: "llama3.1:8b",
-    placeholder:
-      "Ex: Verifique inconsistências nos registros NFe do CNPJ 12.345.678/0001-90",
-  },
-  {
-    value: "researcher",
-    label: "Researcher",
-    model: "llama3.1:8b",
-    placeholder:
-      "Ex: Quais fornecedores têm maior correlação com atrasos de entrega?",
-  },
-] as const;
-
-interface MiroFlowControlProps {
-  currentDashboardData?: Record<string, unknown>;
-}
-
-export function MiroFlowControl({
-  currentDashboardData,
-}: MiroFlowControlProps) {
-  const [enabled, setEnabled] = useState(false);
-  const [selectedAgent, setSelectedAgent] = useState<
-    "statistician" | "fiscal_auditor" | "researcher"
-  >("statistician");
-  const [task, setTask] = useState("");
-
-  const mutation = useMutation({
-    mutationFn: async (request: AnalyzeRequest) => {
-      const response = await apiRequest("POST", "/api/miroflow/analyze", request);
-      return response.json() as Promise<AnalyzeResponse>;
-    },
-  });
-
-  const createDashboardMutation = useMutation({
-    mutationFn: async (dashboardData: {
-      dashboardTitle: string;
-      sqlQuery: string;
-    }) => {
-      const response = await apiRequest(
-        "POST",
-        "/api/superset/miroflow/create-dashboard",
-        {
-          ...dashboardData,
-          analysisId: mutation.data?.execution_id,
-          agent: selectedAgent,
-          task,
-          insights: mutation.data?.result,
-        }
-      );
-      return response.json();
-    },
-  });
-
-  const handleAnalyze = () => {
-    if (!task.trim()) {
-      return;
-    }
-
-    mutation.mutate({
-      agent: selectedAgent,
-      task,
-      context: currentDashboardData,
-    });
-  };
-
-  const currentAgentConfig = AGENTS.find((a) => a.value === selectedAgent);
-
-  return (
-    <div className="space-y-6">
-      <Card className="bg-[#1f334d] border border-[#c89b3c]/20">
-        <CardHeader className="border-b border-[#c89b3c]/20 pb-4">
-          <div className="flex items-center justify-between">
-            <div className="flex items-center gap-3">
-              <Brain className="w-6 h-6 text-[#c89b3c]" />
-              <CardTitle className="text-white">Modo Científico</CardTitle>
-            </div>
-            <button
-              onClick={() => setEnabled(!enabled)}
-              className={`relative inline-flex h-8 w-14 items-center rounded-full transition-colors ${
-                enabled ? "bg-[#c89b3c]" : "bg-gray-600"
-              }`}
-            >
-              <span
-                className={`inline-block h-6 w-6 transform rounded-full bg-white transition-transform ${
-                  enabled ? "translate-x-7" : "translate-x-1"
-                }`}
-              />
-            </button>
-          </div>
-        </CardHeader>
-
-        {enabled && (
-          <CardContent className="space-y-4 pt-6">
-            {/* Agent Selection */}
-            <div>
-              <label className="block text-sm font-medium text-white mb-2">
-                Selecione o Agente
-              </label>
-              <Select value={selectedAgent} onValueChange={(value: any) => setSelectedAgent(value)}>
-                <SelectTrigger className="bg-[#2a4466] border border-[#c89b3c]/20 text-white">
-                  <SelectValue />
-                </SelectTrigger>
-                <SelectContent className="bg-[#2a4466] border border-[#c89b3c]/20">
-                  {AGENTS.map((agent) => (
-                    <SelectItem key={agent.value} value={agent.value} className="text-white">
-                      <div>
-                        <div>{agent.label}</div>
-                        <div className="text-xs text-gray-400">{agent.model}</div>
-                      </div>
-                    </SelectItem>
-                  ))}
-                </SelectContent>
-              </Select>
-            </div>
-
-            {/* Task Input */}
-            <div>
-              <label className="block text-sm font-medium text-white mb-2">
-                Digite a Tarefa
-              </label>
-              <Textarea
-                placeholder={currentAgentConfig?.placeholder || "Digite sua tarefa..."}
-                value={task}
-                onChange={(e) => setTask(e.target.value)}
-                disabled={mutation.isPending}
-                className="bg-[#2a4466] border border-[#c89b3c]/20 text-white placeholder:text-gray-500 min-h-24"
-              />
-            </div>
-
-            {/* Analyze Button */}
-            <Button
-              onClick={handleAnalyze}
-              disabled={!task.trim() || mutation.isPending}
-              className="w-full bg-[#c89b3c] hover:bg-[#d4a94a] text-[#1f334d] font-semibold"
-            >
-              {mutation.isPending ? (
-                <>
-                  <Loader2 className="w-4 h-4 mr-2 animate-spin" />
-                  Analisando...
-                </>
-              ) : (
-                "Analisar"
-              )}
-            </Button>
-
-            {/* Error Display */}
-            {mutation.isError && (
-              <div className="rounded-lg p-4 bg-red-900/20 border border-red-500/50">
-                <Badge className="mb-2 bg-red-600 text-white">Erro</Badge>
-                <p className="text-sm text-red-100">
-                  {mutation.error instanceof Error
-                    ? mutation.error.message
-                    : "Erro ao processar a análise"}
-                </p>
-              </div>
-            )}
-
-            {/* Result Display */}
-            {mutation.isSuccess && (
-              <div className="space-y-3">
-                <div className="flex items-center gap-2 mb-2">
-                  <Badge className="bg-green-600 text-white">Sucesso</Badge>
-                </div>
-
-                <div className="rounded-lg p-4 bg-[#2a4466] border border-[#c89b3c]/20">
-                  <ScrollArea className="h-64 w-full pr-4">
-                    <p className="text-white text-sm whitespace-pre-wrap">
-                      {mutation.data?.result}
-                    </p>
-                  </ScrollArea>
-                </div>
-
-                {/* Metadata */}
-                <div className="grid grid-cols-3 gap-2 text-xs text-gray-400">
-                  <div>
-                    <span className="font-semibold text-[#c89b3c]">Modelo:</span>{" "}
-                    {mutation.data?.model}
-                  </div>
-                  <div>
-                    <span className="font-semibold text-[#c89b3c]">Tempo:</span>{" "}
-                    {mutation.data?.duration_ms}ms
-                  </div>
-                  <div>
-                    <span className="font-semibold text-[#c89b3c]">ID:</span>{" "}
-                    {mutation.data?.execution_id?.slice(0, 8)}...
-                  </div>
-                </div>
-
-                {/* Create Dashboard Button */}
-                <div className="pt-4 border-t border-[#c89b3c]/20">
-                  <Button
-                    onClick={() => {
-                      const title = `Análise ${selectedAgent} - ${new Date().toLocaleDateString('pt-BR')}`;
-                      createDashboardMutation.mutate({
-                        dashboardTitle: title,
-                        sqlQuery: `SELECT * FROM arcadia LIMIT 100`, // Placeholder - idealmente vem do MiroFlow
-                      });
-                    }}
-                    disabled={createDashboardMutation.isPending}
-                    className="w-full bg-[#8b7355] hover:bg-[#9d8568] text-white font-semibold"
-                  >
-                    {createDashboardMutation.isPending ? (
-                      <>
-                        <Loader2 className="w-4 h-4 mr-2 animate-spin" />
-                        Criando Dashboard...
-                      </>
-                    ) : (
-                      "📊 Criar Dashboard no Superset"
-                    )}
-                  </Button>
-
-                  {createDashboardMutation.isSuccess && (
-                    <div className="mt-2 rounded-lg p-3 bg-green-900/20 border border-green-500/50">
-                      <p className="text-xs text-green-100">
-                        ✅ Dashboard criado! Atualizando...
-                      </p>
-                    </div>
-                  )}
-
-                  {createDashboardMutation.isError && (
-                    <div className="mt-2 rounded-lg p-3 bg-red-900/20 border border-red-500/50">
-                      <p className="text-xs text-red-100">
-                        ❌ Erro: {createDashboardMutation.error instanceof Error ? createDashboardMutation.error.message : "Erro ao criar dashboard"}
-                      </p>
-                    </div>
-                  )}
-                </div>
-              </div>
-            )}
-          </CardContent>
-        )}
-      </Card>
-    </div>
-  );
-}

client/src/components/OpenClawPanel.tsx

@@ -1,245 +0,0 @@
-/**
- * OpenClawPanel — Phase 4
- *
- * Painel de visualização de Skills Emergentes detectadas pelo PatternDetector.
- * Exibido como aba na sidebar do /development.
- */
-
-import { useState } from "react";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import {
-  Sparkles, CheckCircle, XCircle, ChevronDown, ChevronRight,
-  Loader2, Activity, Clock, BarChart2
-} from "lucide-react";
-import { Badge } from "@/components/ui/badge";
-import { Button } from "@/components/ui/button";
-import { ScrollArea } from "@/components/ui/scroll-area";
-import { useToast } from "@/hooks/use-toast";
-
-interface Suggestion {
-  id: string;
-  suggestedSkillName: string;
-  suggestedDescription: string | null;
-  estimatedAutomation: string | null;
-  confidence: string;
-  draftBody: string | null;
-  createdAt: string;
-}
-
-interface Pattern {
-  id: string;
-  actionType: string;
-  description: string | null;
-  frequency: number;
-  confidence: string;
-  firstSeenAt: string;
-  lastSeenAt: string;
-  status: string;
-}
-
-export default function OpenClawPanel() {
-  const [tab, setTab] = useState<"suggestions" | "patterns">("suggestions");
-  const [expanded, setExpanded] = useState<string | null>(null);
-  const { toast } = useToast();
-  const qc = useQueryClient();
-
-  const { data: sugData, isLoading: sugLoading } = useQuery<{ suggestions: Suggestion[]; total: number }>({
-    queryKey: ["/api/openclaw/suggestions"],
-    refetchInterval: 2 * 60 * 1000,
-  });
-
-  const { data: patData, isLoading: patLoading } = useQuery<{ patterns: Pattern[]; total: number }>({
-    queryKey: ["/api/openclaw/patterns"],
-    enabled: tab === "patterns",
-  });
-
-  const accept = useMutation({
-    mutationFn: async (id: string) => {
-      const res = await fetch(`/api/openclaw/suggestions/${id}/accept`, { method: "POST" });
-      if (!res.ok) throw new Error();
-      return res.json();
-    },
-    onSuccess: () => {
-      qc.invalidateQueries({ queryKey: ["/api/openclaw/suggestions"] });
-      qc.invalidateQueries({ queryKey: ["/api/skills"] });
-      toast({ title: "Skill publicada!" });
-    },
-    onError: () => toast({ title: "Erro ao aceitar", variant: "destructive" }),
-  });
-
-  const reject = useMutation({
-    mutationFn: async (id: string) => {
-      const res = await fetch(`/api/openclaw/suggestions/${id}/reject`, { method: "POST" });
-      if (!res.ok) throw new Error();
-      return res.json();
-    },
-    onSuccess: () => {
-      qc.invalidateQueries({ queryKey: ["/api/openclaw/suggestions"] });
-      toast({ title: "Sugestão rejeitada" });
-    },
-    onError: () => toast({ title: "Erro ao rejeitar", variant: "destructive" }),
-  });
-
-  const suggestions = sugData?.suggestions ?? [];
-  const patterns = patData?.patterns ?? [];
-
-  return (
-    <div className="h-full flex flex-col bg-gray-900 text-white">
-      {/* Header */}
-      <div className="px-5 py-4 border-b border-white/10 flex items-center gap-2">
-        <Sparkles className="w-4 h-4 text-yellow-400" />
-        <div>
-          <h2 className="text-sm font-semibold">Skills Emergentes</h2>
-          <p className="text-[11px] text-white/40">OpenClaw — detecção automática de padrões</p>
-        </div>
-      </div>
-
-      {/* Tabs */}
-      <div className="flex border-b border-white/10 text-xs">
-        <button
-          onClick={() => setTab("suggestions")}
-          className={`px-4 py-2.5 flex items-center gap-1.5 transition-colors border-b-2 ${tab === "suggestions" ? "border-yellow-400 text-yellow-400" : "border-transparent text-white/50 hover:text-white"}`}
-        >
-          <Sparkles className="w-3 h-3" />
-          Sugestões
-          {suggestions.length > 0 && (
-            <span className="ml-1 rounded-full bg-yellow-400 text-black text-[9px] font-bold w-4 h-4 flex items-center justify-center">
-              {suggestions.length}
-            </span>
-          )}
-        </button>
-        <button
-          onClick={() => setTab("patterns")}
-          className={`px-4 py-2.5 flex items-center gap-1.5 transition-colors border-b-2 ${tab === "patterns" ? "border-yellow-400 text-yellow-400" : "border-transparent text-white/50 hover:text-white"}`}
-        >
-          <Activity className="w-3 h-3" />
-          Padrões
-        </button>
-      </div>
-
-      <ScrollArea className="flex-1">
-        {/* Sugestões */}
-        {tab === "suggestions" && (
-          <div>
-            {sugLoading && (
-              <div className="flex justify-center py-10">
-                <Loader2 className="w-5 h-5 animate-spin text-white/30" />
-              </div>
-            )}
-            {!sugLoading && suggestions.length === 0 && (
-              <div className="px-5 py-12 text-center">
-                <Sparkles className="w-8 h-8 text-white/10 mx-auto mb-3" />
-                <p className="text-sm text-white/30">Nenhuma sugestão pendente</p>
-                <p className="text-xs text-white/20 mt-1">O detector roda a cada hora</p>
-              </div>
-            )}
-            <div className="divide-y divide-white/5">
-              {suggestions.map((s) => {
-                const conf = Math.round(Number(s.confidence) * 100);
-                const isExp = expanded === s.id;
-                const isAccepting = accept.isPending && accept.variables === s.id;
-                const isRejecting = reject.isPending && reject.variables === s.id;
-
-                return (
-                  <div key={s.id} className="px-4 py-4 space-y-2.5">
-                    <div className="flex items-start gap-2">
-                      <div className="flex-1 min-w-0">
-                        <p className="text-sm font-medium text-white truncate">{s.suggestedSkillName}</p>
-                        {s.suggestedDescription && (
-                          <p className="text-xs text-white/50 mt-0.5 line-clamp-2">{s.suggestedDescription}</p>
-                        )}
-                      </div>
-                      <Badge className="shrink-0 bg-yellow-400/10 text-yellow-400 border-yellow-400/20 text-[10px]">
-                        {conf}%
-                      </Badge>
-                    </div>
-
-                    {s.draftBody && (
-                      <div>
-                        <button
-                          onClick={() => setExpanded(isExp ? null : s.id)}
-                          className="flex items-center gap-1 text-[11px] text-white/40 hover:text-white/60 transition-colors"
-                        >
-                          {isExp ? <ChevronDown className="w-3 h-3" /> : <ChevronRight className="w-3 h-3" />}
-                          {isExp ? "Ocultar body" : "Ver body gerado"}
-                        </button>
-                        {isExp && (
-                          <pre className="mt-2 rounded bg-black/40 p-3 text-[11px] text-white/60 overflow-x-auto whitespace-pre-wrap font-mono max-h-40 border border-white/5">
-                            {s.draftBody}
-                          </pre>
-                        )}
-                      </div>
-                    )}
-
-                    <div className="flex gap-2">
-                      <Button
-                        size="sm"
-                        className="h-7 text-xs bg-emerald-900/40 text-emerald-400 border border-emerald-700/40 hover:bg-emerald-900/60"
-                        onClick={() => accept.mutate(s.id)}
-                        disabled={isAccepting || isRejecting}
-                      >
-                        {isAccepting ? <Loader2 className="w-3 h-3 animate-spin" /> : <CheckCircle className="w-3 h-3" />}
-                        <span className="ml-1">Aceitar</span>
-                      </Button>
-                      <Button
-                        size="sm"
-                        variant="ghost"
-                        className="h-7 text-xs text-red-400 hover:text-red-300 hover:bg-red-900/20"
-                        onClick={() => reject.mutate(s.id)}
-                        disabled={isAccepting || isRejecting}
-                      >
-                        {isRejecting ? <Loader2 className="w-3 h-3 animate-spin" /> : <XCircle className="w-3 h-3" />}
-                        <span className="ml-1">Rejeitar</span>
-                      </Button>
-                    </div>
-                  </div>
-                );
-              })}
-            </div>
-          </div>
-        )}
-
-        {/* Padrões */}
-        {tab === "patterns" && (
-          <div>
-            {patLoading && (
-              <div className="flex justify-center py-10">
-                <Loader2 className="w-5 h-5 animate-spin text-white/30" />
-              </div>
-            )}
-            {!patLoading && patterns.length === 0 && (
-              <div className="px-5 py-12 text-center">
-                <BarChart2 className="w-8 h-8 text-white/10 mx-auto mb-3" />
-                <p className="text-sm text-white/30">Nenhum padrão detectado</p>
-                <p className="text-xs text-white/20 mt-1">Execute skills manualmente para gerar dados</p>
-              </div>
-            )}
-            <div className="divide-y divide-white/5">
-              {patterns.map((p) => {
-                const conf = Math.round(Number(p.confidence) * 100);
-                const last = new Date(p.lastSeenAt).toLocaleDateString("pt-BR");
-                return (
-                  <div key={p.id} className="px-4 py-3 space-y-1">
-                    <div className="flex items-center justify-between gap-2">
-                      <p className="text-xs font-mono text-white/70 truncate">{p.actionType}</p>
-                      <Badge className="shrink-0 bg-white/5 text-white/50 border-white/10 text-[10px]">
-                        {conf}%
-                      </Badge>
-                    </div>
-                    {p.description && (
-                      <p className="text-[11px] text-white/40">{p.description}</p>
-                    )}
-                    <div className="flex items-center gap-3 text-[10px] text-white/30">
-                      <span className="flex items-center gap-1"><Activity className="w-3 h-3" />{p.frequency}x</span>
-                      <span className="flex items-center gap-1"><Clock className="w-3 h-3" />{last}</span>
-                    </div>
-                  </div>
-                );
-              })}
-            </div>
-          </div>
-        )}
-      </ScrollArea>
-    </div>
-  );
-}

client/src/components/PlusSyncPanel.tsx

@@ -1,353 +0,0 @@
-import { useState, useEffect, useCallback } from "react";
-import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
-import { Button } from "@/components/ui/button";
-import { Badge } from "@/components/ui/badge";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
-import { useToast } from "@/hooks/use-toast";
-import {
-  RefreshCw, CheckCircle, XCircle, Loader2, Users, Package,
-  ShoppingCart, FileText, ExternalLink, Building2, Link2
-} from "lucide-react";
-import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
-
-interface Empresa {
-  id: number;
-  tenantId: number;
-  razaoSocial: string;
-  nomeFantasia: string | null;
-  cnpj: string;
-  tipo: string;
-  plusEmpresaId: number | null;
-  isActive: boolean;
-}
-
-interface SyncResult {
-  success: boolean;
-  created?: number;
-  updated?: number;
-  failed?: number;
-  errors?: string[];
-  message?: string;
-}
-
-interface PlusStatus {
-  connected: boolean;
-  url?: string;
-  message?: string;
-}
-
-export default function PlusSyncPanel({ tenantId }: { tenantId?: number }) {
-  const { toast } = useToast();
-  const [empresas, setEmpresas] = useState<Empresa[]>([]);
-  const [selectedEmpresa, setSelectedEmpresa] = useState<string>("");
-  const [plusStatus, setPlusStatus] = useState<PlusStatus | null>(null);
-  const [loading, setLoading] = useState(false);
-  const [syncingCustomers, setSyncingCustomers] = useState(false);
-  const [syncingProducts, setSyncingProducts] = useState(false);
-  const [syncingSales, setSyncingSales] = useState(false);
-  const [importingCustomers, setImportingCustomers] = useState(false);
-  const [importingProducts, setImportingProducts] = useState(false);
-  const [bindPlusId, setBindPlusId] = useState("");
-  const [lastResults, setLastResults] = useState<Record<string, SyncResult>>({});
-
-  const currentTenant = tenantId || 1;
-
-  const loadEmpresas = useCallback(async () => {
-    try {
-      const res = await fetch(`/api/retail/plus/empresas?tenantId=${currentTenant}`);
-      if (res.ok) {
-        const data = await res.json();
-        setEmpresas(data);
-        if (data.length > 0 && !selectedEmpresa) {
-          setSelectedEmpresa(data[0].id.toString());
-        }
-      }
-    } catch (error) {
-      console.error("Error loading empresas:", error);
-    }
-  }, [currentTenant, selectedEmpresa]);
-
-  const checkStatus = useCallback(async () => {
-    setLoading(true);
-    try {
-      const empresaId = selectedEmpresa ? `?empresaId=${selectedEmpresa}` : "";
-      const res = await fetch(`/api/retail/plus/status${empresaId}`);
-      if (res.ok) {
-        const data = await res.json();
-        setPlusStatus(data);
-      }
-    } catch (error) {
-      setPlusStatus({ connected: false, message: "Erro ao verificar conexão" });
-    } finally {
-      setLoading(false);
-    }
-  }, [selectedEmpresa]);
-
-  useEffect(() => {
-    loadEmpresas();
-  }, [loadEmpresas]);
-
-  useEffect(() => {
-    if (selectedEmpresa) checkStatus();
-  }, [selectedEmpresa, checkStatus]);
-
-  const handleSync = async (action: string, setLoading: (v: boolean) => void) => {
-    setLoading(true);
-    try {
-      const body: any = { tenantId: currentTenant };
-      if (selectedEmpresa) body.empresaId = parseInt(selectedEmpresa);
-
-      const res = await fetch(`/api/retail/plus/${action}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-      });
-      const data = await res.json();
-      setLastResults(prev => ({ ...prev, [action]: data }));
-
-      if (data.success) {
-        toast({ title: "Sincronização concluída", description: `Criados: ${data.created || 0}, Atualizados: ${data.updated || 0}` });
-      } else {
-        toast({ title: "Erro na sincronização", description: data.message || "Falha na operação", variant: "destructive" });
-      }
-    } catch (error) {
-      toast({ title: "Erro", description: "Falha na comunicação com o servidor", variant: "destructive" });
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  const handleBindEmpresa = async () => {
-    if (!selectedEmpresa || !bindPlusId) return;
-    try {
-      const res = await fetch(`/api/retail/plus/empresas/${selectedEmpresa}/bind`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ plusEmpresaId: parseInt(bindPlusId) }),
-      });
-      if (res.ok) {
-        toast({ title: "Empresa vinculada", description: "Empresa vinculada ao Plus com sucesso" });
-        loadEmpresas();
-        setBindPlusId("");
-      }
-    } catch (error) {
-      toast({ title: "Erro", description: "Falha ao vincular empresa", variant: "destructive" });
-    }
-  };
-
-  const currentEmpresa = empresas.find(e => e.id.toString() === selectedEmpresa);
-
-  const SyncResultBadge = ({ result }: { result?: SyncResult }) => {
-    if (!result) return null;
-    return (
-      <div className="flex items-center gap-2 text-xs mt-1">
-        {result.success ? (
-          <Badge variant="outline" className="text-green-600 border-green-300">
-            <CheckCircle className="h-3 w-3 mr-1" />
-            OK: {result.created || 0} criados, {result.updated || 0} atualizados
-          </Badge>
-        ) : (
-          <Badge variant="destructive" className="text-xs">
-            <XCircle className="h-3 w-3 mr-1" />
-            {result.message || "Falha"}
-          </Badge>
-        )}
-      </div>
-    );
-  };
-
-  return (
-    <div className="space-y-6" data-testid="plus-sync-panel">
-      <div className="flex items-center justify-between">
-        <div>
-          <h3 className="text-lg font-semibold">Integração Plus ERP</h3>
-          <p className="text-sm text-muted-foreground">Sincronização bidirecional com o Arcádia Plus (Laravel ERP)</p>
-        </div>
-        <div className="flex items-center gap-2">
-          {plusStatus && (
-            <Badge variant={plusStatus.connected ? "default" : "destructive"} data-testid="plus-connection-status">
-              {plusStatus.connected ? (
-                <><CheckCircle className="h-3 w-3 mr-1" /> Conectado</>
-              ) : (
-                <><XCircle className="h-3 w-3 mr-1" /> Desconectado</>
-              )}
-            </Badge>
-          )}
-          <Button variant="outline" size="sm" onClick={checkStatus} disabled={loading} data-testid="btn-check-plus-status">
-            <RefreshCw className={`h-4 w-4 mr-1 ${loading ? "animate-spin" : ""}`} />
-            Testar Conexão
-          </Button>
-        </div>
-      </div>
-
-      <Card>
-        <CardHeader>
-          <CardTitle className="text-base flex items-center gap-2">
-            <Building2 className="h-4 w-4" />
-            Empresa Ativa
-          </CardTitle>
-          <CardDescription>Selecione a empresa para operações de sincronização</CardDescription>
-        </CardHeader>
-        <CardContent className="space-y-4">
-          <div className="flex items-end gap-3">
-            <div className="flex-1">
-              <Label>Empresa</Label>
-              <Select value={selectedEmpresa} onValueChange={setSelectedEmpresa}>
-                <SelectTrigger data-testid="select-empresa-plus">
-                  <SelectValue placeholder="Selecione uma empresa" />
-                </SelectTrigger>
-                <SelectContent>
-                  {empresas.map(emp => (
-                    <SelectItem key={emp.id} value={emp.id.toString()}>
-                      {emp.nomeFantasia || emp.razaoSocial} ({emp.cnpj}) {emp.tipo === "matriz" ? "📍" : "🔗"}
-                    </SelectItem>
-                  ))}
-                </SelectContent>
-              </Select>
-            </div>
-          </div>
-
-          {currentEmpresa && (
-            <div className="rounded-lg border p-3 bg-muted/50 space-y-2">
-              <div className="flex items-center justify-between">
-                <span className="text-sm font-medium">{currentEmpresa.razaoSocial}</span>
-                <Badge variant="outline">{currentEmpresa.tipo === "matriz" ? "Matriz" : "Filial"}</Badge>
-              </div>
-              <div className="text-xs text-muted-foreground">CNPJ: {currentEmpresa.cnpj}</div>
-              <div className="flex items-center gap-2">
-                <Link2 className="h-3 w-3" />
-                <span className="text-xs">Plus ID: {currentEmpresa.plusEmpresaId || "Não vinculada"}</span>
-                {!currentEmpresa.plusEmpresaId && (
-                  <div className="flex items-center gap-1 ml-2">
-                    <Input
-                      type="number"
-                      placeholder="ID da empresa no Plus"
-                      value={bindPlusId}
-                      onChange={e => setBindPlusId(e.target.value)}
-                      className="h-7 w-36 text-xs"
-                      data-testid="input-bind-plus-id"
-                    />
-                    <Button size="sm" variant="outline" className="h-7 text-xs" onClick={handleBindEmpresa} data-testid="btn-bind-empresa">
-                      Vincular
-                    </Button>
-                  </div>
-                )}
-              </div>
-            </div>
-          )}
-        </CardContent>
-      </Card>
-
-      <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
-        <Card>
-          <CardHeader>
-            <CardTitle className="text-base flex items-center gap-2">
-              <Users className="h-4 w-4" />
-              Clientes / Fornecedores
-            </CardTitle>
-          </CardHeader>
-          <CardContent className="space-y-3">
-            <div className="flex gap-2">
-              <Button
-                variant="outline"
-                size="sm"
-                className="flex-1"
-                disabled={syncingCustomers}
-                onClick={() => handleSync("sync/customers", setSyncingCustomers)}
-                data-testid="btn-sync-customers-to-plus"
-              >
-                {syncingCustomers ? <Loader2 className="h-4 w-4 mr-1 animate-spin" /> : <ExternalLink className="h-4 w-4 mr-1" />}
-                Enviar → Plus
-              </Button>
-              <Button
-                variant="outline"
-                size="sm"
-                className="flex-1"
-                disabled={importingCustomers}
-                onClick={() => handleSync("import/customers", setImportingCustomers)}
-                data-testid="btn-import-customers-from-plus"
-              >
-                {importingCustomers ? <Loader2 className="h-4 w-4 mr-1 animate-spin" /> : <ExternalLink className="h-4 w-4 mr-1 rotate-180" />}
-                Plus → Importar
-              </Button>
-            </div>
-            <SyncResultBadge result={lastResults["sync/customers"] || lastResults["import/customers"]} />
-          </CardContent>
-        </Card>
-
-        <Card>
-          <CardHeader>
-            <CardTitle className="text-base flex items-center gap-2">
-              <Package className="h-4 w-4" />
-              Produtos / Estoque
-            </CardTitle>
-          </CardHeader>
-          <CardContent className="space-y-3">
-            <div className="flex gap-2">
-              <Button
-                variant="outline"
-                size="sm"
-                className="flex-1"
-                disabled={importingProducts}
-                onClick={() => handleSync("import/products", setImportingProducts)}
-                data-testid="btn-import-products-from-plus"
-              >
-                {importingProducts ? <Loader2 className="h-4 w-4 mr-1 animate-spin" /> : <Package className="h-4 w-4 mr-1" />}
-                Plus → Importar Produtos
-              </Button>
-            </div>
-            <SyncResultBadge result={lastResults["import/products"]} />
-          </CardContent>
-        </Card>
-
-        <Card>
-          <CardHeader>
-            <CardTitle className="text-base flex items-center gap-2">
-              <ShoppingCart className="h-4 w-4" />
-              Vendas PDV
-            </CardTitle>
-          </CardHeader>
-          <CardContent className="space-y-3">
-            <p className="text-xs text-muted-foreground">
-              As vendas são sincronizadas automaticamente ao finalizar no PDV.
-              Use o botão abaixo para reenviar vendas pendentes.
-            </p>
-            <Button
-              variant="outline"
-              size="sm"
-              disabled={syncingSales}
-              onClick={() => {
-                toast({ title: "Em breve", description: "Sincronização em lote será implementada" });
-              }}
-              data-testid="btn-sync-pending-sales"
-            >
-              {syncingSales ? <Loader2 className="h-4 w-4 mr-1 animate-spin" /> : <RefreshCw className="h-4 w-4 mr-1" />}
-              Reenviar Pendentes
-            </Button>
-            <SyncResultBadge result={lastResults["sync/sales"]} />
-          </CardContent>
-        </Card>
-
-        <Card>
-          <CardHeader>
-            <CardTitle className="text-base flex items-center gap-2">
-              <FileText className="h-4 w-4" />
-              Documentos Fiscais
-            </CardTitle>
-          </CardHeader>
-          <CardContent className="space-y-3">
-            <p className="text-xs text-muted-foreground">
-              Emissão de NF-e e NFC-e via Plus ERP. Selecione a venda na aba PDV
-              e use a opção "Emitir NF-e" para gerar o documento fiscal.
-            </p>
-            <Badge variant="outline" className="text-xs">
-              <FileText className="h-3 w-3 mr-1" />
-              Integrado via Plus API
-            </Badge>
-          </CardContent>
-        </Card>
-      </div>
-    </div>
-  );
-}

client/src/components/SupersetDashboard.tsx

@@ -1,160 +0,0 @@
-import { useEffect, useRef, useState, useCallback } from "react";
-import { Loader2, AlertTriangle, ExternalLink, RefreshCw } from "lucide-react";
-
-interface SupersetDashboardProps {
-  dashboardId: string;
-  height?: string | number;
-  className?: string;
-  showOpenLink?: boolean;
-}
-
-/**
- * Componente reutilizável para embedar dashboards do Apache Superset (Arcádia Insights)
- * em QUALQUER tela do Arcádia Suite via Guest Token JWT.
- *
- * Uso:
- *   <SupersetDashboard dashboardId="financial-overview" />
- *   <SupersetDashboard dashboardId="dre-mensal" height={400} />
- */
-export function SupersetDashboard({
-  dashboardId,
-  height = "calc(100vh - 320px)",
-  className = "",
-  showOpenLink = true,
-}: SupersetDashboardProps) {
-  const containerRef = useRef<HTMLDivElement>(null);
-  const sdkRef = useRef<any>(null);
-  const [status, setStatus] = useState<"loading" | "ready" | "error" | "unavailable">("loading");
-  const [errorMsg, setErrorMsg] = useState<string>("");
-
-  const fetchGuestToken = useCallback(async (): Promise<string> => {
-    const resp = await fetch("/api/superset/guest-token", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ dashboardId }),
-      credentials: "include",
-    });
-    if (!resp.ok) {
-      const err = await resp.json().catch(() => ({ error: "Erro desconhecido" }));
-      throw new Error(err.error || `HTTP ${resp.status}`);
-    }
-    const { token } = await resp.json();
-    return token;
-  }, [dashboardId]);
-
-  const loadDashboard = useCallback(async () => {
-    if (!containerRef.current) return;
-    setStatus("loading");
-    setErrorMsg("");
-
-    try {
-      // Verifica se Superset está disponível
-      const health = await fetch("/api/superset/health", { credentials: "include" });
-      const healthData = await health.json();
-      if (!healthData.online) {
-        setStatus("unavailable");
-        return;
-      }
-
-      // Importa SDK dinamicamente (só quando necessário)
-      const { embedDashboard } = await import("@superset-ui/embedded-sdk");
-
-      // Limpa embedding anterior se houver
-      if (sdkRef.current) {
-        containerRef.current.innerHTML = "";
-      }
-
-      sdkRef.current = await embedDashboard({
-        id: dashboardId,
-        supersetDomain: window.location.origin + "/superset",
-        mountPoint: containerRef.current,
-        fetchGuestToken,
-        dashboardUiConfig: {
-          hideTitle: true,
-          hideChartControls: false,
-          filters: { visible: true, expanded: false },
-        },
-      });
-
-      setStatus("ready");
-    } catch (err: any) {
-      console.error("[SupersetDashboard] Erro:", err.message);
-      // Se SDK não estiver instalado, usa iframe como fallback
-      if (err.message?.includes("Cannot find module") || err.message?.includes("embedDashboard")) {
-        setStatus("unavailable");
-      } else {
-        setErrorMsg(err.message);
-        setStatus("error");
-      }
-    }
-  }, [dashboardId, fetchGuestToken]);
-
-  useEffect(() => {
-    loadDashboard();
-    return () => {
-      if (containerRef.current) containerRef.current.innerHTML = "";
-    };
-  }, [loadDashboard]);
-
-  const heightStyle = typeof height === "number" ? `${height}px` : height;
-
-  if (status === "unavailable") {
-    return (
-      <div className={`rounded-xl overflow-hidden border border-[#c89b3c]/20 bg-white shadow-sm ${className}`} style={{ height: heightStyle }}>
-        <iframe
-          src="/superset/login"
-          className="w-full h-full border-0"
-          title="Arcádia Insights — Apache Superset"
-          allow="fullscreen"
-        />
-      </div>
-    );
-  }
-
-  if (status === "error") {
-    return (
-      <div className={`flex flex-col items-center justify-center gap-4 rounded-xl border border-red-100 bg-red-50 ${className}`} style={{ height: heightStyle }}>
-        <AlertTriangle className="w-8 h-8 text-red-400" />
-        <div className="text-center">
-          <p className="font-medium text-red-700 text-sm">Erro ao carregar dashboard</p>
-          <p className="text-red-500 text-xs mt-1">{errorMsg}</p>
-        </div>
-        <button
-          onClick={loadDashboard}
-          className="flex items-center gap-2 px-4 py-2 bg-red-600 text-white rounded-lg text-sm hover:bg-red-700 transition-colors"
-        >
-          <RefreshCw className="w-4 h-4" /> Tentar novamente
-        </button>
-      </div>
-    );
-  }
-
-  return (
-    <div className={`relative ${className}`} style={{ height: heightStyle }}>
-      {status === "loading" && (
-        <div className="absolute inset-0 flex items-center justify-center bg-white/90 z-10 rounded-xl">
-          <div className="text-center">
-            <Loader2 className="w-8 h-8 text-[#c89b3c] animate-spin mx-auto mb-3" />
-            <p className="text-sm text-[#1f334d] font-medium">Carregando Arcádia Insights...</p>
-          </div>
-        </div>
-      )}
-
-      {showOpenLink && status === "ready" && (
-        <a
-          href="/superset"
-          target="_blank"
-          rel="noopener noreferrer"
-          className="absolute top-3 right-3 z-10 flex items-center gap-1 px-2 py-1 bg-white/80 backdrop-blur text-[#1f334d] text-xs rounded-lg border border-gray-200 hover:bg-white transition-colors shadow-sm"
-        >
-          <ExternalLink className="w-3 h-3" /> Abrir completo
-        </a>
-      )}
-
-      <div
-        ref={containerRef}
-        className="w-full h-full rounded-xl overflow-hidden border border-[#c89b3c]/20"
-      />
-    </div>
-  );
-}

client/src/components/openclaw/OpenClawWidget.tsx

@@ -1,131 +0,0 @@
-/**
- * OpenClawWidget.tsx
- *
- * Widget flutuante do OpenClaw — aparece quando há sugestões pendentes.
- * Posicionado no canto inferior direito, fora das rotas.
- * Abre o modal SkillSuggestion para confirmação.
- *
- * Fase 4: OpenClaw Sprint 2
- */
-
-import { useState } from "react";
-import { Sparkles, X, ChevronUp, ChevronDown } from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { Badge } from "@/components/ui/badge";
-import { useAgentEmergence } from "@/hooks/useAgentEmergence";
-import { SkillSuggestion } from "./SkillSuggestion";
-import { useAuth } from "@/hooks/use-auth";
-
-export function OpenClawWidget() {
-  const { user } = useAuth();
-  const {
-    suggestions,
-    activeSuggestion,
-    pendingCount,
-    confirmSkill,
-    rejectSkill,
-    openSuggestion,
-    closeSuggestion,
-  } = useAgentEmergence();
-
-  const [collapsed, setCollapsed] = useState(false);
-  const [dismissed, setDismissed] = useState(false);
-
-  // Não renderiza se não há usuário, não há sugestões, ou foi dispensado
-  if (!user || pendingCount === 0 || dismissed) return null;
-
-  return (
-    <>
-      {/* Widget flutuante */}
-      <div
-        className="fixed bottom-6 right-6 z-50 flex flex-col items-end gap-2"
-        role="complementary"
-        aria-label="OpenClaw - Sugestões de Skills"
-      >
-        {/* Painel expandido */}
-        {!collapsed && (
-          <div className="w-72 rounded-xl border bg-background shadow-lg overflow-hidden">
-            <div className="flex items-center justify-between px-3 py-2.5 border-b bg-violet-50 dark:bg-violet-900/20">
-              <div className="flex items-center gap-2">
-                <Sparkles className="h-4 w-4 text-violet-600 dark:text-violet-400" />
-                <span className="text-sm font-semibold text-violet-700 dark:text-violet-300">
-                  OpenClaw
-                </span>
-                <Badge className="bg-violet-600 text-white text-xs px-1.5 py-0">
-                  {pendingCount}
-                </Badge>
-              </div>
-              <div className="flex items-center gap-1">
-                <button
-                  onClick={() => setCollapsed(true)}
-                  className="p-0.5 rounded hover:bg-violet-100 dark:hover:bg-violet-900/40 text-muted-foreground"
-                  aria-label="Minimizar"
-                >
-                  <ChevronDown className="h-3.5 w-3.5" />
-                </button>
-                <button
-                  onClick={() => setDismissed(true)}
-                  className="p-0.5 rounded hover:bg-violet-100 dark:hover:bg-violet-900/40 text-muted-foreground"
-                  aria-label="Fechar"
-                >
-                  <X className="h-3.5 w-3.5" />
-                </button>
-              </div>
-            </div>
-
-            <div className="p-3 space-y-2 max-h-64 overflow-y-auto">
-              <p className="text-xs text-muted-foreground">
-                Detectei padrões de uso que podem virar skills automáticas:
-              </p>
-              {suggestions.map((s) => (
-                <button
-                  key={s.id}
-                  onClick={() => openSuggestion(s)}
-                  className="w-full text-left rounded-lg border p-2.5 hover:bg-muted/50 transition-colors space-y-1"
-                >
-                  <div className="flex items-start justify-between gap-2">
-                    <span className="text-sm font-medium leading-tight line-clamp-1">
-                      {s.suggested_skill_name}
-                    </span>
-                    <Badge variant="outline" className="text-xs shrink-0">
-                      {Math.round(s.confidence * 100)}%
-                    </Badge>
-                  </div>
-                  <p className="text-xs text-muted-foreground line-clamp-2">
-                    {s.suggested_description}
-                  </p>
-                </button>
-              ))}
-            </div>
-          </div>
-        )}
-
-        {/* Botão minimizado */}
-        {collapsed && (
-          <button
-            onClick={() => setCollapsed(false)}
-            className="flex items-center gap-2 rounded-full bg-violet-600 hover:bg-violet-700 text-white px-4 py-2.5 shadow-lg transition-colors"
-            aria-label="Expandir sugestões de skills"
-          >
-            <Sparkles className="h-4 w-4" />
-            <span className="text-sm font-medium">Skills sugeridas</span>
-            <Badge className="bg-white text-violet-700 text-xs px-1.5 py-0 ml-0.5">
-              {pendingCount}
-            </Badge>
-            <ChevronUp className="h-3.5 w-3.5 ml-0.5" />
-          </button>
-        )}
-      </div>
-
-      {/* Modal de detalhes */}
-      {activeSuggestion && (
-        <SkillSuggestion
-          suggestion={activeSuggestion}
-          onConfirm={confirmSkill}
-          onReject={rejectSkill}
-          onClose={closeSuggestion}
-        />
-      )}
-    </>
-  );
-}

client/src/components/openclaw/SkillSuggestion.tsx

@@ -1,101 +0,0 @@
-/**
- * SkillSuggestion.tsx
- *
- * Modal com preview da skill sugerida pelo OpenClaw.
- * Apresenta padrão detectado, nome, descrição e preview de automação.
- * Usuário pode confirmar ou rejeitar.
- *
- * Fase 4: OpenClaw Sprint 2
- */
-
-import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from "@/components/ui/dialog";
-import { Button } from "@/components/ui/button";
-import { Badge } from "@/components/ui/badge";
-import { Sparkles, X, Check, Zap, BarChart2 } from "lucide-react";
-import type { SkillSuggestionData } from "@/hooks/useAgentEmergence";
-
-interface SkillSuggestionProps {
-  suggestion: SkillSuggestionData;
-  onConfirm: (id: string) => void;
-  onReject: (id: string) => void;
-  onClose: () => void;
-}
-
-export function SkillSuggestion({ suggestion, onConfirm, onReject, onClose }: SkillSuggestionProps) {
-  const confidencePct = Math.round(suggestion.confidence * 100);
-
-  return (
-    <Dialog open onOpenChange={onClose}>
-      <DialogContent className="sm:max-w-lg">
-        <DialogHeader>
-          <div className="flex items-center gap-2">
-            <div className="p-1.5 rounded-md bg-violet-100 dark:bg-violet-900/30">
-              <Sparkles className="h-4 w-4 text-violet-600 dark:text-violet-400" />
-            </div>
-            <DialogTitle className="text-base">Nova skill detectada</DialogTitle>
-          </div>
-        </DialogHeader>
-
-        {/* Padrão detectado */}
-        <div className="rounded-lg border bg-muted/40 p-3 text-sm space-y-1">
-          <p className="text-xs font-medium text-muted-foreground uppercase tracking-wide">Padrão detectado</p>
-          <p className="font-medium">{suggestion.pattern.description || suggestion.pattern.action_type}</p>
-          <div className="flex items-center gap-3 text-muted-foreground text-xs mt-1">
-            <span className="flex items-center gap-1">
-              <BarChart2 className="h-3 w-3" />
-              {suggestion.pattern.frequency}x detectado
-            </span>
-            <span className="flex items-center gap-1">
-              <Zap className="h-3 w-3" />
-              Confiança: {confidencePct}%
-            </span>
-          </div>
-        </div>
-
-        {/* Skill sugerida */}
-        <div className="space-y-3">
-          <div>
-            <p className="text-xs font-medium text-muted-foreground mb-1">Nome da skill</p>
-            <div className="flex items-center gap-2">
-              <Badge variant="secondary" className="font-mono text-xs">
-                {suggestion.suggested_skill_name}
-              </Badge>
-            </div>
-          </div>
-
-          <div>
-            <p className="text-xs font-medium text-muted-foreground mb-1">Descrição</p>
-            <p className="text-sm">{suggestion.suggested_description}</p>
-          </div>
-
-          <div>
-            <p className="text-xs font-medium text-muted-foreground mb-1">O que será automatizado</p>
-            <div className="rounded-md border bg-muted/20 p-2.5 text-sm text-muted-foreground">
-              {suggestion.estimated_automation}
-            </div>
-          </div>
-        </div>
-
-        <DialogFooter className="gap-2 sm:gap-0">
-          <Button
-            variant="outline"
-            size="sm"
-            onClick={() => onReject(suggestion.id)}
-            className="gap-1.5"
-          >
-            <X className="h-3.5 w-3.5" />
-            Rejeitar
-          </Button>
-          <Button
-            size="sm"
-            onClick={() => onConfirm(suggestion.id)}
-            className="gap-1.5 bg-violet-600 hover:bg-violet-700"
-          >
-            <Check className="h-3.5 w-3.5" />
-            Criar skill
-          </Button>
-        </DialogFooter>
-      </DialogContent>
-    </Dialog>
-  );
-}

client/src/contexts/SoeMotorContext.tsx

@@ -1,25 +0,0 @@
-import { createContext, useContext, useState, ReactNode } from "react";
-
-interface SoeMotorContextValue {
-  activeCompany: string | null;
-  setActiveCompany: (id: string | null) => void;
-}
-
-const SoeMotorContext = createContext<SoeMotorContextValue>({
-  activeCompany: null,
-  setActiveCompany: () => {},
-});
-
-export function SoeMotorProvider({ children }: { children: ReactNode }) {
-  const [activeCompany, setActiveCompany] = useState<string | null>(null);
-
-  return (
-    <SoeMotorContext.Provider value={{ activeCompany, setActiveCompany }}>
-      {children}
-    </SoeMotorContext.Provider>
-  );
-}
-
-export function useSoeMotor() {
-  return useContext(SoeMotorContext);
-}

client/src/hooks/use-tenant-features.ts

@@ -1,59 +0,0 @@
-import { useQuery } from "@tanstack/react-query";
-
-export type TenantFeatures = {
-  ide: boolean;
-  ideMode: 'none' | 'no-code' | 'low-code' | 'pro-code';
-  whatsapp: boolean;
-  whatsappSessions: number;
-  crm: boolean;
-  erp: boolean;
-  bi: boolean;
-  manus: boolean;
-  manusTools: string[];
-  centralApis: boolean;
-  centralApisManage: boolean;
-  comunidades: boolean;
-  maxChannels: number;
-  biblioteca: boolean;
-  bibliotecaPublish: boolean;
-  suporteN3: boolean;
-  retail: boolean;
-  plus: boolean;
-  fisco: boolean;
-  cockpit: boolean;
-  compass: boolean;
-  production: boolean;
-  support: boolean;
-  xosCrm: boolean;
-};
-
-const defaultFeatures: TenantFeatures = {
-  ide: true, ideMode: 'pro-code', whatsapp: false, whatsappSessions: 0,
-  crm: true, erp: true, bi: false, manus: true, manusTools: [],
-  centralApis: false, centralApisManage: false, comunidades: false,
-  maxChannels: 5, biblioteca: false, bibliotecaPublish: false,
-  suporteN3: false, retail: false, plus: false, fisco: false,
-  cockpit: false, compass: true, production: false, support: false, xosCrm: false
-};
-
-export function useTenantFeatures() {
-  const { data, isLoading } = useQuery({
-    queryKey: ["tenant-modules"],
-    queryFn: async () => {
-      const res = await fetch("/api/soe/tenant/modules", { credentials: "include" });
-      if (!res.ok) throw new Error("Failed to fetch tenant modules");
-      return res.json();
-    },
-    staleTime: 60000,
-    retry: 1
-  });
-
-  const features: TenantFeatures = { ...defaultFeatures, ...(data?.features || {}) };
-
-  return {
-    features,
-    isLoading,
-    plan: data?.plan as string | undefined,
-    isEnabled: (key: keyof TenantFeatures) => !!features[key],
-  };
-}

client/src/hooks/use-xos-socket.ts

@@ -1,103 +0,0 @@
-/**
- * useXosSocket — subscribes to XOS real-time events from Socket.IO.
- * Usage:
- *   const { supervisorStats, lastSlaBreachEvent } = useXosSocket();
- */
-import { useEffect, useRef, useState, useCallback } from "react";
-import { io, Socket } from "socket.io-client";
-
-export interface SupervisorStats {
-  openConversations: number;
-  resolvedToday: number;
-  urgentTickets: number;
-  agentsOnline: number;
-  timestamp: string;
-}
-
-export interface SlaBreachEvent {
-  protocolId: number;
-  protocolNumber: string;
-  tenantId: number;
-  queueId: number | null;
-  assignedTo: number | null;
-  breachedAt: string;
-}
-
-interface XosSocketState {
-  connected: boolean;
-  supervisorStats: SupervisorStats | null;
-  lastSlaBreachEvent: SlaBreachEvent | null;
-}
-
-let _socket: Socket | null = null;
-let _refCount = 0;
-
-function getSocket(): Socket {
-  if (!_socket) {
-    _socket = io(window.location.origin, {
-      path: "/socket.io",
-      transports: ["websocket", "polling"],
-      reconnectionAttempts: 10,
-      reconnectionDelay: 2000,
-    });
-  }
-  return _socket;
-}
-
-export function useXosSocket() {
-  const [state, setState] = useState<XosSocketState>({
-    connected: false,
-    supervisorStats: null,
-    lastSlaBreachEvent: null,
-  });
-  const socketRef = useRef<Socket | null>(null);
-
-  const handleStats = useCallback((data: SupervisorStats) => {
-    setState((s) => ({ ...s, supervisorStats: data }));
-  }, []);
-
-  const handleSlaBreach = useCallback((data: SlaBreachEvent) => {
-    setState((s) => ({ ...s, lastSlaBreachEvent: data }));
-  }, []);
-
-  const handleConnect = useCallback(() => {
-    setState((s) => ({ ...s, connected: true }));
-  }, []);
-
-  const handleDisconnect = useCallback(() => {
-    setState((s) => ({ ...s, connected: false }));
-  }, []);
-
-  useEffect(() => {
-    const socket = getSocket();
-    socketRef.current = socket;
-    _refCount++;
-
-    socket.on("connect", handleConnect);
-    socket.on("disconnect", handleDisconnect);
-    socket.on("xos:supervisor.stats", handleStats);
-    socket.on("xos:sla.breach", handleSlaBreach);
-
-    // Sync initial connection state
-    if (socket.connected) {
-      setState((s) => ({ ...s, connected: true }));
-    }
-
-    return () => {
-      socket.off("connect", handleConnect);
-      socket.off("disconnect", handleDisconnect);
-      socket.off("xos:supervisor.stats", handleStats);
-      socket.off("xos:sla.breach", handleSlaBreach);
-
-      _refCount--;
-      // Keep socket alive as long as any component uses it
-      if (_refCount <= 0 && _socket) {
-        _socket.disconnect();
-        _socket = null;
-        _refCount = 0;
-      }
-    };
-  }, [handleConnect, handleDisconnect, handleStats, handleSlaBreach]);
-
-  return state;
-}

client/src/hooks/useAgentEmergence.ts

@@ -1,143 +0,0 @@
-/**
- * useAgentEmergence.ts
- *
- * Hook para gerenciar sugestões de skills do OpenClaw.
- * Escuta eventos Socket.IO e coordena confirmações/rejeições.
- *
- * Fase 4: OpenClaw Sprint 2
- */
-
-import { useState, useEffect, useCallback } from "react";
-import { useAuth } from "./use-auth";
-
-export interface SkillSuggestionData {
-  id: string;
-  pattern: {
-    id: string;
-    action_type: string;
-    frequency: number;
-    confidence: number;
-    description: string;
-  };
-  suggested_skill_name: string;
-  suggested_description: string;
-  estimated_automation: string;
-  confidence: number;
-  created_at: string;
-  status: "pending" | "accepted" | "rejected";
-}
-
-interface UseAgentEmergenceReturn {
-  suggestions: SkillSuggestionData[];
-  activeSuggestion: SkillSuggestionData | null;
-  isOpen: boolean;
-  pendingCount: number;
-  confirmSkill: (suggestionId: string) => Promise<void>;
-  rejectSkill: (suggestionId: string) => Promise<void>;
-  openSuggestion: (suggestion: SkillSuggestionData) => void;
-  closeSuggestion: () => void;
-  dismissWidget: () => void;
-}
-
-export function useAgentEmergence(): UseAgentEmergenceReturn {
-  const { user } = useAuth();
-  const [suggestions, setSuggestions] = useState<SkillSuggestionData[]>([]);
-  const [activeSuggestion, setActiveSuggestion] = useState<SkillSuggestionData | null>(null);
-  const [isOpen, setIsOpen] = useState(false);
-
-  // Carrega sugestões pendentes do servidor
-  const fetchPendingSuggestions = useCallback(async () => {
-    if (!user) return;
-    try {
-      const res = await fetch("/api/openclaw/suggestions");
-      if (res.ok) {
-        const data = await res.json();
-        setSuggestions(data.suggestions || []);
-      }
-    } catch {
-      // silencioso — não bloqueia o usuário
-    }
-  }, [user]);
-
-  // Escuta eventos Socket.IO via window (padrão da suite)
-  useEffect(() => {
-    if (!user) return;
-
-    fetchPendingSuggestions();
-
-    const handleOpenClawEvent = (event: CustomEvent) => {
-      const suggestion: SkillSuggestionData = event.detail;
-      setSuggestions((prev) => {
-        const exists = prev.find((s) => s.id === suggestion.id);
-        if (exists) return prev;
-        return [suggestion, ...prev];
-      });
-    };
-
-    window.addEventListener("openclaw:suggestion" as any, handleOpenClawEvent);
-    return () => {
-      window.removeEventListener("openclaw:suggestion" as any, handleOpenClawEvent);
-    };
-  }, [user, fetchPendingSuggestions]);
-
-  const confirmSkill = useCallback(async (suggestionId: string) => {
-    try {
-      const res = await fetch("/api/openclaw/confirm-skill", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ suggestion_id: suggestionId, action: "confirm" }),
-      });
-      if (res.ok) {
-        setSuggestions((prev) => prev.filter((s) => s.id !== suggestionId));
-        setActiveSuggestion(null);
-        setIsOpen(false);
-      }
-    } catch {
-      // erro tratado na UI via toast externo
-    }
-  }, []);
-
-  const rejectSkill = useCallback(async (suggestionId: string) => {
-    try {
-      const res = await fetch("/api/openclaw/confirm-skill", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ suggestion_id: suggestionId, action: "reject" }),
-      });
-      if (res.ok) {
-        setSuggestions((prev) => prev.filter((s) => s.id !== suggestionId));
-        setActiveSuggestion(null);
-        setIsOpen(false);
-      }
-    } catch {
-      // silencioso
-    }
-  }, []);
-
-  const openSuggestion = useCallback((suggestion: SkillSuggestionData) => {
-    setActiveSuggestion(suggestion);
-    setIsOpen(true);
-  }, []);
-
-  const closeSuggestion = useCallback(() => {
-    setActiveSuggestion(null);
-    setIsOpen(false);
-  }, []);
-
-  const dismissWidget = useCallback(() => {
-    setIsOpen(false);
-    setActiveSuggestion(null);
-  }, []);
-
-  return {
-    suggestions,
-    activeSuggestion,
-    isOpen,
-    pendingCount: suggestions.length,
-    confirmSkill,
-    rejectSkill,
-    openSuggestion,
-    closeSuggestion,
-    dismissWidget,
-  };
-}

client/src/lib/export-utils.ts

@@ -1,142 +0,0 @@
-// Utilitários de exportação com lazy loading dinâmico
-// Reduz o bundle inicial do Agent.tsx
-
-export async function exportToPDF(content: string, prompt?: string, chartContainer?: HTMLElement | null) {
-  const [{ jsPDF }, html2canvas] = await Promise.all([
-    import("jspdf"),
-    import("html2canvas").then(m => m.default)
-  ]);
-
-  const doc = new jsPDF();
-  const pageWidth = doc.internal.pageSize.getWidth();
-  const margin = 20;
-  const maxWidth = pageWidth - margin * 2;
-
-  doc.setFontSize(16);
-  doc.setTextColor(31, 51, 77);
-  doc.text("Arcádia Agent - Resultado", margin, 20);
-
-  let currentY = 30;
-
-  if (prompt) {
-    doc.setFontSize(10);
-    doc.setTextColor(90, 108, 125);
-    doc.text("Tarefa:", margin, currentY);
-    currentY += 7;
-    const promptLines = doc.splitTextToSize(prompt, maxWidth);
-    doc.text(promptLines, margin, currentY);
-    currentY += promptLines.length * 5 + 10;
-  }
-
-  doc.setFontSize(12);
-  doc.setTextColor(31, 51, 77);
-  doc.text("Resposta:", margin, currentY);
-  currentY += 8;
-
-  const textContent = content.replace(/__CHART_DATA__[\s\S]*?__END_CHART_DATA__/g, "").trim();
-  doc.setFontSize(11);
-  const lines = doc.splitTextToSize(textContent, maxWidth);
-  doc.text(lines, margin, currentY);
-  currentY += lines.length * 5 + 10;
-
-  // Verifica se há dados de gráfico e captura
-  const chartDataMatch = content.match(/__CHART_DATA__([\s\S]*?)__END_CHART_DATA__/);
-  if (chartDataMatch && chartContainer) {
-    try {
-      const canvas = await html2canvas(chartContainer, {
-        backgroundColor: "#ffffff",
-        scale: 2,
-      });
-      const imgData = canvas.toDataURL("image/png");
-      const imgWidth = maxWidth;
-      const imgHeight = (canvas.height * imgWidth) / canvas.width;
-
-      if (currentY + imgHeight > doc.internal.pageSize.getHeight() - margin) {
-        doc.addPage();
-        currentY = margin;
-      }
-
-      doc.addImage(imgData, "PNG", margin, currentY, imgWidth, imgHeight);
-    } catch (e) {
-      console.error("Error capturing chart:", e);
-    }
-  }
-
-  doc.save("arcadia-resultado.pdf");
-}
-
-export async function exportToWord(content: string, prompt?: string) {
-  const { Document, Packer, Paragraph, TextRun } = await import("docx");
-  const { saveAs } = await import("file-saver");
-
-  const paragraphs = [];
-
-  paragraphs.push(
-    new Paragraph({
-      children: [new TextRun({ text: "Arcádia Agent - Resultado", bold: true, size: 32 })],
-    })
-  );
-
-  if (prompt) {
-    paragraphs.push(
-      new Paragraph({ children: [] }),
-      new Paragraph({
-        children: [new TextRun({ text: "Tarefa: ", bold: true }), new TextRun({ text: prompt })],
-      })
-    );
-  }
-
-  paragraphs.push(
-    new Paragraph({ children: [] }),
-    new Paragraph({
-      children: [new TextRun({ text: "Resposta:", bold: true })],
-    })
-  );
-
-  content.split("\n").forEach((line) => {
-    paragraphs.push(new Paragraph({ children: [new TextRun({ text: line })] }));
-  });
-
-  const doc = new Document({
-    sections: [{ properties: {}, children: paragraphs }],
-  });
-
-  const blob = await Packer.toBlob(doc);
-  saveAs(blob, "arcadia-resultado.docx");
-}
-
-export async function exportToText(content: string, prompt?: string) {
-  const { saveAs } = await import("file-saver");
-  const textContent = prompt ? `Tarefa: ${prompt}\n\nResposta:\n${content}` : content;
-  const blob = new Blob([textContent], { type: "text/plain;charset=utf-8" });
-  saveAs(blob, "arcadia-resultado.txt");
-}
-
-export async function exportToCSV(content: string) {
-  const { saveAs } = await import("file-saver");
-  const lines = content.split("\n");
-  let csvContent = "";
-
-  for (const line of lines) {
-    if (line.includes("|")) {
-      const cells = line
-        .split("|")
-        .map((cell) => cell.trim())
-        .filter((cell) => cell && !cell.match(/^[-:]+$/));
-      if (cells.length > 0) {
-        csvContent += cells.map((cell) => `"${cell.replace(/"/g, """)}"`).join(",") + "\n";
-      }
-    } else if (line.includes("\t")) {
-      csvContent +=
-        line
-          .split("\t")
-          .map((cell) => `"${cell.trim().replace(/"/g, """)}"`)
-          .join(",") + "\n";
-    } else if (line.trim()) {
-      csvContent += `"${line.replace(/"/g, """)}"\n`;
-    }
-  }
-
-  const blob = new Blob([csvContent], { type: "text/csv;charset=utf-8" });
-  saveAs(blob, "arcadia-resultado.csv");
-}

client/src/lib/protected-route.tsx

@@ -7,7 +7,7 @@ export function ProtectedRoute({
   component: Component,
 }: {
   path: string;
-  component: React.ComponentType<any>;
+  component: () => React.JSX.Element;
 }) {
   const { user, isLoading } = useAuth();
 

client/src/pages/Agent.tsx

@@ -54,10 +54,13 @@ import {
 } from "lucide-react";
 import { CardDescription } from "@/components/ui/card";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
+import { jsPDF } from "jspdf";
+import { Document, Packer, Paragraph, TextRun } from "docx";
+import { saveAs } from "file-saver";
+import html2canvas from "html2canvas";
+import { BarChart, Bar, LineChart, Line, PieChart, Pie, AreaChart, Area, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ResponsiveContainer, Cell } from "recharts";
 import { ResultViewer } from "@/components/ResultViewer";
 import DevHistory from "@/components/DevHistory";
-import { ChartRenderer } from "@/components/ChartRenderer";
-import { exportToPDF, exportToWord, exportToText, exportToCSV } from "@/lib/export-utils";
 
 interface ChartData {
   type: 'bar' | 'line' | 'pie' | 'area';

client/src/pages/AutomationCenter.tsx

@@ -1,267 +0,0 @@
-/**
- * AutomationCenter — Phase 5: Automation Fabric
- *
- * Visão unificada de todas as automações: Central + XOS.
- * Rota: /automations-center
- */
-
-import { useState } from "react";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import { Button } from "@/components/ui/button";
-import { Badge } from "@/components/ui/badge";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
-import { ScrollArea } from "@/components/ui/scroll-area";
-import {
-  Zap, Search, Play, Loader2, CheckCircle, XCircle,
-  Clock, Webhook, Bot, Calendar, Activity, Filter
-} from "lucide-react";
-import { useToast } from "@/hooks/use-toast";
-
-interface UnifiedAutomation {
-  id: string;
-  sourceId: number;
-  source: "central" | "xos";
-  name: string;
-  description: string | null;
-  triggerType: string;
-  isActive: boolean;
-  executionCount: number;
-  lastExecutedAt: string | null;
-  createdAt: string;
-}
-
-const TRIGGER_ICONS: Record<string, React.ReactNode> = {
-  schedule: <Clock className="w-3.5 h-3.5" />,
-  webhook: <Webhook className="w-3.5 h-3.5" />,
-  agent: <Bot className="w-3.5 h-3.5" />,
-  event: <Activity className="w-3.5 h-3.5" />,
-  contact_created: <Zap className="w-3.5 h-3.5" />,
-  deal_stage_changed: <Zap className="w-3.5 h-3.5" />,
-  form_submitted: <Zap className="w-3.5 h-3.5" />,
-};
-
-const TRIGGER_LABEL: Record<string, string> = {
-  schedule: "Agendada",
-  webhook: "Webhook",
-  manual: "Manual",
-  event: "Evento",
-  agent: "Agente",
-  contact_created: "Novo Contato",
-  deal_stage_changed: "Mudança de Etapa",
-  form_submitted: "Formulário",
-};
-
-export default function AutomationCenter() {
-  const [search, setSearch] = useState("");
-  const [filterSource, setFilterSource] = useState<"all" | "central" | "xos">("all");
-  const [filterStatus, setFilterStatus] = useState<"all" | "active" | "inactive">("all");
-  const { toast } = useToast();
-  const qc = useQueryClient();
-
-  const { data, isLoading } = useQuery<{ automations: UnifiedAutomation[]; total: number }>({
-    queryKey: ["/api/automation-fabric/list"],
-    refetchInterval: 30_000,
-  });
-
-  const runMutation = useMutation({
-    mutationFn: async (id: string) => {
-      const res = await fetch(`/api/automation-fabric/${encodeURIComponent(id)}/run`, { method: "POST" });
-      if (!res.ok) throw new Error();
-      return res.json();
-    },
-    onSuccess: (_, id) => {
-      toast({ title: "Automação executada" });
-      qc.invalidateQueries({ queryKey: ["/api/automation-fabric/list"] });
-    },
-    onError: () => toast({ title: "Erro ao executar", variant: "destructive" }),
-  });
-
-  const toggleMutation = useMutation({
-    mutationFn: async ({ id, isActive }: { id: string; isActive: boolean }) => {
-      const res = await fetch(`/api/automation-fabric/${encodeURIComponent(id)}/toggle`, {
-        method: "PATCH",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ isActive }),
-      });
-      if (!res.ok) throw new Error();
-      return res.json();
-    },
-    onSuccess: () => qc.invalidateQueries({ queryKey: ["/api/automation-fabric/list"] }),
-    onError: () => toast({ title: "Erro ao atualizar status", variant: "destructive" }),
-  });
-
-  const automations = data?.automations ?? [];
-
-  const filtered = automations.filter((a) => {
-    if (filterSource !== "all" && a.source !== filterSource) return false;
-    if (filterStatus === "active" && !a.isActive) return false;
-    if (filterStatus === "inactive" && a.isActive) return false;
-    if (search) {
-      const q = search.toLowerCase();
-      return (
-        a.name.toLowerCase().includes(q) ||
-        (a.description ?? "").toLowerCase().includes(q) ||
-        a.triggerType.toLowerCase().includes(q)
-      );
-    }
-    return true;
-  });
-
-  const activeCount = automations.filter((a) => a.isActive).length;
-  const centralCount = automations.filter((a) => a.source === "central").length;
-  const xosCount = automations.filter((a) => a.source === "xos").length;
-
-  return (
-    <BrowserFrame>
-      <div className="flex flex-col h-full bg-[#0a0f1a] text-white">
-
-        {/* Header */}
-        <div className="flex items-center justify-between p-4 border-b border-white/10">
-          <div>
-            <h1 className="text-lg font-semibold flex items-center gap-2">
-              <Zap className="w-5 h-5 text-[#c89b3c]" />
-              Automation Center
-            </h1>
-            <p className="text-xs text-muted-foreground mt-0.5">
-              {automations.length} automações · {activeCount} ativas · Central ({centralCount}) + XOS ({xosCount})
-            </p>
-          </div>
-        </div>
-
-        {/* Filters */}
-        <div className="flex gap-2 p-3 border-b border-white/10 flex-wrap">
-          <div className="relative flex-1 min-w-48">
-            <Search className="absolute left-2.5 top-2.5 w-3.5 h-3.5 text-muted-foreground" />
-            <Input
-              placeholder="Buscar automações..."
-              value={search}
-              onChange={(e) => setSearch(e.target.value)}
-              className="pl-8 h-8 text-sm bg-white/5 border-white/10"
-            />
-          </div>
-
-          {/* Source filter */}
-          <div className="flex rounded-md border border-white/10 overflow-hidden">
-            {(["all", "central", "xos"] as const).map((s) => (
-              <button
-                key={s}
-                onClick={() => setFilterSource(s)}
-                className={`px-2.5 py-1.5 text-xs transition-colors ${
-                  filterSource === s ? "bg-[#c89b3c] text-black font-medium" : "text-white/50 hover:text-white hover:bg-white/5"
-                }`}
-              >
-                {s === "all" ? "Todas" : s === "central" ? "Central" : "XOS"}
-              </button>
-            ))}
-          </div>
-
-          {/* Status filter */}
-          <div className="flex rounded-md border border-white/10 overflow-hidden">
-            {(["all", "active", "inactive"] as const).map((s) => (
-              <button
-                key={s}
-                onClick={() => setFilterStatus(s)}
-                className={`px-2.5 py-1.5 text-xs transition-colors ${
-                  filterStatus === s ? "bg-[#c89b3c] text-black font-medium" : "text-white/50 hover:text-white hover:bg-white/5"
-                }`}
-              >
-                {s === "all" ? "Todas" : s === "active" ? "Ativas" : "Inativas"}
-              </button>
-            ))}
-          </div>
-        </div>
-
-        {/* List */}
-        <ScrollArea className="flex-1">
-          {isLoading && (
-            <div className="flex justify-center py-16">
-              <Loader2 className="w-6 h-6 animate-spin text-white/30" />
-            </div>
-          )}
-
-          {!isLoading && filtered.length === 0 && (
-            <div className="flex flex-col items-center justify-center py-20 text-white/30 gap-3">
-              <Filter className="w-10 h-10 opacity-30" />
-              <p className="text-sm">Nenhuma automação encontrada</p>
-              {search && <p className="text-xs">Tente outro filtro ou busca</p>}
-            </div>
-          )}
-
-          <div className="divide-y divide-white/5">
-            {filtered.map((a) => {
-              const isRunning = runMutation.isPending && runMutation.variables === a.id;
-              const isToggling = toggleMutation.isPending && toggleMutation.variables?.id === a.id;
-              const triggerIcon = TRIGGER_ICONS[a.triggerType] ?? <Zap className="w-3.5 h-3.5" />;
-              const triggerLabel = TRIGGER_LABEL[a.triggerType] ?? a.triggerType;
-              const lastRun = a.lastExecutedAt
-                ? new Date(a.lastExecutedAt).toLocaleDateString("pt-BR")
-                : null;
-
-              return (
-                <div key={a.id} className="px-4 py-3 flex items-center gap-3 hover:bg-white/3 transition-colors">
-
-                  {/* Icon */}
-                  <div className={`w-8 h-8 rounded-lg flex items-center justify-center flex-shrink-0 ${a.isActive ? "bg-[#c89b3c]/15 text-[#c89b3c]" : "bg-white/5 text-white/30"}`}>
-                    {triggerIcon}
-                  </div>
-
-                  {/* Info */}
-                  <div className="flex-1 min-w-0">
-                    <div className="flex items-center gap-2">
-                      <span className="text-sm font-medium truncate">{a.name}</span>
-                      <Badge
-                        className={`text-[9px] px-1.5 py-0 shrink-0 ${
-                          a.source === "central"
-                            ? "bg-blue-500/15 text-blue-400 border-blue-500/20"
-                            : "bg-purple-500/15 text-purple-400 border-purple-500/20"
-                        }`}
-                      >
-                        {a.source === "central" ? "Central" : "XOS"}
-                      </Badge>
-                    </div>
-                    <div className="flex items-center gap-3 mt-0.5">
-                      <span className="text-[11px] text-white/40 flex items-center gap-1">
-                        {triggerIcon} {triggerLabel}
-                      </span>
-                      {a.executionCount > 0 && (
-                        <span className="text-[11px] text-white/30">{a.executionCount}x</span>
-                      )}
-                      {lastRun && (
-                        <span className="text-[11px] text-white/30 flex items-center gap-1">
-                          <Calendar className="w-3 h-3" /> {lastRun}
-                        </span>
-                      )}
-                    </div>
-                  </div>
-
-                  {/* Actions */}
-                  <div className="flex items-center gap-2 shrink-0">
-                    <Button
-                      size="sm"
-                      variant="ghost"
-                      className="h-7 w-7 p-0 text-white/40 hover:text-white hover:bg-white/10"
-                      onClick={() => runMutation.mutate(a.id)}
-                      disabled={isRunning || !a.isActive}
-                      title="Executar agora"
-                    >
-                      {isRunning ? <Loader2 className="w-3.5 h-3.5 animate-spin" /> : <Play className="w-3.5 h-3.5" />}
-                    </Button>
-
-                    <Switch
-                      checked={a.isActive}
-                      disabled={isToggling}
-                      onCheckedChange={(v) => toggleMutation.mutate({ id: a.id, isActive: v })}
-                      className="scale-75"
-                    />
-                  </div>
-                </div>
-              );
-            })}
-          </div>
-        </ScrollArea>
-      </div>
-    </BrowserFrame>
-  );
-}

client/src/pages/BiWorkspace.tsx

@@ -1,5 +1,5 @@
 import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import { useState, useEffect } from "react";
+import { useState } from "react";
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
@@ -49,8 +49,6 @@ import {
   MessageSquare,
 } from "lucide-react";
 import { Textarea } from "@/components/ui/textarea";
-import { SupersetDashboard } from "@/components/SupersetDashboard";
-import { MiroFlowControl } from "@/components/MiroFlowControl";
 import {
   Dialog,
   DialogContent,
@@ -83,73 +81,6 @@ import {
   Cell,
 } from "recharts";
 
-// ── Componente da aba Insights (Apache Superset) ──────────────────────────────
-function SupersetAdvancedTab() {
-  const [selectedDashboard, setSelectedDashboard] = useState<string>("");
-  const [dashboards, setDashboards] = useState<Array<{ id: string; title: string }>>([]);
-
-  useEffect(() => {
-    fetch("/api/superset/dashboards", { credentials: "include" })
-      .then(r => r.json())
-      .then(data => {
-        if (Array.isArray(data)) {
-          setDashboards(data.map((d: any) => ({ id: String(d.id), title: d.dashboard_title || d.title })));
-          if (data.length > 0) setSelectedDashboard(String(data[0].id));
-        }
-      })
-      .catch(() => setDashboards([]));
-  }, []);
-
-  return (
-    <div className="space-y-4">
-      <div className="flex items-center justify-between flex-wrap gap-3">
-        <div>
-          <h2 className="text-lg font-semibold text-[#1f334d]">Arcádia Insights — Apache Superset</h2>
-          <p className="text-sm text-gray-500">SQL Lab avançado, 50+ tipos de gráfico, dashboards interativos</p>
-        </div>
-        <div className="flex items-center gap-2">
-          {dashboards.length > 0 && (
-            <select
-              value={selectedDashboard}
-              onChange={e => setSelectedDashboard(e.target.value)}
-              className="text-sm border border-gray-200 rounded-lg px-3 py-2 bg-white text-[#1f334d] focus:outline-none focus:ring-2 focus:ring-[#c89b3c]"
-            >
-              {dashboards.map(d => (
-                <option key={d.id} value={d.id}>{d.title}</option>
-              ))}
-            </select>
-          )}
-          <a
-            href="/superset"
-            target="_blank"
-            rel="noopener noreferrer"
-            className="inline-flex items-center gap-2 px-4 py-2 bg-[#1f334d] text-white rounded-lg hover:bg-[#2a4466] transition-colors text-sm"
-          >
-            <ArrowRight className="w-4 h-4" /> Abrir completo
-          </a>
-        </div>
-      </div>
-
-      {selectedDashboard ? (
-        <SupersetDashboard
-          dashboardId={selectedDashboard}
-          height="calc(100vh - 320px)"
-          showOpenLink={false}
-        />
-      ) : (
-        <div className="rounded-xl overflow-hidden border border-[#c89b3c]/20 bg-white shadow-sm" style={{ height: "calc(100vh - 320px)" }}>
-          <iframe
-            src="/superset"
-            className="w-full h-full border-0"
-            title="Arcádia Insights — Apache Superset"
-            allow="fullscreen"
-          />
-        </div>
-      )}
-    </div>
-  );
-}
-
 interface BiStats {
   dataSources: number;
   datasets: number;
@@ -2958,11 +2889,8 @@ export default function BiWorkspace() {
               <TabsTrigger value="staging" className="data-[state=active]:bg-[#c89b3c] data-[state=active]:text-[#1f334d] text-white/70">
                 <Layers className="w-4 h-4 mr-2" /> Staging
               </TabsTrigger>
-              <TabsTrigger value="cientifico" className="data-[state=active]:bg-[#c89b3c] data-[state=active]:text-[#1f334d] text-white/70">
-                Científico
-              </TabsTrigger>
               <TabsTrigger value="advanced" className="data-[state=active]:bg-[#c89b3c] data-[state=active]:text-[#1f334d] text-white/70">
-                <Settings className="w-4 h-4 mr-2" /> Insights
+                <Settings className="w-4 h-4 mr-2" /> MetaSet
               </TabsTrigger>
             </TabsList>
 
@@ -2987,12 +2915,33 @@ export default function BiWorkspace() {
             <TabsContent value="staging" className="mt-0">
               <StagingTab />
             </TabsContent>
-            <TabsContent value="cientifico" className="mt-0">
-              <MiroFlowControl />
-            </TabsContent>
             <TabsContent value="advanced" className="mt-0">
-              <SupersetAdvancedTab />
+              <div className="space-y-4">
-
+                <div className="flex items-center justify-between">
+                  <div>
+                    <h2 className="text-lg font-semibold text-[#1f334d]">MetaSet - Motor de BI</h2>
+                    <p className="text-sm text-gray-500">Acesso completo para criação manual de consultas SQL, gráficos e dashboards</p>
+                  </div>
+                  <a
+                    href="/api/bi/metaset/autologin"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="inline-flex items-center gap-2 px-4 py-2 bg-[#1f334d] text-white rounded-lg hover:bg-[#2a4466] transition-colors text-sm"
+                    data-testid="link-open-metaset-external"
+                  >
+                    <ArrowRight className="w-4 h-4" /> Abrir em Nova Aba
+                  </a>
+                </div>
+                <div className="rounded-xl overflow-hidden border border-[#c89b3c]/20 bg-white shadow-sm" style={{ height: 'calc(100vh - 320px)' }}>
+                  <iframe
+                    src="/api/bi/metaset/autologin"
+                    className="w-full h-full border-0"
+                    title="MetaSet - Arcádia Insights"
+                    data-testid="iframe-metaset-advanced"
+                    allow="fullscreen"
+                  />
+                </div>
+              </div>
             </TabsContent>
           </Tabs>
         </div>

client/src/pages/DESIGN_STUDIO.md

@@ -1,29 +0,0 @@
-# Design Studio — Contexto para próximo agente
-
-## O que é
-
-Design Studio é a entrada na sidebar de `/development` (DevelopmentModule.tsx) que abre o `DevCenter.tsx` como painel interno.
-
-## Estado atual (27/03/2026)
-
-O ícone e a navegação estão implementados. O conteúdo renderizado é o `DevCenter.tsx` existente, que já possui 4 abas funcionais:
-
-| Aba | O que faz |
-|-----|-----------|
-| **Design** | Editor de definições de agente (modos: Markdown, TypeScript, Visual-JSON) |
-| **Assemble** | Agentes draft → Blackboard gera o código → polling de status |
-| **Deploy** | Agentes prontos → deploy, re-montar |
-| **Galeria** | Grid de agentes implantados, busca, executar, fork |
-
-## O que FALTA (João tem ideias — perguntar antes de implementar)
-
-- **Visual canvas drag-and-drop** para o modo "Visual" do editor (hoje é um Textarea com JSON manual)
-- **Suporte a UML** no editor de definições
-- O usuário João mencionou ter ideias específicas para o Design Studio — **confirmar com ele antes de implementar qualquer coisa nova aqui**
-
-## Arquivos relacionados
-
-- `client/src/pages/DevCenter.tsx` — componente principal renderizado pelo Design Studio
-- `client/src/pages/DevelopmentModule.tsx` — sidebar onde o item foi adicionado (id: "designstudio", ícone: PenTool)
-- `server/routes/agent-defs.ts` (ou similar) — API de definições de agentes usada pelo DevCenter
-- `migrations/phase6_agent_defs.sql` — schema das tabelas de agent definitions

client/src/pages/DevelopmentModule.tsx

@@ -11,12 +11,12 @@ import { Label } from "@/components/ui/label";
 import { Textarea } from "@/components/ui/textarea";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { useToast } from "@/hooks/use-toast";
-import {
+import { 
   Code2, Database, Layout, GitBranch, BarChart3, FileText,
   Plus, Settings, Play, Zap, Layers, Puzzle, Palette,
   Terminal, Box, Workflow, PanelLeft, Table2, FormInput,
   ListChecks, PieChart, LineChart, Gauge, Bot, Code, Trash2, Save,
-  Sparkles, Rocket, PenTool, Brain
+  Sparkles, Rocket
 } from "lucide-react";
 import { useLocation } from "wouter";
 
@@ -25,12 +25,8 @@ import PageBuilder from "./PageBuilder";
 import WorkflowBuilder from "./WorkflowBuilder";
 import IDE from "./IDE";
 import DevAgent from "@/components/lowcode/DevAgent";
-import OpenClawPanel from "@/components/OpenClawPanel";
-import AutomationCenter from "./AutomationCenter";
-import DevCenter from "./DevCenter";
-import { MiroFlowControl } from "@/components/MiroFlowControl";
 
-type ActiveTool = "home" | "doctypes" | "pages" | "workflows" | "dashboards" | "reports" | "scripts" | "ide" | "agent" | "openclaw" | "automationcenter" | "designstudio" | "miroflow";
+type ActiveTool = "home" | "doctypes" | "pages" | "workflows" | "dashboards" | "reports" | "scripts" | "ide" | "agent";
 
 interface Dashboard {
   id: number;
@@ -254,51 +250,15 @@ export default function DevelopmentModule() {
       count: 0,
       category: "dev"
     },
-    {
+    { 
-      id: "agent" as ActiveTool,
+      id: "agent" as ActiveTool, 
-      name: "Manus AI",
+      name: "Manus AI", 
       description: "Agente autônomo de IA",
-      icon: Bot,
+      icon: Bot, 
       color: "bg-violet-600",
       count: 0,
       category: "dev"
     },
-    {
-      id: "openclaw" as ActiveTool,
-      name: "Skills Emergentes",
-      description: "Padrões detectados automaticamente",
-      icon: Sparkles,
-      color: "bg-yellow-500",
-      count: 0,
-      category: "dev"
-    },
-    {
-      id: "automationcenter" as ActiveTool,
-      name: "Automation Center",
-      description: "Automações unificadas Central + XOS",
-      icon: Workflow,
-      color: "bg-blue-600",
-      count: 0,
-      category: "dev"
-    },
-    {
-      id: "designstudio" as ActiveTool,
-      name: "Design Studio",
-      description: "Projete e monte agentes autônomos",
-      icon: PenTool,
-      color: "bg-purple-600",
-      count: 0,
-      category: "dev"
-    },
-    {
-      id: "miroflow" as ActiveTool,
-      name: "MiroFlow",
-      description: "Análises científicas e estatísticas",
-      icon: Brain,
-      color: "bg-cyan-500",
-      count: 0,
-      category: "scientific"
-    },
   ];
 
   const [, navigate] = useLocation();
@@ -711,8 +671,8 @@ export default function DevelopmentModule() {
   );
 
   return (
-    <div className="h-screen flex bg-gray-50">
+    <div className="h-full flex bg-gray-50">
-      <div className="w-16 bg-gray-900 flex flex-col items-center py-4 gap-2 overflow-y-auto h-full">
+      <div className="w-16 bg-gray-900 flex flex-col items-center py-4 gap-2">
         <button
           onClick={() => setActiveTool("home")}
           className={`p-3 rounded-lg transition-colors ${activeTool === "home" ? "bg-blue-600" : "hover:bg-gray-700"}`}
@@ -735,8 +695,8 @@ export default function DevelopmentModule() {
         ))}
       </div>
 
-      <div className="flex-1 h-full overflow-hidden">
+      <div className="flex-1 overflow-hidden">
-        {activeTool === "home" && <div className="h-full overflow-y-auto">{renderHome()}</div>}
+        {activeTool === "home" && renderHome()}
         {activeTool === "doctypes" && <DocTypeBuilder />}
         {activeTool === "pages" && <PageBuilder />}
         {activeTool === "workflows" && <WorkflowBuilder />}
@@ -745,10 +705,6 @@ export default function DevelopmentModule() {
         {activeTool === "scripts" && renderScriptEditor()}
         {activeTool === "ide" && <IDE />}
         {activeTool === "agent" && <DevAgent />}
-        {activeTool === "openclaw" && <OpenClawPanel />}
-        {activeTool === "automationcenter" && <AutomationCenter />}
-        {activeTool === "designstudio" && <DevCenter />}
-        {activeTool === "miroflow" && <MiroFlowControl />}
       </div>
 
       <Dialog open={showNewDashboardDialog} onOpenChange={setShowNewDashboardDialog}>

client/src/pages/RetailReports.tsx

@@ -1,78 +0,0 @@
-import React, { useState } from "react";
-import { TradeInFiltersWidget } from "../components/retail-reports/TradeInFiltersWidget";
-import { TradeInDetailsModal } from "../components/retail-reports/TradeInDetailsModal";
-import { TradeInPrintButton } from "../components/retail-reports/TradeInPrintButton";
-import { useQuery } from "@tanstack/react-query";
-
-const fetchTradeIns = async (filters) => {
-  const query = new URLSearchParams(filters).toString();
-  const response = await fetch(`/api/modules/retail-reports/trade-ins?${query}`);
-  if (!response.ok) throw new Error("Failed to fetch trade-ins.");
-  return response.json();
-};
-
-export const RetailReportsPage: React.FC = () => {
-  const [filters, setFilters] = useState({});
-  const [selectedTradeIn, setSelectedTradeIn] = useState(null);
-
-  const { data: tradeIns, isLoading, error } = useQuery(["tradeIns", filters], () => fetchTradeIns(filters));
-
-  return (
-    <div className="p-4">
-      <h1 className="text-2xl font-bold mb-4">Retail Trade-In Reports</h1>
-      <TradeInFiltersWidget onApplyFilters={setFilters} data-testid="filters-widget" />
-
-      {isLoading && <p>Loading trade-ins...</p>}
-      {error && <p className="text-red-500">Failed to load trade-ins.</p>}
-
-      <table className="table-auto w-full border-collapse border border-gray-300 mt-4">
-        <thead>
-          <tr>
-            <th className="border border-gray-300 px-4 py-2">ID</th>
-            <th className="border border-gray-300 px-4 py-2">Seller</th>
-            <th className="border border-gray-300 px-4 py-2">Company</th>
-            <th className="border border-gray-300 px-4 py-2">Client</th>
-            <th className="border border-gray-300 px-4 py-2">Date</th>
-            <th className="border border-gray-300 px-4 py-2">Value</th>
-            <th className="border border-gray-300 px-4 py-2">Status</th>
-            <th className="border border-gray-300 px-4 py-2">Actions</th>
-          </tr>
-        </thead>
-        <tbody>
-          {tradeIns?.map((tradeIn) => (
-            <tr key={tradeIn.id}>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.id}</td>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.sellerId}</td>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.companyId}</td>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.clientId}</td>
-              <td className="border border-gray-300 px-4 py-2">{new Date(tradeIn.tradeInDate).toLocaleDateString()}</td>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.tradeInValue}</td>
-              <td className="border border-gray-300 px-4 py-2">{tradeIn.status}</td>
-              <td className="border border-gray-300 px-4 py-2">
-                <button
-                  className="text-blue-500 hover:underline"
-                  onClick={() => setSelectedTradeIn(tradeIn)}
-                  data-testid="view-details-button"
-                >
-                  View Details
-                </button>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-
-      <TradeInPrintButton tradeIns={tradeIns} data-testid="print-button" />
-
-      {selectedTradeIn && (
-        <TradeInDetailsModal
-          tradeIn={selectedTradeIn}
-          onClose={() => setSelectedTradeIn(null)}
-          data-testid="details-modal"
-        />
-      )}
-    </div>
-  );
-};
-
-export default RetailReportsPage;

client/src/pages/SOE.tsx

@@ -1,2 +0,0 @@
-// SOE — Sistema de Operações Empresariais
-export { default } from "./ERP";

client/src/pages/Scientist.tsx

@@ -1,5 +1,4 @@
 import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import { MiroFlowControl } from "@/components/MiroFlowControl";
 import { useState } from "react";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { Button } from "@/components/ui/button";
@@ -201,10 +200,6 @@ export default function Scientist() {
                 <Lightbulb className="w-4 h-4 mr-2" />
                 Sugestões
               </TabsTrigger>
-              <TabsTrigger value="scientific" className="data-[state=active]:bg-cyan-500">
-                <Brain className="w-4 h-4 mr-2" />
-                Científico
-              </TabsTrigger>
             </TabsList>
 
             <TabsContent value="knowledge" className="space-y-4">
@@ -832,10 +827,6 @@ export default function Scientist() {
                 </Card>
               )}
             </TabsContent>
-
-            <TabsContent value="scientific" className="space-y-4">
-              <MiroFlowControl />
-            </TabsContent>
           </Tabs>
         </div>
       </div>

client/src/pages/XosCentral.tsx

@@ -1,12 +1,11 @@
 import { useState } from "react";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useQuery } from "@tanstack/react-query";
 import { Link } from "wouter";
 import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import {
+import { 
-  Users, Building2, TrendingUp, MessageSquare, Ticket, Zap, LayoutGrid,
+  Users, Building2, TrendingUp, MessageSquare, Ticket, Zap, LayoutGrid, 
   ChevronRight, PlusCircle, Filter, Search, Bell, Calendar, Target,
-  BarChart3, DollarSign, Clock, AlertCircle, Phone, Mail, ArrowUpRight,
+  BarChart3, DollarSign, Clock, AlertCircle, Phone, Mail, ArrowUpRight
-  Activity, Hash, Shield
 } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
@@ -14,9 +13,6 @@ import { Input } from "@/components/ui/input";
 import { Badge } from "@/components/ui/badge";
 import { Avatar, AvatarFallback } from "@/components/ui/avatar";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import { Dialog, DialogContent, DialogHeader, DialogTitle } from "@/components/ui/dialog";
-import { Label } from "@/components/ui/label";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 
 interface XosStats {
   total_contacts: number;
@@ -70,48 +66,6 @@ interface Activity {
 
 export default function XosCentral() {
   const [activeTab, setActiveTab] = useState("dashboard");
-  const [isNewContactOpen, setIsNewContactOpen] = useState(false);
-  const [isNewActivityOpen, setIsNewActivityOpen] = useState(false);
-  const [newContact, setNewContact] = useState({ name: "", email: "", phone: "", company: "", position: "" });
-  const [newActivity, setNewActivity] = useState({ type: "task", title: "", due_at: "", priority: "medium" });
-
-  const queryClient = useQueryClient();
-
-  const createContactMutation = useMutation({
-    mutationFn: async (data: typeof newContact) => {
-      const res = await fetch("/api/xos/contacts", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(data),
-      });
-      if (!res.ok) throw new Error("Erro ao criar contato");
-      return res.json();
-    },
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/contacts"] });
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/stats"] });
-      setIsNewContactOpen(false);
-      setNewContact({ name: "", email: "", phone: "", company: "", position: "" });
-    },
-  });
-
-  const createActivityMutation = useMutation({
-    mutationFn: async (data: typeof newActivity) => {
-      const res = await fetch("/api/xos/activities", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(data),
-      });
-      if (!res.ok) throw new Error("Erro ao criar atividade");
-      return res.json();
-    },
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/activities"] });
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/stats"] });
-      setIsNewActivityOpen(false);
-      setNewActivity({ type: "task", title: "", due_at: "", priority: "medium" });
-    },
-  });
 
   const { data: stats } = useQuery<XosStats>({
     queryKey: ["/api/xos/stats"],
@@ -143,9 +97,6 @@ export default function XosCentral() {
     { id: "automations", name: "Automações", icon: Zap, href: "/xos/automations", color: "bg-violet-100 text-violet-600", description: "Workflows automáticos" },
     { id: "campaigns", name: "Campanhas", icon: Target, href: "/xos/campaigns", color: "bg-pink-100 text-pink-600", description: "Marketing automation" },
     { id: "sites", name: "Sites", icon: LayoutGrid, href: "/xos/sites", color: "bg-cyan-100 text-cyan-600", description: "Site builder" },
-    { id: "supervisor", name: "Supervisor", icon: Activity, href: "/xos/supervisor", color: "bg-indigo-100 text-indigo-600", description: "Monitor em tempo real" },
-    { id: "reports", name: "Relatórios", icon: BarChart3, href: "/xos/reports", color: "bg-emerald-100 text-emerald-600", description: "CSAT, SLA e KPIs" },
-    { id: "protocols", name: "Protocolos", icon: Hash, href: "/xos/protocols", color: "bg-teal-100 text-teal-600", description: "Rastreamento de atendimentos" },
   ];
 
   const getStatusColor = (status: string) => {
@@ -226,9 +177,9 @@ export default function XosCentral() {
                   </span>
                 )}
               </Button>
-              <Button data-testid="button-new-contact" onClick={() => setIsNewContactOpen(true)}>
+              <Button data-testid="button-new-contact">
                 <PlusCircle className="h-4 w-4 mr-2" />
-                Novo Contato
+                Novo
               </Button>
             </div>
           </div>
@@ -313,7 +264,7 @@ export default function XosCentral() {
             {/* Modules Grid */}
             <div>
               <h2 className="text-lg font-semibold text-slate-800 mb-4">Módulos XOS</h2>
-              <div className="grid grid-cols-3 md:grid-cols-4 lg:grid-cols-9 gap-4">
+              <div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-6 gap-4">
                 {modules.map((mod) => (
                   <Link key={mod.id} href={mod.href}>
                     <Card className="hover:shadow-lg transition-all cursor-pointer group" data-testid={`card-module-${mod.id}`}>
@@ -455,7 +406,7 @@ export default function XosCentral() {
                       <Filter className="h-4 w-4 mr-2" />
                       Filtros
                     </Button>
-                    <Button size="sm" onClick={() => setIsNewContactOpen(true)}>
+                    <Button size="sm">
                       <PlusCircle className="h-4 w-4 mr-2" />
                       Novo Contato
                     </Button>
@@ -527,7 +478,7 @@ export default function XosCentral() {
               <CardHeader>
                 <div className="flex items-center justify-between">
                   <CardTitle>Atividades</CardTitle>
-                  <Button size="sm" onClick={() => setIsNewActivityOpen(true)}>
+                  <Button size="sm">
                     <PlusCircle className="h-4 w-4 mr-2" />
                     Nova Atividade
                   </Button>
@@ -569,129 +520,6 @@ export default function XosCentral() {
         </Tabs>
       </main>
     </div>
-      {/* Modal: Novo Contato */}
-      <Dialog open={isNewContactOpen} onOpenChange={setIsNewContactOpen}>
-        <DialogContent>
-          <DialogHeader>
-            <DialogTitle>Novo Contato</DialogTitle>
-          </DialogHeader>
-          <div className="space-y-4 py-4">
-            <div className="space-y-2">
-              <Label>Nome *</Label>
-              <Input
-                value={newContact.name}
-                onChange={(e) => setNewContact({ ...newContact, name: e.target.value })}
-                placeholder="Nome do contato"
-              />
-            </div>
-            <div className="space-y-2">
-              <Label>Email</Label>
-              <Input
-                type="email"
-                value={newContact.email}
-                onChange={(e) => setNewContact({ ...newContact, email: e.target.value })}
-                placeholder="email@exemplo.com"
-              />
-            </div>
-            <div className="space-y-2">
-              <Label>Telefone</Label>
-              <Input
-                value={newContact.phone}
-                onChange={(e) => setNewContact({ ...newContact, phone: e.target.value })}
-                placeholder="(00) 00000-0000"
-              />
-            </div>
-            <div className="grid grid-cols-2 gap-4">
-              <div className="space-y-2">
-                <Label>Empresa</Label>
-                <Input
-                  value={newContact.company}
-                  onChange={(e) => setNewContact({ ...newContact, company: e.target.value })}
-                  placeholder="Empresa"
-                />
-              </div>
-              <div className="space-y-2">
-                <Label>Cargo</Label>
-                <Input
-                  value={newContact.position}
-                  onChange={(e) => setNewContact({ ...newContact, position: e.target.value })}
-                  placeholder="Cargo"
-                />
-              </div>
-            </div>
-            <Button
-              className="w-full"
-              onClick={() => createContactMutation.mutate(newContact)}
-              disabled={!newContact.name || createContactMutation.isPending}
-            >
-              {createContactMutation.isPending ? "Salvando..." : "Criar Contato"}
-            </Button>
-          </div>
-        </DialogContent>
-      </Dialog>
-
-      {/* Modal: Nova Atividade */}
-      <Dialog open={isNewActivityOpen} onOpenChange={setIsNewActivityOpen}>
-        <DialogContent>
-          <DialogHeader>
-            <DialogTitle>Nova Atividade</DialogTitle>
-          </DialogHeader>
-          <div className="space-y-4 py-4">
-            <div className="space-y-2">
-              <Label>Título *</Label>
-              <Input
-                value={newActivity.title}
-                onChange={(e) => setNewActivity({ ...newActivity, title: e.target.value })}
-                placeholder="Descrição da atividade"
-              />
-            </div>
-            <div className="grid grid-cols-2 gap-4">
-              <div className="space-y-2">
-                <Label>Tipo</Label>
-                <Select value={newActivity.type} onValueChange={(v) => setNewActivity({ ...newActivity, type: v })}>
-                  <SelectTrigger>
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent>
-                    <SelectItem value="task">Tarefa</SelectItem>
-                    <SelectItem value="call">Ligação</SelectItem>
-                    <SelectItem value="email">E-mail</SelectItem>
-                    <SelectItem value="meeting">Reunião</SelectItem>
-                  </SelectContent>
-                </Select>
-              </div>
-              <div className="space-y-2">
-                <Label>Prioridade</Label>
-                <Select value={newActivity.priority} onValueChange={(v) => setNewActivity({ ...newActivity, priority: v })}>
-                  <SelectTrigger>
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent>
-                    <SelectItem value="low">Baixa</SelectItem>
-                    <SelectItem value="medium">Média</SelectItem>
-                    <SelectItem value="high">Alta</SelectItem>
-                  </SelectContent>
-                </Select>
-              </div>
-            </div>
-            <div className="space-y-2">
-              <Label>Data prevista</Label>
-              <Input
-                type="datetime-local"
-                value={newActivity.due_at}
-                onChange={(e) => setNewActivity({ ...newActivity, due_at: e.target.value })}
-              />
-            </div>
-            <Button
-              className="w-full"
-              onClick={() => createActivityMutation.mutate(newActivity)}
-              disabled={!newActivity.title || createActivityMutation.isPending}
-            >
-              {createActivityMutation.isPending ? "Salvando..." : "Criar Atividade"}
-            </Button>
-          </div>
-        </DialogContent>
-      </Dialog>
     </BrowserFrame>
   );
 }

client/src/pages/XosProtocols.tsx

@@ -1,506 +0,0 @@
-import { useState } from "react";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { Link } from "wouter";
-import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import {
-  Hash, Search, Filter, ArrowLeft, CheckCircle2, Clock, AlertTriangle,
-  Plus, Star, Shield, Copy, ChevronRight, User, Inbox
-} from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
-import { Badge } from "@/components/ui/badge";
-import { Input } from "@/components/ui/input";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
-import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from "@/components/ui/dialog";
-import { Label } from "@/components/ui/label";
-import { Textarea } from "@/components/ui/textarea";
-import { useToast } from "@/hooks/use-toast";
-
-interface Protocol {
-  id: number;
-  protocol_number: string;
-  status: "open" | "resolved" | "cancelled";
-  subject: string | null;
-  contact_name: string | null;
-  queue_name: string | null;
-  assigned_to: string | null;
-  sla_deadline: string | null;
-  sla_breach: boolean;
-  satisfaction_score: number | null;
-  opened_at: string;
-  resolved_at: string | null;
-  conversation_id: number | null;
-  ticket_id: number | null;
-}
-
-export default function XosProtocols() {
-  const [search, setSearch] = useState("");
-  const [statusFilter, setStatusFilter] = useState("all");
-  const [selectedProtocol, setSelectedProtocol] = useState<Protocol | null>(null);
-  const [showNewDialog, setShowNewDialog] = useState(false);
-  const [newForm, setNewForm] = useState({ subject: "", contactId: "", queueId: "", slaMinutes: "" });
-  const [csatDialog, setCsatDialog] = useState<{ open: boolean; protocol: Protocol | null }>({ open: false, protocol: null });
-  const [csatScore, setCsatScore] = useState(5);
-  const [csatComment, setCsatComment] = useState("");
-
-  const queryClient = useQueryClient();
-  const { toast } = useToast();
-
-  const { data: protocols = [], isLoading } = useQuery<Protocol[]>({
-    queryKey: ["/api/xos/protocols", search, statusFilter],
-    queryFn: async () => {
-      const params = new URLSearchParams();
-      if (search) params.set("search", search);
-      if (statusFilter !== "all") params.set("status", statusFilter);
-      const res = await fetch(`/api/xos/protocols?${params}`);
-      return res.json();
-    },
-  });
-
-  const createProtocol = useMutation({
-    mutationFn: async (data: typeof newForm) => {
-      const res = await fetch("/api/xos/protocols", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          subject: data.subject || null,
-          contactId: data.contactId ? parseInt(data.contactId) : null,
-          queueId: data.queueId ? parseInt(data.queueId) : null,
-          slaMinutes: data.slaMinutes ? parseInt(data.slaMinutes) : null,
-        }),
-      });
-      if (!res.ok) throw new Error("Falha ao criar protocolo");
-      return res.json();
-    },
-    onSuccess: (prot) => {
-      toast({ title: "Protocolo criado", description: `Número: ${prot.protocol_number}` });
-      setShowNewDialog(false);
-      setNewForm({ subject: "", contactId: "", queueId: "", slaMinutes: "" });
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/protocols"] });
-    },
-    onError: () => toast({ title: "Erro ao criar protocolo", variant: "destructive" }),
-  });
-
-  const updateProtocol = useMutation({
-    mutationFn: async ({ id, status }: { id: number; status: string }) => {
-      const res = await fetch(`/api/xos/protocols/${id}`, {
-        method: "PATCH",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ status }),
-      });
-      return res.json();
-    },
-    onSuccess: () => {
-      toast({ title: "Protocolo atualizado" });
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/protocols"] });
-      setSelectedProtocol(null);
-    },
-  });
-
-  const submitCsat = useMutation({
-    mutationFn: async ({ protocol, score, comment }: { protocol: Protocol; score: number; comment: string }) => {
-      const endpoint = protocol.conversation_id
-        ? `/api/xos/conversations/${protocol.conversation_id}/csat`
-        : protocol.ticket_id
-          ? `/api/xos/tickets/${protocol.ticket_id}/csat`
-          : null;
-      if (!endpoint) throw new Error("Sem conversa ou ticket vinculado");
-      const res = await fetch(endpoint, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ score, comment }),
-      });
-      if (!res.ok) throw new Error("Falha ao registrar CSAT");
-      return res.json();
-    },
-    onSuccess: () => {
-      toast({ title: "Avaliação registrada!", description: "CSAT salvo com sucesso." });
-      setCsatDialog({ open: false, protocol: null });
-      setCsatScore(5);
-      setCsatComment("");
-      queryClient.invalidateQueries({ queryKey: ["/api/xos/protocols"] });
-    },
-    onError: (e: any) => toast({ title: "Erro", description: e.message, variant: "destructive" }),
-  });
-
-  const getStatusConfig = (status: string) => ({
-    open: { label: "Aberto", color: "bg-blue-100 text-blue-700", icon: Clock },
-    resolved: { label: "Resolvido", color: "bg-emerald-100 text-emerald-700", icon: CheckCircle2 },
-    cancelled: { label: "Cancelado", color: "bg-slate-100 text-slate-600", icon: AlertTriangle },
-  }[status] || { label: status, color: "bg-slate-100 text-slate-600", icon: Clock });
-
-  const isSlaBreached = (p: Protocol) => {
-    if (p.sla_breach) return true;
-    if (p.status !== "open" || !p.sla_deadline) return false;
-    return new Date(p.sla_deadline) < new Date();
-  };
-
-  const getSlaTimeLeft = (deadline: string) => {
-    const diff = new Date(deadline).getTime() - Date.now();
-    if (diff < 0) return null;
-    const h = Math.floor(diff / 3600000);
-    const m = Math.floor((diff % 3600000) / 60000);
-    return h > 0 ? `${h}h ${m}m` : `${m}m`;
-  };
-
-  const copyProtocol = (number: string) => {
-    navigator.clipboard.writeText(number);
-    toast({ title: "Copiado!", description: number });
-  };
-
-  const open = protocols.filter(p => p.status === "open").length;
-  const resolved = protocols.filter(p => p.status === "resolved").length;
-  const breached = protocols.filter(p => isSlaBreached(p)).length;
-
-  return (
-    <BrowserFrame>
-      <div className="min-h-screen bg-slate-50">
-        {/* Header */}
-        <header className="sticky top-0 z-50 bg-white border-b shadow-sm">
-          <div className="max-w-7xl mx-auto px-4 py-3">
-            <div className="flex items-center justify-between">
-              <div className="flex items-center gap-3">
-                <Link href="/xos">
-                  <Button variant="ghost" size="icon">
-                    <ArrowLeft className="h-4 w-4" />
-                  </Button>
-                </Link>
-                <div className="bg-gradient-to-br from-teal-600 to-cyan-700 p-2 rounded-xl">
-                  <Hash className="h-5 w-5 text-white" />
-                </div>
-                <div>
-                  <h1 className="text-xl font-bold text-slate-800">Protocolos</h1>
-                  <p className="text-xs text-slate-500">Rastreamento de atendimentos</p>
-                </div>
-              </div>
-              <Button onClick={() => setShowNewDialog(true)}>
-                <Plus className="h-4 w-4 mr-2" />
-                Novo Protocolo
-              </Button>
-            </div>
-          </div>
-        </header>
-
-        <main className="max-w-7xl mx-auto px-4 py-6 space-y-6">
-          {/* Stats */}
-          <div className="grid grid-cols-3 gap-4">
-            <Card className="bg-gradient-to-br from-blue-500 to-blue-600 text-white">
-              <CardContent className="p-4 flex items-center gap-3">
-                <Clock className="h-8 w-8 text-blue-200" />
-                <div>
-                  <p className="text-blue-100 text-sm">Abertos</p>
-                  <p className="text-2xl font-bold">{open}</p>
-                </div>
-              </CardContent>
-            </Card>
-            <Card className="bg-gradient-to-br from-emerald-500 to-emerald-600 text-white">
-              <CardContent className="p-4 flex items-center gap-3">
-                <CheckCircle2 className="h-8 w-8 text-emerald-200" />
-                <div>
-                  <p className="text-emerald-100 text-sm">Resolvidos</p>
-                  <p className="text-2xl font-bold">{resolved}</p>
-                </div>
-              </CardContent>
-            </Card>
-            <Card className={`text-white ${breached > 0 ? "bg-gradient-to-br from-red-500 to-red-600" : "bg-gradient-to-br from-slate-500 to-slate-600"}`}>
-              <CardContent className="p-4 flex items-center gap-3">
-                <AlertTriangle className="h-8 w-8 opacity-70" />
-                <div>
-                  <p className="opacity-80 text-sm">SLA Violado</p>
-                  <p className="text-2xl font-bold">{breached}</p>
-                </div>
-              </CardContent>
-            </Card>
-          </div>
-
-          {/* Filters */}
-          <div className="flex gap-3">
-            <div className="relative flex-1">
-              <Search className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-slate-400" />
-              <Input
-                placeholder="Buscar por número ou assunto..."
-                className="pl-10"
-                value={search}
-                onChange={e => setSearch(e.target.value)}
-              />
-            </div>
-            <Select value={statusFilter} onValueChange={setStatusFilter}>
-              <SelectTrigger className="w-44">
-                <Filter className="h-4 w-4 mr-2" />
-                <SelectValue />
-              </SelectTrigger>
-              <SelectContent>
-                <SelectItem value="all">Todos</SelectItem>
-                <SelectItem value="open">Abertos</SelectItem>
-                <SelectItem value="resolved">Resolvidos</SelectItem>
-                <SelectItem value="cancelled">Cancelados</SelectItem>
-              </SelectContent>
-            </Select>
-          </div>
-
-          {/* List */}
-          {isLoading ? (
-            <div className="flex justify-center py-16">
-              <div className="w-8 h-8 border-4 border-blue-600 border-t-transparent rounded-full animate-spin" />
-            </div>
-          ) : protocols.length === 0 ? (
-            <Card>
-              <CardContent className="py-16 text-center">
-                <Inbox className="h-12 w-12 mx-auto mb-3 text-slate-300" />
-                <p className="text-slate-500">Nenhum protocolo encontrado</p>
-                <Button className="mt-4" onClick={() => setShowNewDialog(true)}>
-                  <Plus className="h-4 w-4 mr-2" /> Criar Protocolo
-                </Button>
-              </CardContent>
-            </Card>
-          ) : (
-            <div className="space-y-2">
-              {protocols.map(protocol => {
-                const statusCfg = getStatusConfig(protocol.status);
-                const StatusIcon = statusCfg.icon;
-                const breached = isSlaBreached(protocol);
-                const slaLeft = protocol.sla_deadline && protocol.status === "open" ? getSlaTimeLeft(protocol.sla_deadline) : null;
-
-                return (
-                  <Card
-                    key={protocol.id}
-                    className={`hover:shadow-md transition-all cursor-pointer ${breached ? "border-red-300 bg-red-50" : ""}`}
-                    onClick={() => setSelectedProtocol(protocol)}
-                  >
-                    <CardContent className="p-4">
-                      <div className="flex items-center gap-4">
-                        <div className="flex-shrink-0">
-                          <StatusIcon className={`h-5 w-5 ${protocol.status === "resolved" ? "text-emerald-500" : protocol.status === "cancelled" ? "text-slate-400" : "text-blue-500"}`} />
-                        </div>
-                        <div className="flex-1 min-w-0">
-                          <div className="flex items-center gap-2 flex-wrap">
-                            <button
-                              className="font-mono font-semibold text-slate-800 hover:text-blue-600 flex items-center gap-1"
-                              onClick={e => { e.stopPropagation(); copyProtocol(protocol.protocol_number); }}
-                            >
-                              #{protocol.protocol_number}
-                              <Copy className="h-3 w-3 opacity-50" />
-                            </button>
-                            <Badge className={statusCfg.color}>{statusCfg.label}</Badge>
-                            {breached && <Badge className="bg-red-100 text-red-700">SLA Violado</Badge>}
-                            {protocol.satisfaction_score && (
-                              <Badge className="bg-yellow-100 text-yellow-700">
-                                <Star className="h-3 w-3 mr-1 fill-current" />
-                                {protocol.satisfaction_score}/5
-                              </Badge>
-                            )}
-                          </div>
-                          <p className="text-sm text-slate-600 mt-1 truncate">{protocol.subject || "Sem assunto"}</p>
-                          <div className="flex items-center gap-3 mt-1 text-xs text-slate-500">
-                            {protocol.contact_name && (
-                              <span className="flex items-center gap-1">
-                                <User className="h-3 w-3" /> {protocol.contact_name}
-                              </span>
-                            )}
-                            {protocol.queue_name && (
-                              <span>{protocol.queue_name}</span>
-                            )}
-                            <span>{new Date(protocol.opened_at).toLocaleDateString("pt-BR")}</span>
-                          </div>
-                        </div>
-                        <div className="flex-shrink-0 text-right">
-                          {slaLeft && (
-                            <p className="text-xs text-emerald-600 font-medium flex items-center gap-1 justify-end">
-                              <Shield className="h-3 w-3" />
-                              {slaLeft} restante
-                            </p>
-                          )}
-                          {breached && protocol.status === "open" && (
-                            <p className="text-xs text-red-600 font-medium">SLA vencido</p>
-                          )}
-                          <ChevronRight className="h-4 w-4 text-slate-400 mt-1 ml-auto" />
-                        </div>
-                      </div>
-                    </CardContent>
-                  </Card>
-                );
-              })}
-            </div>
-          )}
-        </main>
-
-        {/* Protocol detail dialog */}
-        {selectedProtocol && (
-          <Dialog open onOpenChange={() => setSelectedProtocol(null)}>
-            <DialogContent className="max-w-lg">
-              <DialogHeader>
-                <DialogTitle className="flex items-center gap-2">
-                  <Hash className="h-5 w-5 text-teal-600" />
-                  Protocolo #{selectedProtocol.protocol_number}
-                </DialogTitle>
-              </DialogHeader>
-              <div className="space-y-4">
-                <div className="grid grid-cols-2 gap-3">
-                  <div>
-                    <p className="text-xs text-slate-500">Status</p>
-                    <Badge className={getStatusConfig(selectedProtocol.status).color}>
-                      {getStatusConfig(selectedProtocol.status).label}
-                    </Badge>
-                  </div>
-                  <div>
-                    <p className="text-xs text-slate-500">Abertura</p>
-                    <p className="text-sm font-medium">{new Date(selectedProtocol.opened_at).toLocaleString("pt-BR")}</p>
-                  </div>
-                  {selectedProtocol.contact_name && (
-                    <div>
-                      <p className="text-xs text-slate-500">Contato</p>
-                      <p className="text-sm font-medium">{selectedProtocol.contact_name}</p>
-                    </div>
-                  )}
-                  {selectedProtocol.queue_name && (
-                    <div>
-                      <p className="text-xs text-slate-500">Fila</p>
-                      <p className="text-sm font-medium">{selectedProtocol.queue_name}</p>
-                    </div>
-                  )}
-                  {selectedProtocol.sla_deadline && (
-                    <div>
-                      <p className="text-xs text-slate-500">SLA Deadline</p>
-                      <p className={`text-sm font-medium ${isSlaBreached(selectedProtocol) ? "text-red-600" : "text-emerald-600"}`}>
-                        {new Date(selectedProtocol.sla_deadline).toLocaleString("pt-BR")}
-                        {isSlaBreached(selectedProtocol) && " (violado)"}
-                      </p>
-                    </div>
-                  )}
-                  {selectedProtocol.satisfaction_score && (
-                    <div>
-                      <p className="text-xs text-slate-500">CSAT</p>
-                      <div className="flex items-center gap-1 text-yellow-600">
-                        {"★".repeat(selectedProtocol.satisfaction_score)}
-                        <span className="text-sm ml-1">{selectedProtocol.satisfaction_score}/5</span>
-                      </div>
-                    </div>
-                  )}
-                </div>
-                {selectedProtocol.subject && (
-                  <div>
-                    <p className="text-xs text-slate-500 mb-1">Assunto</p>
-                    <p className="text-sm bg-slate-50 p-2 rounded">{selectedProtocol.subject}</p>
-                  </div>
-                )}
-              </div>
-              <DialogFooter className="flex flex-wrap gap-2">
-                {selectedProtocol.status === "open" && (
-                  <>
-                    <Button
-                      variant="outline"
-                      size="sm"
-                      onClick={() => setCsatDialog({ open: true, protocol: selectedProtocol })}
-                    >
-                      <Star className="h-4 w-4 mr-2" /> Registrar CSAT
-                    </Button>
-                    <Button
-                      size="sm"
-                      onClick={() => updateProtocol.mutate({ id: selectedProtocol.id, status: "resolved" })}
-                    >
-                      <CheckCircle2 className="h-4 w-4 mr-2" /> Resolver
-                    </Button>
-                  </>
-                )}
-                <Button variant="ghost" size="sm" onClick={() => setSelectedProtocol(null)}>Fechar</Button>
-              </DialogFooter>
-            </DialogContent>
-          </Dialog>
-        )}
-
-        {/* New Protocol Dialog */}
-        <Dialog open={showNewDialog} onOpenChange={setShowNewDialog}>
-          <DialogContent>
-            <DialogHeader>
-              <DialogTitle>Novo Protocolo</DialogTitle>
-            </DialogHeader>
-            <div className="space-y-4">
-              <div>
-                <Label htmlFor="subject">Assunto</Label>
-                <Input
-                  id="subject"
-                  placeholder="Descreva o motivo do atendimento"
-                  value={newForm.subject}
-                  onChange={e => setNewForm(f => ({ ...f, subject: e.target.value }))}
-                />
-              </div>
-              <div className="grid grid-cols-2 gap-3">
-                <div>
-                  <Label htmlFor="contactId">ID do Contato</Label>
-                  <Input
-                    id="contactId"
-                    type="number"
-                    placeholder="Ex: 42"
-                    value={newForm.contactId}
-                    onChange={e => setNewForm(f => ({ ...f, contactId: e.target.value }))}
-                  />
-                </div>
-                <div>
-                  <Label htmlFor="slaMinutes">SLA (minutos)</Label>
-                  <Input
-                    id="slaMinutes"
-                    type="number"
-                    placeholder="Ex: 480"
-                    value={newForm.slaMinutes}
-                    onChange={e => setNewForm(f => ({ ...f, slaMinutes: e.target.value }))}
-                  />
-                </div>
-              </div>
-            </div>
-            <DialogFooter>
-              <Button variant="ghost" onClick={() => setShowNewDialog(false)}>Cancelar</Button>
-              <Button onClick={() => createProtocol.mutate(newForm)} disabled={createProtocol.isPending}>
-                {createProtocol.isPending ? "Criando..." : "Criar Protocolo"}
-              </Button>
-            </DialogFooter>
-          </DialogContent>
-        </Dialog>
-
-        {/* CSAT Dialog */}
-        <Dialog open={csatDialog.open} onOpenChange={o => !o && setCsatDialog({ open: false, protocol: null })}>
-          <DialogContent className="max-w-sm">
-            <DialogHeader>
-              <DialogTitle>Registrar Avaliação (CSAT)</DialogTitle>
-            </DialogHeader>
-            <div className="space-y-4">
-              <div>
-                <Label>Nota (1 a 5)</Label>
-                <div className="flex gap-2 mt-2">
-                  {[1, 2, 3, 4, 5].map(n => (
-                    <button
-                      key={n}
-                      onClick={() => setCsatScore(n)}
-                      className={`text-2xl transition-transform hover:scale-110 ${n <= csatScore ? "text-yellow-400" : "text-slate-300"}`}
-                    >
-                      ★
-                    </button>
-                  ))}
-                </div>
-                <p className="text-xs text-slate-500 mt-1">{["", "Muito insatisfeito", "Insatisfeito", "Neutro", "Satisfeito", "Muito satisfeito"][csatScore]}</p>
-              </div>
-              <div>
-                <Label htmlFor="csatComment">Comentário (opcional)</Label>
-                <Textarea
-                  id="csatComment"
-                  placeholder="O que poderia melhorar?"
-                  value={csatComment}
-                  onChange={e => setCsatComment(e.target.value)}
-                  rows={3}
-                />
-              </div>
-            </div>
-            <DialogFooter>
-              <Button variant="ghost" onClick={() => setCsatDialog({ open: false, protocol: null })}>Cancelar</Button>
-              <Button
-                onClick={() => csatDialog.protocol && submitCsat.mutate({ protocol: csatDialog.protocol, score: csatScore, comment: csatComment })}
-                disabled={submitCsat.isPending}
-              >
-                {submitCsat.isPending ? "Salvando..." : "Salvar Avaliação"}
-              </Button>
-            </DialogFooter>
-          </DialogContent>
-        </Dialog>
-      </div>
-    </BrowserFrame>
-  );
-}

client/src/pages/XosReports.tsx

@@ -1,514 +0,0 @@
-import { useState } from "react";
-import { useQuery } from "@tanstack/react-query";
-import { Link } from "wouter";
-import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import {
-  BarChart3, Star, Shield, Users, MessageSquare, Ticket, TrendingUp,
-  ArrowLeft, DollarSign, CheckCircle2, AlertTriangle, Clock, Download
-} from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
-import { Badge } from "@/components/ui/badge";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
-import { Progress } from "@/components/ui/progress";
-
-interface OverviewReport {
-  period: string;
-  conversations: { total: number; resolved: number; open: number; avg_csat: number; avg_handle_minutes: number; channels_used: number };
-  tickets: { total: number; resolved: number; open: number; sla_breaches: number; avg_csat: number };
-  contacts: { total: number; leads: number; customers: number; new_in_period: number };
-  deals: { total: number; won: number; lost: number; won_value: number; win_rate_pct: number };
-  generated_at: string;
-}
-
-interface AgentReport {
-  agent_id: string;
-  agent_name: string;
-  conversations_handled: number;
-  resolved: number;
-  avg_csat: number;
-  avg_handle_minutes: number;
-  tickets_handled: number;
-  tickets_resolved: number;
-}
-
-interface SlaReport {
-  period: string;
-  protocols: { total: number; breached: number; compliant: number; compliance_rate_pct: number };
-  tickets_by_priority: Array<{ priority: string; total: number; breached: number; avg_resolution_minutes: number }>;
-}
-
-interface CsatSummary {
-  period: string;
-  total_responses: number;
-  avg_score: number;
-  satisfaction_rate_pct: number;
-  distribution: { 5: number; 4: number; 3: number; "1-2": number };
-}
-
-export default function XosReports() {
-  const [period, setPeriod] = useState("30d");
-  const [activeTab, setActiveTab] = useState("overview");
-
-  const { data: overview, isLoading } = useQuery<OverviewReport>({
-    queryKey: ["/api/xos/reports/overview", period],
-    queryFn: async () => {
-      const res = await fetch(`/api/xos/reports/overview?period=${period}`);
-      return res.json();
-    },
-  });
-
-  const { data: agentReport = [] } = useQuery<AgentReport[]>({
-    queryKey: ["/api/xos/reports/agents", period],
-    queryFn: async () => {
-      const res = await fetch(`/api/xos/reports/agents?period=${period}`);
-      return res.json();
-    },
-  });
-
-  const { data: slaReport } = useQuery<SlaReport>({
-    queryKey: ["/api/xos/reports/sla", period],
-    queryFn: async () => {
-      const res = await fetch(`/api/xos/reports/sla?period=${period}`);
-      return res.json();
-    },
-  });
-
-  const { data: csatSummary } = useQuery<CsatSummary>({
-    queryKey: ["/api/xos/csat/summary", period],
-    queryFn: async () => {
-      const res = await fetch(`/api/xos/csat/summary?period=${period}`);
-      return res.json();
-    },
-  });
-
-  const formatCurrency = (v: number) =>
-    new Intl.NumberFormat("pt-BR", { style: "currency", currency: "BRL" }).format(v || 0);
-
-  const periodLabel: Record<string, string> = { "7d": "7 dias", "30d": "30 dias", "90d": "90 dias", "1y": "1 ano" };
-
-  const getPriorityColor = (p: string) => ({
-    low: "text-slate-500", normal: "text-blue-600", high: "text-orange-600", urgent: "text-red-600"
-  }[p] || "text-slate-600");
-
-  const getPriorityBadge = (p: string) => ({
-    low: "bg-slate-100 text-slate-700", normal: "bg-blue-100 text-blue-700",
-    high: "bg-orange-100 text-orange-700", urgent: "bg-red-100 text-red-700"
-  }[p] || "bg-gray-100 text-gray-700");
-
-  const csatBar = (label: string, count: number, total: number, color: string) => (
-    <div className="flex items-center gap-3">
-      <span className="text-sm text-slate-600 w-8">{label}</span>
-      <Progress value={total > 0 ? (count / total) * 100 : 0} className={`flex-1 h-3 ${color}`} />
-      <span className="text-sm font-medium text-slate-700 w-8 text-right">{count}</span>
-    </div>
-  );
-
-  if (isLoading) {
-    return (
-      <BrowserFrame>
-        <div className="flex items-center justify-center h-screen">
-          <div className="w-10 h-10 border-4 border-blue-600 border-t-transparent rounded-full animate-spin" />
-        </div>
-      </BrowserFrame>
-    );
-  }
-
-  const conv = overview?.conversations;
-  const tick = overview?.tickets;
-  const contacts = overview?.contacts;
-  const deals = overview?.deals;
-
-  return (
-    <BrowserFrame>
-      <div className="min-h-screen bg-slate-50">
-        {/* Header */}
-        <header className="sticky top-0 z-50 bg-white border-b shadow-sm">
-          <div className="max-w-7xl mx-auto px-4 py-3">
-            <div className="flex items-center justify-between">
-              <div className="flex items-center gap-3">
-                <Link href="/xos">
-                  <Button variant="ghost" size="icon">
-                    <ArrowLeft className="h-4 w-4" />
-                  </Button>
-                </Link>
-                <div className="bg-gradient-to-br from-emerald-600 to-teal-700 p-2 rounded-xl">
-                  <BarChart3 className="h-5 w-5 text-white" />
-                </div>
-                <div>
-                  <h1 className="text-xl font-bold text-slate-800">Relatórios XOS</h1>
-                  <p className="text-xs text-slate-500">Análise de atendimento e CRM</p>
-                </div>
-              </div>
-              <div className="flex items-center gap-2">
-                <Select value={period} onValueChange={setPeriod}>
-                  <SelectTrigger className="w-36">
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent>
-                    <SelectItem value="7d">Últimos 7 dias</SelectItem>
-                    <SelectItem value="30d">Últimos 30 dias</SelectItem>
-                    <SelectItem value="90d">Últimos 90 dias</SelectItem>
-                    <SelectItem value="1y">Último ano</SelectItem>
-                  </SelectContent>
-                </Select>
-                <Button variant="outline" size="sm">
-                  <Download className="h-4 w-4 mr-2" />
-                  Exportar
-                </Button>
-              </div>
-            </div>
-          </div>
-        </header>
-
-        <main className="max-w-7xl mx-auto px-4 py-6 space-y-6">
-          <Tabs value={activeTab} onValueChange={setActiveTab}>
-            <TabsList>
-              <TabsTrigger value="overview">Visão Geral</TabsTrigger>
-              <TabsTrigger value="csat">CSAT</TabsTrigger>
-              <TabsTrigger value="sla">SLA</TabsTrigger>
-              <TabsTrigger value="agents">Agentes</TabsTrigger>
-            </TabsList>
-
-            {/* Overview */}
-            <TabsContent value="overview" className="space-y-6">
-              <p className="text-sm text-slate-500">Período: {periodLabel[period]}</p>
-
-              {/* Top KPI row */}
-              <div className="grid grid-cols-2 md:grid-cols-4 gap-4">
-                <Card className="bg-gradient-to-br from-blue-500 to-blue-600 text-white">
-                  <CardContent className="p-4">
-                    <div className="flex items-center justify-between">
-                      <div>
-                        <p className="text-blue-100 text-sm">Conversas</p>
-                        <p className="text-3xl font-bold">{conv?.total || 0}</p>
-                      </div>
-                      <MessageSquare className="h-10 w-10 text-blue-200" />
-                    </div>
-                    <div className="mt-2 text-sm text-blue-100">
-                      {conv?.resolved || 0} resolvidas ({conv?.total ? Math.round((conv.resolved / conv.total) * 100) : 0}%)
-                    </div>
-                  </CardContent>
-                </Card>
-
-                <Card className="bg-gradient-to-br from-orange-500 to-orange-600 text-white">
-                  <CardContent className="p-4">
-                    <div className="flex items-center justify-between">
-                      <div>
-                        <p className="text-orange-100 text-sm">Tickets</p>
-                        <p className="text-3xl font-bold">{tick?.total || 0}</p>
-                      </div>
-                      <Ticket className="h-10 w-10 text-orange-200" />
-                    </div>
-                    <div className="mt-2 text-sm text-orange-100">
-                      {tick?.sla_breaches || 0} SLA violados
-                    </div>
-                  </CardContent>
-                </Card>
-
-                <Card className="bg-gradient-to-br from-emerald-500 to-emerald-600 text-white">
-                  <CardContent className="p-4">
-                    <div className="flex items-center justify-between">
-                      <div>
-                        <p className="text-emerald-100 text-sm">Receita Ganha</p>
-                        <p className="text-2xl font-bold">{formatCurrency(deals?.won_value || 0)}</p>
-                      </div>
-                      <DollarSign className="h-10 w-10 text-emerald-200" />
-                    </div>
-                    <div className="mt-2 text-sm text-emerald-100">
-                      {deals?.won || 0} deals • {deals?.win_rate_pct || 0}% taxa
-                    </div>
-                  </CardContent>
-                </Card>
-
-                <Card className="bg-gradient-to-br from-violet-500 to-violet-600 text-white">
-                  <CardContent className="p-4">
-                    <div className="flex items-center justify-between">
-                      <div>
-                        <p className="text-violet-100 text-sm">Novos Contatos</p>
-                        <p className="text-3xl font-bold">{contacts?.new_in_period || 0}</p>
-                      </div>
-                      <Users className="h-10 w-10 text-violet-200" />
-                    </div>
-                    <div className="mt-2 text-sm text-violet-100">
-                      {contacts?.leads || 0} leads • {contacts?.customers || 0} clientes
-                    </div>
-                  </CardContent>
-                </Card>
-              </div>
-
-              {/* Detail cards */}
-              <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
-                <Card>
-                  <CardHeader>
-                    <CardTitle className="text-base flex items-center gap-2">
-                      <MessageSquare className="h-4 w-4 text-blue-500" />
-                      Atendimento
-                    </CardTitle>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="grid grid-cols-2 gap-4">
-                      <div className="bg-slate-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-slate-800">{conv?.avg_handle_minutes || 0}<span className="text-sm font-normal text-slate-500">min</span></p>
-                        <p className="text-xs text-slate-500 mt-1">Tempo Médio de Atendimento</p>
-                      </div>
-                      <div className="bg-slate-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-slate-800">{conv?.channels_used || 0}</p>
-                        <p className="text-xs text-slate-500 mt-1">Canais Utilizados</p>
-                      </div>
-                      <div className="bg-emerald-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-emerald-700">{conv?.resolved || 0}</p>
-                        <p className="text-xs text-slate-500 mt-1">Resolvidas</p>
-                      </div>
-                      <div className="bg-blue-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-blue-700">{conv?.open || 0}</p>
-                        <p className="text-xs text-slate-500 mt-1">Em Aberto</p>
-                      </div>
-                    </div>
-                    {conv?.avg_csat ? (
-                      <div className="flex items-center gap-3 p-3 bg-yellow-50 rounded-lg">
-                        <Star className="h-5 w-5 text-yellow-500 fill-yellow-500" />
-                        <div>
-                          <p className="font-semibold text-slate-800">{Number(conv.avg_csat).toFixed(1)} / 5</p>
-                          <p className="text-xs text-slate-500">CSAT Médio das Conversas</p>
-                        </div>
-                      </div>
-                    ) : null}
-                  </CardContent>
-                </Card>
-
-                <Card>
-                  <CardHeader>
-                    <CardTitle className="text-base flex items-center gap-2">
-                      <TrendingUp className="h-4 w-4 text-emerald-500" />
-                      Pipeline de Vendas
-                    </CardTitle>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="grid grid-cols-2 gap-4">
-                      <div className="bg-emerald-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-emerald-700">{deals?.won || 0}</p>
-                        <p className="text-xs text-slate-500 mt-1">Ganhos</p>
-                      </div>
-                      <div className="bg-red-50 rounded-lg p-3 text-center">
-                        <p className="text-2xl font-bold text-red-700">{deals?.lost || 0}</p>
-                        <p className="text-xs text-slate-500 mt-1">Perdidos</p>
-                      </div>
-                    </div>
-                    <div className="space-y-2">
-                      <div className="flex justify-between text-sm">
-                        <span className="text-slate-600">Taxa de conversão</span>
-                        <span className="font-semibold">{deals?.win_rate_pct || 0}%</span>
-                      </div>
-                      <Progress value={deals?.win_rate_pct || 0} className="h-3" />
-                    </div>
-                    <div className="p-3 bg-slate-50 rounded-lg">
-                      <p className="text-xs text-slate-500">Valor Total Ganho</p>
-                      <p className="text-xl font-bold text-emerald-600">{formatCurrency(deals?.won_value || 0)}</p>
-                    </div>
-                  </CardContent>
-                </Card>
-              </div>
-            </TabsContent>
-
-            {/* CSAT */}
-            <TabsContent value="csat" className="space-y-6">
-              {csatSummary ? (
-                <>
-                  <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
-                    <Card className="bg-gradient-to-br from-yellow-400 to-orange-500 text-white">
-                      <CardContent className="p-5 text-center">
-                        <Star className="h-10 w-10 mx-auto mb-2 fill-white" />
-                        <p className="text-4xl font-bold">{Number(csatSummary.avg_score).toFixed(1)}</p>
-                        <p className="text-yellow-100 text-sm mt-1">Nota Média / 5</p>
-                      </CardContent>
-                    </Card>
-                    <Card>
-                      <CardContent className="p-5 text-center">
-                        <CheckCircle2 className="h-10 w-10 mx-auto mb-2 text-emerald-500" />
-                        <p className="text-4xl font-bold text-emerald-600">{csatSummary.satisfaction_rate_pct}%</p>
-                        <p className="text-slate-500 text-sm mt-1">Taxa de Satisfação (4-5 ★)</p>
-                      </CardContent>
-                    </Card>
-                    <Card>
-                      <CardContent className="p-5 text-center">
-                        <Users className="h-10 w-10 mx-auto mb-2 text-blue-500" />
-                        <p className="text-4xl font-bold text-blue-600">{csatSummary.total_responses}</p>
-                        <p className="text-slate-500 text-sm mt-1">Total de Avaliações</p>
-                      </CardContent>
-                    </Card>
-                  </div>
-
-                  <Card>
-                    <CardHeader>
-                      <CardTitle>Distribuição de Notas</CardTitle>
-                      <CardDescription>Período: {periodLabel[period]}</CardDescription>
-                    </CardHeader>
-                    <CardContent className="space-y-3">
-                      {csatBar("⭐⭐⭐⭐⭐", csatSummary.distribution[5], csatSummary.total_responses, "[&>div]:bg-emerald-500")}
-                      {csatBar("⭐⭐⭐⭐", csatSummary.distribution[4], csatSummary.total_responses, "[&>div]:bg-green-400")}
-                      {csatBar("⭐⭐⭐", csatSummary.distribution[3], csatSummary.total_responses, "[&>div]:bg-yellow-400")}
-                      {csatBar("⭐⭐", csatSummary.distribution["1-2"], csatSummary.total_responses, "[&>div]:bg-red-400")}
-                    </CardContent>
-                  </Card>
-                </>
-              ) : (
-                <Card>
-                  <CardContent className="py-16 text-center">
-                    <Star className="h-12 w-12 mx-auto mb-3 text-slate-300" />
-                    <p className="text-slate-500">Nenhuma avaliação no período</p>
-                  </CardContent>
-                </Card>
-              )}
-            </TabsContent>
-
-            {/* SLA */}
-            <TabsContent value="sla" className="space-y-6">
-              {slaReport && (
-                <>
-                  <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
-                    <Card className={`${slaReport.protocols.compliance_rate_pct >= 90 ? "bg-gradient-to-br from-emerald-500 to-emerald-600" : slaReport.protocols.compliance_rate_pct >= 70 ? "bg-gradient-to-br from-yellow-500 to-yellow-600" : "bg-gradient-to-br from-red-500 to-red-600"} text-white`}>
-                      <CardContent className="p-5 text-center">
-                        <Shield className="h-10 w-10 mx-auto mb-2 opacity-80" />
-                        <p className="text-4xl font-bold">{slaReport.protocols.compliance_rate_pct}%</p>
-                        <p className="text-sm opacity-80 mt-1">Compliance de SLA</p>
-                      </CardContent>
-                    </Card>
-                    <Card>
-                      <CardContent className="p-5 text-center">
-                        <CheckCircle2 className="h-10 w-10 mx-auto mb-2 text-emerald-500" />
-                        <p className="text-4xl font-bold text-emerald-600">{slaReport.protocols.compliant}</p>
-                        <p className="text-slate-500 text-sm mt-1">Protocolos dentro do SLA</p>
-                      </CardContent>
-                    </Card>
-                    <Card>
-                      <CardContent className="p-5 text-center">
-                        <AlertTriangle className="h-10 w-10 mx-auto mb-2 text-red-500" />
-                        <p className="text-4xl font-bold text-red-600">{slaReport.protocols.breached}</p>
-                        <p className="text-slate-500 text-sm mt-1">Violações de SLA</p>
-                      </CardContent>
-                    </Card>
-                  </div>
-
-                  <Card>
-                    <CardHeader>
-                      <CardTitle>Tickets por Prioridade</CardTitle>
-                    </CardHeader>
-                    <CardContent>
-                      {slaReport.tickets_by_priority.length === 0 ? (
-                        <p className="text-center text-slate-500 py-8">Nenhum ticket no período</p>
-                      ) : (
-                        <div className="overflow-x-auto">
-                          <table className="w-full">
-                            <thead className="bg-slate-50 border-b">
-                              <tr>
-                                <th className="text-left p-3 text-sm font-medium text-slate-600">Prioridade</th>
-                                <th className="text-center p-3 text-sm font-medium text-slate-600">Total</th>
-                                <th className="text-center p-3 text-sm font-medium text-slate-600">Violações</th>
-                                <th className="text-center p-3 text-sm font-medium text-slate-600">Tempo Médio Res.</th>
-                              </tr>
-                            </thead>
-                            <tbody className="divide-y">
-                              {slaReport.tickets_by_priority.map(row => (
-                                <tr key={row.priority} className="hover:bg-slate-50">
-                                  <td className="p-3">
-                                    <Badge className={getPriorityBadge(row.priority)}>{row.priority}</Badge>
-                                  </td>
-                                  <td className="p-3 text-center font-medium">{row.total}</td>
-                                  <td className="p-3 text-center">
-                                    <span className={row.breached > 0 ? "text-red-600 font-semibold" : "text-emerald-600"}>
-                                      {row.breached}
-                                    </span>
-                                  </td>
-                                  <td className="p-3 text-center text-slate-600">
-                                    {row.avg_resolution_minutes ? (
-                                      <div className="flex items-center justify-center gap-1">
-                                        <Clock className="h-3 w-3" />
-                                        {Number(row.avg_resolution_minutes).toFixed(0)}min
-                                      </div>
-                                    ) : "—"}
-                                  </td>
-                                </tr>
-                              ))}
-                            </tbody>
-                          </table>
-                        </div>
-                      )}
-                    </CardContent>
-                  </Card>
-                </>
-              )}
-            </TabsContent>
-
-            {/* Agents */}
-            <TabsContent value="agents">
-              <Card>
-                <CardHeader>
-                  <CardTitle>Performance por Agente</CardTitle>
-                  <CardDescription>Período: {periodLabel[period]}</CardDescription>
-                </CardHeader>
-                <CardContent className="p-0">
-                  <div className="overflow-x-auto">
-                    <table className="w-full">
-                      <thead className="bg-slate-50 border-b">
-                        <tr>
-                          <th className="text-left p-4 text-sm font-medium text-slate-600">Agente</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">Conversas</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">Resolvidas</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">CSAT</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">TMA</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">Tickets</th>
-                        </tr>
-                      </thead>
-                      <tbody className="divide-y">
-                        {agentReport.map(agent => {
-                          const resolutionRate = agent.conversations_handled > 0
-                            ? Math.round((agent.resolved / agent.conversations_handled) * 100)
-                            : 0;
-                          return (
-                            <tr key={agent.agent_id} className="hover:bg-slate-50 transition-colors">
-                              <td className="p-4 font-medium text-slate-800">{agent.agent_name}</td>
-                              <td className="p-4 text-center">{agent.conversations_handled}</td>
-                              <td className="p-4 text-center">
-                                <div className="flex flex-col items-center">
-                                  <span className="font-medium">{agent.resolved}</span>
-                                  <span className="text-xs text-slate-500">{resolutionRate}%</span>
-                                </div>
-                              </td>
-                              <td className="p-4 text-center">
-                                {agent.avg_csat ? (
-                                  <div className="flex items-center justify-center gap-1 text-yellow-600 font-semibold">
-                                    <Star className="h-3 w-3 fill-current" />
-                                    {Number(agent.avg_csat).toFixed(1)}
-                                  </div>
-                                ) : <span className="text-slate-400">—</span>}
-                              </td>
-                              <td className="p-4 text-center text-slate-600">
-                                {agent.avg_handle_minutes ? `${Number(agent.avg_handle_minutes).toFixed(0)}min` : "—"}
-                              </td>
-                              <td className="p-4 text-center">
-                                <span className="text-sm">{agent.tickets_handled} / {agent.tickets_resolved}</span>
-                              </td>
-                            </tr>
-                          );
-                        })}
-                        {agentReport.length === 0 && (
-                          <tr>
-                            <td colSpan={6} className="text-center py-12 text-slate-500">
-                              Nenhum dado de agente no período
-                            </td>
-                          </tr>
-                        )}
-                      </tbody>
-                    </table>
-                  </div>
-                </CardContent>
-              </Card>
-            </TabsContent>
-          </Tabs>
-        </main>
-      </div>
-    </BrowserFrame>
-  );
-}

client/src/pages/XosSupervisor.tsx

@@ -1,478 +0,0 @@
-import { useState } from "react";
-import { useQuery } from "@tanstack/react-query";
-import { useXosSocket } from "@/hooks/use-xos-socket";
-import { Link } from "wouter";
-import { BrowserFrame } from "@/components/Browser/BrowserFrame";
-import {
-  Users, MessageSquare, Ticket, Clock, AlertTriangle, CheckCircle2,
-  TrendingUp, ChevronRight, RefreshCw, Activity, UserCheck, PhoneOff,
-  BarChart3, Inbox, Star, ArrowLeft, Circle
-} from "lucide-react";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
-import { Badge } from "@/components/ui/badge";
-import { Avatar, AvatarFallback } from "@/components/ui/avatar";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
-import { Progress } from "@/components/ui/progress";
-
-interface SupervisorOverview {
-  conversations: {
-    open: number;
-    pending: number;
-    resolved_today: number;
-    unassigned: number;
-    avg_handle_time_minutes: number;
-  };
-  tickets: {
-    open: number;
-    resolved_today: number;
-    urgent_open: number;
-    sla_breached: number;
-  };
-  agents_active: Array<{ agent_id: string; active_conversations: number }>;
-  generated_at: string;
-}
-
-interface QueueStat {
-  id: number;
-  name: string;
-  color: string;
-  active_conversations: number;
-  waiting: number;
-  total_agents: number;
-  avg_first_response_minutes: number;
-}
-
-interface AgentStat {
-  agent_id: string;
-  agent_name: string;
-  avatar: string | null;
-  active_conversations: number;
-  resolved_today: number;
-  avg_csat: number;
-  avg_handle_time_minutes: number;
-  queues: string[];
-}
-
-interface LiveConversation {
-  id: number;
-  contact_name: string;
-  contact_phone: string;
-  queue_name: string;
-  queue_color: string;
-  channel: string;
-  status: string;
-  assigned_to: string | null;
-  age_minutes: number;
-  last_message: string;
-}
-
-export default function XosSupervisor() {
-  const [activeTab, setActiveTab] = useState("overview");
-  const [queueFilter, setQueueFilter] = useState("all");
-  const [autoRefresh] = useState(true);
-  const { connected: socketConnected, supervisorStats: liveStats } = useXosSocket();
-
-  const refetchInterval = autoRefresh ? 30000 : false;
-
-  const { data: overview, isLoading: loadingOverview, refetch: refetchOverview } = useQuery<SupervisorOverview>({
-    queryKey: ["/api/xos/supervisor/overview"],
-    refetchInterval,
-  });
-
-  const { data: queues = [] } = useQuery<QueueStat[]>({
-    queryKey: ["/api/xos/supervisor/queues"],
-    refetchInterval,
-  });
-
-  const { data: agents = [] } = useQuery<AgentStat[]>({
-    queryKey: ["/api/xos/supervisor/agents", queueFilter],
-    queryFn: async () => {
-      const url = queueFilter === "all"
-        ? "/api/xos/supervisor/agents"
-        : `/api/xos/supervisor/agents?queueId=${queueFilter}`;
-      const res = await fetch(url);
-      return res.json();
-    },
-    refetchInterval,
-  });
-
-  const { data: liveConvs = [] } = useQuery<LiveConversation[]>({
-    queryKey: ["/api/xos/supervisor/conversations/live", queueFilter],
-    queryFn: async () => {
-      const url = queueFilter === "all"
-        ? "/api/xos/supervisor/conversations/live"
-        : `/api/xos/supervisor/conversations/live?queueId=${queueFilter}`;
-      const res = await fetch(url);
-      return res.json();
-    },
-    refetchInterval,
-  });
-
-  const getQueueColor = (color: string) => {
-    const map: Record<string, string> = {
-      blue: "bg-blue-500", green: "bg-green-500", red: "bg-red-500",
-      yellow: "bg-yellow-500", purple: "bg-purple-500", orange: "bg-orange-500",
-      cyan: "bg-cyan-500", pink: "bg-pink-500",
-    };
-    return map[color] || "bg-slate-500";
-  };
-
-  const getAgentCsatColor = (score: number) => {
-    if (!score) return "text-slate-400";
-    if (score >= 4.5) return "text-emerald-600";
-    if (score >= 3.5) return "text-yellow-600";
-    return "text-red-600";
-  };
-
-  const getAgeColor = (minutes: number) => {
-    if (minutes < 10) return "text-emerald-600";
-    if (minutes < 30) return "text-yellow-600";
-    return "text-red-600";
-  };
-
-  if (loadingOverview) {
-    return (
-      <BrowserFrame>
-        <div className="flex items-center justify-center h-screen">
-          <div className="text-center">
-            <div className="w-10 h-10 border-4 border-blue-600 border-t-transparent rounded-full animate-spin mx-auto" />
-            <p className="mt-4 text-slate-500">Carregando dados do supervisor...</p>
-          </div>
-        </div>
-      </BrowserFrame>
-    );
-  }
-
-  // Prefer real-time socket stats over polling data when available
-  const conv = overview?.conversations;
-  const tick = overview?.tickets;
-  const totalActive = liveStats?.openConversations ?? ((conv?.open || 0) + (conv?.pending || 0));
-  const resolvedToday = liveStats?.resolvedToday ?? conv?.resolved_today ?? 0;
-  const urgentTickets = liveStats?.urgentTickets ?? tick?.urgent_open ?? 0;
-  const agentsOnline = liveStats?.agentsOnline ?? overview?.agents_active?.length ?? 0;
-
-  return (
-    <BrowserFrame>
-      <div className="min-h-screen bg-slate-50">
-        {/* Header */}
-        <header className="sticky top-0 z-50 bg-white border-b shadow-sm">
-          <div className="max-w-7xl mx-auto px-4 py-3">
-            <div className="flex items-center justify-between">
-              <div className="flex items-center gap-3">
-                <Link href="/xos">
-                  <Button variant="ghost" size="icon">
-                    <ArrowLeft className="h-4 w-4" />
-                  </Button>
-                </Link>
-                <div className="bg-gradient-to-br from-indigo-600 to-purple-700 p-2 rounded-xl">
-                  <Activity className="h-5 w-5 text-white" />
-                </div>
-                <div>
-                  <h1 className="text-xl font-bold text-slate-800">Monitor de Supervisor</h1>
-                  <p className="text-xs text-slate-500">
-                    Atualizado às {overview ? new Date(overview.generated_at).toLocaleTimeString("pt-BR") : "—"}
-                    {socketConnected
-                      ? <span className="ml-2 text-emerald-600">● tempo real</span>
-                      : autoRefresh && <span className="ml-2 text-yellow-600">○ polling 30s</span>
-                    }
-                  </p>
-                </div>
-              </div>
-              <div className="flex items-center gap-2">
-                <Select value={queueFilter} onValueChange={setQueueFilter}>
-                  <SelectTrigger className="w-44">
-                    <SelectValue placeholder="Todas as filas" />
-                  </SelectTrigger>
-                  <SelectContent>
-                    <SelectItem value="all">Todas as filas</SelectItem>
-                    {queues.map(q => (
-                      <SelectItem key={q.id} value={String(q.id)}>{q.name}</SelectItem>
-                    ))}
-                  </SelectContent>
-                </Select>
-                <Button variant="outline" size="icon" onClick={() => refetchOverview()}>
-                  <RefreshCw className="h-4 w-4" />
-                </Button>
-              </div>
-            </div>
-          </div>
-        </header>
-
-        <main className="max-w-7xl mx-auto px-4 py-6 space-y-6">
-          {/* KPI Cards */}
-          <div className="grid grid-cols-2 md:grid-cols-4 gap-4">
-            <Card className="bg-gradient-to-br from-blue-500 to-blue-600 text-white">
-              <CardContent className="p-4">
-                <div className="flex items-center justify-between">
-                  <div>
-                    <p className="text-blue-100 text-sm">Em Atendimento</p>
-                    <p className="text-3xl font-bold">{totalActive}</p>
-                  </div>
-                  <MessageSquare className="h-10 w-10 text-blue-200" />
-                </div>
-                <div className="mt-2 flex items-center gap-2 text-sm text-blue-100">
-                  <span>{conv?.unassigned || 0} sem agente</span>
-
-                  <span>•</span>
-                  <span>{conv?.pending || 0} pendentes</span>
-                </div>
-              </CardContent>
-            </Card>
-
-            <Card className="bg-gradient-to-br from-emerald-500 to-emerald-600 text-white">
-              <CardContent className="p-4">
-                <div className="flex items-center justify-between">
-                  <div>
-                    <p className="text-emerald-100 text-sm">Resolvidos Hoje</p>
-                    <p className="text-3xl font-bold">{resolvedToday}</p>
-                  </div>
-                  <CheckCircle2 className="h-10 w-10 text-emerald-200" />
-                </div>
-                <div className="mt-2 text-sm text-emerald-100">
-                  TMA: {conv?.avg_handle_time_minutes || 0}min
-                </div>
-              </CardContent>
-            </Card>
-
-            <Card className={`text-white ${(tick?.sla_breached || 0) > 0 ? "bg-gradient-to-br from-red-500 to-red-600" : "bg-gradient-to-br from-orange-500 to-orange-600"}`}>
-              <CardContent className="p-4">
-                <div className="flex items-center justify-between">
-                  <div>
-                    <p className="text-orange-100 text-sm">Tickets Urgentes</p>
-                    <p className="text-3xl font-bold">{urgentTickets}</p>
-                  </div>
-                  <Ticket className="h-10 w-10 text-orange-200" />
-                </div>
-                <div className="mt-2 flex items-center gap-2 text-sm text-orange-100">
-                  {(tick?.sla_breached || 0) > 0 && (
-                    <span className="flex items-center gap-1 text-red-200">
-                      <AlertTriangle className="h-3 w-3" />
-                      {tick?.sla_breached} SLA violado
-                    </span>
-                  )}
-                  {(tick?.sla_breached || 0) === 0 && <span>SLA OK</span>}
-                </div>
-              </CardContent>
-            </Card>
-
-            <Card className="bg-gradient-to-br from-violet-500 to-violet-600 text-white">
-              <CardContent className="p-4">
-                <div className="flex items-center justify-between">
-                  <div>
-                    <p className="text-violet-100 text-sm">Agentes Ativos</p>
-                    <p className="text-3xl font-bold">{agentsOnline}</p>
-                  </div>
-                  <Users className="h-10 w-10 text-violet-200" />
-                </div>
-                <div className="mt-2 text-sm text-violet-100">
-                  {agents.length} no total
-                </div>
-              </CardContent>
-            </Card>
-          </div>
-
-          <Tabs value={activeTab} onValueChange={setActiveTab}>
-            <TabsList>
-              <TabsTrigger value="overview">Filas</TabsTrigger>
-              <TabsTrigger value="agents">Agentes</TabsTrigger>
-              <TabsTrigger value="live">Ao Vivo ({liveConvs.length})</TabsTrigger>
-            </TabsList>
-
-            {/* Queues Tab */}
-            <TabsContent value="overview" className="space-y-4">
-              <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
-                {queues.map(queue => {
-                  const occupancy = queue.total_agents > 0
-                    ? Math.min(100, Math.round((queue.active_conversations / queue.total_agents) * 100))
-                    : 0;
-                  return (
-                    <Card key={queue.id} className="hover:shadow-md transition-shadow">
-                      <CardContent className="p-4">
-                        <div className="flex items-center gap-3 mb-3">
-                          <div className={`w-3 h-3 rounded-full ${getQueueColor(queue.color)}`} />
-                          <h3 className="font-semibold text-slate-800">{queue.name}</h3>
-                          <Badge variant="outline" className="ml-auto text-xs">
-                            {queue.total_agents} agentes
-                          </Badge>
-                        </div>
-                        <div className="grid grid-cols-3 gap-3 text-center mb-3">
-                          <div>
-                            <p className="text-2xl font-bold text-blue-600">{queue.active_conversations}</p>
-                            <p className="text-xs text-slate-500">ativos</p>
-                          </div>
-                          <div>
-                            <p className={`text-2xl font-bold ${queue.waiting > 0 ? "text-orange-600" : "text-slate-400"}`}>
-                              {queue.waiting}
-                            </p>
-                            <p className="text-xs text-slate-500">aguardando</p>
-                          </div>
-                          <div>
-                            <p className="text-2xl font-bold text-slate-600">
-                              {queue.avg_first_response_minutes ? `${queue.avg_first_response_minutes}m` : "—"}
-                            </p>
-                            <p className="text-xs text-slate-500">TMP</p>
-                          </div>
-                        </div>
-                        <div className="space-y-1">
-                          <div className="flex justify-between text-xs text-slate-500">
-                            <span>Ocupação</span>
-                            <span>{occupancy}%</span>
-                          </div>
-                          <Progress value={occupancy} className="h-2" />
-                        </div>
-                      </CardContent>
-                    </Card>
-                  );
-                })}
-                {queues.length === 0 && (
-                  <div className="col-span-3 text-center py-12 text-slate-500">
-                    <Inbox className="h-12 w-12 mx-auto mb-3 text-slate-300" />
-                    <p>Nenhuma fila configurada</p>
-                  </div>
-                )}
-              </div>
-            </TabsContent>
-
-            {/* Agents Tab */}
-            <TabsContent value="agents">
-              <Card>
-                <CardContent className="p-0">
-                  <div className="overflow-x-auto">
-                    <table className="w-full">
-                      <thead className="bg-slate-50 border-b">
-                        <tr>
-                          <th className="text-left p-4 text-sm font-medium text-slate-600">Agente</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">Em Atend.</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">Resolvidos Hoje</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">CSAT Médio</th>
-                          <th className="text-center p-4 text-sm font-medium text-slate-600">TMA (min)</th>
-                          <th className="text-left p-4 text-sm font-medium text-slate-600">Filas</th>
-                        </tr>
-                      </thead>
-                      <tbody className="divide-y">
-                        {agents.map(agent => (
-                          <tr key={agent.agent_id} className="hover:bg-slate-50 transition-colors">
-                            <td className="p-4">
-                              <div className="flex items-center gap-3">
-                                <Avatar className="h-9 w-9">
-                                  <AvatarFallback className="bg-gradient-to-br from-blue-500 to-indigo-500 text-white text-sm">
-                                    {(agent.agent_name || "?").slice(0, 2).toUpperCase()}
-                                  </AvatarFallback>
-                                </Avatar>
-                                <div>
-                                  <p className="font-medium text-slate-800">{agent.agent_name}</p>
-                                  <div className="flex items-center gap-1">
-                                    <Circle className={`h-2 w-2 fill-current ${agent.active_conversations > 0 ? "text-emerald-500" : "text-slate-300"}`} />
-                                    <span className="text-xs text-slate-500">
-                                      {agent.active_conversations > 0 ? "online" : "disponível"}
-                                    </span>
-                                  </div>
-                                </div>
-                              </div>
-                            </td>
-                            <td className="p-4 text-center">
-                              <span className={`text-xl font-bold ${agent.active_conversations > 5 ? "text-red-600" : agent.active_conversations > 2 ? "text-yellow-600" : "text-slate-700"}`}>
-                                {agent.active_conversations}
-                              </span>
-                            </td>
-                            <td className="p-4 text-center">
-                              <span className="text-lg font-semibold text-emerald-600">{agent.resolved_today || 0}</span>
-                            </td>
-                            <td className="p-4 text-center">
-                              <div className={`flex items-center justify-center gap-1 font-semibold ${getAgentCsatColor(agent.avg_csat)}`}>
-                                {agent.avg_csat ? (
-                                  <>
-                                    <Star className="h-3 w-3 fill-current" />
-                                    {Number(agent.avg_csat).toFixed(1)}
-                                  </>
-                                ) : "—"}
-                              </div>
-                            </td>
-                            <td className="p-4 text-center text-slate-600">
-                              {agent.avg_handle_time_minutes ? `${agent.avg_handle_time_minutes}m` : "—"}
-                            </td>
-                            <td className="p-4">
-                              <div className="flex flex-wrap gap-1">
-                                {(agent.queues || []).filter(Boolean).map((q, i) => (
-                                  <Badge key={i} variant="outline" className="text-xs">{q}</Badge>
-                                ))}
-                              </div>
-                            </td>
-                          </tr>
-                        ))}
-                        {agents.length === 0 && (
-                          <tr>
-                            <td colSpan={6} className="text-center py-12 text-slate-500">
-                              <UserCheck className="h-12 w-12 mx-auto mb-3 text-slate-300" />
-                              Nenhum agente encontrado
-                            </td>
-                          </tr>
-                        )}
-                      </tbody>
-                    </table>
-                  </div>
-                </CardContent>
-              </Card>
-            </TabsContent>
-
-            {/* Live Conversations Tab */}
-            <TabsContent value="live">
-              <div className="space-y-2">
-                {liveConvs.length === 0 && (
-                  <Card>
-                    <CardContent className="py-16 text-center">
-                      <MessageSquare className="h-12 w-12 mx-auto mb-3 text-slate-300" />
-                      <p className="text-slate-500">Nenhuma conversa em aberto</p>
-                    </CardContent>
-                  </Card>
-                )}
-                {liveConvs.map(conv => (
-                  <Card key={conv.id} className={`hover:shadow-md transition-shadow ${Number(conv.age_minutes) > 30 ? "border-red-200 bg-red-50" : ""}`}>
-                    <CardContent className="p-4">
-                      <div className="flex items-center gap-4">
-                        <Avatar className="h-10 w-10 flex-shrink-0">
-                          <AvatarFallback className="bg-gradient-to-br from-slate-400 to-slate-600 text-white">
-                            {(conv.contact_name || "?").slice(0, 2).toUpperCase()}
-                          </AvatarFallback>
-                        </Avatar>
-                        <div className="flex-1 min-w-0">
-                          <div className="flex items-center gap-2">
-                            <p className="font-medium text-slate-800">{conv.contact_name || "Desconhecido"}</p>
-                            <Badge variant="outline" className="text-xs">{conv.channel}</Badge>
-                          </div>
-                          <p className="text-sm text-slate-500 truncate">{conv.last_message || "—"}</p>
-                        </div>
-                        <div className="flex items-center gap-4 flex-shrink-0">
-                          {conv.queue_name && (
-                            <Badge variant="secondary" className="text-xs">{conv.queue_name}</Badge>
-                          )}
-                          {conv.assigned_to ? (
-                            <div className="flex items-center gap-1 text-xs text-slate-500">
-                              <UserCheck className="h-3 w-3" />
-                              <span className="hidden sm:block">{conv.assigned_to}</span>
-                            </div>
-                          ) : (
-                            <div className="flex items-center gap-1 text-xs text-orange-500">
-                              <PhoneOff className="h-3 w-3" />
-                              <span>Sem agente</span>
-                            </div>
-                          )}
-                          <div className={`flex items-center gap-1 text-sm font-medium ${getAgeColor(Number(conv.age_minutes))}`}>
-                            <Clock className="h-4 w-4" />
-                            {Number(conv.age_minutes).toFixed(0)}m
-                          </div>
-                        </div>
-                      </div>
-                    </CardContent>
-                  </Card>
-                ))}
-              </div>
-            </TabsContent>
-          </Tabs>
-        </main>
-      </div>
-    </BrowserFrame>
-  );
-}

client/src/pages/auth-page.tsx

@@ -6,7 +6,7 @@ import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import browserIcon from "/favicon.png";
+import browserIcon from "@assets/arcadia_branding/arcadia_suite_icon.png";
 import { Loader2 } from "lucide-react";
 
 export default function AuthPage() {

db/index.ts

@@ -8,22 +8,10 @@ if (!process.env.DATABASE_URL) {
   );
 }
 
-// CORREÇÃO: Usar Pool em vez de Client único para melhor performance
+const client = new pg.Client({
-// e evitar queries travadas quando conexão falha
-const pool = new pg.Pool({
   connectionString: process.env.DATABASE_URL,
-  max: 20,                    // máximo de conexões no pool
-  idleTimeoutMillis: 30000,   // tempo máximo de inatividade
-  connectionTimeoutMillis: 5000, // timeout de conexão: 5s
-  statement_timeout: 10000,   // timeout de query: 10s
 });
 
-// Log de erros do pool
+client.connect();
-pool.on('error', (err) => {
-  console.error('[DB Pool] Erro inesperado:', err.message);
-});
 
-// Exportar pool para uso no session store
+export const db = drizzle({ client, schema });
-export { pool };
-
-export const db = drizzle({ client: pool, schema });

deploy.sh

@@ -1,72 +0,0 @@
-#!/bin/bash
-# ==============================================
-# Arcádia Suite - Script de Deploy para VPS
-# ==============================================
-
-set -e
-
-echo "=========================================="
-echo "  Arcádia Suite - Deploy VPS"
-echo "=========================================="
-
-if ! command -v docker &> /dev/null; then
-    echo "Docker não encontrado. Instalando..."
-    curl -fsSL https://get.docker.com | sh
-    sudo usermod -aG docker $USER
-    echo "Docker instalado! Faça logout e login novamente para aplicar as permissões."
-    exit 1
-fi
-
-if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
-    echo "Docker Compose não encontrado. Instalando..."
-    sudo apt-get update && sudo apt-get install -y docker-compose-plugin
-fi
-
-if [ ! -f .env ]; then
-    echo "Arquivo .env não encontrado. Criando a partir do .env.example..."
-    cp .env.example .env
-    echo ""
-    echo "IMPORTANTE: Edite o arquivo .env com suas configurações antes de continuar!"
-    echo "   nano .env"
-    echo ""
-    echo "Depois execute este script novamente."
-    exit 1
-fi
-
-echo ""
-echo "1/4 - Parando containers existentes..."
-docker compose down 2>/dev/null || docker-compose down 2>/dev/null || true
-
-echo ""
-echo "2/5 - Construindo a aplicação..."
-docker compose build --no-cache 2>/dev/null || docker-compose build --no-cache
-
-echo ""
-echo "3/5 - Iniciando o banco de dados..."
-docker compose up -d db 2>/dev/null || docker-compose up -d db
-echo "Aguardando banco ficar pronto..."
-sleep 5
-
-echo ""
-echo "4/5 - Aplicando migrations do banco de dados..."
-docker compose run --rm app npx drizzle-kit push 2>/dev/null || docker-compose run --rm app npx drizzle-kit push
-
-echo ""
-echo "5/5 - Iniciando a aplicação..."
-docker compose up -d 2>/dev/null || docker-compose up -d
-sleep 10
-
-echo ""
-echo "=========================================="
-echo "  Deploy concluído!"
-echo "=========================================="
-echo ""
-echo "  App:  http://$(hostname -I | awk '{print $1}'):5000"
-echo "  DB:   PostgreSQL na porta 5432"
-echo ""
-echo "  Comandos úteis:"
-echo "    Ver logs:     docker compose logs -f app"
-echo "    Parar tudo:   docker compose down"
-echo "    Reiniciar:    docker compose restart app"
-echo "    Status:       docker compose ps"
-echo ""

docker-compose.miroflow.yml

@@ -1,42 +0,0 @@
-# ─── MiroFlow — Aplicação Coolify ─────────────────────────────────────────────
-# Conecta aos serviços compartilhados (ollama) via network arcadia-internal
-# Requer: docker-compose.shared.yml rodando
-
-name: arcadia-miroflow
-
-services:
-
-  # ── MiroFlow (Cientistas via Ollama) ───────────────────────────────────────────
-  miroflow:
-    build:
-      context: .
-      dockerfile: Dockerfile.miroflow
-    restart: always
-    environment:
-      OLLAMA_BASE_URL: ${OLLAMA_BASE_URL:-http://ollama:11434}
-      MIROFLOW_PORT: 8006
-      MIROFLOW_RESEARCHER_MODEL: ${MIROFLOW_RESEARCHER_MODEL:-llama3.1:8b}
-    networks:
-      - arcadia-internal
-      - coolify
-    labels:
-      - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.miroflow.entrypoints=https"
-      - "traefik.http.routers.miroflow.rule=Host(`${MIROFLOW_DOMAIN:-miroflow.onboardbi.com.br}`)"
-      - "traefik.http.routers.miroflow.tls=true"
-      - "traefik.http.routers.miroflow.tls.certresolver=letsencrypt"
-      - "traefik.http.services.miroflow.loadbalancer.server.port=8006"
-    healthcheck:
-      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8006/health')"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-
-networks:
-  arcadia-internal:
-    external: true
-    name: arcadia-internal
-  coolify:
-    external: true

docker-compose.prod.yml

@@ -25,7 +25,6 @@ services:
       retries: 10
     networks:
       - arcadia-internal
-      - coolify
 
   # ── Redis ────────────────────────────────────────────────────────────────────
   redis:
@@ -36,7 +35,6 @@ services:
       - redis_data:/data
     networks:
       - arcadia-internal
-      - coolify
 
   # ── App principal ─────────────────────────────────────────────────────────
   app:
@@ -62,26 +60,9 @@ services:
       LITELLM_API_KEY: ${LITELLM_API_KEY}
       OLLAMA_BASE_URL: ${OLLAMA_BASE_URL:-http://ollama:11434}
       # ── Manus Agent — aponta para LiteLLM como gateway unificado ──────────
+      # LiteLLM roteia para Ollama (local), LLMFit (fine-tuned) ou externo
       AI_INTEGRATIONS_OPENAI_BASE_URL: http://litellm:4000/v1
       AI_INTEGRATIONS_OPENAI_API_KEY: ${LITELLM_API_KEY}
-      # ── Arcádia Plus (Laravel) ─────────────────────────────────────────────
-      PLUS_HOST: plus
-      PLUS_PORT: "8080"
-      PLUS_AUTO_START: "false"   # container separado em prod
-      SSO_PLUS_BASE_URL: http://plus:8080
-      # ── MiroFlow ──────────────────────────────────────────────────────────
-      MIROFLOW_HOST: miroflow
-      MIROFLOW_PORT: "8006"
-      # ── Apache Superset ───────────────────────────────────────────────────
-      SUPERSET_HOST: superset
-      SUPERSET_ADMIN_USER: ${SUPERSET_ADMIN_USER:-admin}
-      SUPERSET_ADMIN_PASSWORD: ${SUPERSET_ADMIN_PASSWORD}
-      # ── ERPNext ───────────────────────────────────────────────────────────
-      ERPNEXT_PROXY_ENABLED: ${ERPNEXT_PROXY_ENABLED:-false}
-      ERPNEXT_CONTAINER_HOST: erpnext
-      ERPNEXT_URL: ${ERPNEXT_URL:-http://erpnext:8080}
-      ERPNEXT_API_KEY: ${ERPNEXT_API_KEY:-}
-      ERPNEXT_API_SECRET: ${ERPNEXT_API_SECRET:-}
     ports:
       - "5000:5000"
     depends_on:
@@ -91,113 +72,12 @@ services:
         condition: service_started
     networks:
       - arcadia-internal
-      - coolify
+      - arcadia-public
     labels:
       - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.arcadia.entrypoints=https"
       - "traefik.http.routers.arcadia.rule=Host(`${DOMAIN}`)"
       - "traefik.http.routers.arcadia.tls=true"
       - "traefik.http.routers.arcadia.tls.certresolver=letsencrypt"
-      - "traefik.http.services.arcadia.loadbalancer.server.port=5000"
-
-  # ── Arcádia Plus (Laravel + MySQL) ──────────────────────────────────────────
-  # Perfil `plus` — suba com: docker compose --profile plus up
-  plus-db:
-    image: mysql:8.0
-    restart: always
-    profiles: [plus]
-    environment:
-      MYSQL_ROOT_PASSWORD: ${PLUS_DB_ROOT_PASSWORD}
-      MYSQL_DATABASE: ${PLUS_DB_DATABASE:-arcadia_plus}
-      MYSQL_USER: ${PLUS_DB_USER:-plus}
-      MYSQL_PASSWORD: ${PLUS_DB_PASSWORD}
-    volumes:
-      - plus_db:/var/lib/mysql
-    command: --default-authentication-plugin=mysql_native_password
-    healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "--password=${PLUS_DB_ROOT_PASSWORD}"]
-      interval: 10s
-      timeout: 5s
-      retries: 10
-    networks:
-      - arcadia-internal
-
-  plus:
-    image: ${PLUS_IMAGE:-php:8.3-apache}
-    restart: always
-    profiles: [plus]
-    environment:
-      APP_ENV: production
-      APP_KEY: ${PLUS_APP_KEY}
-      APP_URL: https://${DOMAIN}/plus
-      DB_HOST: plus-db
-      DB_DATABASE: ${PLUS_DB_DATABASE:-arcadia_plus}
-      DB_USERNAME: ${PLUS_DB_USER:-plus}
-      DB_PASSWORD: ${PLUS_DB_PASSWORD}
-      SESSION_DRIVER: redis
-      REDIS_HOST: redis
-      ARCADIA_URL: https://${DOMAIN}
-      ARCADIA_SSO_SECRET: ${SSO_SECRET}
-    volumes:
-      - plus_storage:/var/www/html/storage
-    depends_on:
-      plus-db:
-        condition: service_healthy
-    networks:
-      - arcadia-internal
-
-  # ── ERPNext (Frappe Framework) ───────────────────────────────────────────────
-  # Perfil `erpnext` — suba com: docker compose --profile erpnext up
-  erpnext-db:
-    image: mariadb:10.6
-    restart: always
-    profiles: [erpnext]
-    environment:
-      MYSQL_ROOT_PASSWORD: ${ERPNEXT_DB_ROOT_PASSWORD}
-      MYSQL_DATABASE: _frappe
-      MYSQL_USER: frappe
-      MYSQL_PASSWORD: ${ERPNEXT_DB_PASSWORD}
-    volumes:
-      - erpnext_db:/var/lib/mysql
-    command: >
-      --character-set-server=utf8mb4
-      --collation-server=utf8mb4_unicode_ci
-      --skip-character-set-client-handshake
-      --skip-innodb-read-only-compressed
-    healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "--password=${ERPNEXT_DB_ROOT_PASSWORD}"]
-      interval: 10s
-      timeout: 5s
-      retries: 10
-      start_period: 30s
-    networks:
-      - arcadia-internal
-
-  erpnext:
-    image: frappe/erpnext:version-15
-    restart: always
-    profiles: [erpnext]
-    environment:
-      FRAPPE_SITE_NAME_HEADER: erpnext.local
-      ERPNEXT_DB_ROOT_PASSWORD: ${ERPNEXT_DB_ROOT_PASSWORD}
-      ERPNEXT_ADMIN_PASSWORD: ${ERPNEXT_ADMIN_PASSWORD}
-    volumes:
-      - erpnext_sites:/home/frappe/frappe-bench/sites
-      - erpnext_logs:/home/frappe/frappe-bench/logs
-      - ./docker/erpnext/init.sh:/usr/local/bin/init-erpnext.sh:ro
-    depends_on:
-      erpnext-db:
-        condition: service_healthy
-    command: ["/bin/bash", "/usr/local/bin/init-erpnext.sh"]
-    healthcheck:
-      test: ["CMD-SHELL", "curl -sf http://localhost:8080/api/method/frappe.ping || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 10
-      start_period: 120s
-    networks:
-      - arcadia-internal
 
   # ── Microserviços Python ─────────────────────────────────────────────────────
   contabil:
@@ -273,9 +153,6 @@ services:
       SERVICE_NAME: embeddings
       SERVICE_PORT: 8001
       DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/${PGDATABASE:-arcadia}
-      LITELLM_BASE_URL: http://litellm:4000
-      LITELLM_API_KEY: ${LITELLM_API_KEY}
-      OLLAMA_BASE_URL: ${OLLAMA_BASE_URL:-http://ollama:11434}
     depends_on:
       db:
         condition: service_healthy
@@ -283,7 +160,7 @@ services:
       - arcadia-internal
 
   # ── LiteLLM (gateway unificado de LLM — soberania dos dados) ─────────────────
-  # Roteia: Ollama (local) → externo (opt-in)
+  # Roteia: LLMFit (fine-tuned) → Ollama (local) → externo (opt-in)
   litellm:
     image: ghcr.io/berriai/litellm:main-latest
     restart: always
@@ -293,10 +170,12 @@ services:
     environment:
       OPENAI_API_KEY: ${OPENAI_API_KEY:-}
       LITELLM_MASTER_KEY: ${LITELLM_API_KEY}
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/litellm
+      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/${PGDATABASE:-arcadia}
       # Ollama: se instalado no host use http://host-gateway:11434
       # Se usar container Docker, mantém http://ollama:11434
       OLLAMA_BASE_URL: ${OLLAMA_BASE_URL:-http://ollama:11434}
+      # LLMFit: URL do serviço de modelos fine-tuned
+      LLMFIT_BASE_URL: ${LLMFIT_BASE_URL:-}
       # Providers externos opcionais (soberania: só habilitados se configurados)
       ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
       GROQ_API_KEY: ${GROQ_API_KEY:-}
@@ -305,7 +184,6 @@ services:
         condition: service_healthy
     networks:
       - arcadia-internal
-      - coolify
 
   # ── Ollama (LLMs locais — soberania total) ────────────────────────────────────
   # OPÇÃO A (padrão): Ollama como container Docker
@@ -318,8 +196,10 @@ services:
       - ollama_models:/root/.ollama
     networks:
       - arcadia-internal
+    # Remova 'profiles: [ai]' para ativar por padrão no deploy
+    profiles: [ai]
 
-  # ── Open WebUI (interface para Ollama) ───────────────────────────────
+  # ── Open WebUI (interface para Ollama + LLMFit) ───────────────────────────────
   open-webui:
     image: ghcr.io/open-webui/open-webui:main
     restart: always
@@ -335,7 +215,7 @@ services:
       - litellm
     networks:
       - arcadia-internal
-      - coolify
+      - arcadia-public
     labels:
       - "traefik.enable=true"
       - "traefik.http.routers.webui.rule=Host(`ai.${DOMAIN}`)"
@@ -344,88 +224,14 @@ services:
       - "traefik.http.services.webui.loadbalancer.server.port=8080"
     profiles: [ai]
 
-  # ── Superset BI ───────────────────────────────────────────────────────────────
-  superset:
-    build:
-      context: ./docker/superset
-      dockerfile: Dockerfile
-    restart: always
-    environment:
-      SUPERSET_SECRET_KEY: ${SUPERSET_SECRET_KEY}
-      SQLALCHEMY_DATABASE_URI: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/superset
-      PYTHONPATH: /app/pythonpath
-      SUPERSET_ADMIN_USERNAME: ${SUPERSET_ADMIN_USERNAME:-admin}
-      SUPERSET_ADMIN_PASSWORD: ${SUPERSET_ADMIN_PASSWORD}
-      SUPERSET_ADMIN_EMAIL: ${SUPERSET_ADMIN_EMAIL:-admin@onboardbi.com.br}
-      ARCADIA_DATABASE_URL: postgresql+psycopg2://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/${PGDATABASE:-arcadia}
-    command: ["/bin/bash", "/app/docker/init.sh"]
-    volumes:
-      - ./docker/superset/superset_config.py:/app/pythonpath/superset_config.py:ro
-      - ./docker/superset/init.sh:/app/docker/init.sh:ro
-      - superset_home:/app/superset_home
-    depends_on:
-      db:
-        condition: service_healthy
-    networks:
-      - arcadia-internal
-      - coolify
-    labels:
-      - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.superset.entrypoints=https"
-      - "traefik.http.routers.superset.rule=Host(`${SUPERSET_DOMAIN:-bi.onboardbi.com.br}`)"
-      - "traefik.http.routers.superset.tls=true"
-      - "traefik.http.routers.superset.tls.certresolver=letsencrypt"
-      - "traefik.http.services.superset.loadbalancer.server.port=8088"
-
-  # ── MiroFlow (Cientistas via Ollama) ───────────────────────────────────────────
-  miroflow:
-    build:
-      context: .
-      dockerfile: Dockerfile.miroflow
-    restart: always
-    environment:
-      OLLAMA_BASE_URL: ${OLLAMA_BASE_URL:-http://ollama:11434}
-      MIROFLOW_PORT: 8006
-      MIROFLOW_RESEARCHER_MODEL: ${MIROFLOW_RESEARCHER_MODEL:-llama3.1:8b}
-    depends_on:
-      ollama:
-        condition: service_started
-    networks:
-      - arcadia-internal
-      - coolify
-    labels:
-      - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.miroflow.entrypoints=https"
-      - "traefik.http.routers.miroflow.rule=Host(`${MIROFLOW_DOMAIN:-miroflow.onboardbi.com.br}`)"
-      - "traefik.http.routers.miroflow.tls=true"
-      - "traefik.http.routers.miroflow.tls.certresolver=letsencrypt"
-      - "traefik.http.services.miroflow.loadbalancer.server.port=8006"
-    healthcheck:
-      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8006/health')"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-
 networks:
   arcadia-internal:
     driver: bridge
-  coolify:
+  arcadia-public:
-    external: true
+    driver: bridge
 
 volumes:
   pgdata:
   redis_data:
   ollama_models:
   open_webui_data:
-
-
-
-  plus_db:
-  plus_storage:
-  superset_home:
-  erpnext_db:
-  erpnext_sites:
-  erpnext_logs:

docker-compose.shared.yml

@@ -1,62 +0,0 @@
-# ─── Arcádia — Infraestrutura Compartilhada ─────────────────────────────────
-# Serviços base: db, redis, ollama
-# Usado por: superset, miroflow, app, etc.
-
-name: arcadia-shared
-
-services:
-
-  # ── Banco de dados com pgvector ─────────────────────────────────────────────
-  db:
-    image: pgvector/pgvector:pg16
-    restart: always
-    environment:
-      POSTGRES_DB: ${PGDATABASE:-arcadia}
-      POSTGRES_USER: ${PGUSER:-arcadia}
-      POSTGRES_PASSWORD: ${PGPASSWORD}
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-      - ./docker/init-pgvector.sql:/docker-entrypoint-initdb.d/01-pgvector.sql
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${PGUSER:-arcadia}"]
-      interval: 10s
-      timeout: 5s
-      retries: 10
-    networks:
-      - arcadia-internal
-
-  # ── Redis ────────────────────────────────────────────────────────────────────
-  redis:
-    image: redis:7-alpine
-    restart: always
-    command: redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru
-    volumes:
-      - redis_data:/data
-    networks:
-      - arcadia-internal
-
-  # ── Ollama (LLMs locais — soberania total) ────────────────────────────────────
-  ollama:
-    image: ollama/ollama:latest
-    restart: always
-    volumes:
-      - ollama_models:/root/.ollama
-    networks:
-      - arcadia-internal
-      - coolify
-
-networks:
-  arcadia-internal:
-    driver: bridge
-    name: arcadia-internal
-  coolify:
-    external: true
-
-volumes:
-  pgdata:
-    external: true
-    name: arcadia-prod_pgdata
-  redis_data:
-    external: true
-    name: arcadia-prod_redis_data
-  ollama_models:

docker-compose.superset.yml

@@ -1,49 +0,0 @@
-# ─── Superset BI — Aplicação Coolify ───────────────────────────────────────
-# Conecta aos serviços compartilhados (db, redis) via network arcadia-internal
-# Requer: docker-compose.shared.yml rodando
-
-name: arcadia-superset
-
-services:
-
-  # ── Superset BI ───────────────────────────────────────────────────────────────
-  superset:
-    image: arcadia-prod-superset:latest
-    restart: always
-    environment:
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/superset
-      SUPERSET_SECRET_KEY: ${SUPERSET_SECRET_KEY}
-      SQLALCHEMY_DATABASE_URI: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/superset
-      PYTHONPATH: /app/pythonpath
-      SUPERSET_ADMIN_USERNAME: ${SUPERSET_ADMIN_USERNAME:-admin}
-      SUPERSET_ADMIN_PASSWORD: ${SUPERSET_ADMIN_PASSWORD}
-      SUPERSET_ADMIN_EMAIL: ${SUPERSET_ADMIN_EMAIL:-admin@onboardbi.com.br}
-      ARCADIA_DATABASE_URL: postgresql+psycopg2://${PGUSER:-arcadia}:${PGPASSWORD}@db:5432/${PGDATABASE:-arcadia}
-    command: ["/bin/bash", "/app/docker/init.sh"]
-    volumes:
-      - ./docker/superset/superset_config.py:/app/pythonpath/superset_config.py:ro
-      - ./docker/superset/init.sh:/app/docker/init.sh:ro
-      - superset_home:/app/superset_home
-    networks:
-      - arcadia-internal
-      - coolify
-    labels:
-      - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.superset.entrypoints=https"
-      - "traefik.http.routers.superset.rule=Host(`${SUPERSET_DOMAIN:-bi.onboardbi.com.br}`)"
-      - "traefik.http.routers.superset.tls=true"
-      - "traefik.http.routers.superset.tls.certresolver=letsencrypt"
-      - "traefik.http.services.superset.loadbalancer.server.port=8088"
-
-networks:
-  arcadia-internal:
-    external: true
-    name: arcadia-internal
-  coolify:
-    external: true
-
-volumes:
-  superset_home:
-    external: true
-    name: arcadia-prod_superset_home

docker-compose.yml

@@ -29,6 +29,8 @@ services:
   redis:
     image: redis:7-alpine
     restart: unless-stopped
+    ports:
+      - "6379:6379"
     healthcheck:
       test: ["CMD", "redis-cli", "ping"]
       interval: 10s
@@ -59,23 +61,12 @@ services:
       OPENAI_API_KEY: ${OPENAI_API_KEY:-}
       LITELLM_BASE_URL: http://litellm:4000
       LITELLM_API_KEY: ${LITELLM_API_KEY:-arcadia-internal}
-      # MetaSet BI
-      METASET_HOST: metaset
-      METASET_PORT: 8100
-      # Kernel Arcadia (Service Discovery)
-      KERNEL_ENABLED: "true"
-      KERNEL_AUTOSTART: "true"
-      COOLIFY_API_TOKEN: "${COOLIFY_API_TOKEN:-}"
     ports:
       - "5000:5000"
-      - "5001:5001"  # Kernel Arcadia (Service Discovery)
     volumes:
       - .:/app
       - /app/node_modules
       - /app/dist
-    networks:
-      - arcadia
-      - coolify
     depends_on:
       db:
         condition: service_healthy
@@ -92,16 +83,6 @@ services:
       context: .
       dockerfile: Dockerfile.python
     restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Motor Contábil"
-      - "arcadia.type=python"
-      - "arcadia.category=contabil"
-      - "arcadia.port=8003"
-      - "arcadia.capabilities=lancamentos,dre,balancete,razao"
-      - "arcadia.requires_ia=false"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=Contabilidade - Lançamentos, DRE, Balancete, Razão"
     environment:
       SERVICE_NAME: contabil
       SERVICE_PORT: 8003
@@ -119,17 +100,6 @@ services:
       context: .
       dockerfile: Dockerfile.python
     restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Motor BI"
-      - "arcadia.type=python"
-      - "arcadia.category=bi"
-      - "arcadia.port=8004"
-      - "arcadia.capabilities=sql,charts,microbi,cache"
-      - "arcadia.requires_ia=true"
-      - "arcadia.ia_policies=bi,lgpd"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=Business Intelligence - SQL, Charts, Micro-BI, Cache"
     environment:
       SERVICE_NAME: bi
       SERVICE_PORT: 8004
@@ -147,17 +117,6 @@ services:
       context: .
       dockerfile: Dockerfile.python
     restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Motor Automação"
-      - "arcadia.type=python"
-      - "arcadia.category=automation"
-      - "arcadia.port=8005"
-      - "arcadia.capabilities=scheduler,eventbus,workflow"
-      - "arcadia.requires_ia=true"
-      - "arcadia.ia_policies=automation"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=Scheduler, Event Bus, Workflow Executor"
     environment:
       SERVICE_NAME: automation
       SERVICE_PORT: 8005
@@ -175,17 +134,6 @@ services:
       context: .
       dockerfile: Dockerfile.python
     restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Motor Fiscal"
-      - "arcadia.type=python"
-      - "arcadia.category=fiscal"
-      - "arcadia.port=8002"
-      - "arcadia.capabilities=nfe,nfce,ncm,cfop,cest,sefaz"
-      - "arcadia.requires_ia=true"
-      - "arcadia.ia_policies=fiscal"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=NF-e/NFC-e - NCMs, CFOPs, CESTs, SEFAZ"
     environment:
       SERVICE_NAME: fisco
       SERVICE_PORT: 8002
@@ -203,17 +151,6 @@ services:
       context: .
       dockerfile: Dockerfile.python
     restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Serviço Embeddings"
-      - "arcadia.type=python"
-      - "arcadia.category=ai"
-      - "arcadia.port=8001"
-      - "arcadia.capabilities=embeddings,vectorsearch"
-      - "arcadia.requires_ia=true"
-      - "arcadia.ia_policies=ai,lgpd"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=Embeddings e Vector Search com pgvector"
     environment:
       SERVICE_NAME: embeddings
       SERVICE_PORT: 8001
@@ -224,145 +161,46 @@ services:
       db:
         condition: service_healthy
 
-  # ── MetaSet BI (Apache Superset Fork) ────────────────────────────────────────
+  # ── Apache Superset (BI avançado) ────────────────────────────────────────────
-  metaset:
-    build:
-      context: ./server/bi/metaset
-      dockerfile: Dockerfile
-    restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=MetaSet BI"
-      - "arcadia.type=python"
-      - "arcadia.category=bi"
-      - "arcadia.port=8100"
-      - "arcadia.capabilities=dashboards,charts,sql_lab,datasets,embedding,rls"
-      - "arcadia.requires_ia=false"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=MetaSet BI - Business Intelligence by ArcadiaSuite"
-      - "arcadia.version=4.1.0-arcadia"
-      - "traefik.enable=true"
-      - "traefik.docker.network=coolify"
-      - "traefik.http.routers.metaset.entrypoints=https"
-      - "traefik.http.routers.metaset.rule=Host(`bi.onboardbi.com.br`)"
-      - "traefik.http.routers.metaset.tls=true"
-      - "traefik.http.routers.metaset.tls.certresolver=letsencrypt"
-      - "traefik.http.services.metaset.loadbalancer.server.port=8100"
-    environment:
-      DATABASE_URL: postgresql://arcadia:arcadia123@db:5432/metaset_db
-      ARCADIA_DATABASE_URL: postgresql://arcadia:arcadia123@db:5432/arcadia
-      SUPERSET_SECRET_KEY: ${SUPERSET_SECRET_KEY:-arcadia-superset-secret-change-in-prod}
-      METASET_ADMIN_USER: ${SUPERSET_ADMIN_USER:-admin}
-      METASET_ADMIN_EMAIL: ${SUPERSET_ADMIN_EMAIL:-admin@arcadia.app}
-      METASET_ADMIN_PASSWORD: ${SUPERSET_ADMIN_PASSWORD:-arcadia2026}
-      REDIS_URL: redis://redis:6379/1
-      PYTHONPATH: /app
-      FLASK_ENV: production
-    ports:
-      - "8100:8100"
-    volumes:
-      - metaset_home:/app/superset_home
-      - ./server/bi/metaset/branding:/app/superset/static/assets/images/branding:ro
-      - ./server/bi/metaset/superset_config.py:/app/superset_config.py:ro
-    extra_hosts:
-      - "db:10.0.10.2"
-    depends_on:
-      db:
-        condition: service_healthy
-      redis:
-        condition: service_healthy
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8100/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 5
-      start_period: 60s
-
-  # ── BI-API Gateway (Node.js) ─────────────────────────────────────────────────
-  bi-api:
-    build:
-      context: .
-      dockerfile: server/bi/Dockerfile
-    restart: unless-stopped
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=BI API Gateway"
-      - "arcadia.type=node"
-      - "arcadia.category=bi"
-      - "arcadia.port=8004"
-      - "arcadia.capabilities=proxy,embed,api"
-      - "arcadia.requires_ia=false"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=BI Gateway - Proxy para MetaSet e FDB-Bridge"
-      - "arcadia.version=1.0.0"
-    environment:
-      NODE_ENV: production
-      PORT: 8004
-      METASET_HOST: metaset
-      METASET_PORT: 8100
-      FDB_BRIDGE_HOST: fdb-bridge
-      FDB_BRIDGE_PORT: 8200
-    ports:
-      - "8004:8004"
-    depends_on:
-      metaset:
-        condition: service_healthy
-
-  # ── Apache Superset (BI avançado - LEGADO, será removido) ─────────────────────
   superset:
     image: apache/superset:4.1.0
     restart: unless-stopped
-    profiles: [bi]
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=Apache Superset"
-      - "arcadia.type=java"
-      - "arcadia.category=data"
-      - "arcadia.port=8088"
-      - "arcadia.capabilities=dashboards,charts,sql_lab,datasets"
-      - "arcadia.requires_ia=false"
-      - "arcadia.health_path=/health"
-      - "arcadia.description=Apache Superset original (legado)"
-      - "arcadia.version=4.1.0"
     environment:
       SUPERSET_SECRET_KEY: ${SUPERSET_SECRET_KEY:-superset-secret-change-in-prod}
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD:-arcadia123}@db:5432/arcadia_superset
+      DATABASE_URL: postgresql://arcadia:arcadia123@db:5432/arcadia_superset
-      ARCADIA_DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD:-arcadia123}@db:5432/arcadia
-      SUPERSET_ADMIN_USER: ${SUPERSET_ADMIN_USER:-admin}
-      SUPERSET_ADMIN_EMAIL: ${SUPERSET_ADMIN_EMAIL:-admin@arcadia.app}
-      SUPERSET_ADMIN_PASSWORD: ${SUPERSET_ADMIN_PASSWORD:-arcadia2026}
-      SUPERSET_WEBSERVER_PORT: 8088
-      PYTHONPATH: /app/pythonpath
-      FLASK_ENV: production
     ports:
       - "8088:8088"
-    volumes:
-      - ./docker/superset/superset_config.py:/app/pythonpath/superset_config.py:ro
-      - ./docker/superset/init.sh:/app/docker/init.sh:ro
-      - superset_home:/app/superset_home
-    extra_hosts:
-      - "db:10.0.10.2"
     depends_on:
       db:
         condition: service_healthy
-    command: ["/bin/bash", "/app/docker/init.sh"]
+    profiles: [bi]
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8088/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 5
-      start_period: 60s
-    networks:
-      - arcadia
 
   # ─────────────── PERFIL: ai (Soberania de IA) ────────────────────────────────
 
+  # ── Ollama (LLMs locais) ─────────────────────────────────────────────────────
+  ollama:
+    image: ollama/ollama:latest
+    restart: unless-stopped
+    volumes:
+      - ollama_models:/root/.ollama
+    ports:
+      - "11434:11434"
+    profiles: [ai]
+    # Para GPU NVIDIA: adicione `deploy.resources.reservations.devices`
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: nvidia
+    #           count: 1
+    #           capabilities: [gpu]
+
   # ── Open WebUI (interface para devs/consultores) ─────────────────────────────
   open-webui:
     image: ghcr.io/open-webui/open-webui:main
     restart: unless-stopped
     environment:
-      OLLAMA_BASE_URL: http://ollama-ia1upsekrad96at5hq97e4qa:11434
+      OLLAMA_BASE_URL: http://ollama:11434
       WEBUI_SECRET_KEY: ${WEBUI_SECRET_KEY:-webui-secret-change-in-prod}
       DEFAULT_MODELS: llama3.3,qwen2.5-coder
       ENABLE_RAG_WEB_SEARCH: "true"
@@ -370,6 +208,8 @@ services:
       - "3001:8080"
     volumes:
       - open_webui_data:/app/backend/data
+    depends_on:
+      - ollama
     profiles: [ai]
 
   # ── LiteLLM (proxy unificado de LLMs) ───────────────────────────────────────
@@ -381,103 +221,13 @@ services:
     command: ["--config", "/app/config.yaml", "--port", "4000", "--detailed_debug"]
     environment:
       OPENAI_API_KEY: ${OPENAI_API_KEY:-}
-      OLLAMA_BASE_URL: http://ollama-ia1upsekrad96at5hq97e4qa:11434
+      OLLAMA_BASE_URL: http://ollama:11434
       LITELLM_MASTER_KEY: ${LITELLM_API_KEY:-arcadia-internal}
     ports:
       - "4000:4000"
     profiles: [ai]
 
-  # ─────────────── PERFIL: erpnext (ERPNext local) ──────────────────────────────
-
-  # ── MariaDB para ERPNext ─────────────────────────────────────────────────────
-  erpnext-db:
-    image: mariadb:10.6
-    restart: unless-stopped
-    profiles: [erpnext]
-    environment:
-      MYSQL_ROOT_PASSWORD: ${ERPNEXT_DB_ROOT_PASSWORD:-erpnext-root-2026}
-      MYSQL_DATABASE: _frappe
-      MYSQL_USER: frappe
-      MYSQL_PASSWORD: ${ERPNEXT_DB_PASSWORD:-frappe2026}
-    volumes:
-      - erpnext_db:/var/lib/mysql
-    command: >
-      --character-set-server=utf8mb4
-      --collation-server=utf8mb4_unicode_ci
-      --skip-character-set-client-handshake
-      --skip-innodb-read-only-compressed
-    healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "--password=${ERPNEXT_DB_ROOT_PASSWORD:-erpnext-root-2026}"]
-      interval: 10s
-      timeout: 5s
-      retries: 10
-      start_period: 30s
-
-  # ── Neo4j (Knowledge Graph) ──────────────────────────────────────────────────
-  neo4j:
-    image: neo4j:5.20-community
-    restart: unless-stopped
-    profiles: [agentic]
-    environment:
-      NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:-arcadia123}
-      NEO4J_PLUGINS: '["apoc"]'
-      NEO4J_dbms_security_procedures_unrestricted: apoc.*
-    volumes:
-      - neo4j_data:/data
-      - neo4j_logs:/logs
-    ports:
-      - "7474:7474"
-      - "7687:7687"
-    healthcheck:
-      test: ["CMD-SHELL", "wget -qO- http://localhost:7474 || exit 1"]
-      interval: 20s
-      timeout: 10s
-      retries: 5
-      start_period: 30s
-    networks:
-      - arcadia
-
-  # ── ERPNext (Frappe Framework + ERPNext app) ─────────────────────────────────
-  erpnext:
-    image: frappe/erpnext:version-15
-    restart: unless-stopped
-    profiles: [erpnext]
-    environment:
-      FRAPPE_SITE_NAME_HEADER: erpnext.local
-      BACKEND_PORT: 8000
-    volumes:
-      - erpnext_sites:/home/frappe/frappe-bench/sites
-      - erpnext_logs:/home/frappe/frappe-bench/logs
-      - ./docker/erpnext/init.sh:/usr/local/bin/init-erpnext.sh:ro
-    depends_on:
-      erpnext-db:
-        condition: service_healthy
-    ports:
-      - "8090:8080"
-    command: ["/bin/bash", "/usr/local/bin/init-erpnext.sh"]
-    healthcheck:
-      test: ["CMD-SHELL", "curl -sf http://localhost:8080/api/method/frappe.ping || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 10
-      start_period: 120s
-    networks:
-      - arcadia
-
 volumes:
   pgdata:
+  ollama_models:
   open_webui_data:
-  superset_home:
-  metaset_home:
-  erpnext_db:
-  erpnext_sites:
-  erpnext_logs:
-  neo4j_data:
-  neo4j_logs:
-
-networks:
-  arcadia:
-    driver: bridge
-  coolify:
-    external: true
-    name: coolify

docker/erpnext/init.sh

@@ -1,56 +0,0 @@
-#!/bin/bash
-# ─── ERPNext init — cria site e instala app se necessário ─────────────────────
-# Executado como entrypoint do container frappe/erpnext:version-15
-
-set -e
-
-SITE_NAME="${FRAPPE_SITE_NAME:-erpnext.local}"
-DB_HOST="${DB_HOST:-erpnext-db}"
-DB_ROOT_PASSWORD="${ERPNEXT_DB_ROOT_PASSWORD:-erpnext-root-2026}"
-ADMIN_PASSWORD="${ERPNEXT_ADMIN_PASSWORD:-admin2026}"
-BENCH_DIR="/home/frappe/frappe-bench"
-
-echo "[ERPNext Init] Aguardando MariaDB em ${DB_HOST}..."
-until mysqladmin ping -h "${DB_HOST}" -u root --password="${DB_ROOT_PASSWORD}" --silent 2>/dev/null; do
-  echo "[ERPNext Init] MariaDB ainda não disponível — aguardando 3s..."
-  sleep 3
-done
-echo "[ERPNext Init] MariaDB disponível."
-
-cd "${BENCH_DIR}"
-
-SITES_DIR="${BENCH_DIR}/sites"
-SITE_DIR="${SITES_DIR}/${SITE_NAME}"
-
-if [ ! -f "${SITE_DIR}/site_config.json" ]; then
-  echo "[ERPNext Init] Criando site ${SITE_NAME}..."
-
-  bench new-site "${SITE_NAME}" \
-    --mariadb-root-password "${DB_ROOT_PASSWORD}" \
-    --admin-password "${ADMIN_PASSWORD}" \
-    --db-host "${DB_HOST}" \
-    --no-mariadb-socket \
-    --verbose || true
-
-  echo "[ERPNext Init] Instalando app erpnext..."
-  bench --site "${SITE_NAME}" install-app erpnext || true
-
-  echo "[ERPNext Init] Ativando modo developer..."
-  bench --site "${SITE_NAME}" set-config developer_mode 1 || true
-
-  echo "[ERPNext Init] Desativando SSL para env local..."
-  bench --site "${SITE_NAME}" set-config ssl_certificate "" || true
-
-  echo "[ERPNext Init] Site criado com sucesso."
-else
-  echo "[ERPNext Init] Site ${SITE_NAME} já existe — pulando criação."
-fi
-
-# Configura common_site_config.json para servir na porta 8080
-if [ ! -f "${SITES_DIR}/common_site_config.json" ]; then
-  echo '{"serve_default_site": true, "socketio_port": 9000, "background_workers": 1}' \
-    > "${SITES_DIR}/common_site_config.json"
-fi
-
-echo "[ERPNext Init] Iniciando servidor Frappe na porta 8080..."
-exec bench serve --port 8080 --site "${SITE_NAME}"

docker/litellm-config.yaml

@@ -3,18 +3,45 @@
 #
 # ESTRATÉGIA DE SOBERANIA DOS DADOS:
 # ┌─────────────────────────────────────────────────────────────────────────┐
-# │  TIER 1 (soberania total): Ollama — modelos open source no servidor     │
+# │  TIER 1 (soberania total): LLMFit — modelos fine-tuned locais           │
-# │  TIER 2 (opt-in): Providers externos — só com configuração explícita    │
+# │  TIER 2 (soberania total): Ollama — modelos open source no servidor     │
+# │  TIER 3 (opt-in): Providers externos — só com configuração explícita    │
 # └─────────────────────────────────────────────────────────────────────────┘
 # O Manus, Autonomous Agents e todos os serviços chamam APENAS este proxy.
 # Nunca chamam APIs externas diretamente.
 
 model_list:
 
-  # ── TIER 1: Ollama (LLMs locais — soberania total) ───────────────────────────
+  # ── TIER 1: LLMFit (modelos fine-tuned locais — máxima soberania) ────────────
-  - model_name: llama3.2
+  # Descomente quando o LLMFit estiver rodando no servidor
+  # O LLMFit expõe API compatível com OpenAI — basta apontar a URL
+  #
+  # - model_name: arcadia-finetuned
+  #   litellm_params:
+  #     model: openai/arcadia-v1          # nome do modelo no LLMFit
+  #     api_base: os.environ/LLMFIT_BASE_URL
+  #     api_key: llmfit-internal
+  #
+  # - model_name: arcadia-embed
+  #   litellm_params:
+  #     model: openai/arcadia-embed-v1    # modelo de embeddings fine-tuned
+  #     api_base: os.environ/LLMFIT_BASE_URL
+  #     api_key: llmfit-internal
+
+  # ── TIER 2: Ollama (LLMs locais — soberania total) ───────────────────────────
+  - model_name: llama3.3
     litellm_params:
-      model: ollama/llama3.2:3b
+      model: ollama/llama3.3
+      api_base: os.environ/OLLAMA_BASE_URL
+
+  - model_name: qwen2.5-coder
+    litellm_params:
+      model: ollama/qwen2.5-coder:7b
+      api_base: os.environ/OLLAMA_BASE_URL
+
+  - model_name: deepseek-r1
+    litellm_params:
+      model: ollama/deepseek-r1:7b
       api_base: os.environ/OLLAMA_BASE_URL
 
   - model_name: nomic-embed-text
@@ -22,13 +49,7 @@ model_list:
       model: ollama/nomic-embed-text
       api_base: os.environ/OLLAMA_BASE_URL
 
-  # Alias OpenAI-compatible para embedding (Manus usa este nome por padrão)
+  # ── TIER 3: OpenAI (opt-in — só ativo se OPENAI_API_KEY configurado) ─────────
-  - model_name: text-embedding-3-small
-    litellm_params:
-      model: ollama/nomic-embed-text
-      api_base: os.environ/OLLAMA_BASE_URL
-
-  # ── TIER 2: OpenAI (opt-in — só ativo se OPENAI_API_KEY configurado) ─────────
   - model_name: gpt-4o
     litellm_params:
       model: openai/gpt-4o
@@ -39,35 +60,42 @@ model_list:
       model: openai/gpt-4o-mini
       api_key: os.environ/OPENAI_API_KEY
 
-  # ── TIER 2: Anthropic (opt-in — descomente para habilitar) ───────────────────
+  # ── TIER 3: Anthropic (opt-in — descomente para habilitar) ───────────────────
   # - model_name: claude-sonnet
   #   litellm_params:
   #     model: anthropic/claude-sonnet-4-6
   #     api_key: os.environ/ANTHROPIC_API_KEY
 
-  # ── TIER 2: Groq (opt-in — inferência rápida sem dados persistidos) ──────────
+  # ── TIER 3: Groq (opt-in — inferência rápida sem dados persistidos) ──────────
   # - model_name: groq-llama
   #   litellm_params:
   #     model: groq/llama-3.3-70b-versatile
   #     api_key: os.environ/GROQ_API_KEY
 
   # ── Modelo padrão do Arcádia (Manus usa este) ─────────────────────────────────
+  # Prioridade: LLMFit → OpenAI (se configurado) → Ollama (sempre disponível)
+  # Para soberania total: remova o fallback para gpt-4o-mini
   - model_name: arcadia-default
     litellm_params:
-      model: ollama/llama3.2:3b
+      model: ollama/llama3.3
       api_base: os.environ/OLLAMA_BASE_URL
+    model_info:
+      # fallbacks: ["gpt-4o-mini"]    # descomente para habilitar fallback externo
 
 router_settings:
   routing_strategy: least-busy
-    fallbacks:
+  fallbacks:
-    - {"gpt-4o": ["llama3.2"]}
+    - {"gpt-4o": ["llama3.3"]}
-    - {"gpt-4o-mini": ["llama3.2"]}
+    - {"gpt-4o-mini": ["llama3.3"]}
-    - {"arcadia-default": ["llama3.2"]}
+    - {"arcadia-default": ["llama3.3"]}
 
 litellm_settings:
   drop_params: true
   request_timeout: 120
   set_verbose: false
+  # Loga todas as chamadas no banco — essencial para auditoria e soberania
+  success_callback: ["langfuse"]
+  failure_callback: ["langfuse"]
 
 general_settings:
   master_key: os.environ/LITELLM_MASTER_KEY

docker/superset/Dockerfile

@@ -1,5 +0,0 @@
-FROM apache/superset:latest
-USER root
-RUN pip install psycopg2-binary && \
-    sed -i 's/include-system-site-packages = false/include-system-site-packages = true/' /app/.venv/pyvenv.cfg
-USER superset

docker/superset/init.sh

@@ -1,83 +0,0 @@
-#!/bin/bash
-# Arcádia Suite — Apache Superset Init Script
-# Executado ao iniciar o container
-set -e
-
-SUPERSET_ADMIN_USER="${SUPERSET_ADMIN_USERNAME:-${SUPERSET_ADMIN_USER:-admin}}"
-SUPERSET_ADMIN_EMAIL="${SUPERSET_ADMIN_EMAIL:-admin@arcadia.app}"
-SUPERSET_ADMIN_PASSWORD="${SUPERSET_ADMIN_PASSWORD:-arcadia2026}"
-ARCADIA_DB_URL="${ARCADIA_DATABASE_URL:-postgresql://arcadia:arcadia123@db:5432/arcadia}"
-
-echo "[Superset Init] Aguardando PostgreSQL..."
-cat > /tmp/pgcheck.py << 'EOF'
-import psycopg2, os, sys
-url = os.environ.get('SQLALCHEMY_DATABASE_URI', 'postgresql://arcadia:arcadia123@db:5432/superset')
-try:
-    psycopg2.connect(url)
-except Exception:
-    sys.exit(1)
-EOF
-until python /tmp/pgcheck.py 2>/dev/null; do
-  sleep 2
-done
-echo "[Superset Init] PostgreSQL disponível!"
-
-echo "[Superset Init] Rodando migrações do banco..."
-superset db upgrade
-
-echo "[Superset Init] Criando admin..."
-superset fab create-admin \
-  --username "${SUPERSET_ADMIN_USER}" \
-  --firstname "Arcádia" \
-  --lastname "Admin" \
-  --email "${SUPERSET_ADMIN_EMAIL}" \
-  --password "${SUPERSET_ADMIN_PASSWORD}" 2>/dev/null || echo "[Superset Init] Admin já existe."
-
-echo "[Superset Init] Inicializando roles e permissões..."
-superset init
-
-echo "[Superset Init] Registrando banco Arcádia Suite..."
-python - <<PYEOF
-import sys
-try:
-    from superset import create_app
-    from superset.extensions import db as sdb
-    from superset.models.core import Database as SupersetDB
-
-    app = create_app()
-    with app.app_context():
-        existing = sdb.session.query(SupersetDB).filter_by(database_name="Arcádia Suite").first()
-        if not existing:
-            new_db = SupersetDB(
-                database_name="Arcádia Suite",
-                sqlalchemy_uri="${ARCADIA_DB_URL}",
-                expose_in_sqllab=True,
-                allow_run_async=True,
-                allow_csv_upload=False,
-                allow_ctas=False,
-                allow_cvas=False,
-                allow_dml=False,
-                extra='{"metadata_params":{},"engine_params":{},"metadata_cache_timeout":{},"schemas_allowed_for_file_upload":[]}',
-            )
-            sdb.session.add(new_db)
-            sdb.session.commit()
-            print("[Superset Init] Banco 'Arcádia Suite' registrado com sucesso!")
-        else:
-            print("[Superset Init] Banco 'Arcádia Suite' já está registrado.")
-except Exception as e:
-    print(f"[Superset Init] Aviso ao registrar banco: {e}")
-    sys.exit(0)
-PYEOF
-
-echo "[Superset Init] Iniciando servidor Superset..."
-exec gunicorn \
-  --bind "0.0.0.0:${SUPERSET_WEBSERVER_PORT:-8088}" \
-  --access-logfile - \
-  --error-logfile - \
-  --workers "${SUPERSET_WORKERS:-4}" \
-  --worker-class gthread \
-  --threads 2 \
-  --timeout 120 \
-  --limit-request-line 0 \
-  --limit-request-field_size 0 \
-  "superset.app:create_app()"

docker/superset/superset_config.py

@@ -1,62 +0,0 @@
-"""
-Arcádia Suite — Apache Superset Configuration
-Habilita embedding nativo via Guest Token JWT
-"""
-import os
-
-# ── Segurança ─────────────────────────────────────────────────────────────────
-SECRET_KEY = os.environ.get("SUPERSET_SECRET_KEY", "change-in-production-use-openssl-rand-hex-32")
-
-# ── Banco de metadados do Superset ────────────────────────────────────────────
-SQLALCHEMY_DATABASE_URI = os.environ.get(
-    "SQLALCHEMY_DATABASE_URI",
-    os.environ.get("DATABASE_URL", "postgresql://arcadia:arcadia123@db:5432/superset")
-)
-
-# ── CORS — permite o gateway Arcádia (:5000) chamar a API ────────────────────
-ENABLE_CORS = True
-CORS_OPTIONS = {
-    "supports_credentials": True,
-    "allow_headers": ["*"],
-    "resources": {r"/api/*": {"origins": "*"}},
-}
-
-# ── Feature Flags ─────────────────────────────────────────────────────────────
-FEATURE_FLAGS = {
-    "EMBEDDED_SUPERSET": True,          # Embedding via Guest Token
-    "ENABLE_TEMPLATE_PROCESSING": True, # Jinja templates em queries
-    "ALERT_REPORTS": True,              # Alertas automáticos
-    "DRILL_TO_DETAIL": True,            # Drill-down em charts
-    "DRILL_BY": True,                   # Drill-by em charts
-    "DASHBOARD_NATIVE_FILTERS": True,   # Filtros nativos em dashboards
-    "DASHBOARD_CROSS_FILTERS": True,    # Cross-filter entre charts
-    "ENABLE_JAVASCRIPT_CONTROLS": False, # Desabilitado por segurança
-}
-
-# ── Cache ─────────────────────────────────────────────────────────────────────
-CACHE_CONFIG = {
-    "CACHE_TYPE": "SimpleCache",
-    "CACHE_DEFAULT_TIMEOUT": 300,  # 5 minutos
-}
-
-# ── Timeout de queries ────────────────────────────────────────────────────────
-SUPERSET_WEBSERVER_TIMEOUT = 300
-SQLLAB_TIMEOUT = 300
-SQLLAB_ASYNC_TIME_LIMIT_SEC = 300
-
-# ── Branding Arcádia ──────────────────────────────────────────────────────────
-APP_NAME = "Arcádia Insights"
-LOGO_TARGET_PATH = "/"
-FAVICONS = [{"href": "/static/assets/images/favicon.png"}]
-
-# ── Segurança de sessão ───────────────────────────────────────────────────────
-SESSION_COOKIE_SAMESITE = "Lax"
-SESSION_COOKIE_SECURE = False   # True em prod com HTTPS
-WTF_CSRF_ENABLED = True
-WTF_CSRF_EXEMPT_LIST = ["superset.views.core.log"]
-
-# ── Guest Token (para embedding) ──────────────────────────────────────────────
-GUEST_TOKEN_JWT_EXP_SECONDS = 300  # 5 minutos — frontend renova automaticamente
-GUEST_ROLE_NAME = "Public"
-GUEST_TOKEN_JWT_ALGO = "HS256"
-GUEST_TOKEN_HEADER_NAME = "X-GuestToken"

docs/.env.example

@@ -1,58 +0,0 @@
-# ===========================================
-# Arcádia Suite - Variáveis de Ambiente
-# ===========================================
-# Copie este arquivo para .env na raiz do projeto
-# e preencha com seus valores
-
-# -----------------------------
-# Banco de Dados PostgreSQL
-# -----------------------------
-DATABASE_URL=postgresql://arcadia:SUA_SENHA_AQUI@localhost:5432/arcadia_suite
-PGHOST=localhost
-PGPORT=5432
-PGUSER=arcadia
-PGPASSWORD=SUA_SENHA_AQUI
-PGDATABASE=arcadia_suite
-
-# -----------------------------
-# Ambiente
-# -----------------------------
-NODE_ENV=production
-PORT=5000
-
-# -----------------------------
-# Sessão e Segurança
-# -----------------------------
-# Gere uma chave aleatória: openssl rand -base64 32
-SESSION_SECRET=GERE_UMA_CHAVE_ALEATORIA_LONGA_AQUI
-
-# -----------------------------
-# ERPNext (opcional)
-# -----------------------------
-ERPNEXT_URL=https://seu-erpnext.com
-ERPNEXT_API_KEY=sua_api_key
-ERPNEXT_API_SECRET=seu_api_secret
-
-# -----------------------------
-# OpenAI (opcional - para IA)
-# -----------------------------
-OPENAI_API_KEY=sk-sua-chave-openai
-
-# -----------------------------
-# WhatsApp Baileys (opcional)
-# -----------------------------
-# As sessões são armazenadas automaticamente em ./baileys_sessions
-
-# -----------------------------
-# Fiscal - SEFAZ (opcional)
-# -----------------------------
-# Caminho para o certificado digital A1 (.pfx)
-CERT_PATH=/path/to/certificado.pfx
-CERT_PASSWORD=senha_do_certificado
-SEFAZ_AMBIENTE=2  # 1=Produção, 2=Homologação
-
-# -----------------------------
-# ChromaDB (opcional)
-# -----------------------------
-CHROMA_HOST=localhost
-CHROMA_PORT=8000

docs/AGENTE_MONITOR_SKILLS.md

@@ -1,54 +0,0 @@
----
-⚠️ **AVISO: DOCUMENTAÇÃO HISTÓRICA**
-
-Este documento foi criado em **Março/2026** como planejamento estratégico.
-Pode conter informações desatualizadas em relação ao sistema atual.
-
-Para documentação técnica atualizada, consulte:
-- \_SPEC_NAVBAR.md\_ (componentes UI)
-- \_KERNEL_SPEC.md\_ (arquitetura do Kernel)
-- Código-fonte em \_server/modules/\_
-
----
-
-# Agente: Monitor de Skills
-
-## Objetivo
-Verificar as skills mais executadas nos últimos 7 dias e gerar um resumo com recomendações.
-
-## Passos
-
-1. **Consultar execuções recentes**
-   - Buscar em `/api/skills` todas as skills ativas do tenant
-   - Para cada skill, buscar `/api/skills/:id/executions?limit=50`
-   - Filtrar execuções dos últimos 7 dias
-
-2. **Analisar padrões**
-   - Contar total de execuções por skill
-   - Identificar taxa de sucesso (status = "success" / total)
-   - Destacar skills com taxa de falha > 20%
-
-3. **Gerar relatório**
-   - Listar top 5 skills mais executadas
-   - Alertar skills com problemas
-   - Sugerir skills candidatas a automação (executadas 3+ vezes por dia)
-
-## Saída esperada
-
-```
-## Relatório de Skills — últimos 7 dias
-
-### Top 5 mais usadas
-1. [nome] — X execuções (Y% sucesso)
-...
-
-### Atenção
-- [skill] com taxa de falha de Z%
-
-### Candidatas ao OpenClaw
-- [skill] — média de N exec/dia
-```
-
-## Parâmetros
-- `tenant_id` — filtro de tenant (opcional)
-- `dias` — janela de análise (padrão: 7)

docs/AGENTS.md

@@ -1,203 +0,0 @@
-# 🤖 Referência Rápida para Agentes - Arcádia Suite
-
-> Guia de referência para desenvolvimento autônomo no projeto Arcádia Suite
-
----
-
-## 📁 Documentação Técnica por Componente
-
-### Navegação (Navbar)
-- **Especificação Completa:** [`docs/SPEC_NAVBAR.md`](docs/SPEC_NAVBAR.md)
-- **Arquivo Fonte:** `client/src/components/Browser/BrowserFrame.tsx`
-- **Hook de Tracking:** `client/src/hooks/use-navigation-tracking.ts`
-- **Error Boundary:** `client/src/components/ErrorBoundary.tsx` (tratamento de erros lazy loading)
-
-### Banco de Dados (Schema)
-- **Arquivo Principal:** `shared/schema.ts` (7.000+ linhas)
-- **Tabelas Principais:**
-  - `users`, `profiles`, `roles` - Autenticação e RBAC
-  - `tenants`, `tenantUsers` - Multi-tenancy
-  - `workspacePages`, `pageBlocks` - Produtividade (estilo Notion)
-  - `conversations`, `messages` - Chat/Agente
-  - `whatsappSessions`, `whatsappMessages` - WhatsApp
-  - `crmPartners`, `crmContracts` - CRM
-  - `fiscalNcms`, `fiscalGruposTributacao` - Fiscal
-  - `retailStores`, `posSales`, `mobileDevices` - Retail
-  - `manusRuns`, `manusSteps` - Agente Manus
-  - `biDatasets`, `biCharts`, `biDashboards` - BI
-
-### Backend (API Routes)
-- **Registro de Rotas:** `server/routes.ts`
-- **Autenticação:** `server/auth.ts`
-- **Agente Manus:** `server/manus/service.ts` + `server/manus/tools.ts`
-- **WhatsApp:** `server/whatsapp/routes.ts` + `server/whatsapp/service.ts`
-- **CRM:** `server/crm/routes.ts`
-- **Fiscal:** `server/fisco/routes.ts`
-- **Retail:** `server/retail/routes.ts`
-- **Blackboard (Agentes):** `server/blackboard/routes.ts`
-
-### Frontend (Páginas)
-- **Router:** `client/src/App.tsx` (inclui ErrorBoundary + Suspense)
-- **Cockpit (Home):** `client/src/pages/Cockpit.tsx`
-- **Agent:** `client/src/pages/Agent.tsx`
-- **DevCenter:** `client/src/pages/DevCenter.tsx`
-- **Crm:** `client/src/pages/Crm.tsx`
-- **Fisco:** `client/src/pages/Fisco.tsx`
-- **Retail:** `client/src/pages/ArcadiaRetail.tsx`
-- **WhatsApp:** `client/src/pages/WhatsApp.tsx`
-- **ErrorBoundary:** `client/src/components/ErrorBoundary.tsx`
-
----
-
-## 🏗️ Arquitetura do Sistema
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    CAMADA DE APRESENTAÇÃO                        │
-│   React 18 + TypeScript + Tailwind CSS + shadcn/ui              │
-│   66 páginas / Interface tipo browser com abas                  │
-└─────────────────────────────────────────────────────────────────┘
-                              ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                   CAMADA DE ORQUESTRAÇÃO                         │
-│   Express.js + Socket.IO + Manus Agent                          │
-│   API REST + WebSocket em tempo real                            │
-└─────────────────────────────────────────────────────────────────┘
-                              ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                   CAMADA DE INTELIGÊNCIA                         │
-│   FastAPI (Contábil 8003, BI 8004, Automação 8005)              │
-│   OpenAI GPT-4o + LiteLLM Gateway + Ollama                      │
-└─────────────────────────────────────────────────────────────────┘
-                              ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      CAMADA DE DADOS                             │
-│   PostgreSQL 16 + Drizzle ORM + pgvector                        │
-│   Session Store + Multi-tenant                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 🛠️ Stack Tecnológico
-
-| Camada | Tecnologia |
-|--------|------------|
-| **Frontend** | React 18, TypeScript, Tailwind CSS, shadcn/ui |
-| **Backend** | Express.js, Socket.IO, Passport.js |
-| **Banco** | PostgreSQL 16, Drizzle ORM, pgvector |
-| **Python** | FastAPI (microserviços nas portas 8001-8005) |
-| **IA** | OpenAI GPT-4o, LiteLLM, Ollama |
-| **Deploy** | Docker Compose, Coolify, PM2 |
-
----
-
-## 🔧 Comandos Úteis
-
-```bash
-# Desenvolvimento
-npm run dev                    # Inicia servidor de desenvolvimento
-npm run dev:client            # Apenas frontend (porta 5000)
-
-# Banco de dados
-npm run db:push               # Aplica migrations Drizzle
-npm run db:apply-rls          # Aplica políticas RLS
-
-# Build
-npm run build                 # Build para produção
-npm run start                 # Inicia em produção
-
-# Docker
-docker compose up -d          # Sobe todos os serviços
-docker compose --profile ai up  # Sobe com IA (Ollama + LiteLLM)
-```
-
----
-
-## 📋 Convenções de Código
-
-### Nomenclatura
-- **Componentes:** PascalCase (ex: `BrowserFrame.tsx`)
-- **Hooks:** camelCase com prefixo `use` (ex: `useAuth.tsx`)
-- **Utilitários:** camelCase (ex: `navigation-tracking.ts`)
-- **Rotas API:** kebab-case (ex: `/api/whatsapp/connect`)
-
-### Estrutura de Pastas
-```
-client/src/
-  components/     # Componentes reutilizáveis
-  pages/          # Páginas da aplicação
-  hooks/          # Custom hooks
-  lib/            # Utilitários e configurações
-  
-server/
-  [modulo]/       # Um diretório por módulo
-    routes.ts     # Rotas da API
-    service.ts    # Lógica de negócio
-    storage.ts    # Acesso a dados
-```
-
----
-
-## 🧪 Test IDs
-
-Sempre adicione `data-testid` em elementos interativos:
-
-```tsx
-<button 
-  data-testid="button-submit"
-  onClick={handleSubmit}
->
-  Enviar
-</button>
-```
-
----
-
-## 📚 Documentação Adicional
-
-- **Documentação Técnica Completa:** [`DOCUMENTATION.md`](DOCUMENTATION.md)
-- **Mapa do Sistema:** [`MAPA_SISTEMA_ARCADIA.md`](MAPA_SISTEMA_ARCADIA.md)
-- **Contexto para Claude:** [`CLAUDE.md`](CLAUDE.md)
-- **README:** [`README.md`](README.md)
-
----
-
-## 🆘 Precisa de Ajuda?
-
-1. Consulte a especificação técnica específica em `docs/`
-2. Verifique exemplos similares no código existente
-3. Siga os padrões já estabelecidos no projeto
-
----
-
-*Última atualização: 2026-04-08*
-
----
-
-## 🐛 Tratamento de Erros - Lazy Loading
-
-### Problema Resolvido: Loading Infinito na Navegação
-
-**Sintoma:** Ao clicar em itens da navbar, se a página tivesse erro (import quebrado, sintaxe inválida), o loading ficava infinito.
-
-**Causa:** `React.lazy()` falha silenciosamente e `Suspense` não tem como capturar o erro.
-
-**Solução:**
-
-1. **ErrorBoundary** (`client/src/components/ErrorBoundary.tsx`):
-   - Captura erros de renderização, incluindo lazy load
-   - Mostra UI de fallback com botão de retry
-
-2. **LoadingFallback com Timeout** (`client/src/App.tsx`):
-   - 3s: mensagem "Isso está demorando..."
-   - 10s: alerta amarelo com botão recarregar
-
-3. **Integração:**
-```tsx
-<ErrorBoundary>
-  <Suspense fallback={<LoadingFallback />}>
-    <Switch>{/* rotas */}</Switch>
-  </Suspense>
-</ErrorBoundary>
-```

docs/AUDITORIA_XOS_v1.0.md

@@ -1,374 +0,0 @@
-# AUDITORIA DO PLANO XOS - Arcádia Suite v1.0
-**Data:** 06 de Fevereiro de 2026
-**Projeto:** Arcádia Suite - Office Estratégico Empresarial
-**Escopo:** Sistema Operacional de Desenvolvimento Autônomo (XOS) com Blackboard Architecture
-
----
-
-## RESUMO EXECUTIVO
-
-O plano XOS v1.0 foi executado em **4 fases** progressivas, transformando o Arcádia Suite de um sistema de automação empresarial em um **sistema operacional de desenvolvimento autônomo** com 6 agentes de IA especializados, governança de segurança, e pipeline autônomo de ponta a ponta.
-
-| Indicador | Valor |
-|---|---|
-| Fases planejadas | 4 |
-| Fases executadas | 4 (100%) |
-| Agentes de IA criados | 6 |
-| Tabelas de banco criadas | 31 (XOS) + 3 (Blackboard) = 34 novas tabelas |
-| Linhas de código (XOS backend) | ~5.491 linhas |
-| Linhas de código (XOS frontend) | ~988 linhas |
-| APIs criadas | 22+ endpoints |
-| Páginas UI criadas | 2 (Governance Dashboard + Pipeline UI) |
-
----
-
-## FASE 1 - FUNDAÇÃO (Blackboard + Agentes Base)
-**Status: CONCLUIDO**
-
-### O que foi planejado:
-- Criar arquitetura Blackboard centralizada para coordenação de agentes
-- Implementar agentes base de IA para desenvolvimento autônomo
-- Sistema de ferramentas (ToolManager) para interação com código
-
-### O que foi executado:
-
-#### 1.1 Blackboard Service (`server/blackboard/service.ts` - 476 linhas)
-- Quadro negro centralizado para coordenação de tarefas entre agentes
-- Criação, atribuição e monitoramento de tarefas
-- Gerenciamento de artefatos (código gerado, especificações, relatórios)
-- Logging estruturado por agente
-
-#### 1.2 Base Agent (`server/blackboard/BaseBlackboardAgent.ts` - 189 linhas)
-- Classe abstrata para todos os agentes de IA
-- Loop thought-action-observation com OpenAI
-- Polling automático para busca de tarefas pendentes
-- Integração com governança para verificação de políticas
-- Event emitter para comunicação entre agentes
-
-#### 1.3 Context Indexer (`server/blackboard/ContextIndexer.ts` - 277 linhas)
-- Indexação inteligente da estrutura do projeto
-- Mapeamento de arquivos, imports e dependências
-- Contexto técnico para agentes tomarem decisões informadas
-
-#### 1.4 ToolManager (`server/autonomous/tools/ToolManager.ts` - 171 linhas)
-- Registro e execução de ferramentas para agentes
-- 10 ferramentas implementadas:
-
-| Ferramenta | Arquivo | Linhas | Função |
-|---|---|---|---|
-| ReadFileTool | filesystem/ReadFileTool.ts | 66 | Leitura de arquivos do projeto |
-| WriteFileTool | filesystem/WriteFileTool.ts | 88 | Escrita segura de arquivos |
-| ListDirectoryTool | filesystem/ListDirectoryTool.ts | 85 | Listagem de diretórios |
-| SearchCodeTool | filesystem/SearchCodeTool.ts | 92 | Busca por padrões no código |
-| RunCommandTool | command/RunCommandTool.ts | 76 | Execução de comandos shell |
-| TypeCheckTool | command/TypeCheckTool.ts | 70 | Validação TypeScript real |
-| GitStatusTool | git/GitStatusTool.ts | 47 | Status do repositório |
-| GitCommitTool | git/GitCommitTool.ts | 67 | Commits automáticos |
-| AnalyzeRepoTool | github/AnalyzeRepoTool.ts | 41 | Análise de repos externos |
-| ReadExternalFileTool | github/ReadExternalFileTool.ts | 41 | Leitura de repos GitHub |
-| GitHubCommitTool | github/GitHubCommitTool.ts | 55 | Commits via GitHub API |
-
-#### 1.5 Tabelas de Banco (Fase 1)
-
-| Tabela | Função |
-|---|---|
-| `blackboard_tasks` | Tarefas do quadro negro (status, agente, prioridade, parent) |
-| `blackboard_artifacts` | Artefatos gerados (código, specs, relatórios) |
-| `blackboard_agent_logs` | Logs estruturados por agente |
-
----
-
-## FASE 2 - AGENTES ESPECIALIZADOS + GOVERNANÇA
-**Status: CONCLUIDO**
-
-### O que foi planejado:
-- Criar 5 agentes especializados com papéis distintos
-- Implementar camada de governança com políticas de segurança
-- Sistema de auditoria imutável
-
-### O que foi executado:
-
-#### 2.1 Agentes Especializados (5 agentes)
-
-| Agente | Arquivo | Linhas | Papel |
-|---|---|---|---|
-| Architect | agents/ArchitectAgent.ts | 156 | Interpreta requisitos, cria specs técnicas, analisa estrutura existente |
-| Generator | agents/GeneratorAgent.ts | 187 | Gera código TypeScript/React de alta qualidade seguindo padrões do projeto |
-| Validator | agents/ValidatorAgent.ts | 232 | Valida código com TypeScript real (tsc --noEmit), análise de qualidade, score >= 60 para aprovar |
-| Executor | agents/ExecutorAgent.ts | 178 | Prepara código para staging, verifica arquivos protegidos, NÃO aplica direto |
-| Evolution | agents/EvolutionAgent.ts | 263 | Aprende com execuções passadas, documenta padrões, sugere melhorias |
-
-#### 2.2 Governança de Segurança (`server/governance/service.ts` - 281 linhas)
-
-**Motor de Políticas (Fail-Closed):**
-- Avaliação de políticas antes de qualquer ação
-- Se não há política explícita permitindo, a ação é BLOQUEADA
-- Integrado automaticamente em BaseBlackboardAgent e ToolManager
-
-**5 Políticas de Segurança:**
-
-| # | Política | Regra |
-|---|---|---|
-| 1 | Proteção de arquivos críticos | Bloqueia escrita em server/routes.ts, server/index.ts, shared/schema.ts, etc. |
-| 2 | Permissões de leitura | Permite leitura de qualquer arquivo do projeto |
-| 3 | Bloqueio de comandos destrutivos | Bloqueia rm -rf, DROP TABLE, DELETE FROM, etc. |
-| 4 | Aprovação humana para produção | Requer aprovação do usuário antes de deploy |
-| 5 | Staging automático com threshold | Score de validação mínimo para ir para staging |
-
-#### 2.3 Registros de Governança
-
-| Componente | Tabela | Função |
-|---|---|---|
-| Contract Registry | `xos_contract_registry` | Contratos entre agentes (SLAs, dependências) |
-| Tool Registry | `xos_tool_registry` | Registro de ferramentas disponíveis (auto-sync do ToolManager) |
-| Skill Registry | `xos_skill_registry` | Habilidades aprendidas com tracking de uso |
-| Policy Rules | `xos_policy_rules` | Regras de política de segurança |
-| Audit Trail | `xos_audit_trail` | Trilha de auditoria imutável de todas as ações |
-
-#### 2.4 API de Governança (`server/governance/routes.ts` - 266 linhas)
-
-| Endpoint | Método | Função |
-|---|---|---|
-| `/api/governance/evaluate` | POST | Avaliar política para ação |
-| `/api/governance/contracts` | GET/POST | Listar/criar contratos |
-| `/api/governance/tools` | GET | Listar ferramentas registradas |
-| `/api/governance/skills` | GET/POST | Listar/registrar habilidades |
-| `/api/governance/policies` | GET/POST | Listar/criar políticas |
-| `/api/governance/audit` | GET | Consultar trilha de auditoria |
-| `/api/governance/dashboard` | GET | Dashboard com estatísticas |
-
----
-
-## FASE 3 - JOB QUEUE + METRICS + RESEARCHER + DASHBOARD
-**Status: CONCLUIDO**
-
-### O que foi planejado:
-- Job Queue PostgreSQL para processamento assíncrono
-- Métricas de agentes para monitoramento
-- 6o agente (Researcher) para análise de repositórios externos
-- Dashboard visual de governança
-
-### O que foi executado:
-
-#### 3.1 Job Queue PostgreSQL (`server/governance/jobQueue.ts` - 252 linhas)
-
-| Feature | Implementação |
-|---|---|
-| Fila de jobs | Tabela `xos_job_queue` com prioridade (0-10) |
-| Claiming atômico | `UPDATE ... FOR UPDATE SKIP LOCKED` (previne race conditions) |
-| Retry automático | Máximo de tentativas configurável por job |
-| Dead-letter | Jobs que falharam todas tentativas vão para dead-letter |
-| Handler registry | Registro de handlers por tipo de job |
-| Processamento | Loop de polling com intervalo configurável |
-
-#### 3.2 Métricas de Agentes
-
-| Tabela | Campos | Função |
-|---|---|---|
-| `xos_agent_metrics` | agentName, tasksCompleted, tasksFailed, avgDuration, lastActive | Monitoramento de performance |
-
-#### 3.3 Researcher Agent (`server/blackboard/agents/ResearcherAgent.ts` - 145 linhas)
-
-- 6o agente especializado em pesquisa
-- Analisa repositórios GitHub externos
-- Pesquisa padrões de implementação e boas práticas
-- Compara soluções e frameworks
-- Gera relatórios de viabilidade técnica
-
-#### 3.4 Governance Dashboard (`client/src/pages/XosGovernance.tsx` - 517 linhas)
-
-**Rota:** `/xos/governance`
-
-| Seção | Conteúdo |
-|---|---|
-| Stats Cards | Contratos, ferramentas, habilidades, políticas, auditorias, jobs |
-| Audit Trail | Tabela com ações, decisões, agentes, timestamps |
-| Policies | Lista de políticas de segurança ativas |
-| Tools | Ferramentas registradas com descrição |
-| Skills | Habilidades aprendidas com contagem de uso |
-| Jobs | Fila de jobs com status e prioridade |
-| Agent Monitoring | Métricas por agente (tarefas, falhas, duração média) |
-
-#### 3.5 APIs Adicionais (Fase 3)
-
-| Endpoint | Método | Função |
-|---|---|---|
-| `/api/governance/jobs` | GET | Listar jobs da fila |
-| `/api/governance/jobs` | POST | Enfileirar novo job |
-| `/api/governance/jobs/:id/cancel` | POST | Cancelar job |
-| `/api/governance/jobs/:id/retry` | POST | Retentar job |
-| `/api/governance/metrics` | GET | Métricas dos agentes |
-
----
-
-## FASE 4 - PIPELINE AUTÔNOMO (Prompt-to-Production)
-**Status: CONCLUIDO**
-
-### O que foi planejado:
-- Pipeline Orchestrator que encadeia todos os 6 agentes
-- Fluxo: Prompt em Português -> Design -> Codegen -> Validação -> Staging -> Evolução
-- Sistema de staging com revisão e aprovação do usuário
-- Streaming em tempo real via SSE
-- UI para submissão, acompanhamento e aprovação
-
-### O que foi executado:
-
-#### 4.1 Pipeline Orchestrator (`server/blackboard/PipelineOrchestrator.ts` - 350 linhas)
-
-| Feature | Implementação |
-|---|---|
-| Criação de pipeline | Registra em `xos_dev_pipelines` + cria tarefa principal |
-| Fases encadeadas | design -> codegen -> validation -> staging -> evolution |
-| Monitoramento | Polling a cada 3s para verificar progresso de cada fase |
-| Job handlers | Registra handlers para cada tipo de job (pipeline_*) |
-| SSE Broadcasting | Emite eventos em tempo real para clientes conectados |
-| Staging review | Pausa no staging para revisão humana antes de aplicar |
-| Aplicação de código | Aplica mudanças aprovadas ao filesystem com backup |
-| Proteção de arquivos | Verifica lista PROTECTED_FILES antes de aplicar |
-
-**Fluxo completo do pipeline:**
-```
-1. Usuário envia prompt em português
-2. DESIGN: ArchitectAgent analisa e cria especificação técnica
-3. CODEGEN: GeneratorAgent gera código TypeScript/React
-4. VALIDATION: ValidatorAgent executa tsc --noEmit real
-5. STAGING: ExecutorAgent prepara para staging (NÃO aplica direto)
-6. REVIEW: Usuário revisa código staged e aprova/rejeita
-7. EVOLUTION: EvolutionAgent documenta aprendizados
-```
-
-#### 4.2 Tabelas de Banco (Fase 4)
-
-| Tabela | Campos Principais | Função |
-|---|---|---|
-| `xos_dev_pipelines` | prompt, status, currentPhase, mainTaskId, phases (JSON), error | Rastreamento do pipeline |
-| `xos_staging_changes` | pipelineId, filePath, content, action, status, reviewedBy | Código staged para revisão |
-
-#### 4.3 Pipeline API (`server/blackboard/pipelineRoutes.ts` - 134 linhas)
-
-| Endpoint | Método | Função |
-|---|---|---|
-| `/api/xos/pipeline` | POST | Criar e iniciar pipeline com prompt |
-| `/api/xos/pipeline` | GET | Listar pipelines recentes |
-| `/api/xos/pipeline/:id` | GET | Detalhes do pipeline (staging, tarefas, artefatos, logs) |
-| `/api/xos/pipeline/:id/staging` | GET | Listar mudanças staged |
-| `/api/xos/pipeline/:id/approve` | POST | Aprovar e aplicar código staged |
-| `/api/xos/pipeline/:id/reject` | POST | Rejeitar código staged |
-| `/api/xos/pipeline/:id/stream` | GET | SSE para eventos em tempo real |
-
-#### 4.4 Pipeline UI (`client/src/pages/XosPipeline.tsx` - 471 linhas)
-
-**Rota:** `/xos/pipeline`
-
-| Componente | Funcionalidade |
-|---|---|
-| Formulário de prompt | Textarea com instruções em português + botão de envio |
-| Timeline ao vivo | 5 fases com ícones, cores e status em tempo real |
-| Staging review | Preview do código gerado com path dos arquivos |
-| Approve/Reject | Botões para aprovar ou rejeitar código staged |
-| Pipeline history | Lista de pipelines passados com status badges |
-| SSE EventSource | Conexão em tempo real para atualizações |
-
----
-
-## INVENTÁRIO COMPLETO DE ARTEFATOS
-
-### Arquivos Backend (server/)
-
-| Caminho | Linhas | Fase |
-|---|---|---|
-| `server/blackboard/BaseBlackboardAgent.ts` | 189 | 1 |
-| `server/blackboard/service.ts` | 476 | 1 |
-| `server/blackboard/ContextIndexer.ts` | 277 | 1 |
-| `server/blackboard/routes.ts` | - | 1 |
-| `server/blackboard/agents/index.ts` | 58 | 1/2 |
-| `server/blackboard/agents/ArchitectAgent.ts` | 156 | 2 |
-| `server/blackboard/agents/GeneratorAgent.ts` | 187 | 2 |
-| `server/blackboard/agents/ValidatorAgent.ts` | 232 | 2 |
-| `server/blackboard/agents/ExecutorAgent.ts` | 178 | 2 |
-| `server/blackboard/agents/EvolutionAgent.ts` | 263 | 2 |
-| `server/blackboard/agents/ResearcherAgent.ts` | 145 | 3 |
-| `server/blackboard/PipelineOrchestrator.ts` | 350 | 4 |
-| `server/blackboard/pipelineRoutes.ts` | 134 | 4 |
-| `server/governance/service.ts` | 281 | 2 |
-| `server/governance/routes.ts` | 266 | 2/3 |
-| `server/governance/jobQueue.ts` | 252 | 3 |
-| `server/autonomous/tools/ToolManager.ts` | 171 | 1 |
-| `server/autonomous/tools/BaseTool.ts` | 82 | 1 |
-| `server/autonomous/tools/**/*.ts` | ~750 | 1 |
-| `server/autonomous/agents/**/*.ts` | ~1.003 | 1 |
-| **TOTAL BACKEND XOS** | **~5.491** | |
-
-### Arquivos Frontend (client/src/)
-
-| Caminho | Linhas | Fase |
-|---|---|---|
-| `client/src/pages/XosGovernance.tsx` | 517 | 3 |
-| `client/src/pages/XosPipeline.tsx` | 471 | 4 |
-| **TOTAL FRONTEND XOS** | **988** | |
-
-### Tabelas de Banco de Dados (34 novas tabelas)
-
-| Tabela | Fase | Propósito |
-|---|---|---|
-| `blackboard_tasks` | 1 | Tarefas do quadro negro |
-| `blackboard_artifacts` | 1 | Artefatos gerados |
-| `blackboard_agent_logs` | 1 | Logs de agentes |
-| `xos_contract_registry` | 2 | Contratos entre agentes |
-| `xos_tool_registry` | 2 | Ferramentas registradas |
-| `xos_skill_registry` | 2 | Habilidades aprendidas |
-| `xos_policy_rules` | 2 | Políticas de segurança |
-| `xos_audit_trail` | 2 | Trilha de auditoria |
-| `xos_job_queue` | 3 | Fila de jobs assíncronos |
-| `xos_agent_metrics` | 3 | Métricas de agentes |
-| `xos_dev_pipelines` | 4 | Pipelines de desenvolvimento |
-| `xos_staging_changes` | 4 | Código staged para revisão |
-
----
-
-## DECISÕES ARQUITETURAIS REGISTRADAS
-
-| # | Decisão | Justificativa |
-|---|---|---|
-| 1 | SSE em vez de Socket.IO para pipeline | Evita conflito com sockets existentes (WhatsApp, Chat) |
-| 2 | FOR UPDATE SKIP LOCKED no job claiming | Previne race conditions com múltiplos workers |
-| 3 | Fail-closed na governança | Segurança: ação sem política explícita = BLOQUEADA |
-| 4 | Staging obrigatório antes de aplicar | Nunca auto-aplica código em produção |
-| 5 | Arquivos protegidos (PROTECTED_FILES) | Lista de arquivos críticos que agentes não podem sobrescrever |
-| 6 | Polling de 3s no pipeline monitor | Equilíbrio entre responsividade e carga no servidor |
-| 7 | Score >= 60 para validação | Threshold mínimo para código passar pela validação |
-| 8 | Prompts em português nos agentes | Sistema projetado para prompts de negócio em português brasileiro |
-
----
-
-## VERIFICAÇÃO DE FUNCIONAMENTO
-
-| Teste | Status | Evidência |
-|---|---|---|
-| API Pipeline retorna lista | OK | `GET /api/xos/pipeline` -> `{"success": true, "pipelines": [...]}` |
-| Criação de pipeline funciona | OK | `POST /api/xos/pipeline` -> Pipeline #1 criado e rodando |
-| Fases iniciam corretamente | OK | Design phase `status: "running"` após criação |
-| SSE streaming configurado | OK | Endpoint `/api/xos/pipeline/:id/stream` implementado |
-| Staging review configurado | OK | Endpoints approve/reject implementados |
-| Governance dashboard funciona | OK | Página `/xos/governance` com 517 linhas de UI |
-| Pipeline UI funciona | OK | Página `/xos/pipeline` com 471 linhas de UI |
-| Todas as rotas registradas | OK | Verificado em server/routes.ts e client/src/App.tsx |
-| 6 agentes rodando | OK | Architect, Generator, Validator, Executor, Evolution, Researcher |
-| Job Queue operacional | OK | Atomic claiming com FOR UPDATE SKIP LOCKED |
-
----
-
-## CONCLUSÃO
-
-O plano XOS v1.0 foi executado com **100% de completude** em suas 4 fases:
-
-- **Fase 1:** Fundação sólida com Blackboard architecture, 10 ferramentas e sistema de coordenação
-- **Fase 2:** 5 agentes especializados + governança com 5 políticas de segurança fail-closed
-- **Fase 3:** Job Queue PostgreSQL + Métricas + 6o agente Researcher + Dashboard visual
-- **Fase 4:** Pipeline autônomo prompt-to-production com staging review e SSE streaming
-
-O sistema está operacional e pronto para uso, com todas as salvaguardas de segurança ativas (staging obrigatório, arquivos protegidos, governança fail-closed, aprovação humana para produção).
-
----
-
-*Documento gerado em 06/02/2026 como registro de auditoria do plano XOS v1.0 do Arcádia Suite.*

docs/AVALIACAO_IMPACTO_GEOLOGIA.md

@@ -1,235 +0,0 @@
-# Avaliação de Aderência - Impacto Geologia
-## Arcádia Suite vs Requisitos do Book de Requisitos
-### Data: Fevereiro 2026
-
--## 1. RESUMO EXECUTIVO
-
-Este documento apresenta a análise de aderência entre os requisitos levantados no Book de Requisitos da Impacto Geologia e as funcionalidades atualmente implementadas na plataforma Arcádia Suite. A avaliação considera o estado atual do sistema, identificando o que já está pronto, o que está parcialmente implementado e o que precisa ser desenvolvido.
-
-**Resultado Geral:**
-| Status | Quantidade | % |
-|--------|-----------|---|
-| Implementado | 14 | 38% |
-| Parcialmente Implementado | 10 | 27% |
-| Não Implementado | 13 | 35% |
-| **Total de Requisitos** | **37** | **100%** |
-
----
-
-## 2. ANÁLISE POR MÓDULO
-
-### 2.1 Módulo Administrativo Financeiro
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| RF-AF01 | Conciliação Bancária Automatizada | Parcial | Existe `finBankAccounts` e `finTransactions` para contas bancárias e transações, mas não há rotina de conciliação automática com extratos OFX/CSV |
-| RF-AF02 | Fluxo de Pagamentos Controlado | Parcial | `finAccountsPayable` existe para contas a pagar, mas falta workflow de aprovação (programação → aprovação → execução) |
-| RF-AF03 | Controle de Fluxo de Caixa Projetado | Parcial | `finCashFlowCategories` e transações existem, mas falta projeção automática de 90 dias com cenários |
-| RF-AF04 | Gestão de Impostos e Obrigações | Implementado | Módulo fiscal completo: `fiscalNcms`, `fiscalCfops`, `fiscalCests`, `fiscalGruposTributacao`, `fiscalConfiguracoes`, `fiscalNotas` com integração Arcádia Plus |
-| RF-AF05 | Prestação de Contas Digital | Parcial | `fieldExpenses` existe para despesas de campo, mas falta fluxo de aprovação digital e comprovantes fotográficos via mobile |
-| - | Gestão de Ativos e Endividamento | Não Implementado | Não existe módulo de controle de ativos fixos nem dashboard de endividamento |
-| - | Gestão de Cartões Corporativos | Não Implementado | Não há funcionalidade para tratar cartões como "contas correntes individuais" com controle de cargas/depósitos |
-
-**Resumo Financeiro: 1 implementado, 4 parciais, 2 não implementados**
-
----
-
-### 2.2 Módulo Comercial (Vendas e CRM)
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| RF-COM01 | Conversão Proposta → Projeto | Parcial | `crmProposals`, `crmProposalItems`, `crmOpportunities` existem, mas falta a automação de conversão proposta aprovada → criação automática de Projeto + Ordem de Venda |
-| RF-COM02 | Gestão de Incentivos/Comissões | Implementado | `crmCommissionRules`, `crmCommissions` no CRM + `retailCommissionPlans`, `retailCommissionClosures` no Retail - sistema completo de comissões |
-| RF-COM03 | Pesquisa de Satisfação (NPS) | Não Implementado | Campos de `satisfactionScore` existem em algumas tabelas, mas não há módulo dedicado de envio automático de pesquisa NPS pós-projeto |
-
-**Resumo Comercial: 1 implementado, 1 parcial, 1 não implementado**
-
----
-
-### 2.3 Módulo Operações e Projetos
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| RF-OP01 | Rastreabilidade por ID de Projeto | Implementado | `pcProjects`, `pcProjectMembers`, `pcProjectActivities`, `pcProjectTasks`, `pcProjectFiles`, `pcProjectHistory` - sistema completo de gestão de projetos com ID único e rastreabilidade |
-| RF-OP02 | Gestão de Insumos de Campo | Parcial | Existe estoque (`retailWarehouseStock`, `retailStockMovements`) mas não há vinculação automática de consumo de materiais/equipamentos por projeto |
-| RF-OP03 | Digitalização de Fichas de Campo | Parcial | `qualityFieldForms` existe para formulários digitais, mas falta os formulários específicos de geologia (Plano de Amostragem, PT, Monitoramento de Poços) e app mobile dedicado |
-| RF-OP04 | Gestão de Pendências de Faturamento | Não Implementado | Não há sistema de monitoramento de eventos de campo que causem quebra de faturamento com alertas automáticos |
-| - | Acompanhamento do Ciclo de Vida | Parcial | `pcProjectActivities` e `pcProjectHistory` registram atividades, mas falta pipeline visual desde pré-programação até entrega do relatório final |
-| - | Custódia de Equipamentos | Não Implementado | Não existe módulo para controle de custódia de equipamentos por equipe de campo (DOC-010) |
-| - | Programação de Equipes de Campo | Não Implementado | Não há funcionalidade de programação de equipes para mobilização de campo (DOC-008) |
-| - | Programação de Relatórios | Não Implementado | Não existe módulo de programação e acompanhamento de relatórios técnicos (DOC-009) |
-
-**Resumo Operações: 1 implementado, 3 parciais, 4 não implementados**
-
----
-
-### 2.4 Módulo Qualidade e Serviços de Terceiros
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| RF-QC01 | Controle de Amostras e Laudos | Implementado | `qualitySamples`, `qualityLabReports` - sistema para rastreamento de amostras enviadas a laboratórios e laudos recebidos |
-| RF-QC02 | Gestão de Documentos (QMS) | Implementado | `qualityDocuments`, `qualityDocumentRevisions` - controle de versão e lista mestra de documentos internos (FT-xx) |
-| RF-QC03 | Controle de Não Conformidades (RNC) | Implementado | `qualityNonConformities` - registro e gestão de RNC, Ações Corretivas e Oportunidades de Melhoria |
-| RF-QC04 | Homologação de Fornecedores (ISO 17025) | Parcial | `suppliers` e `purchaseOrders` existem, mas falta controle de certificações ISO 17025, bloqueio de compras de não-homologados e portal de fornecedores |
-| - | Matriz de Treinamentos | Implementado | `qualityTrainingMatrix` - controle de treinamentos, participação e validade |
-| - | Controle de Brancos | Não Implementado | Não existe funcionalidade específica para controle de brancos de laboratório (FT-58, FT-68) |
-
-**Resumo Qualidade: 4 implementados, 1 parcial, 1 não implementado**
-
----
-
-### 2.5 Módulo Fiscal e Tributário
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| RF-FT01 | Módulo Fiscal e Tributário | Implementado | Motor Fiscal completo (Arcádia Fisco): NCMs, CFOPs, CESTs, grupos tributação, certificados digitais, NF-e/NFC-e com integração SEFAZ via nfelib |
-| - | Emissão de NF-e de Serviço | Parcial | Infraestrutura fiscal existe, mas NFS-e (Nota Fiscal de Serviço Eletrônica) requer integração com prefeituras, que varia por município - não implementado |
-| - | Integração com Arcádia Plus | Implementado | `FiscalAdapter` com conexão via API para transmissão fiscal e emissão de documentos fiscais via Arcádia Plus |
-
-**Resumo Fiscal: 2 implementados, 1 parcial, 0 não implementados**
-
----
-
-### 2.6 Módulo Estoque e Logística
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| - | Gestão de Estoque | Implementado | `retailWarehouseStock`, `retailStockMovements`, `retailInventories`, `retailInventoryItems` - estoque completo com movimentações e inventário |
-| - | Transferências entre Almoxarifados | Implementado | `retailStockTransfers`, `retailStockTransferItems`, `retailTransferSerials` - transferências com rastreio de seriais |
-| - | Estoque de Segurança | Não Implementado | Não há funcionalidade de definição de estoque mínimo com alertas automáticos para itens com lead time > 90 dias |
-| - | Controle de Km Rodado | Não Implementado | Não existe módulo para controle de custos de km rodado por veículo/equipe |
-
-**Resumo Estoque: 2 implementados, 0 parciais, 2 não implementados**
-
----
-
-### 2.7 Módulo Gestão de Pessoas (RH)
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| - | Cadastro de Colaboradores | Implementado | `peopleFuncionarios`, `peopleDependentes`, `peopleCargos`, `peopleDepartamentos` |
-| - | Folha de Pagamento | Implementado | `peopleFolhaPagamento`, `peopleFolhaItens`, `peopleFolhaEventos`, `peopleEventosFolha` |
-| - | Controle de Férias | Implementado | `peopleFerias` |
-| - | Controle de Ponto | Implementado | `peoplePonto` |
-| - | Benefícios | Implementado | `peopleBeneficios`, `peopleFuncionarioBeneficios` |
-
-**Resumo RH: 5 implementados - módulo completo**
-
----
-
-### 2.8 Módulo Contabilidade
-
-| ID | Requisito | Status | Observação |
-|----|-----------|--------|------------|
-| - | Plano de Contas | Implementado | `contabilPlanoContas` |
-| - | Centros de Custo | Implementado | `contabilCentrosCusto` - permite vincular custos por projeto |
-| - | Lançamentos Contábeis | Implementado | `contabilLancamentos`, `contabilPartidas` |
-| - | Períodos e Saldos | Implementado | `contabilPeriodos`, `contabilSaldos` |
-
-**Resumo Contabilidade: 4 implementados - módulo completo**
-
----
-
-## 3. REQUISITOS NÃO-FUNCIONAIS
-
-| Requisito | Status | Observação |
-|-----------|--------|------------|
-| Usabilidade/Interface intuitiva | Implementado | Interface moderna React + Tailwind + shadcn/ui, estilo WhatsApp Web |
-| Integração via APIs | Implementado | APIs REST completas, protocolos MCP/A2A implementados |
-| Segurança e Governança | Implementado | Multi-tenant com tenant scoping, XOS Governance Layer, audit trail |
-| Mobile | Não Implementado | Não há aplicativo móvel dedicado; interface web é responsiva mas não tem funcionalidades offline para campo |
-| Framework FA (DocTypes customizados) | Implementado | Sistema ArcDocTypes com fields, layouts, pages, scripts e widgets |
-
----
-
-## 4. PRIORIZAÇÃO - O QUE FALTA PARA FECHAR O PROJETO
-
-### Prioridade ALTA (Essencial para entrega)
-
-| # | Item | Esforço Estimado | Descrição |
-|---|------|-----------------|-----------|
-| 1 | Conversão Proposta → Projeto automática | 2-3 dias | Workflow que ao aprovar proposta cria automaticamente o Projeto e Ordem de Venda |
-| 2 | Workflow de aprovação de pagamentos | 2-3 dias | Fluxo: programação → aprovação (Fran → Sidney) → execução de pagamentos |
-| 3 | Conciliação bancária | 3-5 dias | Import de extratos bancários (OFX/CSV) e conciliação automática com transações |
-| 4 | Vinculação Insumos ↔ Projetos | 2-3 dias | Associar consumo de materiais e equipamentos a cada projeto |
-| 5 | Homologação de Fornecedores ISO 17025 | 3-4 dias | Status de homologação, certificações, bloqueio de compras para não-homologados |
-| 6 | Gestão de Pendências de Faturamento | 2-3 dias | Alertas para eventos de campo que impedem faturamento |
-
-### Prioridade MÉDIA (Importante para operação completa)
-
-| # | Item | Esforço Estimado | Descrição |
-|---|------|-----------------|-----------|
-| 7 | Prestação de contas digital com aprovação | 2-3 dias | Upload de comprovantes, fluxo aprovação de despesas de campo |
-| 8 | Projeção de fluxo de caixa 90 dias | 2-3 dias | Dashboard com projeção baseada em recebíveis e pagáveis programados |
-| 9 | Formulários de campo específicos | 3-5 dias | Plano de Amostragem, PT, Monitoramento de Poços como DocTypes |
-| 10 | Portal de Fornecedores | 3-5 dias | Área externa para fornecedores atualizarem documentos e certificações |
-| 11 | NPS automático pós-projeto | 1-2 dias | Envio automático de pesquisa de satisfação ao concluir projeto |
-| 12 | Programação de Equipes de Campo | 2-3 dias | Calendário de mobilização de equipes para projetos |
-| 13 | Programação de Relatórios | 2 dias | Controle de prazos e status de relatórios técnicos |
-| 14 | NFS-e (Nota Fiscal de Serviço) | 5-10 dias | Integração com webservices municipais (varia por prefeitura) |
-
-### Prioridade BAIXA (Desejável / Fase 2)
-
-| # | Item | Esforço Estimado | Descrição |
-|---|------|-----------------|-----------|
-| 15 | Gestão de Ativos Fixos | 3-5 dias | Cadastro, depreciação e controle de ativos da empresa |
-| 16 | Dashboard de Endividamento | 1-2 dias | BI com visão consolidada de endividamento |
-| 17 | Gestão de Cartões Corporativos | 2-3 dias | Tratar cartões como contas individuais com cargas |
-| 18 | Estoque de Segurança com alertas | 1-2 dias | Definição de estoque mínimo e alertas automáticos |
-| 19 | Controle de Km Rodado | 1-2 dias | Registro de km por veículo/equipe com cálculo de custos |
-| 20 | Custódia de Equipamentos | 2-3 dias | Controle de equipamentos alocados por equipe de campo |
-| 21 | Controle de Brancos de Laboratório | 1-2 dias | Registro e rastreamento de amostras branco |
-| 22 | App Mobile para Campo | 15-20 dias | PWA ou app nativo para coleta de dados offline em campo |
-| 23 | Contratos Guarda-Chuva | 2-3 dias | Gestão de contratos de fornecimento de longo prazo |
-
----
-
-## 5. ESTIMATIVA TOTAL DE ESFORÇO
-
-| Prioridade | Itens | Dias Estimados |
-|------------|-------|---------------|
-| Alta | 6 itens | 14-21 dias |
-| Média | 8 itens | 19-33 dias |
-| Baixa | 9 itens | 28-42 dias |
-| **Total** | **23 itens** | **61-96 dias** |
-
-### Recomendação de Fases:
-
-**Fase 1 (MVP Impacto):** Prioridade Alta → ~3-4 semanas
-- Entrega o mínimo necessário para operação integrada
-
-**Fase 2 (Operação Completa):** Prioridade Média → ~4-5 semanas
-- Completa todas as funcionalidades operacionais do dia a dia
-
-**Fase 3 (Evolução):** Prioridade Baixa → ~5-7 semanas
-- Funcionalidades avançadas e app mobile
-
----
-
-## 6. O QUE JÁ ESTÁ PRONTO E FUNCIONANDO
-
-A Arcádia Suite já possui uma base sólida implementada:
-
-- **Contabilidade completa** (plano de contas, centros de custo, lançamentos, períodos)
-- **Gestão de Pessoas completa** (funcionários, folha, férias, ponto, benefícios)
-- **Motor Fiscal completo** (NCMs, CFOPs, CESTs, NF-e/NFC-e, certificados digitais)
-- **CRM e Comercial** (leads, oportunidades, propostas, comissões)
-- **Gestão de Projetos** (projetos, membros, tarefas, atividades, histórico)
-- **Qualidade** (amostras, laudos, RNC, documentos, treinamentos)
-- **Estoque** (warehouses, movimentações, transferências, inventário)
-- **Financeiro básico** (contas bancárias, a pagar, a receber, transações)
-- **Framework FA** (DocTypes customizados para fichas de campo)
-- **Multi-tenant com governança** (segurança, audit trail, políticas)
-- **Inteligência Artificial** (Manus agent, Dev Center, auto-programação)
-- **Comunicação unificada** (WhatsApp, chat interno, email)
-- **BI e Dashboards** (motor BI com análise de dados)
-
----
-
-## 7. CONCLUSÃO
-
-O sistema Arcádia Suite apresenta **aderência de ~65%** aos requisitos da Impacto Geologia, com os módulos estruturais (Contabilidade, RH, Fiscal, Qualidade) praticamente completos. Os principais gaps estão nos **fluxos de negócio específicos** (workflows de aprovação, conciliação bancária, conversão proposta→projeto) e nas **funcionalidades de campo** (formulários específicos de geologia, app mobile, programação de equipes).--
-
-
-
-A recomendação é priorizar os 6 itens de alta prioridade para uma entrega funcional em **3-4 semanas**, seguida de evolução gradual nos itens médios e baixos.

docs/DEPLOY_COOLIFY.md

@@ -1,386 +0,0 @@
-# Deploy no Coolify — Arcádia Suite
-
-> Guia completo para subir o Arcádia Suite no Coolify com Docker Compose.
-
----
-
-## Índice
-
-1. [Pré-requisitos](#pré-requisitos)
-2. [Arquitetura de Serviços](#arquitetura-de-serviços)
-3. [Configuração no Coolify](#configuração-no-coolify)
-4. [Variáveis de Ambiente](#variáveis-de-ambiente)
-5. [Serviços Opcionais (Profiles)](#serviços-opcionais-profiles)
-6. [Sequência de Inicialização](#sequência-de-inicialização)
-7. [Traefik e HTTPS](#traefik-e-https)
-8. [Volumes e Persistência](#volumes-e-persistência)
-9. [Stack de IA (LiteLLM + Ollama)](#stack-de-ia-litellm--ollama)
-10. [Pós-deploy](#pós-deploy)
-11. [Checklist Final](#checklist-final)
-
----
-
-## Pré-requisitos
-
-- Coolify instalado e acessível (v4+)
-- Docker Engine 24+ e Docker Compose v2+ no servidor
-- Domínio apontando para o IP do servidor (`A record`)
-- Mínimo recomendado: **4 vCPU, 8 GB RAM, 50 GB SSD**
-- Para IA local (Ollama): **16 GB RAM, GPU opcional**
-
----
-
-## Arquitetura de Serviços
-
-```
-Internet → Traefik (Coolify) → app:5000     → arcadia-internal
-                              → open-webui:8080 (opcional)
-
-arcadia-internal:
-  db (PostgreSQL 16 + pgvector) :5432
-  redis                          :6379
-  app (Node.js/Express)          :5000
-  embeddings (Python FastAPI)    :8001
-  fisco (Python FastAPI)         :8002
-  contabil (Python FastAPI)      :8003
-  bi (Python FastAPI)            :8004
-  automation (Python FastAPI)    :8005
-  litellm (gateway LLM)          :4000   ← profile: ai
-  ollama (modelos locais)        :11434  ← profile: ai
-  superset (BI)                  :8088   ← profile: bi
-  plus (Laravel/ERP)             :8080   ← profile: plus
-  erpnext                        :8090   ← profile: erpnext
-```
-
----
-
-## Configuração no Coolify
-
-### 1. Criar novo projeto
-
-No painel Coolify: **New Project → Docker Compose**.
-
-### 2. Apontar para o repositório
-
-- **Source:** Git (GitHub/GitLab/Gitea)
-- **Branch:** `main` (ou sua branch de produção)
-- **Docker Compose file:** `docker-compose.prod.yml`
-
-### 3. Definir o domínio
-
-Em **Domains**, adicione `seu-dominio.com`. O Coolify irá automaticamente:
-- Criar as rotas no Traefik
-- Emitir certificado Let's Encrypt
-
----
-
-## Variáveis de Ambiente
-
-Configure todas no painel **Environment Variables** do Coolify (nunca no `.env` do repositório).
-
-### Obrigatórias
-
-```env
-# Aplicação
-NODE_ENV=production
-PORT=5000
-DOMAIN=seu-dominio.com
-DOCKER_MODE=true
-
-# Segredos — gerar com: openssl rand -hex 32
-SESSION_SECRET=<gerado>
-SSO_SECRET=<gerado>
-
-# Banco de dados
-PGHOST=db
-PGPORT=5432
-PGUSER=arcadia
-PGPASSWORD=<senha-forte>
-PGDATABASE=arcadia
-DATABASE_URL=postgresql://arcadia:<senha>@db:5432/arcadia
-
-# Redis
-REDIS_URL=redis://redis:6379
-
-# IA — LiteLLM gateway
-LITELLM_API_KEY=<gerado>
-AI_INTEGRATIONS_OPENAI_BASE_URL=http://litellm:4000/v1
-AI_INTEGRATIONS_OPENAI_API_KEY=<mesmo-que-LITELLM_API_KEY>
-OLLAMA_BASE_URL=http://ollama:11434
-
-# Microserviços Python
-PYTHON_SERVICE_URL=http://embeddings:8001
-FISCO_PYTHON_URL=http://fisco:8002
-CONTABIL_PYTHON_URL=http://contabil:8003
-BI_PYTHON_URL=http://bi:8004
-AUTOMATION_PYTHON_URL=http://automation:8005
-```
-
-### LLMs externos (opcionais — soberania: deixar em branco)
-
-```env
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-GROQ_API_KEY=
-```
-
-### Superset — profile `bi`
-
-```env
-SUPERSET_SECRET_KEY=<openssl rand -hex 32>
-SUPERSET_ADMIN_USER=admin
-SUPERSET_ADMIN_EMAIL=admin@seu-dominio.com
-SUPERSET_ADMIN_PASSWORD=<senha-forte>
-SUPERSET_HOST=superset
-SUPERSET_PORT=8088
-```
-
-### Arcádia Plus — profile `plus`
-
-```env
-SSO_PLUS_BASE_URL=http://plus:8080
-PLUS_APP_KEY=<laravel-key>
-PLUS_DB_ROOT_PASSWORD=<senha>
-PLUS_DB_PASSWORD=<senha>
-PLUS_DB_DATABASE=arcadia_plus
-PLUS_DB_USER=plus
-```
-
-### ERPNext — profile `erpnext`
-
-```env
-ERPNEXT_PROXY_ENABLED=true
-ERPNEXT_CONTAINER_HOST=erpnext
-ERPNEXT_DB_ROOT_PASSWORD=<senha>
-ERPNEXT_DB_PASSWORD=<senha>
-ERPNEXT_ADMIN_PASSWORD=<senha>
-ERPNEXT_URL=http://erpnext:8090
-```
-
----
-
-## Serviços Opcionais (Profiles)
-
-O `docker-compose.prod.yml` usa profiles para habilitar serviços sob demanda.
-No Coolify, adicione a variável de ambiente `COMPOSE_PROFILES`:
-
-| O que habilitar | `COMPOSE_PROFILES` |
-|---|---|
-| Somente core | *(vazio)* |
-| IA local (Ollama + LiteLLM + WebUI) | `ai` |
-| Superset BI | `bi` |
-| Arcádia Plus (Laravel ERP) | `plus` |
-| ERPNext | `erpnext` |
-| Tudo | `ai,bi,plus,erpnext` |
-
-> **Atenção:** Ollama com modelos grandes (llama3.3, qwen2.5) pode consumir 10–20 GB de disco. Certifique-se de ter espaço no volume `ollama_models`.
-
----
-
-## Sequência de Inicialização
-
-Os `depends_on` garantem a ordem correta automaticamente:
-
-```
-1. db          → healthcheck: pg_isready (até 10 tentativas)
-2. redis       → healthcheck: redis-cli ping
-3. embeddings, fisco, contabil, bi, automation  → aguardam db healthy
-4. litellm, ollama                              → aguardam redis (se profile ai)
-5. app         → aguarda db healthy + redis started
-6. open-webui, superset, plus, erpnext          → aguardam serviços base
-```
-
-Se um serviço falhar ao iniciar, cheque os logs:
-
-```bash
-# No servidor
-docker compose -f docker-compose.prod.yml logs app --tail 50
-docker compose -f docker-compose.prod.yml logs db --tail 50
-```
-
----
-
-## Traefik e HTTPS
-
-O Coolify gerencia o Traefik. As labels já estão no `docker-compose.prod.yml`:
-
-```yaml
-# Serviço principal
-labels:
-  - "traefik.enable=true"
-  - "traefik.http.routers.arcadia.rule=Host(`${DOMAIN}`)"
-  - "traefik.http.routers.arcadia.tls=true"
-  - "traefik.http.routers.arcadia.tls.certresolver=letsencrypt"
-  - "traefik.http.services.arcadia.loadbalancer.server.port=5000"
-
-# Open WebUI (profile ai) — subdomínio ai.seu-dominio.com
-labels:
-  - "traefik.http.routers.webui.rule=Host(`ai.${DOMAIN}`)"
-  - "traefik.http.routers.webui.tls=true"
-  - "traefik.http.routers.webui.tls.certresolver=letsencrypt"
-  - "traefik.http.services.webui.loadbalancer.server.port=8080"
-```
-
-Certifique-se de que o DNS do subdomínio `ai.seu-dominio.com` também aponta para o servidor antes de habilitar o profile `ai`.
-
----
-
-## Volumes e Persistência
-
-| Volume | Conteúdo | Criticidade |
-|---|---|---|
-| `pgdata` | Banco de dados PostgreSQL | **CRÍTICO — fazer backup** |
-| `redis_data` | Sessões e cache | Alta |
-| `ollama_models` | Modelos LLM baixados (~10–20 GB) | Média (redownload possível) |
-| `open_webui_data` | Histórico do WebUI | Baixa |
-| `superset_home` | Dashboards Superset | Média |
-| `plus_db` | Banco MySQL do Plus | Alta |
-| `plus_storage` | Arquivos do Plus | Alta |
-| `erpnext_sites` | Sites ERPNext | **CRÍTICO** |
-| `erpnext_logs` | Logs ERPNext | Baixa |
-
-### Backup do PostgreSQL
-
-```bash
-# Backup
-docker exec arcadia-db pg_dump -U arcadia arcadia | gzip > backup-$(date +%Y%m%d).sql.gz
-
-# Restore
-gunzip < backup-20240101.sql.gz | docker exec -i arcadia-db psql -U arcadia arcadia
-```
-
-Configure backups automáticos no Coolify em **Project → Backups**.
-
----
-
-## Stack de IA (LiteLLM + Ollama)
-
-### Dois tiers configurados em `docker/litellm-config.yaml`
-
-```
-TIER 1 — Ollama (local, padrão)           → llama3.3, qwen2.5-coder, nomic-embed-text
-TIER 2 — Externos (opt-in)               → OpenAI, Anthropic, Groq (apenas se API key definida)
-```
-
-### Baixar modelos Ollama após o primeiro deploy
-
-```bash
-docker exec arcadia-ollama ollama pull llama3.3
-docker exec arcadia-ollama ollama pull qwen2.5-coder:7b
-docker exec arcadia-ollama ollama pull nomic-embed-text
-```
-
----
-
-## Pós-deploy
-
-### Rodar migrations do banco
-
-```bash
-# Via Coolify → Run Command, ou no servidor:
-docker exec arcadia-app npm run db:push
-```
-
-### Verificar saúde dos serviços
-
-```bash
-docker compose -f docker-compose.prod.yml ps
-```
-
-Todos devem estar `healthy` ou `running`. Se algum ficar em `restarting`, verifique os logs.
-
-### Verificar conectividade IA
-
-```bash
-curl -H "Authorization: Bearer $LITELLM_API_KEY" \
-     http://localhost:4000/v1/models
-```
-
----
-
-## Otimização de Build (.dockerignore)
-
-O arquivo `.dockerignore` é crítico para builds rápidos. Ele evita que arquivos desnecessários sejam enviados para o Docker daemon.
-
-### Estrutura atual otimizada
-
-```
-# Excluídos (reduzem contexto de build)
-node_modules/          ← Instalados no container
-dist/                  ← Gerado no build
-git/                   ← Não necessário
-server/bi/metaset/superset-src/  ← 3.7GB de código fonte Superset
-server/bi/metaset/venv/          ← Python venv local
-__pycache__/           ← Cache Python
-.pytest_cache/         ← Cache de testes
-.playwright-mcp/       ← Screenshots de teste
-docs/                  ← Documentação Markdown
-*.md                   ← Arquivos Markdown
-
-# INCLUÍDOS (necessários para build)
-attached_assets/       ← Assets de branding (ícones, logos)
-```
-
-### Resultado da otimização
-
-| Métrica | Antes | Depois | Melhoria |
-|---------|-------|--------|----------|
-| Contexto de build | ~5GB | ~93MB | **98% menor** |
-| Tempo de transferência | ~2-3 min | ~5-10s | **~90% mais rápido** |
-
-> ⚠️ **Atenção**: Ao adicionar novos diretórios ao `.dockerignore`, verifique se não há assets necessários para o build (como imagens importadas no frontend).
-
----
-
-## Checklist Final
-
-### Antes do deploy
-
-- [ ] Domínio DNS apontando para o servidor (`A record`)
-- [ ] Todas as variáveis obrigatórias definidas no Coolify
-- [ ] `SESSION_SECRET` e `SSO_SECRET` gerados com `openssl rand -hex 32`
-- [ ] Senhas do banco definidas (nunca reutilizar senhas de dev)
-- [ ] `DOCKER_MODE=true` definido
-- [ ] `.dockerignore` revisado (especialmente após adicionar novos diretórios grandes)
-
-### No Coolify
-
-- [ ] Projeto criado apontando para `docker-compose.prod.yml`
-- [ ] Domínio configurado no Coolify
-- [ ] HTTPS ativo (Let's Encrypt)
-- [ ] Volumes persistentes configurados (especialmente `pgdata`)
-- [ ] `COMPOSE_PROFILES` definido conforme os serviços desejados
-
-### Após o deploy
-
-- [ ] `npm run db:push` executado (migrations)
-- [ ] Login funcional no `https://seu-dominio.com`
-- [ ] Healthchecks verdes no painel Coolify
-- [ ] Modelos Ollama baixados (se profile `ai` ativo)
-- [ ] Backup automático configurado para `pgdata`
-- [ ] Monitoramento/alertas configurados (Coolify suporta webhooks)
-
----
-
-## Comandos de Referência Rápida
-
-```bash
-# Subir apenas o core
-docker compose -f docker-compose.prod.yml up -d
-
-# Subir com IA
-docker compose -f docker-compose.prod.yml --profile ai up -d
-
-# Subir tudo
-docker compose -f docker-compose.prod.yml --profile ai --profile bi --profile plus up -d
-
-# Ver logs em tempo real
-docker compose -f docker-compose.prod.yml logs -f app
-
-# Reiniciar um serviço específico
-docker compose -f docker-compose.prod.yml restart app
-
-# Atualizar para nova versão (após git pull)
-docker compose -f docker-compose.prod.yml pull
-docker compose -f docker-compose.prod.yml up -d --no-deps app
-```

docs/DEV_CENTER.md

@@ -1,116 +0,0 @@
-# Dev Center — Fábrica de Agentes
-
-**Rota:** `/development` → ícone "Design Studio"
-**Componente:** `client/src/pages/DevCenter.tsx` (função `AgentFactoryTabs`)
-**Backend:** `server/agent-defs/routes.ts` + `server/blackboard/`
-
----
-
-## Visão Geral
-
-O Dev Center é a fábrica de agentes do Arcádia Suite. Permite criar, montar, implantar e monitorar agentes de IA de forma visual, seguindo o pipeline:
-
-```
-Design → Assemble → Deploy → Galeria
-```
-
-Cada agente tem um ciclo de vida com 4 status:
-
-| Status | Descrição |
-|--------|-----------|
-| `draft` | Rascunho criado, aguardando montagem |
-| `assembling` | Sendo montado pelo Blackboard |
-| `ready` | Montagem concluída, pronto para deploy |
-| `deployed` | Implantado e disponível para execução |
-
----
-
-## Abas
-
-### Design
-
-Cria e edita definições de agentes (`agent_defs`).
-
-- **Editor de spec** — suporta 3 modos: `markdown`, `typescript`, `visual`
-- Salva via `PATCH /api/agent-defs/:id`
-- Após salvar, agente fica com status `draft` e aparece na aba Assemble
-
-### Assemble (Linha de Montagem)
-
-Lista agentes em `draft` ou `assembling` e aciona a montagem via Blackboard.
-
-- Botão **Montar** → `POST /api/agent-defs/:id/assemble`
-  - Cria uma `MainTask` no Blackboard com a spec do agente
-  - Cria subtask `architect` para projetar a estrutura
-- **Painel de progresso** (expansível por Task ID):
-  - Polling a cada 3s em `/api/blackboard/task/:id`
-  - Mostra subtasks com ícones de status (✓ ✗ ⏳ ⏰) e `agentRole`
-- Quando a task completa → status muda para `ready` (ou `draft` se falhou)
-
-### Deploy (Orchestrate Center)
-
-Gerencia agentes `ready` e `deployed`.
-
-- **Stats** no topo: total de agentes / prontos p/ deploy / implantados
-- **Deploy** → `POST /api/agent-defs/:id/deploy` (só para `ready`)
-  - Incrementa `version`, muda status para `deployed`
-- **Executar** → `POST /api/agent-defs/:id/run` (só para `deployed`)
-  - Cria nova task no Blackboard para execução
-- **Re-montar** → `POST /api/agent-defs/:id/redraft`
-  - Volta para `draft` para corrigir e remontar
-
-### Galeria
-
-Grid de agentes `deployed` com busca por nome/descrição.
-
-- Cada card mostra: nome, descrição, versão
-- Botão **Executar** — dispara execução imediata
-- Botão **Fork** → `POST /api/agent-defs/:id/fork` — duplica como novo `draft`
-- Botão **Info** (ícone) — dialog com spec completo, modo do editor e data de criação
-
----
-
-## API Reference
-
-| Método | Endpoint | Descrição |
-|--------|----------|-----------|
-| `GET` | `/api/agent-defs` | Lista todos os agentes do tenant |
-| `POST` | `/api/agent-defs` | Cria novo agente (status: draft) |
-| `PATCH` | `/api/agent-defs/:id` | Atualiza nome, descrição ou spec |
-| `DELETE` | `/api/agent-defs/:id` | Remove agente |
-| `POST` | `/api/agent-defs/:id/assemble` | Inicia montagem via Blackboard |
-| `POST` | `/api/agent-defs/:id/deploy` | Implanta agente (ready → deployed) |
-| `POST` | `/api/agent-defs/:id/run` | Executa agente implantado |
-| `POST` | `/api/agent-defs/:id/fork` | Duplica como draft |
-| `POST` | `/api/agent-defs/:id/redraft` | Volta para draft |
-
----
-
-## Schema
-
-Tabela: `arcadia_agent_defs`
-
-```sql
-id          serial PRIMARY KEY
-tenant_id   varchar
-user_id     varchar REFERENCES users(id)
-name        varchar(200) NOT NULL
-description text
-spec        jsonb NOT NULL DEFAULT '{}'   -- { mode, content }
-status      varchar(30)  DEFAULT 'draft'
-version     integer      DEFAULT 1
-last_task_id integer                      -- FK blackboard_tasks
-created_at  timestamp
-updated_at  timestamp
-```
-
-Migration: `migrations/phase6_agent_defs.sql`
-
----
-
-## Integração com Blackboard
-
-O Assemble usa `blackboardService.createMainTask()` + `createSubtask()`.
-A spec do agente é passada como `content` da task, com metadata `{ agentDefId, source: "agent-factory" }`.
-
-Quando a task do Blackboard completa ou falha, o polling no frontend (`useEffect` com `setInterval(3000)`) atualiza o status do agente via `PATCH /api/agent-defs/:id`.

docs/HOSPEDAGEM.md

@@ -1,620 +0,0 @@
-# Arcadia Suite - Guia Completo de Hospedagem e Deploy
-
-## Indice
-
-1. [Requisitos do Servidor](#1-requisitos-do-servidor)
-2. [Variaveis de Ambiente](#2-variaveis-de-ambiente)
-3. [Instalacao](#3-instalacao)
-4. [Banco de Dados](#4-banco-de-dados)
-5. [Servicos Python](#5-servicos-python)
-6. [Metabase (Arcadia Insights)](#6-metabase-arcadia-insights)
-7. [Build e Producao](#7-build-e-producao)
-8. [Configuracao do Servidor Web (Nginx)](#8-configuracao-do-servidor-web-nginx)
-9. [Process Manager (PM2)](#9-process-manager-pm2)
-10. [SSL/HTTPS](#10-sslhttps)
-11. [Estrutura de Portas](#11-estrutura-de-portas)
-12. [Arcadia Plus (Laravel)](#12-arcadia-plus-laravel)
-13. [Manutencao e Backups](#13-manutencao-e-backups)
-14. [Troubleshooting](#14-troubleshooting)
-
----
-
-## 1. Requisitos do Servidor
-
-### Minimo Recomendado
-- **SO:** Ubuntu 22.04 LTS ou Debian 12
-- **CPU:** 4 vCPUs
-- **RAM:** 8 GB (16 GB recomendado)
-- **Disco:** 50 GB SSD
-- **Node.js:** v20.x ou superior
-- **Python:** 3.11 ou superior
-- **PostgreSQL:** 15 ou superior
-- **Java:** OpenJDK 11+ (para Metabase)
-- **PHP:** 8.1+ (para Arcadia Plus, opcional)
-- **Composer:** 2.x (para Arcadia Plus, opcional)
-
-### Instalacao de Dependencias (Ubuntu/Debian)
-
-```bash
-# Atualizar sistema
-sudo apt update && sudo apt upgrade -y
-
-# Node.js 20
-curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
-sudo apt install -y nodejs
-
-# Python 3.11
-sudo apt install -y python3.11 python3.11-venv python3-pip
-
-# PostgreSQL 15
-sudo apt install -y postgresql postgresql-contrib
-
-# Java (para Metabase)
-sudo apt install -y openjdk-11-jre-headless
-
-# Ferramentas auxiliares
-sudo apt install -y git nginx certbot python3-certbot-nginx build-essential
-```
-
----
-
-## 2. Variaveis de Ambiente
-
-Crie um arquivo `.env` na raiz do projeto:
-
-```env
-# === BANCO DE DADOS ===
-DATABASE_URL=postgresql://arcadia_user:SUA_SENHA_AQUI@localhost:5432/arcadia_suite
-PGHOST=localhost
-PGPORT=5432
-PGUSER=arcadia_user
-PGPASSWORD=SUA_SENHA_AQUI
-PGDATABASE=arcadia_suite
-
-# === OPENAI (IA) ===
-OPENAI_API_KEY=sk-sua-chave-openai-aqui
-
-# === ERPNext (opcional) ===
-ERPNEXT_URL=https://seu-erpnext.com
-ERPNEXT_API_KEY=sua-api-key
-ERPNEXT_API_SECRET=seu-api-secret
-
-# === GITHUB (opcional - para XOS Pipeline) ===
-GITHUB_TOKEN=ghp_seu-token-github
-
-# === PRODUCAO ===
-NODE_ENV=production
-PORT=5000
-SESSION_SECRET=gere-uma-string-secreta-longa-e-aleatoria
-
-# === METABASE ===
-MB_DB_TYPE=postgres
-MB_DB_DBNAME=arcadia_metabase
-MB_DB_PORT=5432
-MB_DB_USER=arcadia_user
-MB_DB_PASS=SUA_SENHA_AQUI
-MB_DB_HOST=localhost
-MB_JETTY_PORT=8088
-METABASE_PORT=8088
-METASET_ADMIN_EMAIL=admin@arcadia.app
-METASET_ADMIN_PASSWORD=SuaSenhaMetaSet
-```
-
----
-
-## 3. Instalacao
-
-```bash
-# Clonar o repositorio
-git clone https://github.com/SEU_USUARIO/arcadia-suite.git
-cd arcadia-suite
-
-# Instalar dependencias Node.js
-npm install
-
-# Instalar dependencias Python
-python3.11 -m venv .venv
-source .venv/bin/activate
-pip install -r python-service/requirements.txt
-pip install fastapi uvicorn pandas numpy httpx pydantic nfelib lxml signxml \
-  cryptography zeep beautifulsoup4 psycopg2-binary matplotlib pymongo \
-  python-multipart python-docx pyopenssl
-
-# Copiar arquivo de ambiente
-cp .env.example .env
-# Edite o .env com suas credenciais
-nano .env
-```
-
----
-
-## 4. Banco de Dados
-
-### Criar banco e usuario
-
-```bash
-sudo -u postgres psql
-```
-
-```sql
--- Criar usuario
-CREATE USER arcadia_user WITH PASSWORD 'SUA_SENHA_SEGURA';
-
--- Criar banco principal
-CREATE DATABASE arcadia_suite OWNER arcadia_user;
-
--- Criar banco do Metabase (separado)
-CREATE DATABASE arcadia_metabase OWNER arcadia_user;
-
--- Permissoes
-GRANT ALL PRIVILEGES ON DATABASE arcadia_suite TO arcadia_user;
-GRANT ALL PRIVILEGES ON DATABASE arcadia_metabase TO arcadia_user;
-
-\q
-```
-
-### Executar migracoes (Drizzle ORM)
-
-```bash
-# Sincronizar schema com o banco
-npx drizzle-kit push
-```
-
----
-
-## 5. Servicos Python
-
-O projeto utiliza servicos Python para funcionalidades especificas. Eles sao iniciados automaticamente pelo servidor Node.js, mas podem ser executados manualmente para testes:
-
-| Servico | Porta | Funcao | Inicio Automatico |
-|---------|-------|--------|--------------------|
-| Contabil | 8003 | Motor contabil | Sim |
-| BI Engine | 8004 | Business Intelligence | Sim |
-| Automations | 8005 | Motor de automacoes | Sim |
-| Scientist | 8001 | IA, embeddings, analise de dados | Opcional* |
-| Fisco | 8002 | Motor fiscal NF-e/NFC-e | Opcional* |
-| Communication | 8006 | Motor de comunicacao | Opcional* |
-
-*Servicos opcionais podem ser ativados adicionando suas chamadas em `server/index.ts`.
-
-Os servicos Contabil, BI e Automations sao iniciados automaticamente pelo `server/index.ts`.
-
----
-
-## 6. Metabase (Arcadia Insights)
-
-O Metabase e usado como motor de BI invisivel. Para instala-lo:
-
-```bash
-# Criar diretorio
-mkdir -p metabase/plugins
-
-# Baixar Metabase (versao 0.50.x recomendada)
-wget https://downloads.metabase.com/v0.50.31/metabase.jar -O metabase/metabase.jar
-
-# Testar execucao
-java -jar metabase/metabase.jar &
-```
-
-O Metabase sera executado na porta 8088 e proxied pelo Node.js em `/api/bi/metaset/*` e `/metabase/`.
-
-O script de inicio esta em `metabase/start-metabase.sh` e e gerenciado automaticamente pelo servidor Node.js.
-
----
-
-## 7. Build e Producao
-
-```bash
-# Build do frontend (Vite) + backend
-npm run build
-
-# Iniciar em producao
-npm run start
-```
-
-O comando `npm run start` executa `NODE_ENV=production node dist/index.cjs` na porta 5000.
-
----
-
-## 8. Configuracao do Servidor Web (Nginx)
-
-Crie o arquivo de configuracao:
-
-```bash
-sudo nano /etc/nginx/sites-available/arcadia-suite
-```
-
-```nginx
-server {
-    listen 80;
-    server_name seu-dominio.com.br;
-
-    # Redirecionar HTTP para HTTPS
-    return 301 https://$server_name$request_uri;
-}
-
-server {
-    listen 443 ssl http2;
-    server_name seu-dominio.com.br;
-
-    # SSL (sera configurado pelo Certbot)
-    ssl_certificate /etc/letsencrypt/live/seu-dominio.com.br/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/seu-dominio.com.br/privkey.pem;
-
-    # Limites
-    client_max_body_size 50M;
-
-    # Proxy principal (Node.js na porta 5000)
-    location / {
-        proxy_pass http://127.0.0.1:5000;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_read_timeout 86400;
-    }
-
-    # WebSocket (Socket.IO)
-    location /socket.io/ {
-        proxy_pass http://127.0.0.1:5000;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_read_timeout 86400;
-    }
-
-    # Arcadia Plus (Laravel, opcional)
-    location /plus/ {
-        proxy_pass http://127.0.0.1:8080/;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-```
-
-```bash
-# Ativar o site
-sudo ln -s /etc/nginx/sites-available/arcadia-suite /etc/nginx/sites-enabled/
-sudo nginx -t
-sudo systemctl reload nginx
-```
-
----
-
-## 9. Process Manager (PM2)
-
-Use PM2 para manter o servidor rodando:
-
-```bash
-# Instalar PM2 globalmente
-sudo npm install -g pm2
-
-# Iniciar a aplicacao
-pm2 start dist/index.cjs --name arcadia-suite --env production
-
-# Salvar a lista de processos
-pm2 save
-
-# Configurar para iniciar no boot
-pm2 startup
-```
-
-### Arquivo ecosystem (opcional)
-
-Crie `ecosystem.config.cjs`:
-
-```javascript
-module.exports = {
-  apps: [
-    {
-      name: "arcadia-suite",
-      script: "dist/index.cjs",
-      env: {
-        NODE_ENV: "production",
-        PORT: 5000,
-      },
-      instances: 1,
-      max_memory_restart: "1G",
-      log_date_format: "YYYY-MM-DD HH:mm:ss",
-      error_file: "logs/error.log",
-      out_file: "logs/output.log",
-    },
-    {
-      name: "arcadia-metabase",
-      script: "java",
-      args: "-jar metabase/metabase.jar",
-      interpreter: "none",
-      env: {
-        MB_DB_TYPE: "postgres",
-        MB_DB_DBNAME: "arcadia_metabase",
-        MB_DB_PORT: "5432",
-        MB_DB_USER: "arcadia_user",
-        MB_DB_PASS: "SUA_SENHA_AQUI",
-        MB_DB_HOST: "localhost",
-        MB_JETTY_PORT: "8088",
-      },
-      max_memory_restart: "2G",
-    },
-  ],
-};
-```
-
-```bash
-# Iniciar com ecosystem
-pm2 start ecosystem.config.cjs
-pm2 save
-```
-
----
-
-## 10. SSL/HTTPS
-
-```bash
-# Certificado gratuito com Let's Encrypt
-sudo certbot --nginx -d seu-dominio.com.br
-
-# Renovacao automatica (ja configurada pelo Certbot)
-sudo certbot renew --dry-run
-```
-
----
-
-## 11. Estrutura de Portas
-
-| Porta | Servico | Acesso |
-|-------|---------|--------|
-| 5000 | Node.js (Express + Vite) | Principal - proxied pelo Nginx |
-| 8088 | Metabase (Arcadia Insights) | Interno - proxied via /api/bi/metaset e /metabase |
-| 8003 | Python Contabil | Interno - inicio automatico |
-| 8004 | Python BI Engine | Interno - inicio automatico |
-| 8005 | Python Automations | Interno - inicio automatico |
-| 8001 | Python Scientist | Interno - opcional |
-| 8002 | Python Fisco | Interno - opcional |
-| 8006 | Node Communication | Interno - opcional |
-| 8080 | Arcadia Plus (Laravel) | Interno - proxied via /plus |
-
-Apenas a porta 80 (HTTP) e 443 (HTTPS) devem estar expostas publicamente via Nginx.
-
----
-
-## 12. Arcadia Plus (Laravel)
-
-Se voce utiliza o modulo Plus (ERP Laravel):
-
-```bash
-cd plus
-
-# Instalar dependencias PHP
-composer install --no-dev --optimize-autoloader
-
-# Configurar ambiente
-cp .env.example .env
-php artisan key:generate
-
-# Configurar banco (usar schema separado no mesmo PostgreSQL)
-# Edite plus/.env com as credenciais do banco
-
-# Migracoes
-php artisan migrate
-
-# Otimizar para producao
-php artisan config:cache
-php artisan route:cache
-php artisan view:cache
-
-# Servir (porta 8080)
-php artisan serve --host=0.0.0.0 --port=8080
-```
-
----
-
-## 13. Manutencao e Backups
-
-### Backup do Banco de Dados
-
-```bash
-# Criar backup
-pg_dump -U arcadia_user -h localhost arcadia_suite > backup_$(date +%Y%m%d_%H%M%S).sql
-
-# Restaurar backup
-psql -U arcadia_user -h localhost arcadia_suite < backup_20260209.sql
-```
-
-### Atualizar a Aplicacao
-
-```bash
-cd /caminho/para/arcadia-suite
-
-# Parar a aplicacao
-pm2 stop arcadia-suite
-
-# Atualizar codigo
-git pull origin main
-
-# Reinstalar dependencias
-npm install
-
-# Rebuild
-npm run build
-
-# Migrar banco (se necessario)
-npx drizzle-kit push
-
-# Reiniciar
-pm2 restart arcadia-suite
-```
-
-### Logs
-
-```bash
-# Ver logs em tempo real
-pm2 logs arcadia-suite
-
-# Ver logs do Nginx
-sudo tail -f /var/log/nginx/error.log
-```
-
----
-
-## 14. Troubleshooting
-
-### Erro: "Cannot find module"
-```bash
-npm install
-npm run build
-```
-
-### Erro: "ECONNREFUSED" no banco
-```bash
-# Verificar se PostgreSQL esta rodando
-sudo systemctl status postgresql
-sudo systemctl start postgresql
-```
-
-### Erro: "Port already in use"
-```bash
-# Encontrar processo na porta
-lsof -i :5000
-kill -9 PID_DO_PROCESSO
-```
-
-### Servicos Python nao iniciam
-```bash
-# Verificar Python
-python3.11 --version
-
-# Verificar ambiente virtual
-source .venv/bin/activate
-pip list | grep fastapi
-```
-
-### Metabase nao inicia
-```bash
-# Verificar Java
-java -version
-
-# Verificar se metabase.jar existe
-ls -la metabase/metabase.jar
-
-# Executar manualmente para ver erros
-java -jar metabase/metabase.jar
-```
-
----
-
-## Hospedagem em Cloud (Alternativas)
-
-### VPS Recomendados
-- **Hetzner:** A partir de EUR 4/mes (melhor custo-beneficio)
-- **DigitalOcean:** A partir de USD 12/mes (4GB RAM)
-- **Vultr:** A partir de USD 12/mes
-- **AWS EC2:** t3.medium (sob demanda)
-- **Contabo:** A partir de EUR 5/mes (alto recurso por preco)
-
-### Deploy com Docker (Alternativa)
-
-Se preferir usar Docker, crie um `Dockerfile`:
-
-```dockerfile
-FROM node:20-slim
-
-WORKDIR /app
-
-# Instalar Python e Java
-RUN apt-get update && apt-get install -y \
-    python3.11 python3.11-venv python3-pip \
-    openjdk-11-jre-headless \
-    && rm -rf /var/lib/apt/lists/*
-
-# Copiar e instalar dependencias
-COPY package.json ./
-RUN npm install --production
-
-# Instalar dependencias Python
-COPY python-service/requirements.txt ./python-requirements.txt
-RUN python3.11 -m venv /app/.venv && \
-    /app/.venv/bin/pip install -r python-requirements.txt
-
-# Copiar codigo
-COPY . .
-
-# Build
-RUN npm run build
-
-EXPOSE 5000
-
-CMD ["npm", "run", "start"]
-```
-
-```yaml
-# docker-compose.yml
-version: "3.8"
-services:
-  app:
-    build: .
-    ports:
-      - "5000:5000"
-    environment:
-      - DATABASE_URL=postgresql://arcadia_user:senha@db:5432/arcadia_suite
-      - NODE_ENV=production
-    depends_on:
-      - db
-
-  db:
-    image: postgres:15
-    environment:
-      POSTGRES_USER: arcadia_user
-      POSTGRES_PASSWORD: senha
-      POSTGRES_DB: arcadia_suite
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-
-  metabase:
-    image: metabase/metabase:v0.50.31
-    ports:
-      - "8088:8088"
-    environment:
-      MB_DB_TYPE: postgres
-      MB_DB_DBNAME: arcadia_metabase
-      MB_DB_PORT: 5432
-      MB_DB_USER: arcadia_user
-      MB_DB_PASS: senha
-      MB_DB_HOST: db
-      MB_JETTY_PORT: 8088
-
-volumes:
-  pgdata:
-```
-
----
-
-## Checklist de Deploy
-
-- [ ] Servidor provisionado com requisitos minimos
-- [ ] PostgreSQL instalado e configurado
-- [ ] Node.js 20 instalado
-- [ ] Python 3.11 instalado
-- [ ] Repositorio clonado
-- [ ] Dependencias instaladas (npm install)
-- [ ] Dependencias Python instaladas
-- [ ] Arquivo .env configurado com todas as variaveis
-- [ ] Banco de dados criado e migracoes executadas
-- [ ] Build de producao executado (npm run build)
-- [ ] Metabase baixado e configurado
-- [ ] PM2 configurado e aplicacao rodando
-- [ ] Nginx configurado como reverse proxy
-- [ ] SSL/HTTPS configurado com Certbot
-- [ ] Firewall configurado (portas 80 e 443 abertas)
-- [ ] Backup automatico do banco configurado
-- [ ] Dominio apontando para o servidor
-
----
-
-*Documento gerado em 09/02/2026 - Arcadia Suite v1.0*

docs/INDICE_PLANEJAMENTO.md

@@ -1,252 +0,0 @@
----
-⚠️ **AVISO: DOCUMENTAÇÃO HISTÓRICA**
-
-Este documento foi criado em **Março/2026** como planejamento estratégico.
-Pode conter informações desatualizadas em relação ao sistema atual.
-
-Para documentação técnica atualizada, consulte:
-- \_SPEC_NAVBAR.md\_ (componentes UI)
-- \_KERNEL_SPEC.md\_ (arquitetura do Kernel)
-- Código-fonte em \_server/modules/\_
-
----
-
-# Índice: PLANEJAMENTO ESTRATÉGICO ARCÁDIA AGENTIC SUITE
-
-**Documento:** `/home/ubuntu/# PLANEJAMENTO ESTRATÉGICO ARCÁDIA.txt`
-**Versão:** 1.0 — Março 2026
-**Estado:** Pronto para Implementação
-
----
-
-## 📑 ESTRUTURA DO DOCUMENTO
-
-### 1. **Executive Summary** (Seção 1)
-- Visão: ERP tradicional → **Sistema Agêntico Orientado a Objetos**
-- 5 decisões arquiteturais críticas (MiroFlow, OpenClaw, Superset, Skills POO, Automações)
-
-### 2. **Arquitetura de Alto Nível** (Seção 2)
-```
-Interface Unificada (Chat + Dev Center + OpenClaw + BI)
-         ↓
-Orquestradores (Manus + Blackboard + Automation Fabric)
-         ↓
-Motores Especializados Embutidos (MiroFlow + OpenClaw + Skill Engine)
-         ↓
-Infraestrutura (Knowledge Graph + PostgreSQL + Ollama/DeepSeek)
-```
-
-### 3. **Componentes Embutidos** (Seção 3+)
-
-| Componente | Status | Local | Propósito |
-|-----------|--------|-------|----------|
-| **MiroFlow** | ✅ | `server/modules/miroflow/` | Motor científico, benchmarks, análise estatística |
-| **OpenClaw** | 🔄 | `server/modules/openclaw/` + `client/src/components/openclaw/` | Detecção padrões, sugestão proativa, skills emergentes |
-| **Skills Engine** | ✅ | `server/skills/` | POO: herança, composição, polimorfismo, versionamento |
-| **Automation Fabric** | ⏳ | `server/modules/automation/` | Runtime unificado: Workflow, Rule, Agent, Schedule, Event |
-| **Dev Center** | ⏳ | `client/src/pages/DevCenter.tsx` | Design → Assemble → Deploy de agentes |
-| **Superset Integration** | ⏳ | `server/modules/superset/` | BI visual + MiroFlow bridge |
-
-### 4. **Skills Engine POO** (Seção 4)
-- ✅ Herança: `extends`, `isA`
-- ✅ Composição: `dependencies`, `requires`
-- ✅ Polimorfismo: `useMiroFlow`, `autoApprove`
-- ✅ Versionamento Git-like (createVersion, listVersions, rollback, fork, diff)
-- ✅ Marketplace / Biblioteca (import de skills públicas)
-
-### 5. **Automation Fabric Unificada** (Seção 6)
-- Runtime com suporte: Workflow, Rule, Agent, Schedule, Event
-- Trigger-based (webhook, database, schedule, event)
-- Integração com Blackboard para codegen
-
-### 6. **Dev Center Completo** (Seção 8)
-- **Design Studio**: UML, Visual, Markdown
-- **Assemble Line**: Integração com Blackboard
-- **Orchestrate Center**: Deploy, monitoramento
-- **Galeria de Agentes**: Marketplace interno
-
-### 7. **Infraestrutura** (Seção 9)
-- PostgreSQL 16 + pgvector
-- Neo4j (Knowledge Graph)
-- Ollama (LLMs locais: deepseek-r1:32b/70b, llama3.1:8b/70b)
-- Apache Superset (BI visual)
-
----
-
-## 🗺️ ROADMAP E STATUS
-
-### ✅ Fase 1: Fundação (Semanas 1-2)
-**Status: CONCLUÍDA (2026-03-25)**
-- Submodules MiroFlow + OpenClaw
-- Tabelas skills, skill_executions
-- Neo4j no Docker
-- ReferenceParser/Resolver
-- Superset + Ollama
-
-**Entregável:** Infraestrutura base ✅
-
----
-
-### ✅ Fase 2: Skills Engine (Semanas 3-4)
-**Status: CONCLUÍDA (25/03/2026 - 15:04)**
-- SkillEngine com herança/composição
-- API REST CRUD + execução + histórico
-- Editor Monaco (tabs Geral/Body/Params)
-- Versionamento Git-like (VersionManager)
-- Skill Marketplace / Biblioteca
-
-**Entregável:** Skills criáveis, versionáveis, executáveis ✅
-
----
-
-### ✅ Fase 3: MiroFlow Embutido (Semanas 5-6)
-**Status: CONCLUÍDA PARCIAL (25/03/2026 - 15:04)**
-
-**Implementado:**
-- Adapt MiroFlow para Ollama local (llama3.2:3b / deepseek-r1:14b)
-- Containerização em docker-compose.prod.yml
-- Agentes especializados (Statistician, Auditor, Researcher)
-- Proxy Node.js: `/api/miroflow/analyze`
-- UI MiroFlowControl (tab Científico em /insights)
-
-**Pendente:**
-- [ ] MiroFlowBridge para Superset
-- [ ] Integração com Arcádia Audit (imutabilidade)
-- [ ] Dashboard de benchmarks no Dev Center
-- [ ] **Tool SQL via Skills** (skill `db_query` como MCP tool)
-
-**Entregável:** Análises científicas (ETA completo: 08/04/2026)
-
----
-
-### 🔄 Fase 4: OpenClaw Embutido (Semanas 7-8)
-**Status: SPRINT 1 COMPLETO (26/03/2026) | Sprints 2-3 Em Progresso**
-
-#### ✅ Sprint 1: Backend (COMPLETO - 26/03)
-- [x] PatternDetector.ts — detecção (3+ em 30d), confiança, Neo4j
-- [x] OpenClawEngine.ts — orquestração, sugestões, scheduler, Socket.IO
-- [x] SkillEmergence.ts — Blackboard codegen, validação, DRAFT storage
-- [x] routes.ts — 10 endpoints REST
-- [x] arcadia.config.yaml — pattern detection, suggestions, emergence
-
-#### ⏳ Sprint 2: Frontend (PRÓXIMO - 28-29/03)
-- [ ] OpenClawWidget.tsx — widget flutuante de sugestão
-- [ ] SkillSuggestion.tsx — modal de sugestão
-- [ ] useAgentEmergence.ts — hook de lógica
-- [ ] Integração em App.tsx (layout principal)
-
-#### ⏳ Sprint 3: Config + Testes (30-31/03)
-- [ ] Schema database (detectedPatterns, skillSuggestions)
-- [ ] Migration SQL (migrations/0004_openclaw_tables.sql)
-- [ ] Testes unitários
-- [ ] Documentação
-
-**Fluxo:** Padrão → Detector → Engine → Sugestão → Widget → User → Blackboard → SkillEmergence → DRAFT → Dev Center → Publicada
-
-**Entregável:** Skills emergentes (ETA: 08/04/2026)
-
----
-
-### ⏳ Fase 5: Automation Fabric (Semanas 9-10)
-**Status: PENDENTE**
-- [ ] Unificar XOS/Automations + Central /automations
-- [ ] 4 runtimes: Workflow, Rule, Agent, Schedule, Event
-- [ ] UI única no Dev Center
-- [ ] Migração dados existentes
-- [ ] Testes carga/segurança
-
-**Entregável:** Automações unificadas
-
----
-
-### ⏳ Fase 6: Dev Center Completo (Semanas 11-12)
-**Status: PENDENTE**
-- [ ] Design Studio (UML, Visual, Markdown)
-- [ ] Assemble Line (Blackboard integration)
-- [ ] Orchestrate Center (deploy, monitoramento)
-- [ ] Galeria de Agentes (marketplace interno)
-- [ ] Documentação e treinamento
-
-**Entregável:** Sistema completo operacional
-
----
-
-## 🎯 DECISÕES CRÍTICAS (RESUMO)
-
-| Decisão | Escolha | Justificativa |
-|---------|---------|---------------|
-| **MiroFlow** | **EMBUTIR** | Motor científico nativo, benchmarks, verificação multi-camada |
-| **OpenClaw** | **EMBUTIR** | Widget interno, detecção contextual no Arcádia |
-| **Superset** | **INTEGRAR** | BI visual mantido, bridge para MiroFlow |
-| **Skills** | **POO** | Herança, composição, polimorfismo para reuso |
-| **Automações** | **UNIFICAR** | Runtime único, múltiplos orquestradores |
-| **Dev Center** | **FÁBRICA** | Design → Assemble → Deploy de agentes |
-| **Multi-tenant** | **HIERARQUIA** | System → Tenant → Company → User skills |
-
----
-
-## 📋 PRÓXIMO PASSO
-
-### **Fase 4 Sprint 2: OpenClaw Frontend**
-**ETA: 28-29/03/2026**
-
-A Fase 4 Sprint 1 (backend) foi concluída em 26/03. Agora entrar na **Sprint 2 do frontend**, que consiste em:
-
-#### Tarefas Sprint 2:
-1. **OpenClawWidget.tsx** — Widget flutuante que:
-   - Escuta eventos de sugestões via Socket.IO
-   - Mostra notificação "Detectei padrão!"
-   - Abre SkillSuggestion modal ao ser clicado
-
-2. **SkillSuggestion.tsx** — Modal que:
-   - Exibe padrão detectado (frequência, confiança)
-   - Preview do código da skill sugerida (gerado por Blackboard)
-   - Botões: Aprovar (→ DRAFT em Dev Center) ou Rejeitar
-
-3. **useAgentEmergence.ts** — Hook que:
-   - Conecta a Socket.IO `/api/openclaw` events
-   - Gerencia estado de sugestões
-   - Sincroniza com OpenClawEngine backend
-
-4. **Integração em App.tsx**:
-   - Importar OpenClawWidget
-   - Renderizar no layout principal (canto inferior direito)
-   - Garantir que não bloqueia interação com página
-
-#### Localização dos arquivos:
-```
-client/src/
-├── components/
-│   └── openclaw/
-│       ├── OpenClawWidget.tsx      ← NOVO
-│       ├── SkillSuggestion.tsx     ← NOVO
-│       └── ...
-├── hooks/
-│   └── useAgentEmergence.ts        ← NOVO
-└── App.tsx                          ← MODIFICAR (integração)
-```
-
-#### Integração com backend já pronto:
-- PatternDetector.ts emite eventos via Socket.IO
-- OpenClawEngine.ts orquestra sugestões
-- SkillEmergence.ts gera código via Blackboard
-- Todas as rotas REST já existem
-
-**Próximo passo após Sprint 2:** Sprint 3 (Config + Testes), depois Fase 5 (Automation Fabric).
-
----
-
-## 🔗 LINKS ESSENCIAIS
-
-| Recurso | URL |
-|---------|-----|
-| **MiroFlow Docs** | https://github.com/MiroMindAI/MiroFlow/tree/main/docs |
-| **MiroFlow Paper** | https://arxiv.org/abs/2602.22808 |
-| **OpenClaw README** | https://github.com/miaoxworld/OpenClawInstaller/blob/main/README.md |
-| **Superset Docs** | https://superset.apache.org/docs/intro |
-| **Neo4j Docs** | https://neo4j.com/docs/ |
-| **Ollama Docs** | https://github.com/ollama/ollama/blob/main/README.md |
-
----
-
-**Pronto para começar Fase 4 Sprint 2?**

docs/KERNEL_GAP_ANALYSIS.md

@@ -1,255 +0,0 @@
-# Análise de Gap - Arcadia Kernel
-
-**Data:** 09/04/2026  
-**Objetivo:** Comparar funcionalidades implementadas vs. sugeridas
-
----
-
-## 🔴 Root Cause Analysis: Learning Service Timeouts (RESOLVIDO)
-
-**Problema:** `PYTHON_SERVICE_URL` sendo resetado para porta 8001 em vez de 8000
-
-**Causa Raiz Identificada:** O arquivo `.env.example` na linha 30 continha:
-```bash
-PYTHON_SERVICE_URL=http://localhost:8001  # ← ERRADO
-```
-
-Quando o Coolify recriava o container, ele usava o valor do `.env.example` como fallback, causando:
-- Timeouts de 10s a cada 60s (ciclo do Learning Service)
-- Degradação de performance do sistema
-- Erros silenciosos no log
-
-**Solução Aplicada (08/04/2026):** Corrigido `.env.example` para usar porta 8000 com comentário explicativo.
-
-**Lição Aprendida:** O `.env.example` deve sempre estar sincronizado com a configuração de produção correta.
-
----
-
-## 📊 Resumo das Funcionalidades
-
-| Funcionalidade | Status | Implementação | Notas |
-|----------------|--------|---------------|-------|
-| **Service Discovery** | ✅ **Parcial** | `ServiceRegistry` + 4 providers | Docker, Coolify, XOS, Static |
-| **Load Balancer** | ❌ **Não tem** | - | Não implementado |
-| **Circuit Breaker** | ❌ **Não tem** | - | Não implementado |
-| **Config Hot Reload** | ❌ **Não tem** | - | Requer restart do Kernel |
-| **Resource Limits** | ⚠️ **Parcial** | Via `ProcessManager` | Limites básicos de processo |
-| **Secrets Management** | ❌ **Não tem** | - | Variáveis em `.env` |
-
----
-
-## ✅ O que Temos Implementado
-
-### 1. Service Discovery (Parcial ✅)
-
-**Arquivos:**
-- `server/kernel/registry/ServiceRegistry.ts`
-- `server/kernel/discovery/*`
-
-**Providers Implementados:**
-- `DockerDiscovery` - Descobre containers Docker
-- `CoolifyDiscovery` - Integração com Coolify
-- `XOSDiscovery` - Descobre serviços XOS
-- `StaticDiscovery` - Configuração estática
-
-**Funcionalidades:**
-- ✅ Discovery automático (30s intervalo)
-- ✅ Health checks (15s intervalo)
-- ✅ Cleanup de serviços stale (5min)
-- ✅ EventEmitter para mudanças
-- ❌ **Falta:** Service mesh, load balancing entre instâncias
-
-### 2. Health Monitor ✅
-
-**Arquivo:** `server/kernel/core/HealthMonitor.ts`
-
-**Funcionalidades:**
-- ✅ Health checks HTTP periódicos
-- ✅ Configurável (interval, timeout, retries)
-- ✅ Eventos onHealthChange
-- ✅ Tracking de falhas/sucessos consecutivos
-
-### 3. Process Manager ✅
-
-**Arquivo:** `server/kernel/core/ProcessManager.ts`
-
-**Funcionalidades:**
-- ✅ Gerenciamento de processos filhos
-- ✅ Logs aggregator
-- ✅ State tracking
-- ⚠️ **Básico:** Resource limits ( apenas via SO)
-
-### 4. Log Aggregator ✅
-
-**Arquivo:** `server/kernel/core/LogAggregator.ts`
-
-**Funcionalidades:**
-- ✅ Centralização de logs
-- ✅ Limite de linhas (configurável)
-- ✅ Query/filter básico
-
-### 5. Dashboard Web ✅
-
-**Arquivo:** `server/kernel/dashboard/DashboardServer.ts`
-
-**Funcionalidades:**
-- ✅ Interface web (porta 5001)
-- ✅ WebSocket para tempo real
-- ✅ Visualização de serviços
-
----
-
-## ❌ O que Falta Implementar
-
-### 1. Load Balancer ❌
-
-**Prioridade:** Alta  
-**Descrição:** Distribuir carga entre instâncias de serviços
-
-**Casos de Uso:**
-- Múltiplas instâncias do mesmo serviço
-- Failover automático
-- Distribuição por região
-
-**Implementação Sugerida:**
-```typescript
-// server/kernel/balancer/LoadBalancer.ts
-interface LoadBalancer {
-  selectInstance(serviceId: string): RegisteredService;
-  registerStrategy(strategy: BalanceStrategy): void;
-}
-```
-
-### 2. Circuit Breaker ❌
-
-**Prioridade:** Alta  
-**Descrição:** Parar de chamar serviço falho após N falhas
-
-**Estados:**
-- CLOSED: Funcionando normal
-- OPEN: Circuito aberto (rejeita chamadas)
-- HALF_OPEN: Testando se voltou
-
-**Implementação Sugerida:**
-```typescript
-// server/kernel/circuit/CircuitBreaker.ts
-interface CircuitBreaker {
-  call<T>(fn: () => Promise<T>): Promise<T>;
-  getState(): 'CLOSED' | 'OPEN' | 'HALF_OPEN';
-}
-```
-
-### 3. Config Hot Reload ❌
-
-**Prioridade:** Média  
-**Descrição:** Mudar configuração sem restartar Kernel
-
-**Funcionalidades:**
-- Watch de arquivo `services.json`
-- Aplicar mudanças em runtime
-- Notificar serviços afetados
-
-**Implementação Sugerida:**
-```typescript
-// server/kernel/config/ConfigWatcher.ts
-interface ConfigWatcher {
-  watch(path: string, onChange: (config: Config) => void): void;
-}
-```
-
-### 4. Resource Limits (Melhorar) ⚠️
-
-**Prioridade:** Média  
-**Status:** Básico via SO (ulimit)
-
-**O que falta:**
-- Limite de CPU por serviço (cgroups)
-- Limite de memória por serviço
-- Throttling de requisições
-- Quotas por tenant
-
-### 5. Secrets Management ❌
-
-**Prioridade:** Alta  
-**Status:** Variáveis em `.env` (inseguro)
-
-**Funcionalidades Necessárias:**
-- Vault integrado (HashiCorp Vault style)
-- Encryption at rest
-- Rotacionamento automático
-- Acesso por política (RBAC)
-- Audit logging
-
-**Implementação Sugerida:**
-```typescript
-// server/kernel/secrets/SecretVault.ts
-interface SecretVault {
-  get(key: string): Promise<string>;
-  set(key: string, value: string): Promise<void>;
-  rotate(key: string): Promise<void>;
-}
-```
-
----
-
-## 📋 Recomendações de Prioridade
-
-### Fase 1 - Crítico (Segurança + Estabilidade)
-1. **Secrets Management** - Dados sensíveis expostos em `.env`
-2. **Circuit Breaker** - Evitar cascata de falhas
-
-### Fase 2 - Performance
-3. **Load Balancer** - Necessário para escalar
-4. **Resource Limits** - Prevenir resource exhaustion
-
-### Fase 3 - DX (Developer Experience)
-5. **Config Hot Reload** - Evitar restart em produção
-
----
-
-## 🔧 Notas Técnicas
-
-### Service Discovery Atual
-```
-ServiceRegistry
-├── DockerDiscovery (containers)
-├── CoolifyDiscovery (apps Coolify)
-├── XOSDiscovery (serviços XOS)
-└── StaticDiscovery (config manual)
-```
-
-**Limitação:** Não faz load balancing entre múltiplas instâncias do mesmo serviço.
-
-### Health Check Atual
-- Interval: 15s
-- Timeout: 5s
-- Retries: 3
-- **Falta:** Circuit breaker baseado em health
-
-### Process Manager Atual
-- Gerencia processos via Node.js spawn
-- **Falta:** Isolamento real (containers), resource limits
-
----
-
-## 📁 Arquivos Relacionados
-
-| Componente | Arquivo |
-|------------|---------|
-| Entry Point | `server/kernel/index.ts` |
-| Service Registry | `server/kernel/registry/ServiceRegistry.ts` |
-| Health Monitor | `server/kernel/core/HealthMonitor.ts` |
-| Process Manager | `server/kernel/core/ProcessManager.ts` |
-| Discovery | `server/kernel/discovery/*.ts` |
-| Dashboard | `server/kernel/dashboard/DashboardServer.ts` |
-
----
-
-## 🎯 Próximos Passos Sugeridos
-
-1. **Criar especificação técnica** para cada funcionalidade faltante
-2. **Priorizar** baseado em necessidades de produção
-3. **Implementar** gradualmente, começando por Secrets e Circuit Breaker
-
-**Responsável:** Equipe de Platform/Infra  
-**Timeline:** 2-4 semanas por funcionalidade

docs/KERNEL_SPEC.md

@@ -1,365 +0,0 @@
-# Especificação Técnica: Arcadia Kernel
-
-> **Versão:** 3.3  
-> **Status:** ✅ Produção  
-> **Última atualização:** 2026-04-08
-
----
-
-## 1. Visão Geral
-
-O **Arcadia Kernel** é o sistema operacional nativo da ArcadiaSuite - um orquestrador de serviços em Node.js que unifica discovery, health monitoring e gerenciamento de processos.
-
-### 1.1 Objetivos
-
-- **Discovery**: Descobrir automaticamente todos os serviços do ecossistema
-- **Orquestração**: Iniciar, parar e reiniciar serviços (processos e containers)
-- **Observabilidade**: Health checks, logs e métricas centralizados
-- **Integração**: Unificar visão da Casa de Máquinas com dados reais
-
-### 1.2 Arquitetura
-
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                         ARCADIA APPLICATION (5000)                      │
-│  ┌─────────────────────────────────────────────────────────────────┐   │
-│  │                      ARCADIA KERNEL (5001)                      │   │
-│  ├─────────────────────────────────────────────────────────────────┤   │
-│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
-│  │  │  Dashboard  │  │   Process   │  │      LogAggregator      │ │   │
-│  │  │   (Web UI)  │  │   Manager   │  │                         │ │   │
-│  │  └──────┬──────┘  └──────┬──────┘  └─────────────────────────┘ │   │
-│  │         │                │                                      │   │
-│  │         └────────────────┴────────────────┐                     │   │
-│  │                          │                │                     │   │
-│  │              ┌───────────┴───────────┐   │                     │   │
-│  │              │   Service Registry    │◄──┼──┐                  │   │
-│  │              │  (Unified Discovery)  │   │  │                  │   │
-│  │              └───────────┬───────────┘   │  │                  │   │
-│  │                          │               │  │                  │   │
-│  │    ┌─────────────────────┼───────────────┘  │                  │   │
-│  │    │                     │                  │                  │   │
-│  │ ┌──┴──┐  ┌──────────┐  ┌┴─────────┐  ┌────┴─────┐  ┌────────┐ │   │
-│  │ │Static│  │ Coolify  │  │   XOS    │  │  Docker  │  │  ...   │ │   │
-│  │ │Disc. │  │  Disc.   │  │  Disc.   │  │  Disc.   │  │        │ │   │
-│  │ └──┬──┘  └────┬─────┘  └────┬─────┘  └────┬─────┘  └───┬────┘ │   │
-│  │    │          │             │             │            │      │   │
-│  │    └──────────┴─────────────┴─────────────┴────────────┘      │   │
-│  │                         │                                      │   │
-│  │              ┌──────────┴──────────┐                          │   │
-│  │              │   UnifiedRegistry   │                          │   │
-│  │              │  (Agregação + Dedu) │                          │   │
-│  │              └──────────┬──────────┘                          │   │
-│  └─────────────────────────┼─────────────────────────────────────┘   │
-│                            │                                          │
-│         ┌──────────────────┴──────────────────┐                       │
-│         │  global.arcadiaKernelRegistry        │                       │
-│         │  (Acesso direto - mesmo processo)    │                       │
-│         └──────────────────┬──────────────────┘                       │
-│                            │                                          │
-│    ┌───────────────────────┴───────────────────────┐                  │
-│    │                                               │                  │
-│    ▼                                               ▼                  │
-│ ┌─────────────────┐                    ┌─────────────────────┐       │
-│ │  Casa de        │                    │  /api/engine-room/* │       │
-│ │  Máquinas       │                    │  (API Express)      │       │
-│ │  (React UI)     │                    │                     │       │
-│ └─────────────────┘                    └─────────────────────┘       │
-└─────────────────────────────────────────────────────────────────────────┘
-
-Legenda:
-  ───► HTTP/HTTPS          ─ ─► Acesso direto (memória)
-  Porta 5000: App principal    Porta 5001: Kernel Dashboard (interno)
-```
-
----
-
-## 2. Componentes
-
-### 2.1 Core (ProcessManager, HealthMonitor, LogAggregator)
-
-**Status:** ✅ Estável
-
-- **ProcessManager**: Gerencia processos Node.js/Python locais
-- **HealthMonitor**: Health checks periódicos
-- **LogAggregator**: Coleta e armazena logs
-
-### 2.2 Service Registry
-
-**Status:** ✅ Implementado
-
-Catálogo central de serviços com:
-- Registro manual ou automático
-- Health status tracking
-- Capabilities e metadados
-- Eventos (service:registered, service:health_changed, etc)
-
-### 2.3 Discovery Providers
-
-| Provider | Status | Descrição |
-|----------|--------|-----------|
-| `StaticDiscovery` | ✅ | DNS interno (nomes fixos) |
-| `CoolifyDiscovery` | ✅ | API Coolify (produção) |
-| `DockerDiscovery` | ✅ | Docker labels (fallback) |
-| `XOSDiscovery` | ✅ | Banco XOS (filas, integrações) |
-| `UnifiedRegistry` | ⏳ | Agregador (Semana 5) |
-
----
-
-## 3. Discovery Providers
-
-### 3.1 StaticDiscovery
-
-Descobre serviços via nomes DNS fixos na rede Docker.
-
-```typescript
-// Ex: http://contabil:8003, http://bi:8004
-```
-
-### 3.2 CoolifyDiscovery
-
-Consulta API Coolify para descobrir serviços em produção.
-
-**Endpoints:**
-- `GET /api/v1/services` - Docker Compose services
-- `GET /api/v1/applications` - Aplicações
-
-**Filtro:** `arcadia.discovery.enabled=true`
-
-### 3.3 DockerDiscovery
-
-Lê labels de containers Docker na rede local.
-
-**Labels:**
-- `arcadia.discovery.enabled=true`
-- `arcadia.name=MetaSet BI`
-- `arcadia.type=python`
-- `arcadia.port=8100`
-- `arcadia.capabilities=dashboards,charts,sql_lab`
-
-### 3.4 XOSDiscovery
-
-Consulta banco de dados para descobrir serviços XOS.
-
-**Descobre:**
-- Filas de atendimento (`xos_queues`)
-- Integrações WhatsApp (`whatsapp_sessions`)
-- Automações ativas (`xos_automations`)
-
----
-
-## 4. API do Kernel
-
-### 4.1 Endpoints Core
-
-| Endpoint | Método | Descrição |
-|----------|--------|-----------|
-| `/health` | GET | Health check do Kernel |
-| `/api/kernel/services` | GET | Lista serviços do ProcessManager |
-| `/api/kernel/services/:id/start` | POST | Inicia serviço |
-| `/api/kernel/services/:id/stop` | POST | Para serviço |
-| `/api/kernel/services/:id/restart` | POST | Reinicia serviço |
-| `/api/kernel/services/:id/logs` | GET | Logs do serviço |
-
-### 4.2 Endpoints Registry
-
-| Endpoint | Método | Descrição |
-|----------|--------|-----------|
-| `/api/registry/services` | GET | Lista serviços descobertos |
-| `/api/registry/services/:id` | GET | Detalhes de um serviço |
-| `/api/registry/by-category/:cat` | GET | Serviços por categoria |
-| `/api/registry/by-capability/:cap` | GET | Serviços por capability |
-| `/api/registry/stats` | GET | Estatísticas do registry |
-| `/api/registry/discover` | POST | Força discovery manual |
-
-### 4.3 Endpoints Casa de Máquinas
-
-| Endpoint | Método | Descrição |
-|----------|--------|-----------|
-| `/api/engine-room/status` | GET | Status unificado (Registry + Presets) |
-| `/api/engine-room/engine/:name/health` | GET | Health de um motor |
-| `/api/engine-room/engine/:name/start` | POST | Inicia motor |
-| `/api/engine-room/engine/:name/stop` | POST | Para motor |
-| `/api/engine-room/engine/:name/restart` | POST | Reinicia motor |
-| `/api/engine-room/engine/:name/logs` | GET | Logs do motor |
-
----
-
-## 5. Integração Casa de Máquinas
-
-### 5.1 Fluxo de Dados
-
-```
-Casa de Máquinas (React)
-         │
-         ▼
-/api/engine-room/status
-         │
-         ▼
-┌─────────────────────────────┐
-│  fetchRegistryServices()    │
-│                             │
-│  PRIORIDADE 1: Registry     │
-│  Global (mesmo processo)    │
-│  ─────────────────────────  │
-│  (global.arcadiaKernel      │
-│   .serviceRegistry)         │
-│         │                   │
-│         ▼                   │
-│  ┌─────────────┐            │
-│  │  Acesso     │            │
-│  │  direto     │            │
-│  │  (memória)  │            │
-│  └──────┬──────┘            │
-│         │                   │
-│  Se falhar:                 │
-│  ─────────────────────────  │
-│  PRIORIDADE 2: HTTP         │
-│  Fallback para porta 5001   │
-│         │                   │
-│         ▼                   │
-│  ┌─────────────┐            │
-│  │  http.get   │            │
-│  │  127.0.0.1  │            │
-│  │  localhost  │            │
-│  └──────┬──────┘            │
-└─────────┼───────────────────┘
-          │
-          ▼
-    Resposta JSON
-          │
-          ▼
-     Frontend Render
-```
-
-### 5.2 Implementação Atual
-
-```typescript
-// server/engine-room/routes.ts
-async function fetchRegistryServicesWithRetry(): Promise<any[] | null> {
-  // PRIORIDADE 1: Registry global (mesmo processo Node.js)
-  const globalRegistry = (global as any).arcadiaKernelRegistry;
-  if (globalRegistry) {
-    const services = globalRegistry.getServices();
-    console.log(`[Engine Room] Usando Registry global: ${services.length} serviços`);
-    return services;
-  }
-  
-  // PRIORIDADE 2: HTTP request para porta 5001 (fallback)
-  console.log('[Engine Room] Registry global não disponível, tentando HTTP...');
-  // ... retry com 127.0.0.1 e localhost
-}
-```
-
-#### Vantagens do Registry Global
-
-| Aspecto | HTTP (antigo) | Registry Global (novo) |
-|---------|---------------|------------------------|
-| Latência | ~10-50ms | ~0.1ms |
-| Confiabilidade | Problemas com loopback Docker | 100% (mesmo processo) |
-| Complexidade | Retry, timeout, hostname | Acesso direto |
-| Failover | Necessário | Não aplicável |
-
-#### Inicialização no server/index.ts
-
-```typescript
-// Inicia Kernel ANTES do servidor HTTP
-const kernel = new ArcadiaKernel({
-  dashboard: { enabled: true, port: 5001, host: '0.0.0.0' },
-  autoStart: process.env.KERNEL_AUTOSTART === 'true',
-});
-await kernel.start();
-
-// Exporta Registry globalmente
-if (kernel.serviceRegistry) {
-  (global as any).arcadiaKernelRegistry = kernel.serviceRegistry;
-}
-
-// DEPOIS inicia servidor HTTP (porta 5000)
-httpServer.listen({ port: 5000, host: "0.0.0.0" }, ...);
-```
-
----
-
-## 6. Configuração
-
-### 6.1 Variáveis de Ambiente
-
-```bash
-# Kernel
-KERNEL_ENABLED=true
-KERNEL_AUTOSTART=true
-
-# Coolify Discovery
-COOLIFY_API_TOKEN=seu_token_aqui
-
-# MetaSet
-METASET_HOST=metaset
-METASET_PORT=8100
-
-# Modo Docker (desativa spawn de processos)
-DOCKER_MODE=true
-```
-
-### 6.2 Docker Compose Labels
-
-```yaml
-services:
-  metaset:
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=MetaSet BI"
-      - "arcadia.type=python"
-      - "arcadia.category=bi"
-      - "arcadia.port=8100"
-      - "arcadia.capabilities=dashboards,charts,sql_lab,rls,embedding"
-```
-
----
-
-## 7. Roadmap
-
-### Semana 4 ✅ CONCLUÍDO
-- [x] Service Registry
-- [x] StaticDiscovery
-- [x] CoolifyDiscovery
-- [x] DockerDiscovery
-- [x] Integração com Casa de Máquinas
-
-### Semana 5 ✅ CONCLUÍDO
-- [x] XOSDiscovery
-- [x] Registry Global (acesso direto)
-- [x] Integração Casa de Máquinas via memória
-- [ ] UnifiedRegistry (agregador) - Opcional
-
-### Semana 6 PLANEJADO
-- [ ] Maestro IA (Guardião de IAs)
-- [ ] Policy Engine
-- [ ] Audit Trail
-
-### Semana 7 PLANEJADO
-- [ ] Integração completa Maestro
-- [ ] Documentação P2P
-
----
-
-## 8. Histórico de Mudanças
-
-| Data | Versão | Mudança |
-|------|--------|---------|
-| 2026-04-06 | 3.0 | Service Registry + Discovery |
-| 2026-04-07 | 3.1 | Integração Casa de Máquinas |
-| 2026-04-08 | 3.2 | Coolify Discovery, XOS Discovery, correção MetaSet |
-| 2026-04-08 | 3.3 | **Registry Global** - Casa de Máquinas usa acesso direto (memória) em vez de HTTP |
-| 2026-04-08 | 3.4 | **MetaSet Consolidado** - Migração Metabase → Apache Superset 4.1.0 |
-
----
-
-## 9. Referências
-
-- `/server/kernel/` - Código fonte do Kernel
-- `/server/kernel/registry/` - Service Registry
-- `/server/kernel/discovery/` - Discovery Providers
-- `/server/engine-room/` - Casa de Máquinas (backend)
-- `/client/src/pages/Admin.tsx` - Casa de Máquinas (frontend)
-- `/home/ubuntu/.kimi/kernel e tenants.md` - Planejamento executivo

docs/MAPA_AUTOMACOES_ARCADIA.md

@@ -1,885 +0,0 @@
-# Arcádia Automações — Mapa Completo do Motor de Automação
-
-> Mapa da arquitetura de automações da Arcádia Suite: Automation Engine
-> (FastAPI :8005), Scheduler (Cron), Event Bus (Pub/Sub), Workflow
-> Executor (multi-step), Service Node.js (fallback), XOS Automations
-> (CRM), BPMN Viewer, e integração com Manus IA.
-> Atualizado em: Março 2026
-
----
-
-## 1. Visão Geral
-
-O sistema de automações opera em **duas camadas** coordenadas: um motor Python (FastAPI) que executa workflows complexos com scheduler e event bus, e um serviço Node.js que gerencia o CRUD das automações e funciona como fallback de agendamento.
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                   ARCÁDIA AUTOMAÇÕES — STACK COMPLETO                │
-│                                                                      │
-│  ┌─────────── Frontend ──────────────────────────────────────┐      │
-│  │                                                            │      │
-│  │  Automations.tsx    XosAutomations.tsx    WorkflowBuilder   │      │
-│  │  (559 linhas)       (350 linhas)          (493 linhas)     │      │
-│  │  CRUD + Trigger     CRM workflows         Visual editor   │      │
-│  │                                                            │      │
-│  │  BpmnPage.tsx       BpmnDiagram.tsx       ProcessDiagram   │      │
-│  │  (12 linhas)        (645 linhas)          (184 linhas)     │      │
-│  │  BPMN viewer        Diagrama visual       Fluxos visuais  │      │
-│  └────────────────────────┬───────────────────────────────────┘      │
-│                            │                                         │
-│  ┌─────────── Gateway (Node.js :5000) ───────────────────────┐      │
-│  │                            │                               │      │
-│  │  /api/automations/*   ←───┤   CRUD + Execução (Drizzle)   │      │
-│  │  (routes.ts — 343L)       │                               │      │
-│  │                            │                               │      │
-│  │  /api/automation-engine/* ←┤   Proxy → FastAPI :8005      │      │
-│  │  (engine-proxy.ts — 267L) │                               │      │
-│  │                            │                               │      │
-│  │  AutomationService        ←┤   Executor + Scheduler Node  │      │
-│  │  (service.ts — 209L)      │   (polling 60s fallback)      │      │
-│  └────────────────────────┬───────────────────────────────────┘      │
-│                            │                                         │
-│  ┌─────────── Motor Python (FastAPI :8005) ──────────────────┐      │
-│  │                            │                               │      │
-│  │  automation_engine.py (668 linhas)                        │      │
-│  │                                                            │      │
-│  │  ┌──────────┐  ┌──────────┐  ┌──────────────────┐        │      │
-│  │  │ Scheduler│  │Event Bus │  │Workflow Executor  │        │      │
-│  │  │ (Cron)   │  │(Pub/Sub) │  │(Multi-step)      │        │      │
-│  │  │          │  │          │  │                   │        │      │
-│  │  │ Entries  │  │ Subscribe│  │ Condition         │        │      │
-│  │  │ Start/   │  │ Emit     │  │ Action            │        │      │
-│  │  │ Stop     │  │ History  │  │ Delay             │        │      │
-│  │  │ 30s loop │  │ 500 max  │  │ SQL Query         │        │      │
-│  │  │          │  │          │  │ HTTP Request      │        │      │
-│  │  │          │  │          │  │ Transform         │        │      │
-│  │  │          │  │          │  │ Notify            │        │      │
-│  │  └──────────┘  └──────────┘  └──────────────────┘        │      │
-│  └───────────────────────────────────────────────────────────┘      │
-│                                                                      │
-│  ┌─────────── PostgreSQL ────────────────────────────────────┐      │
-│  │  automations, automation_actions, automation_logs,        │      │
-│  │  scheduled_tasks, xos_automations                         │      │
-│  └───────────────────────────────────────────────────────────┘      │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. Automation Engine (Python FastAPI — :8005)
-
-O motor Python é o coração do sistema de automações. Roda como processo separado e expõe 3 subsistemas via REST:
-
-### 2.1 — Event Bus (Barramento de Eventos)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  EventBus — Pub/Sub em memória                                    │
-│  server/python/automation_engine.py:117                           │
-│                                                                   │
-│  ┌─── Tipos de Eventos (EventType) ──────────────────────┐      │
-│  │                                                        │      │
-│  │  record.created      → Registro criado no banco       │      │
-│  │  record.updated      → Registro atualizado            │      │
-│  │  record.deleted      → Registro deletado              │      │
-│  │  schedule.fired      → Scheduler disparou cron        │      │
-│  │  webhook.received    → Webhook externo recebido       │      │
-│  │  threshold.reached   → Limiar atingido                │      │
-│  │  agent.completed     → Manus IA finalizou tarefa      │      │
-│  │  manual.trigger      → Disparo manual do usuário      │      │
-│  │  system.event        → Evento interno do sistema      │      │
-│  │                                                        │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Operações ─────────────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  subscribe(event_type, handler_id, config)            │      │
-│  │  → Registra um handler para um tipo de evento         │      │
-│  │                                                        │      │
-│  │  unsubscribe(event_type, handler_id)                  │      │
-│  │  → Remove assinatura                                  │      │
-│  │                                                        │      │
-│  │  emit(event_type, payload)                            │      │
-│  │  → Emite evento, retorna handlers triggerados          │      │
-│  │  → Suporta wildcard "*" (ouve tudo)                   │      │
-│  │                                                        │      │
-│  │  get_history(limit, event_type)                       │      │
-│  │  → Últimos eventos (máx. 500 em memória)              │      │
-│  │                                                        │      │
-│  │  stats()                                               │      │
-│  │  → total_event_types, total_subscribers,               │      │
-│  │    history_size, event_types list                       │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Fluxo:                                                           │
-│                                                                   │
-│  Emissor ──emit("record.created", {entity: "lead"})──▶ EventBus  │
-│                                                           │       │
-│                          ┌────────────────────────────────┤       │
-│                          ▼                                ▼       │
-│                    Handler A                         Handler B    │
-│                  (workflow X)                       (notificação) │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.2 — Scheduler (Agendador Cron)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  Scheduler — Cron-based scheduler                                 │
-│  server/python/automation_engine.py:186                           │
-│                                                                   │
-│  ┌─── CronExpression Parser ─────────────────────────────┐      │
-│  │                                                        │      │
-│  │  Formato: "minuto hora dia mês dia_semana"            │      │
-│  │  Suporta: *, ranges (1-5), steps (*/5), lists (1,3,5) │      │
-│  │                                                        │      │
-│  │  Exemplos:                                             │      │
-│  │  "0 9 * * 1-5"    → Seg-Sex às 9h                    │      │
-│  │  "*/15 * * * *"   → A cada 15 minutos                │      │
-│  │  "0 0 1 * *"      → 1º dia de cada mês à meia-noite  │      │
-│  │                                                        │      │
-│  │  matches(datetime) → bool                              │      │
-│  │  next_run(from_dt) → datetime                          │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── SchedulerEntry ────────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  id:             Identificador único                   │      │
-│  │  name:           Nome descritivo                       │      │
-│  │  cron:           Expressão cron (5 partes)             │      │
-│  │  automation_id:  Link para automação (opcional)        │      │
-│  │  action:         "trigger" (padrão)                    │      │
-│  │  config:         Configurações extras (JSON)           │      │
-│  │  is_active:      Ativo/Inativo                        │      │
-│  │  last_run:       Última execução (ISO)                 │      │
-│  │  next_run:       Próxima execução (ISO)                │      │
-│  │  run_count:      Contador de execuções                 │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Loop de Execução ──────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  Thread daemon, check_interval = 30 segundos          │      │
-│  │                                                        │      │
-│  │  A cada 30s:                                          │      │
-│  │  1. Varre todas as entries ativas                     │      │
-│  │  2. Para cada entry: cron.matches(agora)?             │      │
-│  │  3. Se match:                                         │      │
-│  │     a. Atualiza last_run, run_count                   │      │
-│  │     b. Calcula next_run                               │      │
-│  │     c. event_bus.emit("schedule.fired", {             │      │
-│  │          scheduler_id, automation_id, name             │      │
-│  │        })                                              │      │
-│  │  4. Sleep(30s)                                        │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Inicia automaticamente no startup do FastAPI                     │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.3 — Workflow Executor (Executor Multi-Step)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  WorkflowExecutor                                                 │
-│  server/python/automation_engine.py:273                           │
-│                                                                   │
-│  ┌─── WorkflowDefinition ────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  id:         Identificador do workflow                 │      │
-│  │  name:       Nome descritivo                           │      │
-│  │  steps:      Lista de WorkflowStep                     │      │
-│  │  trigger:    Tipo de trigger (opcional)                 │      │
-│  │  variables:  Variáveis iniciais (Dict)                 │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── WorkflowStep ─────────────────────────────────────┐       │
-│  │                                                        │      │
-│  │  id:         Identificador do step                     │      │
-│  │  type:       Tipo (ver abaixo)                         │      │
-│  │  config:     Configuração do step (Dict)               │      │
-│  │  on_success: Próximo step se OK (opcional)              │      │
-│  │  on_failure: Próximo step se falha (opcional)           │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Tipos de Steps (WorkflowStepType) ─────────────────┐      │
-│  │                                                        │      │
-│  │  condition   → Avalia condição (field, operator, value)│      │
-│  │               Operadores: ==, !=, >, <, >=, <=,       │      │
-│  │               contains, exists                         │      │
-│  │                                                        │      │
-│  │  action      → Executa ação:                           │      │
-│  │               • log (registra mensagem)                │      │
-│  │               • set_variable (define variável)         │      │
-│  │               • emit_event (emite evento no bus)       │      │
-│  │                                                        │      │
-│  │  delay       → Pausa execução (max 30s)                │      │
-│  │                                                        │      │
-│  │  query       → Executa SELECT no PostgreSQL            │      │
-│  │               Conexão read-only, timeout 10s,          │      │
-│  │               limite 100 rows                          │      │
-│  │                                                        │      │
-│  │  http        → Requisição HTTP (GET/POST/PUT/DELETE)   │      │
-│  │               Timeout 10s, resposta truncada em 5KB    │      │
-│  │                                                        │      │
-│  │  transform   → Transforma dados:                       │      │
-│  │               • count (conta itens)                    │      │
-│  │               • sum (soma campo numérico)              │      │
-│  │               • filter (filtra por campo/valor)        │      │
-│  │                                                        │      │
-│  │  notify      → Envia notificação (message + channel)   │      │
-│  │                                                        │      │
-│  │  loop        → Iteração (planejado)                    │      │
-│  │  parallel    → Execução paralela (planejado)           │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Fluxo de Execução ────────────────────────────────┐       │
-│  │                                                        │      │
-│  │  1. Recebe workflow_id + trigger_data + variables     │      │
-│  │  2. Cria execution com status "running"               │      │
-│  │  3. Merge: workflow.variables + variables + trigger   │      │
-│  │  4. Para cada step (sequencial):                      │      │
-│  │     a. Executa _execute_step(step, variables)         │      │
-│  │     b. Se resultado tem "output" → merge em variables │      │
-│  │     c. Registra resultado do step                     │      │
-│  │  5. Status final: "completed" ou "error"              │      │
-│  │  6. Guarda em memória (máx. 200 execuções)            │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Segurança:                                                       │
-│  • SQL: somente SELECT, read-only connection, timeout 10s        │
-│  • HTTP: timeout 10s, resposta truncada                          │
-│  • Delay: máximo 30 segundos                                     │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 3. Automation Service (Node.js — Fallback)
-
-O serviço Node.js complementa o motor Python, fornecendo CRUD das automações e um scheduler de fallback:
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  AutomationService                                                │
-│  server/automations/service.ts (209 linhas)                       │
-│                                                                   │
-│  ┌─── Executor de Ações (Node.js) ──────────────────────┐      │
-│  │                                                        │      │
-│  │  runAutomation(automationId, userId, triggerData)      │      │
-│  │                                                        │      │
-│  │  1. Cria log com status "running"                     │      │
-│  │  2. Busca automation + actions (orderBy orderIndex)   │      │
-│  │  3. Executa cada action sequencialmente:              │      │
-│  │                                                        │      │
-│  │  Tipos de ação suportados:                            │      │
-│  │                                                        │      │
-│  │  ┌────────────────────────────────────────────┐       │      │
-│  │  │ agent_task       → Dispara Manus IA        │       │      │
-│  │  │                   manusService.run(prompt)  │       │      │
-│  │  │                   Aguarda até 120s          │       │      │
-│  │  │                   Polls a cada 2s           │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ send_notification→ Registra notificação    │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ erp_sync         → Inicia sync com ERP     │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ generate_report  → Gera relatório          │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ webhook          → Chama URL externa       │       │      │
-│  │  │                   POST + JSON payload      │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ send_email       → Envia email             │       │      │
-│  │  ├────────────────────────────────────────────┤       │      │
-│  │  │ send_whatsapp    → Envia msg WhatsApp      │       │      │
-│  │  └────────────────────────────────────────────┘       │      │
-│  │                                                        │      │
-│  │  4. Atualiza log: "completed" ou "error"              │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Scheduler (Fallback) ──────────────────────────────┐      │
-│  │                                                        │      │
-│  │  startScheduler()                                      │      │
-│  │  → setInterval(60000) — verifica a cada 60s           │      │
-│  │                                                        │      │
-│  │  checkScheduledTasks()                                 │      │
-│  │  → JOIN scheduled_tasks + automations                 │      │
-│  │  → WHERE isActive = true AND nextRunAt <= agora       │      │
-│  │  → Executa runAutomation() para cada task due         │      │
-│  │  → Calcula nextRunAt baseado em intervalMinutes       │      │
-│  │  → Atualiza lastRunAt                                 │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Integração com Manus IA:                                         │
-│  • action "agent_task" → manusService.run(userId, prompt)        │
-│  • Aguarda execução com polling (até 120s)                       │
-│  • Verifica status: completed | stopped | error                   │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 4. Engine Proxy (Node.js → Python)
-
-O proxy traduz chamadas `/api/automation-engine/*` para o FastAPI em `:8005`:
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  Engine Proxy                                                     │
-│  server/automations/engine-proxy.ts (267 linhas)                  │
-│                                                                   │
-│  Config:                                                          │
-│  AUTOMATION_ENGINE_HOST = localhost (ou env var)                   │
-│  AUTOMATION_ENGINE_PORT = 8005                                    │
-│  TIMEOUT = 30 segundos                                            │
-│                                                                   │
-│  Tradução:                                                        │
-│                                                                   │
-│  /api/automation-engine/health     → GET  :8005/health            │
-│  /api/automation-engine/version    → GET  :8005/version           │
-│  /api/automation-engine/metrics    → GET  :8005/metrics           │
-│                                                                   │
-│  /api/automation-engine/scheduler/ → :8005/scheduler/             │
-│    entries (GET/POST/DELETE)                                      │
-│    start (POST)                                                   │
-│    stop (POST)                                                    │
-│                                                                   │
-│  /api/automation-engine/events/    → :8005/events/                │
-│    emit (POST)                                                    │
-│    subscribe (POST)                                               │
-│    subscribers (GET)                                               │
-│    history (GET)                                                   │
-│    types (GET)                                                    │
-│                                                                   │
-│  /api/automation-engine/workflows/ → :8005/workflows/             │
-│    register (POST)                                                │
-│    list (GET)                                                     │
-│    get/:id (GET)                                                  │
-│    execute/:id (POST)                                             │
-│    executions/:id (GET)                                           │
-│                                                                   │
-│  /api/automation-engine/executions → :8005/executions             │
-│  /api/automation-engine/cron/validate → :8005/cron/validate       │
-│                                                                   │
-│  Se engine offline → retorna { status: "offline" } no /health    │
-│  Demais rotas → 502 Bad Gateway se timeout                       │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 5. XOS Automations (CRM Workflows)
-
-Automações específicas do CRM com triggers baseados em eventos de negócio:
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  XOS Automations                                                  │
-│  Tabela: xos_automations — shared/schema.ts:6593                 │
-│  UI: client/src/pages/XosAutomations.tsx (350 linhas)            │
-│                                                                   │
-│  ┌─── Schema ────────────────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  id               serial PK                            │      │
-│  │  tenantId          FK → tenants.id                     │      │
-│  │  name             varchar(200) NOT NULL                │      │
-│  │  description      text                                 │      │
-│  │  triggerType      varchar(50) NOT NULL                 │      │
-│  │  triggerConfig    JSONB { condições do trigger }       │      │
-│  │  actions          JSONB [ { type, config } ]           │      │
-│  │  conditions       JSONB [ { field, operator, value } ] │      │
-│  │  isActive         boolean (default true)               │      │
-│  │  executionCount   integer (default 0)                  │      │
-│  │  lastExecutedAt   timestamp                            │      │
-│  │  createdBy        FK → users.id                        │      │
-│  │  createdAt, updatedAt  timestamp                       │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Triggers CRM ─────────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  contact_created    → Novo contato cadastrado          │      │
-│  │  deal_stage_changed → Deal mudou de estágio            │      │
-│  │  form_submitted     → Formulário preenchido            │      │
-│  │  ticket_created     → Ticket de suporte aberto         │      │
-│  │  deal_won           → Negócio fechado (ganho)          │      │
-│  │  deal_lost          → Negócio perdido                  │      │
-│  │  message_received   → Mensagem WhatsApp recebida       │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌─── Ações CRM ────────────────────────────────────────┐      │
-│  │                                                        │      │
-│  │  send_email         → Email automático                 │      │
-│  │  send_whatsapp      → Mensagem WhatsApp               │      │
-│  │  create_task        → Cria tarefa/atividade            │      │
-│  │  assign_agent       → Atribui agente ao ticket         │      │
-│  │  update_field       → Atualiza campo do registro       │      │
-│  │  move_deal_stage    → Move deal no pipeline            │      │
-│  │  webhook            → Chama URL externa                │      │
-│  │  notify_team        → Notifica equipe                  │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Diferença vs automations genérica:                               │
-│  • xos_automations → multi-tenant (tenantId)                     │
-│  • xos_automations → triggers de negócio (CRM)                   │
-│  • xos_automations → conditions inline (JSONB array)             │
-│  • automations     → por usuário (userId)                        │
-│  • automations     → triggers genéricos (schedule/webhook/manual)│
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 6. Banco de Dados — Tabelas
-
-### 6.1 — automations (Automações Genéricas)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  automations — shared/schema.ts:582                               │
-│                                                                   │
-│  id            serial PK                                          │
-│  userId        FK → users.id (CASCADE)                            │
-│  name          text NOT NULL                                      │
-│  description   text                                               │
-│  triggerType   text NOT NULL                                      │
-│                  "schedule" | "webhook" | "manual" | "event"      │
-│  triggerConfig text (JSON stringified)                            │
-│  isActive      "true" | "false"                                   │
-│  createdAt     timestamp                                          │
-│  updatedAt     timestamp                                          │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 6.2 — automation_actions (Ações da Automação)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  automation_actions — shared/schema.ts:594                        │
-│                                                                   │
-│  id              serial PK                                        │
-│  automationId    FK → automations.id (CASCADE)                    │
-│  orderIndex      integer (ordem de execução)                      │
-│  actionType      text NOT NULL                                    │
-│                    "agent_task" | "send_notification" |           │
-│                    "erp_sync" | "generate_report" |              │
-│                    "webhook" | "send_email" | "send_whatsapp"    │
-│  actionConfig    text (JSON: url, method, to, prompt, etc.)      │
-│  conditionConfig text (JSON: condição para executar)             │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 6.3 — automation_logs (Histórico de Execuções)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  automation_logs — shared/schema.ts:603                           │
-│                                                                   │
-│  id            serial PK                                          │
-│  automationId  FK → automations.id (CASCADE)                      │
-│  status        "running" | "completed" | "error"                  │
-│  triggerData   text (JSON: dados que dispararam)                  │
-│  result        text (resultado da execução)                       │
-│  error         text (mensagem de erro, se falhou)                 │
-│  startedAt     timestamp                                          │
-│  completedAt   timestamp                                          │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 6.4 — scheduled_tasks (Tarefas Agendadas)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  scheduled_tasks — shared/schema.ts:614                           │
-│                                                                   │
-│  id              serial PK                                        │
-│  automationId    FK → automations.id (CASCADE)                    │
-│  cronExpression  text ("0 9 * * 1-5")                             │
-│  intervalMinutes integer (alternativa ao cron)                    │
-│  nextRunAt       timestamp (próxima execução)                     │
-│  lastRunAt       timestamp (última execução)                      │
-│  isActive        "true" | "false"                                 │
-│                                                                   │
-│  Dois modos:                                                      │
-│  1. cronExpression → Parser Python (5 partes)                    │
-│  2. intervalMinutes → Simples: nextRunAt += interval              │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 6.5 — xos_automations (CRM Automations)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  xos_automations — shared/schema.ts:6593                         │
-│                                                                   │
-│  id              serial PK                                        │
-│  tenantId        FK → tenants.id (CASCADE)                        │
-│  name            varchar(200) NOT NULL                            │
-│  description     text                                             │
-│  triggerType     varchar(50) NOT NULL                             │
-│  triggerConfig   JSONB                                            │
-│  actions         JSONB [ { type, config } ]                      │
-│  conditions      JSONB [ { field, operator, value } ]            │
-│  isActive        boolean (default true)                           │
-│  executionCount  integer (default 0)                              │
-│  lastExecutedAt  timestamp                                        │
-│  createdBy       FK → users.id                                    │
-│  createdAt, updatedAt  timestamp                                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 7. API REST Completa
-
-### 7.1 — CRUD Automações (/api/automations/*)
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/automations` | Lista automações do usuário |
-| GET | `/api/automations/:id` | Detalhe (com actions + schedule) |
-| POST | `/api/automations` | Cria automação (+ actions + schedule) |
-| PUT | `/api/automations/:id` | Atualiza automação completa |
-| DELETE | `/api/automations/:id` | Exclui automação (cascade) |
-| POST | `/api/automations/:id/run` | Executa manualmente |
-| GET | `/api/automations/:id/logs` | Histórico de execuções (últimas 50) |
-
-### 7.2 — Automation Engine (/api/automation-engine/*)
-
-#### Saúde e Métricas
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/health` | Status (online/offline + stats) |
-| GET | `/version` | Versão + capabilities |
-| GET | `/metrics` | Métricas: scheduler, event_bus, workflows |
-
-#### Scheduler
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/scheduler/entries` | Lista entradas cron |
-| POST | `/scheduler/entries` | Adiciona entrada cron |
-| DELETE | `/scheduler/entries/:id` | Remove entrada |
-| POST | `/scheduler/start` | Inicia loop do scheduler |
-| POST | `/scheduler/stop` | Para loop do scheduler |
-
-#### Event Bus
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| POST | `/events/emit` | Emite evento |
-| POST | `/events/subscribe` | Registra handler |
-| GET | `/events/subscribers` | Lista assinantes |
-| GET | `/events/history` | Histórico de eventos |
-| GET | `/events/types` | Tipos de eventos disponíveis |
-
-#### Workflows
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| POST | `/workflows/register` | Registra workflow (steps) |
-| GET | `/workflows` | Lista workflows |
-| GET | `/workflows/:id` | Detalhe do workflow |
-| POST | `/workflows/:id/execute` | Executa workflow |
-| GET | `/workflows/:id/executions` | Execuções do workflow |
-| GET | `/executions` | Todas as execuções |
-
-#### Cron
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| POST | `/cron/validate` | Valida expressão cron + próximas 5 execuções |
-
-**Total: 27+ endpoints de automação**
-
----
-
-## 8. Frontend — Interfaces
-
-### 8.1 — Automations.tsx (Gestão Geral)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  Automations.tsx — 559 linhas                                     │
-│  Rota: /automations                                               │
-│                                                                   │
-│  Componentes:                                                     │
-│                                                                   │
-│  ┌── CreateAutomationDialog ─────────────────────────────┐      │
-│  │  • Nome, descrição                                     │      │
-│  │  • Tipo de trigger: schedule | webhook | manual | event│      │
-│  │  • Config do trigger (JSON)                            │      │
-│  │  • Actions: lista de { actionType, actionConfig }     │      │
-│  │  • Schedule: cronExpression ou intervalMinutes          │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  ┌── AutomationCard ────────────────────────────────────┐       │
-│  │  • Nome, tipo de trigger, status (ativo/inativo)      │      │
-│  │  • Botão: Executar agora                              │      │
-│  │  • Botão: Ativar/Desativar                           │      │
-│  │  • Botão: Excluir                                     │      │
-│  │  • Logs de execução (últimas 50)                      │      │
-│  └────────────────────────────────────────────────────────┘      │
-│                                                                   │
-│  Lista todas as automações do usuário logado                     │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 8.2 — XosAutomations.tsx (CRM Workflows)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  XosAutomations.tsx — 350 linhas                                  │
-│  Rota: /xos/automations                                           │
-│                                                                   │
-│  Foco em automações de CRM:                                       │
-│  • Triggers de negócio (contact_created, deal_stage_changed)     │
-│  • Ações comerciais (send_email, assign_agent, move_deal)        │
-│  • Condições inline (campo, operador, valor)                     │
-│  • Contagem de execuções e última execução                       │
-│  • Vinculado ao tenant (multi-tenant)                            │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 8.3 — WorkflowBuilder.tsx (Editor Visual)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  WorkflowBuilder.tsx — 493 linhas                                 │
-│  Rota: /workflow-builder                                          │
-│                                                                   │
-│  Editor visual de workflows:                                      │
-│  • Drag & drop de steps                                          │
-│  • Configuração de cada step (type + config)                     │
-│  • Visualização do fluxo                                         │
-│  • Registro no Workflow Executor do engine                       │
-│  • Execução e monitoramento                                     │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 8.4 — BPMN (Diagramas de Processo)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  BpmnDiagram.tsx — 645 linhas                                     │
-│  ProcessDiagram.tsx — 184 linhas                                  │
-│  BpmnPage.tsx — 12 linhas (wrapper)                               │
-│                                                                   │
-│  Visualização BPMN de processos:                                  │
-│  • Render de diagramas BPMN 2.0                                  │
-│  • Nós: start, end, task, gateway, event                         │
-│  • Conexões direcionais                                          │
-│  • Zoom e pan                                                    │
-│  • Usado no Process Compass (Módulo Consultivo)                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 9. Fluxo de Execução Completo
-
-### 9.1 — Automação Manual (Trigger: manual)
-
-```
-Usuário clica "Executar" na UI
-        │
-        ▼
-POST /api/automations/:id/run
-        │
-        ▼
-AutomationService.runAutomation()
-        │
-        ├──▶ INSERT automation_logs (status: "running")
-        │
-        ├──▶ SELECT automation_actions ORDER BY orderIndex
-        │
-        ├──▶ Para cada action:
-        │    ├── agent_task    → manusService.run() → GPT-4o
-        │    ├── webhook       → fetch(url, POST, body)
-        │    ├── send_email    → (placeholder)
-        │    ├── send_whatsapp → (placeholder)
-        │    ├── erp_sync      → (placeholder)
-        │    └── generate_report → (placeholder)
-        │
-        └──▶ UPDATE automation_logs (status: "completed")
-```
-
-### 9.2 — Automação Agendada (Trigger: schedule)
-
-```
-┌───────────────────── Scheduler Python ──────────────────────┐
-│                                                              │
-│  Thread daemon (30s loop)                                    │
-│  ↓                                                           │
-│  CronExpression.matches(agora)? → SIM                       │
-│  ↓                                                           │
-│  event_bus.emit("schedule.fired", {automation_id: 42})      │
-│                                                              │
-└──────────────────────────────────────────────────────────────┘
-        │
-        ▼ (subscriber triggerado)
-Handler executa ação configurada
-
-┌───────────── OU ── Scheduler Node.js (Fallback) ────────────┐
-│                                                              │
-│  setInterval(60000) → checkScheduledTasks()                 │
-│  ↓                                                           │
-│  SELECT scheduled_tasks                                      │
-│  JOIN automations                                           │
-│  WHERE isActive AND nextRunAt <= NOW()                       │
-│  ↓                                                           │
-│  AutomationService.runAutomation(id, userId)                │
-│  ↓                                                           │
-│  UPDATE nextRunAt = NOW() + intervalMinutes                  │
-│                                                              │
-└──────────────────────────────────────────────────────────────┘
-```
-
-### 9.3 — Workflow Engine (Multi-Step)
-
-```
-POST /api/automation-engine/workflows/register
-        │
-        ▼ Registra WorkflowDefinition com N steps
-        
-POST /api/automation-engine/workflows/:id/execute
-        │
-        ▼
-WorkflowExecutor.execute(workflow_id, trigger_data, variables)
-        │
-        ▼
-┌────────────── EXECUÇÃO SEQUENCIAL ──────────────────────────┐
-│                                                              │
-│  Step 1: condition                                          │
-│  ├── field: "revenue" operator: ">" value: 10000            │
-│  └── result: true → continua                                │
-│                                                              │
-│  Step 2: query                                              │
-│  ├── sql: "SELECT COUNT(*) FROM crm_leads WHERE ..."       │
-│  └── output: { query_result: [{count: 42}] }               │
-│                                                              │
-│  Step 3: http                                               │
-│  ├── url: "https://api.slack.com/webhook"                   │
-│  ├── method: "POST"                                         │
-│  └── body: { text: "42 novos leads!" }                     │
-│                                                              │
-│  Step 4: transform                                          │
-│  ├── operation: "sum", source: "query_result"               │
-│  └── output: { sum: 42 }                                   │
-│                                                              │
-│  Step 5: notify                                             │
-│  ├── message: "Pipeline atualizado"                         │
-│  └── channel: "system"                                      │
-│                                                              │
-│  → status: "completed", steps_completed: 5/5               │
-└──────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 10. Integração com Outros Sistemas
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                   INTEGRAÇÕES DA AUTOMAÇÃO                           │
-│                                                                      │
-│  ┌───────── Manus IA (GPT-4o) ─────────────────────────────┐      │
-│  │  action: "agent_task"                                     │      │
-│  │  → manusService.run(userId, prompt)                      │      │
-│  │  → Polling até 120s para conclusão                        │      │
-│  │  → Retorna resultado do agente                            │      │
-│  └───────────────────────────────────────────────────────────┘      │
-│                                                                      │
-│  ┌───────── WhatsApp (Baileys) ──────────────────────────────┐     │
-│  │  action: "send_whatsapp"                                   │     │
-│  │  trigger: "message_received" (xos_automations)             │     │
-│  │  → Integra via CommunicationService                        │     │
-│  └────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────── ERPNext/SOE ─────────────────────────────────────┐     │
-│  │  action: "erp_sync"                                        │     │
-│  │  trigger: "record.created" / "record.updated"              │     │
-│  │  → Sincroniza entidades com motor SOE                      │     │
-│  └────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────── Webhooks Externos ───────────────────────────────┐     │
-│  │  action: "webhook"                                         │     │
-│  │  trigger: "webhook.received"                               │     │
-│  │  → HTTP POST/GET com payload JSON                         │     │
-│  │  → Slack, Zapier, n8n, APIs externas                      │     │
-│  └────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────── Knowledge Graph ─────────────────────────────────┐     │
-│  │  Eventos de automação alimentam o Knowledge Graph         │     │
-│  │  via comm_events → graph_nodes + graph_edges              │     │
-│  └────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────── Casa de Máquinas ─────────────────────────────────┐    │
-│  │  Monitora status do Automation Engine (:8005)               │    │
-│  │  GET /api/automation-engine/health                          │    │
-│  │  Exibe: scheduler stats, event_bus stats, workflow stats    │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 11. Arquivos-Chave
-
-| Arquivo | Função | Linhas |
-|---------|--------|--------|
-| `server/python/automation_engine.py` | Motor FastAPI (Scheduler + EventBus + Workflows) | 668 |
-| `server/automations/service.ts` | AutomationService (executor + scheduler fallback) | 209 |
-| `server/automations/routes.ts` | CRUD API (/api/automations/*) | 343 |
-| `server/automations/engine-proxy.ts` | Proxy Node → Python (:8005) | 267 |
-| `shared/schema.ts` (L582-636) | 4 tabelas: automations, actions, logs, scheduled | 55 |
-| `shared/schema.ts` (L6593-6608) | xos_automations (CRM workflows) | 16 |
-| `client/src/pages/Automations.tsx` | Interface CRUD geral | 559 |
-| `client/src/pages/XosAutomations.tsx` | Interface CRM automations | 350 |
-| `client/src/pages/WorkflowBuilder.tsx` | Editor visual de workflows | 493 |
-| `client/src/components/BpmnDiagram.tsx` | Diagrama BPMN | 645 |
-| `client/src/components/ProcessDiagram.tsx` | Diagrama de processos | 184 |
-
----
-
-## 12. Resumo Visual
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    ARCÁDIA AUTOMAÇÕES STACK                           │
-│                                                                      │
-│  ┌─── Frontend ──────────────────────────────────────────────┐     │
-│  │  Automations.tsx │ XosAutomations.tsx │ WorkflowBuilder    │     │
-│  │  BPMN Viewer     │ ProcessDiagram     │                    │     │
-│  └──────────────────────────┬────────────────────────────────┘     │
-│                              │                                      │
-│  ┌──────────────────────────▼────────────────────────────────┐     │
-│  │  Node.js Gateway (:5000)                                   │     │
-│  │                                                            │     │
-│  │  /api/automations/*        → CRUD (Drizzle ORM)           │     │
-│  │  /api/automation-engine/*  → Proxy para :8005             │     │
-│  │  AutomationService         → Executor + Scheduler 60s    │     │
-│  └──────────────────────────┬────────────────────────────────┘     │
-│                              │                                      │
-│  ┌──────────────────────────▼────────────────────────────────┐     │
-│  │  Python FastAPI (:8005)                                    │     │
-│  │                                                            │     │
-│  │  ┌──────────┐  ┌──────────┐  ┌──────────────────┐        │     │
-│  │  │ Scheduler│  │Event Bus │  │Workflow Executor  │        │     │
-│  │  │ 30s loop │  │ Pub/Sub  │  │ 10 step types    │        │     │
-│  │  │ Cron 5pt │  │ 9 events │  │ SQL/HTTP/Logic   │        │     │
-│  │  └──────────┘  └──────────┘  └──────────────────┘        │     │
-│  └───────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────────────────────────────────────────────────────────┐     │
-│  │  PostgreSQL: 5 tabelas                                     │     │
-│  │  automations, automation_actions, automation_logs,         │     │
-│  │  scheduled_tasks, xos_automations                          │     │
-│  └───────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌───────────────────────────────────────────────────────────┐     │
-│  │  Integrações: Manus IA, WhatsApp, ERPNext, Webhooks,      │     │
-│  │  Knowledge Graph, Casa de Máquinas                         │     │
-│  └───────────────────────────────────────────────────────────┘     │
-└─────────────────────────────────────────────────────────────────────┘
-```

docs/MAPA_BI_ARCADIA.md

@@ -1,841 +0,0 @@
-# Arcádia BI — Mapa de Business Intelligence
-
-> Mapa completo da arquitetura de BI, incluindo Motor Python, MetaSet (Apache Superset),
-> Cientista (IA), ETL/Staging, APIs e Frontend.
-> Atualizado em: Abril 2026
-
----
-
-## 1. Visão Geral
-
-O BI da Arcádia Suite opera em **4 camadas complementares** que se combinam para oferecer analytics completo: desde queries SQL diretas até dashboards visuais no MetaSet (Apache Superset), passando por análise com IA e ingestão de dados externos.
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                        USUÁRIO / FRONTEND                            │
-│                                                                      │
-│   BiWorkspace.tsx (2.970 linhas)          MetaSet (Embeddado)       │
-│   React + Recharts + Tailwind             Proxy → :8088              │
-│   8 abas funcionais                       Dashboards avançados       │
-│                                                                      │
-│   ┌──────────┬──────────┬──────────┬──────────┬──────────┐          │
-│   │ Overview │DataSrc   │ Upload   │ Datasets │ Charts   │          │
-│   ├──────────┼──────────┼──────────┼──────────┼──────────┤          │
-│   │ Backups  │ Staging  │ Advanced │          │          │          │
-│   └──────────┴──────────┴──────────┴──────────┴──────────┘          │
-│                                                                      │
-│   ┌─────────────────────────────────────┐                            │
-│   │  🤖 Assistente BI (IA)              │                            │
-│   │  Chat com GPT-4o sobre dados        │                            │
-│   │  Prompts rápidos + análise livre    │                            │
-│   └─────────────────────────────────────┘                            │
-└─────────────────────────┬────────────────────────────────────────────┘
-                          │
-          ┌───────────────┼───────────────────────┐
-          │               │                       │
-          ▼               ▼                       ▼
-┌─────────────────┐ ┌──────────────────┐ ┌─────────────────────┐
-│  API BI (Node)  │ │BI Engine (Python)│ │ MetaSet (Python)    │
-│  /api/bi/*      │ │ /api/bi-engine/* │ │ /bi/metaset/*      │
-│                 │ │                  │ │                     │
-│ CRUD:           │ │ SQL Execution    │ │ Dashboards          │
-│ - DataSources   │ │ Chart Data Gen   │ │ Perguntas/Queries   │
-│ - Datasets      │ │ Micro-BI         │ │ Alertas             │
-│ - Charts        │ │ Análise Pandas   │ │ Visualizações       │
-│ - Dashboards    │ │ Cache (TTL 5min) │ │ Coleções            │
-│ - Backups       │ │ Agregações       │ │ Embedding           │
-│ - Upload/ETL    │ │ Insights Auto    │ │                     │
-│ - Staging       │ │                  │ │                     │
-│ - AI Analysis   │ │                  │ │                     │
-└────────┬────────┘ └────────┬─────────┘ └──────────┬──────────┘
-         │                   │                       │
-         ▼                   ▼                       ▼
-┌─────────────────────────────────────────────────────────────────────┐
-│                       PostgreSQL (Porta 5432)                        │
-│                                                                      │
-│  Tabelas de gestão BI: data_sources, bi_datasets, bi_charts,        │
-│  bi_dashboards, bi_dashboard_charts, backup_jobs, backup_artifacts,  │
-│  staged_tables, staging_mappings, migration_jobs                     │
-│                                                                      │
-│  Tabelas de negócio: persons, products, sales_orders, fin_*,        │
-│  crm_*, whatsapp_messages, valuation_*, etc.                         │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. Os 4 Pilares do BI
-
-### Pilar 1 — Motor BI Python (FastAPI :8004)
-
-O coração analítico. Processa SQL, gera dados para gráficos e fornece Micro-BI.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    BI ENGINE (Python 3.11)                    │
-│                    FastAPI + Pandas + NumPy                   │
-│                    Porta: 8004                                │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ SEGURANÇA SQL                                         │   │
-│  │                                                       │   │
-│  │ ✓ Somente SELECT/WITH permitidos                     │   │
-│  │ ✓ 17 keywords bloqueadas (DROP, DELETE, INSERT...)   │   │
-│  │ ✓ 7 padrões perigosos filtrados (pg_sleep, --, /*)   │   │
-│  │ ✓ Multi-statement bloqueado (múltiplos ;)            │   │
-│  │ ✓ Conexão read-only (autocommit)                     │   │
-│  │ ✓ Timeout: 30 segundos por query                     │   │
-│  │ ✓ Limite: 10.000 linhas por resultado                │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ CACHE (QueryCache)                                    │   │
-│  │                                                       │   │
-│  │ • Tipo: In-memory (OrderedDict)                      │   │
-│  │ • Max entries: 200                                    │   │
-│  │ • TTL: 300 segundos (5 minutos)                      │   │
-│  │ • Key: SHA-256 de (SQL + params)                     │   │
-│  │ • Métricas: hits, misses, hit_rate (%)               │   │
-│  │ • Invalidação: por padrão ou total                   │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ CAPABILITIES                                          │   │
-│  │                                                       │   │
-│  │ • sql_query    → Execução de SELECT arbitrário       │   │
-│  │ • chart_data   → Geração de dados para gráficos     │   │
-│  │ • micro_bi     → Métricas rápidas com comparação    │   │
-│  │ • analysis     → Análise estatística com Pandas     │   │
-│  │ • aggregation  → Agregações customizadas            │   │
-│  │ • cache        → Cache inteligente de queries       │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Pilar 2 — MetaSet (Apache Superset :8100)
-
-Plataforma visual de BI baseada em Apache Superset 4.1.0, acessível via proxy reverso.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                      METASET (SUPERSET)                      │
-│               Porta: 8100 (via proxy /bi/metaset)            │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ PROXY (http-proxy-middleware)                         │   │
-│  │                                                       │   │
-│  │ Gateway (:5000) → /bi/metaset/* → MetaSet (:8100)    │   │
-│  │                                                       │   │
-│  │ • pathRewrite: /bi/metaset → /                      │   │
-│  │ • changeOrigin: true                                  │   │
-│  │ • timeout: 60 segundos                                │   │
-│  │ • Reescrita de Location headers                      │   │
-│  │ • Fallback: 502 "MetaSet indisponível"              │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ FUNCIONALIDADES                                       │   │
-│  │                                                       │   │
-│  │ • Dashboards visuais (drag & drop)                   │   │
-│  │ • Perguntas SQL / visual query builder               │   │
-│  │ • Alertas automáticos                                │   │
-│  │ • Coleções organizadas                               │   │
-│  │ • Embedding de dashboards                            │   │
-│  │ • Filtros interativos                                │   │
-│  │ • Exportação (CSV, Excel, PDF)                       │   │
-│  │ • Agendamento de relatórios                          │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │ CONEXÃO                                               │   │
-│  │                                                       │   │
-│  │ Banco: PostgreSQL (mesmo DATABASE_URL do Gateway)    │   │
-│  │ Acesso: Todas as tabelas public (read-only)          │   │
-│  │ Config: METABASE_HOST, METABASE_PORT                 │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Pilar 3 — API BI Node.js (Gateway :5000)
-
-Camada de gestão e CRUD para objetos de BI.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    API BI (Node.js/Express)                   │
-│                    Registrada no Gateway (:5000)              │
-│                                                              │
-│  ┌── Gestão de Objetos BI ──────────────────────────────┐   │
-│  │                                                       │   │
-│  │  Data Sources → Conexões com bancos externos         │   │
-│  │  Datasets     → Conjuntos de dados (table/SQL/API)   │   │
-│  │  Charts       → Gráficos salvos (config + dados)     │   │
-│  │  Dashboards   → Painéis com layout de charts         │   │
-│  │  Backup Jobs  → Jobs de backup programados           │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── ETL & Ingestão ────────────────────────────────────┐   │
-│  │                                                       │   │
-│  │  Upload      → Importação de arquivos                │   │
-│  │  Staging     → Área de preparação para migração      │   │
-│  │  Migration   → Jobs de migração de dados             │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Tabelas Internas ──────────────────────────────────┐   │
-│  │                                                       │   │
-│  │  Exploração de schema do PostgreSQL                  │   │
-│  │  Criação de datasets a partir de tabelas internas    │   │
-│  │  Categorização automática (Sistema, CRM, BI, etc.)   │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Análise com IA ────────────────────────────────────┐   │
-│  │                                                       │   │
-│  │  OpenAI GPT-4o → Responde perguntas sobre dados      │   │
-│  │  Prompts pré-definidos (Resumo, Anomalias, etc.)    │   │
-│  │  Formato JSON estruturado (answer + insights)        │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Pilar 4 — Cientista (Python: Auto-Programação)
-
-Módulo de IA para análise avançada e geração de código.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    CIENTISTA (Python)                         │
-│                    python-service/services/cientista.py       │
-│                                                              │
-│  ┌── Análise Estatística ───────────────────────────────┐   │
-│  │                                                       │   │
-│  │  analyze_data()                                       │   │
-│  │  → Shape (rows × columns)                            │   │
-│  │  → Tipos de dados por coluna                         │   │
-│  │  → Valores ausentes                                  │   │
-│  │  → Estatísticas (describe): mean, std, min, max     │   │
-│  │  → Amostra dos dados (5 primeiros registros)        │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Detecção de Padrões ──────────────────────────────┐   │
-│  │                                                       │   │
-│  │  detect_patterns()                                    │   │
-│  │  → Correlações fortes (> 0.7) entre colunas         │   │
-│  │  → Tendências (crescente/decrescente) via polyfit   │   │
-│  │  → Saída: [{ type, columns, value, description }]   │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Insights Automáticos ─────────────────────────────┐   │
-│  │                                                       │   │
-│  │  generate_insights()                                  │   │
-│  │  → Valores ausentes por coluna (% de missing)       │   │
-│  │  → Detecção de outliers (IQR × 1.5)                 │   │
-│  │  → Valores dominantes (> 50% em categóricas)        │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Auto-Programação (ScientistModule) ────────────────┐  │
-│  │                                                       │   │
-│  │  generate_analysis_code(description, goal)            │   │
-│  │  → Templates: aggregate, filter, predict, correlate  │   │
-│  │  → Gera código Python executável                     │   │
-│  │  → Salva padrões aprendidos                          │   │
-│  │  → Histórico de execuções                            │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 3. API REST Completa
-
-### 3.1 — BI Engine Proxy (/api/bi-engine/*)
-
-Proxy do Gateway para o Motor Python FastAPI (:8004):
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi-engine/health` | Status do motor (online/offline, banco, cache) |
-| GET | `/api/bi-engine/version` | Versão e capabilities |
-| GET | `/api/bi-engine/metrics` | Métricas (cache stats, limites) |
-| GET | `/api/bi-engine/tables` | Lista todas as tabelas do PostgreSQL |
-| GET | `/api/bi-engine/tables/:name/columns` | Schema de colunas de uma tabela |
-| GET | `/api/bi-engine/tables/:name/preview` | Preview dos dados (limit padrão: 50) |
-| GET | `/api/bi-engine/tables/:name/stats` | Estatísticas (row_count, column_count) |
-| POST | `/api/bi-engine/query` | Executa SQL (somente SELECT/WITH) |
-| POST | `/api/bi-engine/chart-data` | Gera dados formatados para gráficos |
-| POST | `/api/bi-engine/micro-bi` | Micro-BI: métricas rápidas com comparação temporal |
-| POST | `/api/bi-engine/analyze` | Análise de dados com Pandas |
-| POST | `/api/bi-engine/aggregate` | Agregações customizadas |
-| GET | `/api/bi-engine/cache/stats` | Estatísticas do cache |
-| POST | `/api/bi-engine/cache/invalidate` | Invalida cache (por padrão ou total) |
-
-### 3.2 — BI Management (/api/bi/*)
-
-CRUD de objetos BI no Gateway Node.js:
-
-#### Data Sources
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/data-sources` | Lista fontes de dados do usuário |
-| POST | `/api/bi/data-sources` | Cria fonte (PostgreSQL, MySQL, MongoDB, SQLite, Internal) |
-| POST | `/api/bi/data-sources/:id/test` | Testa conexão |
-| DELETE | `/api/bi/data-sources/:id` | Remove fonte |
-
-#### Datasets
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/datasets` | Lista datasets do usuário |
-| POST | `/api/bi/datasets` | Cria dataset (table, SQL ou API) |
-| POST | `/api/bi/datasets/:id/execute` | Executa dataset e retorna dados |
-| DELETE | `/api/bi/datasets/:id` | Remove dataset |
-
-#### Charts
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/charts` | Lista gráficos do usuário |
-| POST | `/api/bi/charts` | Cria gráfico (bar, line, pie, area, scatter, table, metric, donut) |
-| DELETE | `/api/bi/charts/:id` | Remove gráfico |
-
-#### Dashboards
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/dashboards` | Lista dashboards do usuário |
-| GET | `/api/bi/dashboards/:id` | Detalhe do dashboard + charts posicionados |
-| POST | `/api/bi/dashboards` | Cria dashboard |
-| POST | `/api/bi/dashboards/:id/charts` | Adiciona chart ao dashboard (com posição X/Y/W/H) |
-| DELETE | `/api/bi/dashboards/:id` | Remove dashboard |
-
-#### Tabelas Internas
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/internal-tables` | Lista tabelas do sistema (com tamanho e categoria) |
-| GET | `/api/bi/internal-tables/:name/schema` | Schema + preview + row count |
-| POST | `/api/bi/internal-tables/:name/create-dataset` | Cria dataset a partir de tabela interna |
-| POST | `/api/bi/query` | Query direta em tabela (simples, limite 1000) |
-
-#### Backups
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/bi/backup-jobs` | Lista jobs de backup |
-| POST | `/api/bi/backup-jobs` | Cria job (full, schema, data, incremental) |
-| POST | `/api/bi/backup-jobs/:id/run` | Executa backup |
-| DELETE | `/api/bi/backup-jobs/:id` | Remove job |
-| GET | `/api/bi/backup-artifacts` | Lista artefatos gerados |
-
-### 3.3 — Upload & ETL (/api/upload/*, /api/staging/*)
-
-#### Upload de Dados
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| POST | `/api/upload/file` | Upload de arquivo (CSV, JSON, Excel, SQL, BSON, ZIP) |
-| POST | `/api/upload/analyze` | Analisa arquivo e sugere schema |
-
-Formatos suportados (até 200MB):
-- `.csv`, `.txt` → Parser CSV inteligente (suporta aspas)
-- `.json` → Parse direto de arrays/objetos
-- `.xlsx`, `.xls` → Leitura via SheetJS (XLSX)
-- `.sql` → Detecção de INSERTs e criação de datasets
-- `.bson` → Parse via biblioteca BSON
-- `.zip` → Extração e processamento de conteúdo
-
-#### Staging (Área de Preparação)
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/staging/tables` | Lista tabelas staged |
-| GET | `/api/staging/tables/:id` | Detalhe de tabela staged |
-| GET | `/api/staging/tables/:id/data` | Dados da tabela staged |
-| POST | `/api/staging/tables/:id/mappings` | Cria mapeamento de colunas |
-| GET | `/api/staging/tables/:id/mappings` | Lista mapeamentos |
-| POST | `/api/staging/tables/:id/migrate` | Executa migração para tabela destino |
-| DELETE | `/api/staging/tables/:id` | Remove tabela staged |
-
-### 3.4 — MetaSet Proxy (/metaset/*)
-
-| Rota | Destino | Função |
-|------|---------|--------|
-| `/metaset/*` | `http://localhost:8088/*` | Proxy reverso completo para MetaSet |
-
----
-
-## 4. Banco de Dados — Tabelas do BI
-
-### Objetos BI
-
-```
-┌─────────────────────────────┐  ┌──────────────────────────────┐
-│ data_sources                 │  │ bi_datasets                   │
-│                              │  │                               │
-│ id, userId, name,            │  │ id, userId, name, description,│
-│ type (postgresql|mysql|      │  │ dataSourceId, queryType       │
-│ mongodb|sqlite|internal),    │  │ (table|sql|api), tableName,   │
-│ host, port, database,        │  │ sqlQuery, columns, filters,   │
-│ username, password,          │  │ isPublic, createdAt, updatedAt│
-│ connectionString, isActive,  │  │                               │
-│ lastTestedAt, createdAt      │  └───────────────┬───────────────┘
-└──────────────────────────────┘                  │ 1:N
-                                                   ▼
-┌─────────────────────────────────────────────────────────────────┐
-│ bi_charts                                                        │
-│                                                                  │
-│ id, userId, name, datasetId, chartType (bar|line|pie|area|      │
-│ scatter|table|metric|donut), config (JSON), xAxis, yAxis,       │
-│ groupBy, aggregation, colors, createdAt, updatedAt               │
-└──────────────────────────┬──────────────────────────────────────┘
-                           │ N:M (via bi_dashboard_charts)
-                           ▼
-┌─────────────────────────────────────────────────────────────────┐
-│ bi_dashboards                           bi_dashboard_charts     │
-│                                                                  │
-│ id, userId, name,                       id, dashboardId,        │
-│ description, layout (JSON),             chartId,                │
-│ isPublic, createdAt, updatedAt          positionX, positionY,   │
-│                                         width, height            │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Backups
-
-```
-┌───────────────────────────────┐  ┌───────────────────────────────┐
-│ backup_jobs                    │  │ backup_artifacts               │
-│                                │  │                                │
-│ id, userId, name,              │  │ id, backupJobId, filename,     │
-│ dataSourceId, backupType       │  │ filePath, fileSize, status     │
-│ (full|schema|data|incremental),│  │ (running|completed|failed),   │
-│ includeSchema, includeTables,  │  │ startedAt, completedAt,       │
-│ excludeTables, compressionType,│  │ errorMessage                   │
-│ retentionDays, storageLocation,│  │                                │
-│ lastRunAt, isActive, createdAt │  │                                │
-└───────────────────────────────┘  └───────────────────────────────┘
-```
-
-### Staging & Migração
-
-```
-┌───────────────────────────────┐  ┌───────────────────────────────┐
-│ staged_tables                  │  │ staging_mappings               │
-│                                │  │                                │
-│ id, userId, name,              │  │ id, stagedTableId,             │
-│ originalFilename, fileType,    │  │ sourceColumn, targetTable,     │
-│ rowCount, columnCount,         │  │ targetColumn, transformType,   │
-│ columns (JSON), sampleData,    │  │ transformConfig, createdAt     │
-│ status, createdAt, updatedAt   │  │                                │
-└───────────────────────────────┘  └───────────────────────────────┘
-
-┌───────────────────────────────────────────────────────────────────┐
-│ migration_jobs                                                     │
-│                                                                    │
-│ id, userId, name, stagedTableId, targetTable, status,              │
-│ (pending|running|completed|failed), totalRows, processedRows,     │
-│ errorLog, mappingConfig (JSON), createdAt, updatedAt               │
-└───────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 5. Frontend — BiWorkspace.tsx (2.970 linhas)
-
-### Tabs
-
-| Tab | Valor | Descrição |
-|-----|-------|-----------|
-| **Overview** | `overview` | KPIs resumo: DataSources, Datasets, Charts, Dashboards, Backups |
-| **Data Sources** | `datasources` | CRUD de fontes externas (PostgreSQL, MySQL, MongoDB, SQLite) + tabelas internas do sistema |
-| **Upload** | `upload` | Importação de arquivos (CSV, Excel, JSON, SQL, BSON, ZIP) com preview automático |
-| **Datasets** | `datasets` | Conjuntos de dados criados a partir de tabelas ou SQL, com execução e preview |
-| **Charts** | `charts` | Criação de gráficos (8 tipos) a partir de datasets, com visualização Recharts |
-| **Backups** | `backups` | Jobs de backup com execução e artefatos gerados |
-| **Staging** | `staging` | Área de preparação: mapeamento de colunas, migração para tabelas destino |
-| **Advanced** | `advanced` | BI Engine (link para Motor Python), MetaSet (link para iframe), Assistente IA |
-
-### Tipos de Gráficos Suportados (Recharts)
-
-| Tipo | Componente | Uso |
-|------|-----------|-----|
-| `bar` | `BarChart + Bar` | Comparação entre categorias |
-| `line` | `LineChart + Line` | Evolução temporal |
-| `pie` | `PieChart + Pie + Cell` | Proporções (até 8 fatias) |
-| `area` | `AreaChart + Area` | Tendências com preenchimento |
-| `scatter` | (planejado) | Correlação entre variáveis |
-| `table` | HTML Table | Dados tabulares |
-| `metric` | Card KPI | Valor único com destaque |
-| `donut` | `PieChart (innerRadius)` | Proporções com centro vazio |
-
-### Assistente BI (IA)
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  🤖 Assistente BI                                            │
-│                                                              │
-│  • Chat conversacional com GPT-4o                           │
-│  • Recebe dados do dataset ativo como contexto              │
-│  • Prompts rápidos pré-definidos:                           │
-│    📊 "Resumo Executivo" (principais métricas e insights)   │
-│    🔍 "Anomalias" (outliers e desvios)                      │
-│    📈 "Tendências" (padrões temporais)                      │
-│    💡 "Recomendações" (ações sugeridas)                     │
-│  • Formato de resposta: JSON { answer, insights[] }         │
-│  • Interface: chat bubble com histórico                     │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Categorias de Tabelas Internas
-
-O BI mapeia automaticamente as tabelas do sistema em categorias:
-
-| Categoria | Tabelas |
-|-----------|---------|
-| **Sistema** | users, applications, roles |
-| **Process Compass** | pc_clients, pc_projects, pc_tasks |
-| **CRM** | crm_clients, crm_contracts, crm_partners, crm_opportunities, crm_leads, crm_messages |
-| **BI** | bi_datasets, bi_charts |
-| **Conhecimento** | knowledge_base |
-| **Manus** | manus_runs, agent_tasks |
-| **Comunicação** | whatsapp_messages, conversations |
-| **Outros** | Todas as demais tabelas (valuation_*, fin_*, etc.) |
-
----
-
-## 6. Motor BI Python — Endpoints Detalhados
-
-### POST /query — Execução SQL
-
-```json
-{
-  "sql": "SELECT status, COUNT(*) as total FROM sales_orders GROUP BY status",
-  "params": {},
-  "limit": 1000,
-  "use_cache": true
-}
-```
-
-Retorno:
-```json
-{
-  "data": [{"status": "confirmed", "total": 45}, ...],
-  "columns": [{"name": "status", "type": "1043"}, ...],
-  "row_count": 3,
-  "elapsed_ms": 12.5,
-  "cached": false
-}
-```
-
-### POST /chart-data — Dados para Gráficos
-
-```json
-{
-  "table": "sales_orders",
-  "x_axis": "created_at",
-  "y_axis": "total_amount",
-  "aggregation": "sum",
-  "time_grain": "month",
-  "group_by": "status",
-  "filters": [{"column": "status", "operator": "!=", "value": "cancelled"}],
-  "limit": 12
-}
-```
-
-Retorno:
-```json
-{
-  "labels": ["2026-01", "2026-02", "2026-03"],
-  "series": {
-    "confirmed": [{"label": "2026-01", "value": 15000}, ...],
-    "delivered": [{"label": "2026-01", "value": 12000}, ...]
-  },
-  "row_count": 6,
-  "elapsed_ms": 18.3,
-  "query": "SELECT DATE_TRUNC('month', created_at) AS label, status AS series, SUM(total_amount) AS value FROM sales_orders WHERE status != 'cancelled' GROUP BY ...",
-  "cached": false
-}
-```
-
-### POST /micro-bi — Métricas Rápidas
-
-```json
-{
-  "table": "fin_transactions",
-  "metrics": ["count", "sum:amount", "avg:amount"],
-  "dimension": "category",
-  "period": "month",
-  "compare_previous": true
-}
-```
-
-Retorno:
-```json
-{
-  "current": [
-    {"dimension": "vendas", "count": 120, "sum_amount": 45000, "avg_amount": 375}
-  ],
-  "previous": [
-    {"dimension": "vendas", "count": 98, "sum_amount": 38000, "avg_amount": 387.76}
-  ],
-  "comparison": {
-    "count": {"current": 120, "previous": 98, "change": 22, "change_pct": 22.4, "trend": "up"}
-  }
-}
-```
-
-### POST /analyze — Análise com Pandas
-
-```json
-{
-  "data": [{"col1": 10, "col2": "A"}, ...],
-  "question": "Quais são os outliers?"
-}
-```
-
-Retorno: estatísticas por coluna (min, max, mean, median, std, sum), insights automáticos, sugestões de gráficos.
-
-### Granularidades Temporais (time_grain)
-
-| Valor | Função SQL | Exemplo |
-|-------|-----------|---------|
-| `day` | `DATE_TRUNC('day', col)` | 2026-03-16 |
-| `week` | `DATE_TRUNC('week', col)` | 2026-03-11 |
-| `month` | `DATE_TRUNC('month', col)` | 2026-03-01 |
-| `quarter` | `DATE_TRUNC('quarter', col)` | 2026-01-01 |
-| `year` | `DATE_TRUNC('year', col)` | 2026-01-01 |
-
-### Funções de Agregação
-
-| Valor | SQL | Uso |
-|-------|-----|-----|
-| `sum` | `SUM(col)` | Totalizador |
-| `avg` | `AVG(col)` | Média |
-| `count` | `COUNT(*)` | Contagem |
-| `min` | `MIN(col)` | Mínimo |
-| `max` | `MAX(col)` | Máximo |
-
----
-
-## 7. Pipeline ETL — Fluxo de Ingestão
-
-```
-Arquivo (CSV/Excel/JSON/SQL/BSON/ZIP)
-         │
-         ▼
-┌──────────────────────────────────────┐
-│  1. UPLOAD (/api/upload/file)        │
-│                                      │
-│  • Multer (disk storage)             │
-│  • Limite: 200 MB                    │
-│  • Validação de extensão             │
-│  • Parse do conteúdo                 │
-└──────────────────┬───────────────────┘
-                   │
-                   ▼
-┌──────────────────────────────────────┐
-│  2. STAGING (staged_tables)          │
-│                                      │
-│  • Armazena headers e sample data    │
-│  • Detecta tipos de colunas          │
-│  • Preview para o usuário            │
-└──────────────────┬───────────────────┘
-                   │
-                   ▼
-┌──────────────────────────────────────┐
-│  3. MAPEAMENTO (staging_mappings)    │
-│                                      │
-│  • sourceColumn → targetColumn       │
-│  • transformType (cast, rename, etc.)│
-│  • Validação de compatibilidade      │
-└──────────────────┬───────────────────┘
-                   │
-                   ▼
-┌──────────────────────────────────────┐
-│  4. MIGRAÇÃO (migration_jobs)        │
-│                                      │
-│  • Cria tabela destino se necessário │
-│  • INSERT em lotes                   │
-│  • Tracking: total/processed rows    │
-│  • Status: pending → running →       │
-│            completed/failed          │
-│  • Error log para debugging          │
-└──────────────────┬───────────────────┘
-                   │
-                   ▼
-┌──────────────────────────────────────┐
-│  5. DATASET (bi_datasets)            │
-│                                      │
-│  • Dataset pronto para visualização  │
-│  • Pode criar charts e dashboards    │
-│  • Conecta com BI Engine e MetaSet  │
-└──────────────────────────────────────┘
-```
-
----
-
-## 8. Integração entre Pilares
-
-```
-┌──────────────────────────────────────────────────────────────────────┐
-│                         FLUXO DE DADOS                                │
-│                                                                       │
-│  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐    │
-│  │  Upload  │────▶│ Staging  │────▶│ Dataset  │────▶│  Chart   │    │
-│  │  (ETL)   │     │(Prepare) │     │ (Dados)  │     │ (Visual) │    │
-│  └──────────┘     └──────────┘     └────┬─────┘     └────┬─────┘    │
-│                                          │                │          │
-│                                    ┌─────▼──────┐   ┌────▼─────┐   │
-│                                    │  BI Engine  │   │Dashboard │   │
-│                                    │  (Análise)  │   │(Painel)  │   │
-│                                    └─────┬──────┘   └──────────┘   │
-│                                          │                          │
-│  ┌──────────┐                      ┌─────▼──────┐                  │
-│  │ Tabelas  │─────────────────────▶│  MetaSet  │                  │
-│  │ Internas │                      │  (Visual)  │                  │
-│  │  (PG)    │                      └──────┬─────┘                  │
-│  └──────────┘                             │                         │
-│                                     ┌─────▼──────┐                  │
-│                                     │ Cientista   │                  │
-│                                     │  (IA/ML)    │                  │
-│                                     └────────────┘                  │
-└──────────────────────────────────────────────────────────────────────┘
-```
-
-### Como os pilares se conectam:
-
-| De | Para | Como |
-|----|------|------|
-| Upload | Staging | Arquivo parseado → tabela staged |
-| Staging | Dataset | Migração → dataset criado automaticamente |
-| Tabela Interna | Dataset | `/api/bi/internal-tables/:name/create-dataset` |
-| Dataset | BI Engine | SQL do dataset executado no Motor Python |
-| Dataset | Chart | Chart referencia datasetId |
-| Chart | Dashboard | `bi_dashboard_charts` com posição (X,Y,W,H) |
-| Tabelas PG | MetaSet | Conexão direta ao PostgreSQL |
-| Dataset | Assistente IA | Dados enviados como contexto ao GPT-4o |
-| Dados | Cientista | `analyze_data()`, `detect_patterns()`, `generate_insights()` |
-
----
-
-## 9. Configuração e Variáveis de Ambiente
-
-| Variável | Default | Usado por | Descrição |
-|----------|---------|-----------|-----------|
-| `DATABASE_URL` | - | BI Engine, Gateway | Conexão PostgreSQL |
-| `BI_ENGINE_HOST` | `localhost` | Engine Proxy | Host do motor Python |
-| `BI_PORT` | `8004` | BI Engine, Proxy | Porta do motor Python |
-| `BI_ENGINE_TIMEOUT` | `30000` | Engine Proxy | Timeout de proxy (ms) |
-| `METASET_HOST` | `metaset` | MetaSet Proxy | Host do MetaSet |
-| `METASET_PORT` | `8100` | MetaSet Proxy | Porta do MetaSet |
-| `METASET_TIMEOUT` | `30000` | MetaSet Proxy | Timeout do proxy (ms) |
-| `OPENAI_API_KEY` | - | Assistente BI | API key para GPT-4o |
-
----
-
-## 10. Arquivos-Chave
-
-| Arquivo | Camada | Função | Linhas |
-|---------|--------|--------|--------|
-| `server/python/bi_engine.py` | Motor Python | SQL, Charts, Micro-BI, Cache, Análise | ~650 |
-| `server/bi/routes.ts` | API Node | CRUD de DataSources, Datasets, Charts, Dashboards, Backups | ~700 |
-| `server/bi/engine-proxy.ts` | Proxy | Proxy Gateway → BI Engine Python (:8004) | ~200 |
-| `server/bi/upload.ts` | ETL | Upload de arquivos (CSV, Excel, JSON, SQL, BSON, ZIP) | ~1.060 |
-| `server/bi/staging.ts` | ETL | Staging, mapeamento, migração de dados | ~408 |
-| `server/bi/metaset-client/routes.ts` | Proxy | Proxy Gateway → MetaSet (:8100) | ~215 |
-| `client/src/pages/BiWorkspace.tsx` | Frontend | Interface principal do BI (8 tabs) | ~2.970 |
-| `server/bi/metaset-client/index.ts` | Cliente | Cliente TypeScript para API Superset | ~375 |
-| `client/src/pages/MetaSetProxyPage.tsx` | Frontend | Página do MetaSet embeddado | ~25 |
-| `python-service/services/cientista.py` | IA/ML | Análise, padrões, insights, auto-programação | ~567 |
-| `shared/schema.ts` | Schema | Tabelas BI (9 tabelas) | Parte do schema |
-
----
-
-## 11. Deploy (Docker/Coolify)
-
-### Container `arcadia-bi` (Motor Python)
-
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-RUN pip install fastapi uvicorn pydantic pandas numpy psycopg2-binary
-COPY server/python/bi_engine.py ./main.py
-EXPOSE 8004
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8004"]
-```
-
-### Container `metaset`
-
-```yaml
-metaset:
-  image: metaset/metaset:latest
-  restart: always
-  ports:
-    - "8088:3000"
-  environment:
-    MB_DB_TYPE: postgres
-    MB_DB_DBNAME: metaset
-    MB_DB_PORT: 5432
-    MB_DB_USER: ${PGUSER:-arcadia}
-    MB_DB_PASS: ${PGPASSWORD}
-    MB_DB_HOST: postgres
-    JAVA_TIMEZONE: America/Sao_Paulo
-  depends_on:
-    postgres:
-      condition: service_healthy
-  volumes:
-    - metaset-data:/metaset-data
-  networks:
-    - arcadia
-```
-
-### Variáveis no Gateway (Docker)
-
-```yaml
-gateway:
-  environment:
-    BI_ENGINE_HOST: bi
-    BI_PORT: 8004
-    METABASE_HOST: metaset
-    METABASE_PORT: 3000
-```
-
----
-
-## 12. Resumo Visual
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                        ARCÁDIA BI STACK                               │
-│                                                                      │
-│   ┌─────────────────────────────────────────────────────────────┐    │
-│   │  FRONTEND: BiWorkspace.tsx + Recharts + Assistente IA (GPT) │   │
-│   └────────────────────────────┬────────────────────────────────┘    │
-│                                │                                     │
-│          ┌─────────────────────┼─────────────────────┐              │
-│          │                     │                     │              │
-│   ┌──────▼──────┐    ┌────────▼────────┐   ┌────────▼────────┐     │
-│   │  API BI     │    │  BI Engine      │   │    MetaSet     │     │
-│   │  (Node.js)  │    │  (Python:8004)  │   │    (Java:8088)  │     │
-│   │             │    │                 │   │                 │     │
-│   │ CRUD        │    │ SQL + Charts    │   │ Dashboards      │     │
-│   │ Upload/ETL  │    │ Micro-BI        │   │ Visual Builder  │     │
-│   │ Staging     │    │ Análise Pandas  │   │ Alertas         │     │
-│   │ Backups     │    │ Cache (5min)    │   │ Exportação      │     │
-│   └──────┬──────┘    └────────┬────────┘   └────────┬────────┘     │
-│          │                    │                      │              │
-│          └────────────────────┼──────────────────────┘              │
-│                               │                                     │
-│                    ┌──────────▼──────────┐                          │
-│                    │    PostgreSQL       │                          │
-│                    │    (Porta 5432)     │                          │
-│                    │                    │                          │
-│                    │  9 tabelas BI +    │                          │
-│                    │  100+ tabelas SOE  │                          │
-│                    └────────────────────┘                          │
-│                                                                     │
-│   ┌─────────────────────────────────────────────────────────────┐   │
-│   │  CIENTISTA (Python) — Análise, Padrões, Insights, AutoCode  │  │
-│   └─────────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────────┘
-```

docs/MAPA_CRM_ARCADIA.md

@@ -1,834 +0,0 @@
-# Arcádia CRM — Mapa Completo do Sistema de Relacionamento
-
-> Mapa da arquitetura CRM nativa da Arcádia Suite: módulos, tabelas,
-> APIs, comunicação unificada (WhatsApp/Email), motor de comissões,
-> integração Frappe/ERPNext e frontend.
-> Atualizado em: Março 2026
-
----
-
-## 1. Visão Geral
-
-O CRM da Arcádia Suite é **100% nativo** — construído internamente em Node.js + PostgreSQL com Drizzle ORM. Ele opera em **três camadas** que se complementam, unificadas por um Motor de Comunicação e alimentadas por IA (Manus/GPT-4o):
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                         CAMADA DE EXPERIÊNCIA                        │
-│                                                                      │
-│  ┌────────────────────────┐  ┌───────────────────────┐              │
-│  │  Arcádia CRM (Crm.tsx) │  │  XOS CRM (XosCrm.tsx) │              │
-│  │  2.700 linhas          │  │  752 linhas            │              │
-│  │  12 abas               │  │  Kanban visual         │              │
-│  │  Gestão completa       │  │  Deals + Pipeline      │              │
-│  └────────────┬───────────┘  └───────────┬───────────┘              │
-│               │                           │                          │
-│               └──────────┬────────────────┘                          │
-│                          │                                           │
-│  ┌───────────────────────▼───────────────────────────────────┐      │
-│  │         WhatsApp.tsx — Interface de Atendimento            │      │
-│  │         Multi-sessão, tickets, IA auto-reply               │      │
-│  └───────────────────────────────────────────────────────────┘      │
-└──────────────────────────┬───────────────────────────────────────────┘
-                           │
-┌──────────────────────────▼───────────────────────────────────────────┐
-│                        CAMADA DE ORQUESTRAÇÃO                        │
-│                                                                      │
-│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐  │
-│  │  Routes  │ │ Storage  │ │  Comm.   │ │Commission│ │  WA      │  │
-│  │ (1.592L) │ │ (708L)   │ │ (289L)   │ │ Engine   │ │ Bridge   │  │
-│  │          │ │          │ │          │ │ (418L)   │ │ (126L)   │  │
-│  │ 90+      │ │CrmStorage│ │ Connect/ │ │ Revenue  │ │ Sessão   │  │
-│  │ endpoints│ │ class    │ │ Send/    │ │ Schedule │ │ ↔ Canal  │  │
-│  │          │ │          │ │ Receive  │ │ Comissões│ │ Eventos  │  │
-│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘  │
-│                                                                      │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐              │
-│  │ Frappe Svc   │  │Google Calendar│  │ Knowledge   │              │
-│  │ ERPNext sync │  │ OAuth + Sync  │  │ Graph Feed  │              │
-│  └──────────────┘  └──────────────┘  └──────────────┘              │
-└──────────────────────────┬───────────────────────────────────────────┘
-                           │
-┌──────────────────────────▼───────────────────────────────────────────┐
-│                          CAMADA DE DADOS                             │
-│                                                                      │
-│  PostgreSQL — 30 tabelas CRM (crm_*) + 15 tabelas XOS (xos_*)      │
-│              + 8 tabelas Communication (comm_*)                      │
-│                                                                      │
-│  Drizzle ORM — Schema em shared/schema.ts                            │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. Os Três CRMs
-
-### 2.1 — Arcádia CRM (Principal)
-
-O CRM completo da plataforma. Gerencia todo o ciclo de relacionamento: da captação de leads até contratos e comissões.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  ARCÁDIA CRM                                 │
-│                  client/src/pages/Crm.tsx (2.700 linhas)     │
-│                  /api/crm/* (90+ endpoints)                  │
-│                                                              │
-│  12 Abas:                                                    │
-│  ┌──────────┬──────────┬──────────┬──────────┐              │
-│  │Dashboard │  Leads   │  Opps    │ Produtos │              │
-│  ├──────────┼──────────┼──────────┼──────────┤              │
-│  │Parceiros │ Clientes │Contratos │Mensagens │              │
-│  ├──────────┼──────────┼──────────┼──────────┤              │
-│  │Calendário│Integrações│Config   │Multitenant│             │
-│  └──────────┴──────────┴──────────┴──────────┘              │
-│                                                              │
-│  Domínios:                                                   │
-│  • Pipeline de Vendas (Leads → Opps → Propostas → Contratos)│
-│  • Parceiros & Certificações                                 │
-│  • Produtos & Catálogo                                       │
-│  • Comunicação Multicanal (WhatsApp, Email)                 │
-│  • Comissões & Revenue Schedule                              │
-│  • Agenda (Google Calendar)                                  │
-│  • Integração Frappe/ERPNext                                 │
-│  • Multi-tenant                                              │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 2.2 — XOS CRM (Kanban/Pipeline)
-
-Visão simplificada e visual focada em gestão de deals com drag & drop.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    XOS CRM                                   │
-│                    client/src/pages/XosCrm.tsx (752 linhas)  │
-│                                                              │
-│  Foco:                                                       │
-│  • Kanban visual de deals                                    │
-│  • Pipeline com estágios customizáveis                       │
-│  • Contatos & Empresas                                       │
-│  • Conversas & Tickets                                       │
-│  • Campanhas & Automações                                    │
-│  • Filas de atendimento                                      │
-│                                                              │
-│  Tabelas próprias: xos_contacts, xos_companies,             │
-│  xos_pipelines, xos_pipeline_stages, xos_deals,             │
-│  xos_conversations, xos_messages, xos_tickets,              │
-│  xos_campaigns, xos_automations, xos_activities,            │
-│  xos_queues, xos_queue_users, xos_internal_notes,           │
-│  xos_quick_messages                                          │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 2.3 — Plus CRM (Legado/PHP)
-
-Módulo CRM dentro do Arcádia Plus (Laravel), focado em anotações e histórico.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    PLUS CRM (Legado)                         │
-│                    plus/app/Http/Controllers/CrmController   │
-│                                                              │
-│  • Anotações de clientes (crm_anotacoes)                    │
-│  • Histórico de interações                                   │
-│  • Integrado ao ERP Plus (fiscal, estoque, financeiro)       │
-│  • Proxy reverso via /plus                                   │
-│  • Banco MySQL (separado do PostgreSQL)                      │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 3. Ciclo de Vida do Cliente
-
-```
-┌────────┐    ┌────────┐    ┌────────────┐    ┌──────────┐    ┌──────────┐
-│  LEAD  │───▶│  OPP   │───▶│  PROPOSTA  │───▶│ CONTRATO │───▶│ CLIENTE  │
-│        │    │        │    │            │    │          │    │          │
-│ Nome   │    │ Valor  │    │ Itens      │    │ Receita  │    │ Ativo    │
-│ Email  │    │ Stage  │    │ Preços     │    │ Parcelas │    │ Suporte  │
-│ Fone   │    │ Prob%  │    │ Desconto   │    │ Comissão │    │ Upsell   │
-│ Source │    │ Close  │    │ Aprovação  │    │ Marcos   │    │          │
-│ Status │    │ Owner  │    │ PDF        │    │ Duração  │    │          │
-└────┬───┘    └────┬───┘    └────────────┘    └──────────┘    └──────────┘
-     │             │
-     │  convert    │  won/lost
-     │             │
-     ▼             ▼
- POST /leads/     POST /opportunities/
- :id/convert      :id/won
-                  :id/lost
-                  :id/bill
-                  :id/open-project
-```
-
-### Fluxo detalhado:
-
-| Etapa | Ação | Endpoint | Resultado |
-|-------|------|----------|-----------|
-| 1 | Captação | `POST /api/crm/leads` | Lead criado (status: new) |
-| 2 | Qualificação | `PATCH /api/crm/leads/:id` | Lead atualizado (status: qualified) |
-| 3 | Conversão | `POST /api/crm/leads/:id/convert` | Cria Opportunity + Client automaticamente |
-| 4 | Negociação | `PATCH /api/crm/opportunities/:id/stage` | Move entre estágios do pipeline |
-| 5 | Proposta | `POST /api/crm/proposals` | Proposta com itens e preços |
-| 6 | Ganho | `POST /api/crm/opportunities/:id/won` | Marca como ganha |
-| 7 | Contrato | `POST /api/crm/contracts` | Contrato com receita e marcos |
-| 8 | Faturamento | `POST /api/crm/opportunities/:id/bill` | Gera faturamento |
-| 9 | Projeto | `POST /api/crm/opportunities/:id/open-project` | Abre projeto no Process Compass |
-| 10 | Perda | `POST /api/crm/opportunities/:id/lost` | Marca como perdida + motivo |
-
----
-
-## 4. Comunicação Multicanal
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    SISTEMA DE COMUNICAÇÃO                            │
-│                                                                      │
-│  ┌───────────┐    ┌────────────────┐    ┌──────────────────┐        │
-│  │ WhatsApp  │    │ Communication  │    │   CRM Threads    │        │
-│  │ (Baileys) │───▶│   Service      │───▶│   & Messages     │        │
-│  │           │    │                │    │                  │        │
-│  │ Multi-    │    │ connectChannel │    │ crm_channels     │        │
-│  │ sessão    │    │ sendMessage    │    │ crm_threads      │        │
-│  │ QR Code   │    │ receiveMessage │    │ crm_messages     │        │
-│  │ Auto-reply│    │ getOrCreate    │    │ crm_quick_msgs   │        │
-│  │ (GPT-4o)  │    │   Thread       │    │                  │        │
-│  └─────┬─────┘    └────────────────┘    └──────────────────┘        │
-│        │                                                             │
-│  ┌─────▼─────────────────────────────────────┐                      │
-│  │  WhatsApp Bridge                           │                      │
-│  │                                            │                      │
-│  │  Evento "message"  → handleIncoming        │                      │
-│  │  Evento "connected"→ updateChannelStatus   │                      │
-│  │  Evento "qr"       → storeQRCode          │                      │
-│  │  Evento "disconnect"→ markDisconnected     │                      │
-│  │                                            │                      │
-│  │  sessionChannelMap: Session ↔ CRM Channel  │                      │
-│  └────────────────────────────────────────────┘                      │
-│                                                                      │
-│  ┌────────────────────────────────────────────┐                      │
-│  │  Motor de Comunicação (:8006)              │                      │
-│  │                                            │                      │
-│  │  Unifica:                                  │                      │
-│  │  • CRM Threads  (crm_threads)             │                      │
-│  │  • XOS Conversations (xos_conversations)   │                      │
-│  │  • WhatsApp Tickets (xos_tickets)          │                      │
-│  │                                            │                      │
-│  │  Tabelas comm_*:                           │                      │
-│  │  comm_contacts, comm_threads,              │                      │
-│  │  comm_messages, comm_channels,             │                      │
-│  │  comm_queues, comm_quick_messages,         │                      │
-│  │  comm_events → Knowledge Graph             │                      │
-│  └────────────────────────────────────────────┘                      │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
-### Fluxo de mensagem WhatsApp:
-
-```
-Cliente envia mensagem no WhatsApp
-        │
-        ▼
-Baileys (whatsappService) recebe
-        │
-        ▼ emite evento "message"
-WhatsApp Bridge captura
-        │
-        ▼ mapeia session → channelId
-CommunicationService.receiveMessage()
-        │
-        ├──▶ getOrCreateThread() → cria/reutiliza thread
-        │
-        ├──▶ crmMessages → INSERT (direction: "incoming")
-        │
-        ├──▶ AI Auto-Reply? (GPT-4o-mini em horário comercial)
-        │
-        └──▶ Knowledge Graph → graph_nodes + graph_edges
-```
-
-### Canais suportados:
-
-| Canal | Tecnologia | Status |
-|-------|-----------|--------|
-| **WhatsApp** | Baileys (multi-device) | Ativo |
-| **Email** | SMTP + IMAP | Planejado |
-| **SMS** | API (Twilio/etc.) | Futuro |
-| **Telegram** | Bot API | Futuro |
-| **Chat Interno** | Socket.IO | Ativo (Comunidades) |
-
----
-
-## 5. Motor de Comissões
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  COMMISSION ENGINE                           │
-│                  server/crm/commission-engine.ts (418L)      │
-│                                                              │
-│  ┌── Revenue Schedule ──────────────────────────────────┐   │
-│  │                                                       │   │
-│  │  generateRevenueSchedule(contractId)                  │   │
-│  │                                                       │   │
-│  │  • Mensal: projeta N parcelas (até 24 meses)         │   │
-│  │  • Anual: projeta N anos (até 10 anos)               │   │
-│  │  • Calcula datas de vencimento                       │   │
-│  │  • Status: pending → paid → overdue                  │   │
-│  │                                                       │   │
-│  │  Contrato R$ 5.000/mês × 12 meses:                  │   │
-│  │  → 12 registros em crm_revenue_schedule              │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Commission Rules ─────────────────────────────────┐   │
-│  │                                                       │   │
-│  │  crm_commission_rules                                 │   │
-│  │                                                       │   │
-│  │  Regras baseadas em:                                  │   │
-│  │  • Tipo de receita: recurring / one-time             │   │
-│  │  • Cenário de venda: direct / partner                │   │
-│  │  • Mês do contrato (faixas)                          │   │
-│  │                                                       │   │
-│  │  Exemplo:                                             │   │
-│  │  Meses 1-5 (aquisição): 15% sobre receita            │   │
-│  │  Meses 6-12 (retenção): 10% sobre receita            │   │
-│  │  Meses 13+ (maturidade): 5% sobre receita            │   │
-│  └──────────────────────────────────────────────────────┘   │
-│                                                              │
-│  ┌── Cálculo de Comissões ─────────────────────────────┐   │
-│  │                                                       │   │
-│  │  calculateCommissions(contractId)                     │   │
-│  │                                                       │   │
-│  │  Para cada parcela da revenue schedule:               │   │
-│  │  1. Identifica o mês do contrato                     │   │
-│  │  2. Busca regra aplicável (tipo + cenário + faixa)   │   │
-│  │  3. Calcula valor = parcela × percentual             │   │
-│  │  4. Cria registro em crm_commissions                 │   │
-│  │                                                       │   │
-│  │  Status: pending → approved → paid                    │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 6. Integração Frappe/ERPNext
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  FRAPPE SERVICE                              │
-│                  server/crm/frappe-service.ts                │
-│                                                              │
-│  Autenticação: token apiKey:apiSecret                       │
-│  Base URL: configurável por conector                        │
-│                                                              │
-│  Sync Bidirecional:                                          │
-│                                                              │
-│  Arcádia CRM ←──────────→ ERPNext/Frappe                   │
-│                                                              │
-│  ┌──────────────────────────────────────────────────┐       │
-│  │ Entidade Arcádia    DocType Frappe                │       │
-│  │ ─────────────────── ─────────────────             │       │
-│  │ crm_leads        →  Lead                          │       │
-│  │ crm_opportunities→  Opportunity                   │       │
-│  │ crm_products     →  Item                          │       │
-│  │ crm_partners     →  Supplier (tipo: partner)      │       │
-│  │ crm_clients      →  Customer                      │       │
-│  └──────────────────────────────────────────────────┘       │
-│                                                              │
-│  Funcionalidades:                                            │
-│  • POST /frappe/connectors → Cria conector                  │
-│  • POST /frappe/connectors/:id/test → Testa conexão         │
-│  • POST /frappe/connectors/:id/sync → Sincroniza dados      │
-│  • GET  /frappe/connectors/:id/logs → Logs de sync          │
-│  • CRUD /frappe/connectors/:id/mappings → Mapeamentos       │
-│                                                              │
-│  Tabelas: crm_frappe_connectors, crm_frappe_mappings        │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 7. Google Calendar
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  GOOGLE CALENDAR INTEGRATION                 │
-│                  server/crm/google-calendar.ts               │
-│                                                              │
-│  OAuth 2.0 Flow:                                             │
-│  GET  /api/crm/google/auth        → Inicia OAuth            │
-│  GET  /api/crm/google/callback    → Recebe token            │
-│  GET  /api/crm/google/status      → Status da conexão       │
-│  POST /api/crm/google/disconnect  → Desconecta              │
-│  POST /api/crm/google/sync        → Sincroniza eventos      │
-│  GET  /api/crm/google/events      → Lista eventos           │
-│  POST /api/crm/google/events      → Cria evento             │
-│                                                              │
-│  Tabela: crm_google_tokens                                   │
-│  Tabela: crm_events (sincronizado)                           │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 8. Banco de Dados — Todas as Tabelas
-
-### 8.1 — Tabelas CRM (crm_*) — 30 tabelas
-
-#### Entidades Principais
-
-```
-┌──────────────────────────┐  ┌──────────────────────────┐
-│ crm_leads                 │  │ crm_clients               │
-│                           │  │                           │
-│ id, tenantId, name,       │  │ id, tenantId, name,       │
-│ email, phone, company,    │  │ email, phone, company,    │
-│ source, status (new|      │  │ type, address, city,      │
-│ contacted|qualified|      │  │ state, notes, segment,    │
-│ proposal|won|lost),       │  │ isActive, createdAt,      │
-│ notes, assignedTo,        │  │ updatedAt                 │
-│ estimatedValue,           │  │                           │
-│ createdAt, updatedAt      │  └──────────────────────────┘
-└──────────────────────────┘
-
-┌──────────────────────────┐  ┌──────────────────────────┐
-│ crm_opportunities         │  │ crm_partners              │
-│                           │  │                           │
-│ id, tenantId, name,       │  │ id, tenantId, companyName,│
-│ clientId, value,          │  │ contactName, email, phone,│
-│ probability, stageId,     │  │ type (reseller|referral|  │
-│ expectedCloseDate,        │  │ integrator|consultant),   │
-│ status (open|won|lost),   │  │ status (active|inactive|  │
-│ lostReason, assignedTo,   │  │ suspended), tier (gold|   │
-│ notes, approvalStatus,    │  │ silver|bronze|platinum),  │
-│ approvedBy, createdAt     │  │ commissionRate, region,   │
-│                           │  │ specializations, notes    │
-└──────────────────────────┘  └──────────────────────────┘
-```
-
-#### Pipeline e Propostas
-
-```
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_pipeline_stages        │  │ crm_proposals              │
-│                            │  │                            │
-│ id, tenantId, name,        │  │ id, tenantId, opportunityId│
-│ order, color, isDefault,   │  │ title, description,        │
-│ probability, createdAt     │  │ totalValue, discount,      │
-│                            │  │ validUntil, status (draft| │
-│                            │  │ sent|approved|rejected),   │
-│                            │  │ approvedBy, notes,         │
-│                            │  │ createdAt, updatedAt       │
-└───────────────────────────┘  └───────────────────────────┘
-
-┌───────────────────────────┐
-│ crm_proposal_items         │
-│                            │
-│ id, proposalId, productId, │
-│ description, quantity,     │
-│ unitPrice, discount,       │
-│ totalPrice, createdAt      │
-└───────────────────────────┘
-```
-
-#### Contratos e Financeiro
-
-```
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_contracts              │  │ crm_revenue_schedule       │
-│                            │  │                            │
-│ id, tenantId, name,        │  │ id, contractId, month,     │
-│ clientId, partnerId,       │  │ dueDate, value, status     │
-│ type (recurring|one_time), │  │ (pending|paid|overdue),    │
-│ totalValue, monthlyValue,  │  │ paidDate, createdAt        │
-│ startDate, endDate,        │  │                            │
-│ billingCycle (monthly|     │  └───────────────────────────┘
-│ yearly), status (draft|    │
-│ active|completed|cancelled)│  ┌───────────────────────────┐
-│ autoRenew, notes,          │  │ crm_contract_milestones    │
-│ createdAt, updatedAt       │  │                            │
-└───────────────────────────┘  │ id, contractId, name,      │
-                                │ description, dueDate,      │
-┌───────────────────────────┐  │ status (pending|in_progress│
-│ crm_commission_rules       │  │ |completed|delayed),       │
-│                            │  │ completedAt, notes         │
-│ id, tenantId, name,        │  └───────────────────────────┘
-│ revenueType (recurring|    │
-│ one_time), saleType        │
-│ (direct|partner),          │
-│ percentage, monthFrom,     │
-│ monthTo, isActive          │
-└───────────────────────────┘
-
-┌───────────────────────────┐
-│ crm_commissions            │
-│                            │
-│ id, tenantId, contractId,  │
-│ partnerId, userId,         │
-│ revenueScheduleId, month,  │
-│ baseValue, percentage,     │
-│ commissionValue, status    │
-│ (pending|approved|paid),   │
-│ paidDate, createdAt        │
-└───────────────────────────┘
-```
-
-#### Comunicação
-
-```
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_channels               │  │ crm_threads                │
-│                            │  │                            │
-│ id, tenantId, name,        │  │ id, tenantId, channelId,   │
-│ type (whatsapp|email|sms|  │  │ contactPhone, contactName, │
-│ telegram), status          │  │ status (open|waiting|      │
-│ (connected|disconnected|   │  │ resolved|closed),          │
-│ pending_qr), identifier,   │  │ assignedTo, priority,      │
-│ qrCode, sessionData,       │  │ subject, tags, unreadCount,│
-│ lastConnectedAt,           │  │ lastMessageAt, closedAt,   │
-│ createdAt, updatedAt       │  │ createdAt, updatedAt       │
-└───────────────────────────┘  └───────────────────────────┘
-
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_messages               │  │ crm_quick_messages         │
-│                            │  │                            │
-│ id, threadId, direction    │  │ id, tenantId, title,       │
-│ (incoming|outgoing),       │  │ content, shortcut,         │
-│ content, contentType       │  │ category, isActive,        │
-│ (text|image|audio|video|   │  │ createdAt                  │
-│ document), externalId,     │  │                            │
-│ status (sent|delivered|    │  │ Uso: /atalho → mensagem    │
-│ read|failed), senderName,  │  │ rápida pré-definida        │
-│ metadata, createdAt        │  │                            │
-└───────────────────────────┘  └───────────────────────────┘
-```
-
-#### Outros
-
-```
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_products               │  │ crm_opportunity_products   │
-│                            │  │                            │
-│ id, tenantId, name, sku,   │  │ id, opportunityId,         │
-│ description, category,     │  │ productId, quantity,        │
-│ unitPrice, costPrice,      │  │ unitPrice, discount,        │
-│ type (product|service|     │  │ totalPrice                  │
-│ subscription), isActive    │  └───────────────────────────┘
-└───────────────────────────┘
-
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_campaigns              │  │ crm_campaign_contacts      │
-│                            │  │                            │
-│ id, tenantId, name, type,  │  │ id, campaignId, contactId, │
-│ status, channelId,         │  │ status (pending|sent|      │
-│ message, scheduledAt,      │  │ delivered|failed|replied),  │
-│ sentCount, deliveredCount, │  │ sentAt, deliveredAt,        │
-│ failedCount, createdAt     │  │ repliedAt                   │
-└───────────────────────────┘  └───────────────────────────┘
-
-┌───────────────────────────┐  ┌───────────────────────────┐
-│ crm_events                 │  │ crm_google_tokens          │
-│                            │  │                            │
-│ id, tenantId, title,       │  │ id, userId, accessToken,   │
-│ description, type,         │  │ refreshToken, expiresAt,   │
-│ startDate, endDate,        │  │ calendarId, createdAt      │
-│ isAllDay, location,        │  │                            │
-│ attendees, googleEventId,  │  └───────────────────────────┘
-│ color, reminders,          │
-│ createdBy, createdAt       │  ┌───────────────────────────┐
-│                            │  │ crm_opportunity_registrations│
-└───────────────────────────┘  │                              │
-                                │ id, opportunityId, partnerId,│
-┌───────────────────────────┐  │ status (pending|approved|    │
-│ crm_partner_certifications │  │ rejected), registeredAt      │
-│                            │  └───────────────────────────┘
-│ id, partnerId, name,       │
-│ issuer, certDate, expDate, │  ┌───────────────────────────┐
-│ status, documentUrl        │  │ crm_partner_performance    │
-│                            │  │                            │
-└───────────────────────────┘  │ id, partnerId, period,     │
-                                │ revenue, deals, activeContracts│
-                                │ satisfaction, churnRate     │
-                                └───────────────────────────┘
-```
-
-### 8.2 — Tabelas XOS CRM (xos_*) — 15 tabelas
-
-```
-xos_contacts              → Contatos unificados (nome, email, phone, company, tags)
-xos_companies             → Empresas (nome, CNPJ, segmento, tamanho, receita)
-xos_pipelines             → Pipelines customizáveis
-xos_pipeline_stages       → Estágios de pipeline (nome, ordem, cor, prob%)
-xos_deals                 → Negócios/Deals (valor, estágio, expected close)
-xos_conversations         → Conversas (canal, status, prioridade)
-xos_messages              → Mensagens individuais
-xos_tickets               → Tickets de suporte (SLA, prioridade)
-xos_campaigns             → Campanhas de marketing
-xos_automations           → Regras de automação (trigger, action)
-xos_activities            → Atividades (calls, emails, meetings, tasks)
-xos_queues                → Filas de atendimento
-xos_queue_users           → Usuários nas filas
-xos_internal_notes        → Notas internas de deals/contatos
-xos_quick_messages        → Mensagens rápidas/templates
-```
-
-### 8.3 — Tabelas Comunicação Unificada (comm_*) — 8 tabelas
-
-```
-comm_channels             → Canais unificados
-comm_contacts             → Contatos unificados (merge CRM + XOS + WA)
-comm_threads              → Threads unificadas
-comm_messages             → Mensagens unificadas
-comm_queues               → Filas unificadas
-comm_queue_members        → Membros das filas
-comm_quick_messages       → Templates unificados
-comm_events               → Eventos (alimentam Knowledge Graph)
-```
-
----
-
-## 9. API REST Completa (/api/crm/*)
-
-### Parceiros
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/partners` | Lista parceiros |
-| GET | `/partners/:id` | Detalhe do parceiro |
-| POST | `/partners` | Cria parceiro |
-| PATCH | `/partners/:id` | Atualiza parceiro |
-| DELETE | `/partners/:id` | Remove parceiro |
-| GET | `/partners/:id/certifications` | Certificações |
-| POST | `/partners/:id/certifications` | Adiciona certificação |
-| GET | `/partners/:id/performance` | Performance |
-| POST | `/partners/:id/performance` | Registra performance |
-| POST | `/partners/:id/convert-to-client` | Converte para cliente |
-
-### Clientes
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/clients` | Lista clientes |
-| GET | `/clients/:id` | Detalhe do cliente |
-| POST | `/clients` | Cria cliente |
-| PATCH | `/clients/:id` | Atualiza cliente |
-| DELETE | `/clients/:id` | Remove cliente |
-
-### Leads
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/leads` | Lista leads |
-| GET | `/leads/:id` | Detalhe do lead |
-| POST | `/leads` | Cria lead |
-| PATCH | `/leads/:id` | Atualiza lead |
-| DELETE | `/leads/:id` | Remove lead |
-| POST | `/leads/:id/convert` | Converte para Opportunity + Client |
-
-### Oportunidades
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/opportunities` | Lista oportunidades |
-| GET | `/opportunities/:id` | Detalhe |
-| POST | `/opportunities` | Cria oportunidade |
-| PATCH | `/opportunities/:id` | Atualiza |
-| DELETE | `/opportunities/:id` | Remove |
-| PATCH | `/opportunities/:id/stage` | Muda estágio do pipeline |
-| POST | `/opportunities/:id/won` | Marca como ganha |
-| POST | `/opportunities/:id/lost` | Marca como perdida |
-| POST | `/opportunities/:id/approve` | Aprova (governance) |
-| POST | `/opportunities/:id/reject` | Rejeita |
-| POST | `/opportunities/:id/open-project` | Abre projeto no Compass |
-| POST | `/opportunities/:id/bill` | Gera faturamento |
-| GET | `/opportunities/:id/products` | Produtos da opp |
-| POST | `/opportunities/:id/products` | Adiciona produto |
-| DELETE | `/opportunity-products/:id` | Remove produto |
-| GET | `/opportunities/:id/proposals` | Propostas da opp |
-
-### Propostas
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/proposals` | Lista propostas |
-| GET | `/proposals/:id` | Detalhe |
-| POST | `/proposals` | Cria proposta |
-| PATCH | `/proposals/:id` | Atualiza |
-| DELETE | `/proposals/:id` | Remove |
-| GET | `/proposals/:id/items` | Itens da proposta |
-| POST | `/proposals/:id/items` | Adiciona item |
-| PATCH | `/proposal-items/:id` | Atualiza item |
-| DELETE | `/proposal-items/:id` | Remove item |
-
-### Contratos
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/contracts` | Lista contratos |
-| GET | `/contracts/:id` | Detalhe |
-| POST | `/contracts` | Cria contrato |
-| PATCH | `/contracts/:id` | Atualiza |
-| GET | `/contracts/:id/revenue` | Revenue schedule |
-| GET | `/contracts/:id/milestones` | Marcos |
-| POST | `/contracts/:id/milestones` | Adiciona marco |
-| PATCH | `/milestones/:id` | Atualiza marco |
-| DELETE | `/milestones/:id` | Remove marco |
-| POST | `/contracts/:id/process-commissions` | Calcula comissões |
-| POST | `/contracts/:id/extend-schedule` | Estende schedule |
-| POST | `/contracts/extend-all` | Estende todos |
-
-### Comissões
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/commission-rules` | Lista regras |
-| POST | `/commission-rules` | Cria regra |
-| POST | `/commission-rules/seed` | Seed regras padrão |
-| GET | `/commissions` | Lista comissões |
-| GET | `/commissions/summary` | Resumo financeiro |
-| POST | `/commissions/:id/mark-paid` | Marca como paga |
-
-### Comunicação
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/channels` | Lista canais |
-| POST | `/channels` | Cria canal |
-| PATCH | `/channels/:id` | Atualiza canal |
-| POST | `/channels/:id/whatsapp/connect` | Conecta WhatsApp |
-| POST | `/channels/whatsapp/new` | Novo canal WhatsApp |
-| POST | `/channels/:id/whatsapp/disconnect` | Desconecta |
-| GET | `/threads` | Lista threads |
-| GET | `/threads/:id` | Detalhe da thread |
-| POST | `/threads` | Cria thread |
-| PATCH | `/threads/:id` | Atualiza thread |
-| GET | `/threads/:id/messages` | Mensagens da thread |
-| POST | `/threads/:id/messages` | Envia mensagem |
-| POST | `/threads/:id/send` | Envia via WhatsApp |
-| POST | `/threads/:id/read` | Marca como lida |
-| POST | `/threads/:id/assign` | Atribui a agente |
-| POST | `/threads/:id/close` | Fecha thread |
-| POST | `/threads/:id/reopen` | Reabre thread |
-| GET | `/threads/stats` | Estatísticas de threads |
-| GET | `/quick-messages` | Mensagens rápidas |
-| POST | `/quick-messages` | Cria mensagem rápida |
-
-### Produtos
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/products` | Lista produtos |
-| GET | `/products/:id` | Detalhe |
-| POST | `/products` | Cria produto |
-| PATCH | `/products/:id` | Atualiza |
-| DELETE | `/products/:id` | Remove |
-
-### Pipeline
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/pipeline-stages` | Lista estágios |
-| POST | `/pipeline-stages` | Cria estágio |
-| PATCH | `/pipeline-stages/:id` | Atualiza |
-| DELETE | `/pipeline-stages/:id` | Remove |
-
-### Eventos e Calendário
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/events` | Lista eventos |
-| POST | `/events` | Cria evento |
-| PATCH | `/events/:id` | Atualiza |
-| PUT | `/events/:id` | Atualiza (full) |
-| DELETE | `/events/:id` | Remove |
-| GET | `/google/auth` | Inicia OAuth Google |
-| GET | `/google/callback` | Callback OAuth |
-| GET | `/google/status` | Status conexão |
-| POST | `/google/disconnect` | Desconecta Google |
-| POST | `/google/sync` | Sincroniza eventos |
-| GET | `/google/events` | Eventos Google |
-| POST | `/google/events` | Cria evento Google |
-
-### Frappe/ERPNext
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/frappe/connectors` | Lista conectores |
-| GET | `/frappe/connectors/:id` | Detalhe |
-| POST | `/frappe/connectors` | Cria conector |
-| PATCH | `/frappe/connectors/:id` | Atualiza |
-| DELETE | `/frappe/connectors/:id` | Remove |
-| POST | `/frappe/connectors/:id/test` | Testa conexão |
-| POST | `/frappe/connectors/:id/sync` | Sincroniza dados |
-| GET | `/frappe/connectors/:id/logs` | Logs de sync |
-| GET | `/frappe/connectors/:id/mappings` | Mapeamentos |
-| POST | `/frappe/connectors/:id/mappings` | Cria mapeamento |
-
-### Estatísticas
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/stats` | KPIs gerais |
-| GET | `/stats/sales` | Estatísticas de vendas |
-
-**Total: 90+ endpoints**
-
----
-
-## 10. Arquivos-Chave
-
-| Arquivo | Função | Linhas |
-|---------|--------|--------|
-| `client/src/pages/Crm.tsx` | Interface principal (12 tabs) | 2.700 |
-| `client/src/pages/XosCrm.tsx` | CRM Kanban/Pipeline | 752 |
-| `client/src/pages/WhatsApp.tsx` | Interface WhatsApp | — |
-| `server/crm/routes.ts` | API REST (90+ endpoints) | 1.592 |
-| `server/crm/storage.ts` | CrmStorage class (Drizzle ORM) | 708 |
-| `server/crm/communication.ts` | CommunicationService | 289 |
-| `server/crm/commission-engine.ts` | CommissionEngine | 418 |
-| `server/crm/whatsapp-bridge.ts` | WhatsAppBridge | 126 |
-| `server/crm/frappe-service.ts` | Integração ERPNext | — |
-| `server/crm/google-calendar.ts` | Google Calendar OAuth | — |
-| `server/whatsapp/service.ts` | WhatsApp (Baileys) | — |
-| `server/communication/engine.ts` | Motor Comunicação (:8006) | — |
-| `shared/schema.ts` | 53 tabelas CRM/XOS/Comm | — |
-
----
-
-## 11. Resumo Visual
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                        ARCÁDIA CRM STACK                             │
-│                                                                      │
-│  ┌─────────────────────────────────────────────────────────────┐    │
-│  │  FRONTEND                                                    │    │
-│  │  Crm.tsx (12 tabs) + XosCrm.tsx (Kanban) + WhatsApp.tsx     │    │
-│  └────────────────────────────┬────────────────────────────────┘    │
-│                               │                                     │
-│  ┌────────────────────────────▼────────────────────────────────┐    │
-│  │  API: /api/crm/* — 90+ endpoints                           │    │
-│  │  Router → CrmStorage → PostgreSQL                           │    │
-│  └───┬─────────┬─────────┬──────────┬──────────┬──────────────┘    │
-│      │         │         │          │          │                    │
-│  ┌───▼───┐ ┌───▼───┐ ┌───▼────┐ ┌───▼───┐ ┌───▼────────┐         │
-│  │Comm   │ │Comissão│ │WhatsApp│ │Frappe │ │Google Cal  │         │
-│  │Service│ │Engine  │ │Bridge  │ │Service│ │OAuth       │         │
-│  └───┬───┘ └───────┘ └───┬────┘ └───────┘ └────────────┘         │
-│      │                    │                                        │
-│      │              ┌─────▼──────┐                                 │
-│      │              │  Baileys   │                                 │
-│      │              │  WhatsApp  │                                 │
-│      │              │  Multi-Sess│                                 │
-│      │              └─────┬──────┘                                 │
-│      │                    │                                        │
-│  ┌───▼────────────────────▼──────────────────────────────────┐    │
-│  │  Motor de Comunicação (:8006)                              │    │
-│  │  Unifica: CRM + XOS + WhatsApp → comm_* tables            │    │
-│  │  Alimenta: Knowledge Graph + Manus IA                      │    │
-│  └───────────────────────────────────────────────────────────┘    │
-│                                                                     │
-│  ┌───────────────────────────────────────────────────────────┐    │
-│  │  PostgreSQL: 53 tabelas (30 crm_* + 15 xos_* + 8 comm_*) │   │
-│  └───────────────────────────────────────────────────────────┘    │
-└─────────────────────────────────────────────────────────────────────┘
-```

docs/MAPA_MICROSERVICOS_COOLIFY.md

@@ -1,734 +0,0 @@
-# Arcádia Suite — Mapa de Microserviços para Coolify/Docker
-
-> Documento de referência para containerização e deploy em Coolify.
-> Atualizado em: Março 2026
-
----
-
-## 1. Visão Geral da Arquitetura
-
-```
-                         ┌──────────────────────────────┐
-                         │         COOLIFY / TRAEFIK     │
-                         │    Reverse Proxy + TLS + DNS  │
-                         └──────────┬───────────────────┘
-                                    │
-              ┌─────────────────────┼─────────────────────┐
-              │                     │                       │
-     ┌────────▼────────┐  ┌────────▼────────┐   ┌─────────▼────────┐
-     │  arcadia-gateway │  │  arcadia-plus   │   │  arcadia-frontend│
-     │  (Node.js:5000)  │  │  (PHP/Nginx)    │   │  (Nginx/Static)  │
-     │  API + WebSocket │  │  :8080          │   │  :80 (React SPA) │
-     └────────┬────────┘  └────────┬────────┘   └──────────────────┘
-              │                     │
-    ┌─────────┼──────────────┬──────┘
-    │         │              │
-┌───▼──┐ ┌───▼───┐ ┌────────▼────────┐
-│Postgres│ │MySQL  │ │  Redis (futuro) │
-│  :5432 │ │ :3306 │ │     :6379       │
-└───┬────┘ └───────┘ └─────────────────┘
-    │
-    │  (DATABASE_URL compartilhado)
-    │
-┌───▼──────────────────────────────────────────────────────┐
-│                    MOTORES (FastAPI / Node)               │
-│                                                           │
-│  ┌─────────┐ ┌─────────┐ ┌──────┐ ┌──────┐ ┌──────────┐ │
-│  │ Fisco   │ │Contábil │ │  BI  │ │Auto  │ │  Comm    │ │
-│  │ :8002   │ │ :8003   │ │:8004 │ │:8005 │ │  :8006   │ │
-│  │ Python  │ │ Python  │ │Python│ │Python│ │  Node/TS │ │
-│  └─────────┘ └─────────┘ └──────┘ └──────┘ └──────────┘ │
-└──────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. Inventário de Serviços (9 containers + 3 bancos)
-
-### 2.1 — `arcadia-gateway` (Container Principal)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Node.js 20 + Express + Socket.IO |
-| **Porta** | 5000 |
-| **Entrada** | `server/index.ts` (build: `dist/index.cjs`) |
-| **Banco** | PostgreSQL (Drizzle ORM) |
-| **Responsabilidades** | API REST principal, autenticação/sessões, WebSocket (chat + WhatsApp), proxy para motores, Dev Center (6 agentes XOS), Manus IA (OpenAI), Knowledge Graph, Learning System, Governance, MCP/A2A protocols |
-| **Variáveis obrigatórias** | `DATABASE_URL`, `PGHOST`, `PGUSER`, `PGPASSWORD`, `PGDATABASE`, `SESSION_SECRET`, `OPENAI_API_KEY`, `GITHUB_TOKEN` |
-| **Variáveis opcionais** | `ERPNEXT_URL`, `ERPNEXT_API_KEY`, `ERPNEXT_API_SECRET`, `GITHUB_OWNER`, `GITHUB_REPO` |
-| **Healthcheck** | `GET /api/health` ou `GET /` |
-| **Dockerfile existente** | `./Dockerfile` (node:20-alpine, multi-stage) |
-
-```dockerfile
-# Build: npm run build → dist/index.cjs
-# Run: node dist/index.cjs
-# Portas: 5000
-```
-
-### 2.2 — `arcadia-frontend` (SPA React)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | React 18 + Vite + TypeScript + Tailwind + shadcn/ui |
-| **Build** | `npm run build` → `dist/public/` |
-| **Servir com** | Nginx (static files) ou incluir no Gateway |
-| **Porta** | 80/443 (via Coolify/Traefik) |
-
-> **Nota**: Atualmente o frontend é servido pelo Gateway (Express serve os assets estáticos). Para microsserviços, pode ser separado em um container Nginx leve ou mantido no Gateway.
-
-**Opção A — Junto com Gateway** (recomendado para início):
-O Dockerfile atual já faz isso. O Express serve o React build.
-
-**Opção B — Separado** (para escalar independentemente):
-```dockerfile
-FROM node:20-alpine AS builder
-WORKDIR /app
-COPY package.json package-lock.json* ./
-RUN npm install --legacy-peer-deps
-COPY . .
-RUN npm run build
-
-FROM nginx:alpine
-COPY --from=builder /app/dist/public /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
-EXPOSE 80
-```
-
-### 2.3 — `arcadia-plus` (ERP Laravel/PHP)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | PHP 8.2 + Laravel + Nginx |
-| **Porta** | 8080 (interno) → exposto via proxy `/plus` |
-| **Banco** | MySQL 8.0 (separado do PostgreSQL) |
-| **Entrada** | `plus/public/index.php` via `php artisan serve` ou PHP-FPM + Nginx |
-| **Dockerfile existente** | `plus/Dockerfile` (php:8.2-fpm) |
-| **docker-compose existente** | `plus/docker-compose.yml` (app + web + db) |
-| **Dependências** | Composer, Node.js 18 (para assets) |
-| **Variáveis obrigatórias** | `DB_HOST`, `DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`, `MYSQL_ROOT_PASSWORD`, `APP_KEY`, `APP_URL` |
-| **Módulos** | NF-e/NFC-e/CT-e/MDF-e, PDV, Menu Digital, Ordem de Serviço, Financeiro, Estoque, CRM |
-
-**Containers necessários para o Plus**:
-1. `arcadia-plus-app` — PHP-FPM (porta 9000 interna)
-2. `arcadia-plus-web` — Nginx (porta 8080, proxy para PHP-FPM)
-3. `arcadia-mysql` — MySQL 8.0 (porta 3306)
-
-### 2.4 — `arcadia-fisco` (Motor Fiscal)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Python 3.11 + FastAPI + Uvicorn |
-| **Porta** | 8002 |
-| **Arquivo** | `server/python/fisco_service.py` |
-| **Banco** | Nenhum direto (opera sobre XML) |
-| **Dependências Python** | `fastapi`, `uvicorn`, `nfelib`, `signxml`, `lxml`, `zeep`, `cryptography`, `pydantic` |
-| **Responsabilidades** | Geração XML NF-e/NFC-e, assinatura digital, comunicação SEFAZ, consulta/cancelamento/inutilização |
-| **Variáveis** | `FISCO_PORT=8002` |
-| **Healthcheck** | `GET /health` |
-
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-COPY server/python/fisco_service.py .
-COPY requirements-fisco.txt .
-RUN pip install -r requirements-fisco.txt
-EXPOSE 8002
-CMD ["uvicorn", "fisco_service:app", "--host", "0.0.0.0", "--port", "8002"]
-```
-
-### 2.5 — `arcadia-contabil` (Motor Contábil)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Python 3.11 + FastAPI |
-| **Porta** | 8003 |
-| **Arquivo** | `server/python/contabil_service.py` |
-| **Banco** | Nenhum direto (recebe dados via POST) |
-| **Dependências Python** | `fastapi`, `uvicorn`, `pydantic` |
-| **Responsabilidades** | DRE, Balanço Patrimonial, Balancete, Validação de Lançamentos, SPED ECD/ECF, integração NF-e/folha |
-| **Variáveis** | `CONTABIL_PORT=8003` |
-| **Healthcheck** | `GET /health` |
-
-### 2.6 — `arcadia-bi` (Motor BI/Analytics)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Python 3.11 + FastAPI + Pandas + NumPy |
-| **Porta** | 8004 |
-| **Arquivo** | `server/python/bi_engine.py` |
-| **Banco** | PostgreSQL (via `psycopg2`, leitura direta) |
-| **Dependências Python** | `fastapi`, `uvicorn`, `pandas`, `numpy`, `psycopg2-binary`, `pydantic` |
-| **Responsabilidades** | Exploração de schema, execução SQL, geração de dados para gráficos, Micro-BI, análise de dados |
-| **Variáveis** | `BI_PORT=8004`, `DATABASE_URL` |
-| **Healthcheck** | `GET /health` |
-
-### 2.7 — `arcadia-automation` (Motor de Automação)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Python 3.11 + FastAPI + APScheduler |
-| **Porta** | 8005 |
-| **Arquivo** | `server/python/automation_engine.py` |
-| **Banco** | PostgreSQL (via `psycopg2`) |
-| **Dependências Python** | `fastapi`, `uvicorn`, `psycopg2-binary`, `apscheduler`, `pydantic` |
-| **Responsabilidades** | Scheduler (cron jobs), Event Bus, Workflow executor |
-| **Variáveis** | `AUTOMATION_PORT=8005`, `DATABASE_URL` |
-| **Healthcheck** | `GET /health` |
-
-### 2.8 — `arcadia-communication` (Motor de Comunicação)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Node.js 20 + Express + TypeScript |
-| **Porta** | 8006 |
-| **Arquivo** | `server/communication/engine.ts` |
-| **Banco** | PostgreSQL (via `@neondatabase/serverless`) |
-| **Dependências Node** | `express`, `@neondatabase/serverless`, `ws` |
-| **Responsabilidades** | Unifica contatos/threads/mensagens de WhatsApp, CRM, XOS. Canais, filas, mensagens rápidas, eventos |
-| **Variáveis** | `COMMUNICATION_PORT=8006`, `DATABASE_URL` |
-| **Healthcheck** | `GET /health` |
-
-### 2.9 — `arcadia-people` (Motor RH — opcional/futuro)
-
-| Item | Valor |
-|------|-------|
-| **Tecnologia** | Python 3.11 + FastAPI |
-| **Porta** | 8007 (ajustar — conflito atual com BI na 8004) |
-| **Arquivo** | `server/python/people_service.py` |
-| **Banco** | Nenhum direto (cálculos puros) |
-| **Dependências Python** | `fastapi`, `uvicorn`, `pydantic` |
-| **Responsabilidades** | Cálculo INSS/IRRF, folha de pagamento, férias, rescisão, eSocial |
-| **Variáveis** | `PEOPLE_PORT=8007` |
-
----
-
-## 3. Bancos de Dados (3 containers)
-
-### 3.1 — `arcadia-postgres`
-
-| Item | Valor |
-|------|-------|
-| **Imagem** | `postgres:16-alpine` |
-| **Porta** | 5432 |
-| **Uso** | Gateway, BI Engine, Automation Engine, Communication Engine |
-| **ORM** | Drizzle (Node.js) / psycopg2 (Python) |
-| **Schema** | ~100+ tabelas (tenants, users, valuation_*, crm_*, comm_*, xos_*, etc.) |
-| **Volume** | `/var/lib/postgresql/data` |
-
-### 3.2 — `arcadia-mysql`
-
-| Item | Valor |
-|------|-------|
-| **Imagem** | `mysql:8.0` |
-| **Porta** | 3306 |
-| **Uso** | Exclusivo do Plus (Laravel) |
-| **Schema** | 260+ migrações Laravel (produtos, vendas, fiscal, estoque, etc.) |
-| **Volume** | `/var/lib/mysql` |
-
-### 3.3 — `arcadia-redis` (futuro/recomendado)
-
-| Item | Valor |
-|------|-------|
-| **Imagem** | `redis:7-alpine` |
-| **Porta** | 6379 |
-| **Uso** | Cache de sessões, fila de jobs, pub/sub entre serviços |
-| **Recomendação** | Substituir session store do Express (atualmente PostgreSQL) e usar como broker de eventos |
-
----
-
-## 4. Mapa de Comunicação entre Serviços
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    arcadia-gateway (:5000)                       │
-│                                                                  │
-│  /api/*          → Rotas internas (Express)                     │
-│  /api/fisco/*    → proxy → arcadia-fisco:8002                   │
-│  /api/contabil/* → proxy → arcadia-contabil:8003                │
-│  /api/bi/*       → proxy → arcadia-bi:8004                      │
-│  /api/automation/*→ proxy → arcadia-automation:8005              │
-│  /api/comm/*     → proxy → arcadia-communication:8006            │
-│  /plus/*         → proxy → arcadia-plus-web:8080                │
-│  /metabase/*     → proxy → metabase:8088 (se usar)              │
-│                                                                  │
-│  WebSocket (Socket.IO) → Chat interno, WhatsApp real-time       │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Dependências entre serviços:
-
-| Serviço | Depende de | Comunicação |
-|---------|-----------|-------------|
-| Gateway | PostgreSQL, todos os motores | HTTP proxy, DB direto |
-| Plus | MySQL, Gateway (SSO) | HTTP (proxy reverso) |
-| Fisco | Nenhum banco | HTTP (recebe XMLs) |
-| Contábil | Nenhum banco | HTTP (recebe dados via POST) |
-| BI | PostgreSQL | HTTP + SQL direto no PG |
-| Automation | PostgreSQL | HTTP + SQL direto no PG |
-| Communication | PostgreSQL | HTTP + SQL direto no PG |
-| People | Nenhum banco | HTTP (cálculos puros) |
-
----
-
-## 5. Docker Compose Completo para Coolify
-
-```yaml
-# docker-compose.coolify.yml
-version: "3.8"
-
-services:
-  # ═══════════════════════════════════════════
-  # BANCOS DE DADOS
-  # ═══════════════════════════════════════════
-  postgres:
-    image: postgres:16-alpine
-    restart: always
-    environment:
-      POSTGRES_USER: ${PGUSER:-arcadia}
-      POSTGRES_PASSWORD: ${PGPASSWORD}
-      POSTGRES_DB: ${PGDATABASE:-arcadia}
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-    ports:
-      - "5432:5432"
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${PGUSER:-arcadia}"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - arcadia
-
-  mysql:
-    image: mysql:8.0
-    restart: always
-    command: >
-      --default-authentication-plugin=mysql_native_password
-      --character-set-server=utf8mb4
-      --collation-server=utf8mb4_unicode_ci
-    environment:
-      MYSQL_DATABASE: ${PLUS_DB_DATABASE:-controlplus}
-      MYSQL_USER: ${PLUS_DB_USERNAME:-controlplus}
-      MYSQL_PASSWORD: ${PLUS_DB_PASSWORD}
-      MYSQL_ROOT_PASSWORD: ${PLUS_MYSQL_ROOT_PASSWORD}
-    volumes:
-      - mysqldata:/var/lib/mysql
-    ports:
-      - "3306:3306"
-    healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - arcadia
-
-  redis:
-    image: redis:7-alpine
-    restart: always
-    ports:
-      - "6379:6379"
-    volumes:
-      - redisdata:/data
-    healthcheck:
-      test: ["CMD", "redis-cli", "ping"]
-      interval: 10s
-    networks:
-      - arcadia
-
-  # ═══════════════════════════════════════════
-  # GATEWAY + FRONTEND (Node.js principal)
-  # ═══════════════════════════════════════════
-  gateway:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    restart: always
-    depends_on:
-      postgres:
-        condition: service_healthy
-    ports:
-      - "5000:5000"
-    environment:
-      NODE_ENV: production
-      PORT: 5000
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@postgres:5432/${PGDATABASE:-arcadia}
-      PGHOST: postgres
-      PGUSER: ${PGUSER:-arcadia}
-      PGPASSWORD: ${PGPASSWORD}
-      PGDATABASE: ${PGDATABASE:-arcadia}
-      SESSION_SECRET: ${SESSION_SECRET}
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-      GITHUB_TOKEN: ${GITHUB_TOKEN}
-      ERPNEXT_URL: ${ERPNEXT_URL:-}
-      ERPNEXT_API_KEY: ${ERPNEXT_API_KEY:-}
-      ERPNEXT_API_SECRET: ${ERPNEXT_API_SECRET:-}
-      # URLs dos motores (comunicação interna Docker)
-      FISCO_URL: http://fisco:8002
-      CONTABIL_URL: http://contabil:8003
-      BI_URL: http://bi:8004
-      AUTOMATION_URL: http://automation:8005
-      COMMUNICATION_URL: http://communication:8006
-      PLUS_URL: http://plus-web:8080
-      REDIS_URL: redis://redis:6379
-    volumes:
-      - uploads:/app/uploads
-    healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://localhost:5000/"]
-      interval: 30s
-      timeout: 10s
-      start_period: 40s
-    networks:
-      - arcadia
-
-  # ═══════════════════════════════════════════
-  # MOTORES PYTHON (FastAPI)
-  # ═══════════════════════════════════════════
-  fisco:
-    build:
-      context: .
-      dockerfile: docker/fisco.Dockerfile
-    restart: always
-    ports:
-      - "8002:8002"
-    environment:
-      FISCO_PORT: 8002
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8002/health"]
-      interval: 30s
-    networks:
-      - arcadia
-
-  contabil:
-    build:
-      context: .
-      dockerfile: docker/contabil.Dockerfile
-    restart: always
-    ports:
-      - "8003:8003"
-    environment:
-      CONTABIL_PORT: 8003
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8003/health"]
-      interval: 30s
-    networks:
-      - arcadia
-
-  bi:
-    build:
-      context: .
-      dockerfile: docker/bi.Dockerfile
-    restart: always
-    depends_on:
-      postgres:
-        condition: service_healthy
-    ports:
-      - "8004:8004"
-    environment:
-      BI_PORT: 8004
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@postgres:5432/${PGDATABASE:-arcadia}
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8004/health"]
-      interval: 30s
-    networks:
-      - arcadia
-
-  automation:
-    build:
-      context: .
-      dockerfile: docker/automation.Dockerfile
-    restart: always
-    depends_on:
-      postgres:
-        condition: service_healthy
-    ports:
-      - "8005:8005"
-    environment:
-      AUTOMATION_PORT: 8005
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@postgres:5432/${PGDATABASE:-arcadia}
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8005/health"]
-      interval: 30s
-    networks:
-      - arcadia
-
-  communication:
-    build:
-      context: .
-      dockerfile: docker/communication.Dockerfile
-    restart: always
-    depends_on:
-      postgres:
-        condition: service_healthy
-    ports:
-      - "8006:8006"
-    environment:
-      COMMUNICATION_PORT: 8006
-      DATABASE_URL: postgresql://${PGUSER:-arcadia}:${PGPASSWORD}@postgres:5432/${PGDATABASE:-arcadia}
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8006/health"]
-      interval: 30s
-    networks:
-      - arcadia
-
-  # ═══════════════════════════════════════════
-  # ARCÁDIA PLUS (Laravel/PHP)
-  # ═══════════════════════════════════════════
-  plus-app:
-    build:
-      context: ./plus
-      dockerfile: Dockerfile
-    restart: always
-    depends_on:
-      mysql:
-        condition: service_healthy
-    env_file:
-      - ./plus/.env
-    volumes:
-      - ./plus:/var/www/html:cached
-      - plus-vendor:/var/www/html/vendor
-    networks:
-      - arcadia
-
-  plus-web:
-    image: nginx:1.25-alpine
-    restart: always
-    depends_on:
-      - plus-app
-    ports:
-      - "8080:80"
-    volumes:
-      - ./plus:/var/www/html:cached
-      - ./plus/docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
-    networks:
-      - arcadia
-
-volumes:
-  pgdata:
-  mysqldata:
-  redisdata:
-  uploads:
-  plus-vendor:
-
-networks:
-  arcadia:
-    driver: bridge
-```
-
----
-
-## 6. Variáveis de Ambiente (.env para Coolify)
-
-```env
-# ══════════════════════════════════════
-# POSTGRESQL (Principal)
-# ══════════════════════════════════════
-PGUSER=arcadia
-PGPASSWORD=SuaSenhaSegura123!
-PGDATABASE=arcadia
-DATABASE_URL=postgresql://arcadia:SuaSenhaSegura123!@postgres:5432/arcadia
-
-# ══════════════════════════════════════
-# GATEWAY (Node.js)
-# ══════════════════════════════════════
-NODE_ENV=production
-PORT=5000
-SESSION_SECRET=sua-session-secret-aqui
-
-# ══════════════════════════════════════
-# INTELIGÊNCIA ARTIFICIAL
-# ══════════════════════════════════════
-OPENAI_API_KEY=sk-...
-
-# ══════════════════════════════════════
-# GITHUB
-# ══════════════════════════════════════
-GITHUB_TOKEN=ghp_...
-GITHUB_OWNER=jonaspachecoometas
-GITHUB_REPO=arcadiasuite
-
-# ══════════════════════════════════════
-# ERPNEXT (opcional)
-# ══════════════════════════════════════
-ERPNEXT_URL=https://seu-erpnext.com
-ERPNEXT_API_KEY=
-ERPNEXT_API_SECRET=
-
-# ══════════════════════════════════════
-# MYSQL (Plus/Laravel)
-# ══════════════════════════════════════
-PLUS_DB_DATABASE=controlplus
-PLUS_DB_USERNAME=controlplus
-PLUS_DB_PASSWORD=SenhaMySQLSegura!
-PLUS_MYSQL_ROOT_PASSWORD=RootSenha123!
-
-# ══════════════════════════════════════
-# REDIS
-# ══════════════════════════════════════
-REDIS_URL=redis://redis:6379
-```
-
----
-
-## 7. Dockerfiles dos Motores (a criar em `docker/`)
-
-### `docker/fisco.Dockerfile`
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-RUN pip install fastapi uvicorn pydantic cryptography lxml zeep signxml
-# nfelib se disponível: RUN pip install nfelib
-COPY server/python/fisco_service.py ./main.py
-EXPOSE 8002
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8002"]
-```
-
-### `docker/contabil.Dockerfile`
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-RUN pip install fastapi uvicorn pydantic
-COPY server/python/contabil_service.py ./main.py
-EXPOSE 8003
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8003"]
-```
-
-### `docker/bi.Dockerfile`
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-RUN pip install fastapi uvicorn pydantic pandas numpy psycopg2-binary
-COPY server/python/bi_engine.py ./main.py
-EXPOSE 8004
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8004"]
-```
-
-### `docker/automation.Dockerfile`
-```dockerfile
-FROM python:3.11-slim
-WORKDIR /app
-RUN pip install fastapi uvicorn pydantic psycopg2-binary apscheduler
-COPY server/python/automation_engine.py ./main.py
-EXPOSE 8005
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8005"]
-```
-
-### `docker/communication.Dockerfile`
-```dockerfile
-FROM node:20-alpine
-WORKDIR /app
-COPY package.json package-lock.json* ./
-RUN npm install --legacy-peer-deps --production
-COPY server/communication/ ./server/communication/
-COPY shared/ ./shared/
-COPY tsconfig.json ./
-EXPOSE 8006
-CMD ["npx", "tsx", "server/communication/engine.ts"]
-```
-
----
-
-## 8. Ordem de Deploy no Coolify
-
-### Fase 1 — Infraestrutura (subir primeiro)
-1. `arcadia-postgres` — Banco principal
-2. `arcadia-mysql` — Banco do Plus
-3. `arcadia-redis` — Cache e filas
-
-### Fase 2 — Motores Independentes (podem subir em paralelo)
-4. `arcadia-fisco` — Sem dependência de banco
-5. `arcadia-contabil` — Sem dependência de banco
-6. `arcadia-bi` — Depende do PostgreSQL
-7. `arcadia-automation` — Depende do PostgreSQL
-8. `arcadia-communication` — Depende do PostgreSQL
-
-### Fase 3 — Aplicações Principais
-9. `arcadia-gateway` — Depende de PostgreSQL + todos os motores
-10. `arcadia-plus-app` + `arcadia-plus-web` — Depende do MySQL
-
-### Fase 4 — Migrações (após tudo no ar)
-```bash
-# PostgreSQL (Drizzle)
-docker exec arcadia-gateway npx drizzle-kit push
-
-# MySQL (Laravel)
-docker exec arcadia-plus-app php artisan migrate --force
-docker exec arcadia-plus-app php artisan db:seed --force
-```
-
----
-
-## 9. Ajustes Necessários no Código
-
-### 9.1 — Gateway: URLs dos motores precisam ser configuráveis
-
-Atualmente o código usa `localhost:800X`. Para Docker, precisa usar nomes de serviço:
-
-| Arquivo | Linha | De | Para |
-|---------|-------|----|------|
-| `server/contabil/routes.ts` | proxy | `localhost:8003` | `process.env.CONTABIL_URL` |
-| `server/fisco/routes.ts` | proxy | `localhost:8002` | `process.env.FISCO_URL` |
-| `server/bi/proxy.ts` | proxy | `localhost:8004` | `process.env.BI_URL` |
-| `server/python/launcher.ts` | spawn | hardcoded | Remover spawns no modo Docker |
-| `server/plus/proxy.ts` | proxy | `localhost:8080` | `process.env.PLUS_URL` |
-| `server/communication/proxy.ts` | proxy | `localhost:8006` | `process.env.COMMUNICATION_URL` |
-
-### 9.2 — Desabilitar spawns de subprocessos em produção
-
-O Gateway atualmente inicia os motores Python como subprocessos. No Docker cada motor roda em seu próprio container. Adicionar flag:
-
-```typescript
-// server/index.ts
-if (process.env.DOCKER_MODE !== 'true') {
-  // spawn python services
-  startManagedServices();
-}
-```
-
-### 9.3 — Conflito de portas
-
-| Serviço | Porta atual | Conflito | Solução |
-|---------|------------|----------|---------|
-| People | 8004 | BI Engine | Mudar para 8007 |
-| BI Analysis | 8003 | Contábil | Mesclar no BI Engine (8004) |
-
----
-
-## 10. Checklist de Migração para Coolify
-
-- [ ] Criar pasta `docker/` com Dockerfiles dos motores
-- [ ] Criar `docker-compose.coolify.yml` (baseado na seção 5)
-- [ ] Criar `.env.production` com todas as variáveis
-- [ ] Ajustar proxies do Gateway para usar variáveis de ambiente
-- [ ] Adicionar flag `DOCKER_MODE=true` para desabilitar spawns
-- [ ] Resolver conflitos de porta (People → 8007)
-- [ ] Testar build de cada Dockerfile isoladamente
-- [ ] Configurar Coolify com Docker Compose
-- [ ] Rodar migrações PostgreSQL (`drizzle-kit push`)
-- [ ] Rodar migrações MySQL (`php artisan migrate`)
-- [ ] Configurar domínio e TLS no Coolify/Traefik
-- [ ] Configurar volumes persistentes (pgdata, mysqldata, uploads)
-- [ ] Testar SSO do Plus via proxy
-- [ ] Verificar WebSocket (Socket.IO) funciona via Traefik
-- [ ] Configurar healthchecks em todos os serviços
-
----
-
-## 11. Resumo Visual Rápido
-
-| # | Container | Porta | Tech | Banco | Prioridade |
-|---|-----------|-------|------|-------|-----------|
-| 1 | postgres | 5432 | PostgreSQL 16 | - | Essencial |
-| 2 | mysql | 3306 | MySQL 8.0 | - | Para Plus |
-| 3 | redis | 6379 | Redis 7 | - | Recomendado |
-| 4 | gateway | 5000 | Node.js 20 | PG | Essencial |
-| 5 | fisco | 8002 | Python 3.11 | - | Módulo |
-| 6 | contabil | 8003 | Python 3.11 | - | Módulo |
-| 7 | bi | 8004 | Python 3.11 | PG | Módulo |
-| 8 | automation | 8005 | Python 3.11 | PG | Módulo |
-| 9 | communication | 8006 | Node.js 20 | PG | Módulo |
-| 10 | plus-app | 9000 | PHP 8.2 FPM | MySQL | Módulo |
-| 11 | plus-web | 8080 | Nginx 1.25 | - | Módulo |
-| 12 | people | 8007 | Python 3.11 | - | Futuro |
-
-**Total: 12 containers (3 bancos + 1 gateway + 8 motores)**

docs/MAPA_SOE_ARCADIA.md

@@ -1,746 +0,0 @@
-# Arcádia SOE — Sistema Operacional Empresarial
-## Mapa Completo para Deploy em Servidor Dedicado
-
-> Mapa da rota `/soe`: todos os arquivos do módulo, domínios de negócio,
-> padrão de motor (adapter), tabelas PostgreSQL, APIs REST e dependências
-> externas. Atualizado em: Março 2026.
-
----
-
-## 1. O que é o SOE
-
-O **Arcádia SOE (Sistema Operacional Empresarial)** é o **kernel central** da Arcádia Suite — o sistema que concentra todos os domínios canônicos de negócio. Enquanto apps como Varejo, Engenharia e Food Service adicionam experiências verticais, o SOE é a camada horizontal que todos compartilham.
-
-**Princípio central:** O SOE **pensa e governa**; os motores (Plus, ERPNext) **executam e registram**.
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                      ARCÁDIA SOE — VISÃO GERAL                       │
-│                                                                      │
-│  URL: /soe                                                           │
-│  API: /api/soe/* (alias backward-compatible → /api/erp/*)           │
-│                                                                      │
-│  ┌──────── Domínios Canônicos ────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  Pessoas  │ Produtos │ Vendas   │ Compras  │ Estoque       │     │
-│  │  Fiscal   │ Financ.  │ CRM      │ Projetos │ Qualidade     │     │
-│  │  Governa. │ RH       │                                     │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌──────── Motores (Adapters) ────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  motor = "plus"    → Arcádia Plus (Laravel :8080)         │     │
-│  │  motor = "erpnext" → ERPNext/Frappe (externo)             │     │
-│  │  motor = nativo    → PostgreSQL local (default fallback)   │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌──────── Apps que estendem o SOE ───────────────────────────┐     │
-│  │  Varejo (Retail)  │  Engenharia  │  Food Service           │     │
-│  │  Assistência Tec  │  Educação    │  (outros segmentos)     │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. Arquivos do Módulo SOE — Lista Completa para Export
-
-### 2.1 — Frontend (React/TypeScript)
-
-| Arquivo | Função | Linhas |
-|---------|--------|--------|
-| `client/src/pages/SOE.tsx` | **Página principal** do SOE — 9 abas, CRUD completo | 2.414 |
-| `client/src/pages/ERP.tsx` | Legacy ERP — mantido para referência histórica | 2.197 |
-| `client/src/contexts/SoeMotorContext.tsx` | **Context do Motor** — gerencia plus/erpnext via localStorage | 63 |
-| `client/src/contexts/ErpProfileContext.tsx` | Alias legacy do SoeMotorContext (backward compat.) | 52 |
-
-### 2.2 — Backend (Node.js/TypeScript)
-
-| Arquivo | Função | Linhas |
-|---------|--------|--------|
-| `server/erp/routes.ts` | **Rotas SOE core** — /api/erp/* (= /api/soe/*) | 1.343 |
-| `server/erp/index.ts` | Setup do módulo + alias /api/soe → /api/erp | 210 |
-| `server/retail/routes.ts` | **Rotas do Varejo** — /api/retail/* | 5.218 |
-| `server/retail/index.ts` | Setup do módulo retail | — |
-| `server/retail/sync-service.ts` | Sincronização retail ↔ Plus | — |
-| `server/retail/plus-sync.ts` | Ponte retail → Arcádia Plus | — |
-| `server/plus/client.ts` | **Cliente HTTP** para Arcádia Plus (:8080) | 376 |
-| `server/plus/routes.ts` | Rotas de integração Plus | — |
-| `server/plus/launcher.ts` | Iniciador do serviço Plus | — |
-| `server/plus/proxy.ts` | Proxy transparente → Plus (:8080) | — |
-| `server/plus/sso.ts` | Single Sign-On entre SOE e Plus | — |
-| `server/erpnext/routes.ts` | Rotas de integração ERPNext | — |
-| `server/erpnext/index.ts` | Setup do módulo ERPNext | — |
-
-### 2.3 — Schema PostgreSQL (Drizzle ORM)
-
-| Arquivo | Tabelas relacionadas ao SOE |
-|---------|----------------------------|
-| `shared/schema.ts` (L348) | `erp_connections` |
-| `shared/schema.ts` (L3303) | `erp_segments`, `erp_config` |
-| `shared/schema.ts` (L3367–3517) | `customers`, `suppliers`, `products`, `sales_orders`, `sales_order_items`, `purchase_orders`, `purchase_order_items` |
-| `shared/schema.ts` (L5082–5617) | Tabelas retail (ver seção 5) |
-| `shared/schema.ts` (L6204) | `persons`, `person_roles` |
-| `shared/schema.ts` (L4372) | `fin_payment_methods`, `fin_payment_plans` |
-
----
-
-## 3. Arquitetura de Arquivos
-
-```
-workspace/
-│
-├── client/src/
-│   ├── pages/
-│   │   ├── SOE.tsx                  ← Página principal (/soe)
-│   │   └── ERP.tsx                  ← Legacy (mantido)
-│   │
-│   └── contexts/
-│       ├── SoeMotorContext.tsx       ← Motor context (plus | erpnext)
-│       └── ErpProfileContext.tsx     ← Alias backward-compat
-│
-├── server/
-│   ├── erp/
-│   │   ├── routes.ts                ← /api/erp/* (= /api/soe/*)
-│   │   └── index.ts                 ← Setup + alias soe→erp
-│   │
-│   ├── retail/
-│   │   ├── routes.ts                ← /api/retail/*
-│   │   ├── index.ts
-│   │   ├── sync-service.ts
-│   │   └── plus-sync.ts
-│   │
-│   ├── plus/
-│   │   ├── client.ts                ← HTTP client → Plus :8080
-│   │   ├── routes.ts
-│   │   ├── proxy.ts
-│   │   ├── launcher.ts
-│   │   └── sso.ts
-│   │
-│   └── erpnext/
-│       ├── routes.ts
-│       └── index.ts
-│
-└── shared/
-    └── schema.ts                    ← Tabelas SOE + Retail
-```
-
----
-
-## 4. Motor de Execução (Adapter Pattern)
-
-O SOE usa um **padrão de adapter** para rotear operações para o motor correto:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    SOEOMOTOR — ADAPTER PATTERN                        │
-│                                                                      │
-│  SoeMotorContext.tsx                                                 │
-│                                                                      │
-│  export type SoeMotor = "plus" | "erpnext"                          │
-│                                                                      │
-│  Persistência: localStorage["arcadia_soe_motor"]                    │
-│                                                                      │
-│  getApiUrl(localPath, plusPath, erpnextPath?)                       │
-│                                                                      │
-│  ┌──────── motor = "plus" ────────────────────────────────────┐     │
-│  │  → /plus/api{plusPath}                                      │     │
-│  │  → Passa pelo proxy transparente do Plus                   │     │
-│  │  → Arcádia Plus (Laravel) em :8080                         │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌──────── motor = "erpnext" ─────────────────────────────────┐     │
-│  │  → erpnextPath ou localPath                                │     │
-│  │  → ERPNext API (ERPNEXT_URL env var)                       │     │
-│  │  → Autenticado via ERPNEXT_API_KEY + ERPNEXT_API_SECRET    │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌──────── motor = nativo (fallback) ─────────────────────────┐     │
-│  │  → localPath (/api/erp/*)                                  │     │
-│  │  → PostgreSQL local via Drizzle ORM                         │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  Seleção na UI: SOE.tsx → Config tab → Dropdown de motor           │
-│  Plus ativo: isERPNextConnected verifica /api/erpnext/connections   │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 5. Domínios e Abas do SOE
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  SOE.tsx — 9 ABAS PRINCIPAIS                                         │
-│                                                                      │
-│  ┌── Tab: dashboard ──────────────────────────────────────────┐    │
-│  │  • Stats: clientes, produtos, pedidos, total vendas        │    │
-│  │  • Cards com indicadores-chave do negócio                  │    │
-│  │  • Acesso rápido às seções                                 │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌── Tab: persons (Pessoas) ───────────────────────────────────┐   │
-│  │  • Clientes, Fornecedores, Funcionários, Técnicos, Parceiros│   │
-│  │  • Busca + filtro por papel (role)                         │   │
-│  │  • Campos: nome, CPF/CNPJ, email, telefone, endereço       │   │
-│  │  • Tabelas: persons + person_roles                         │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: products (Produtos) ─────────────────────────────────┐   │
-│  │  • Cadastro de produtos/serviços                           │   │
-│  │  • Rastreamento: IMEI, Número de Série, sem rastreamento   │   │
-│  │  • Grupos de produto, unidades (UN/KG/M/L/CX/PC)          │   │
-│  │  • Estoque por produto, devices batch import               │   │
-│  │  • Tabela: products + mobile_devices                       │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: sales (Vendas) ──────────────────────────────────────┐   │
-│  │  • Pedidos de venda                                        │   │
-│  │  • Status: draft → confirmed → delivered                   │   │
-│  │  • Geração de NF-e a partir do pedido                     │   │
-│  │  • Formas de pagamento: Dinheiro/Cartão/PIX/Boleto/Prazo  │   │
-│  │  • Tabelas: sales_orders + sales_order_items               │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: purchases (Compras) ─────────────────────────────────┐   │
-│  │  • Pedidos de compra                                       │   │
-│  │  • Associados a fornecedores                               │   │
-│  │  • Tabelas: purchase_orders + purchase_order_items         │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: financial (Financeiro) ──────────────────────────────┐   │
-│  │  • Visão financeira consolidada                            │   │
-│  │  • Planos de pagamento e parcelamento                      │   │
-│  │  • Tabelas: fin_payment_methods + fin_payment_plans        │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: crm ─────────────────────────────────────────────────┐   │
-│  │  • Módulo CRM inline no SOE                                │   │
-│  │  • Integrado via useTenantFeatures (feature: crm)          │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: sync (Sincronização) ────────────────────────────────┐   │
-│  │  • Status dos motores (Plus/ERPNext)                       │   │
-│  │  • Módulos ativos/inativos do tenant                       │   │
-│  │  • Botões de sync manual por entidade                      │   │
-│  │  • Indica se Plus está online (:8080)                      │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌── Tab: config (Configuração) ───────────────────────────────┐   │
-│  │  • Dados da empresa: razão social, CNPJ, regime tributário │   │
-│  │  • Inscrição estadual/municipal                            │   │
-│  │  • Segmento de negócio                                    │   │
-│  │  • Seletor de motor: Plus ou ERPNext                       │   │
-│  │  • Tabela: erp_config + erp_segments                       │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 6. Tabelas PostgreSQL — SOE Core
-
-### 6.1 — erp_connections (Conexões com ERPs externos)
-
-```
-erp_connections
-├── id              serial PK
-├── userId          FK → users.id
-├── erpType         "erpnext" | "plus" | "omie" | etc.
-├── name            Nome da conexão
-├── url             URL do ERP
-├── apiKey          Chave de API
-├── apiSecret       Secret
-├── isActive        boolean
-└── createdAt, updatedAt
-```
-
-### 6.2 — erp_segments (Segmentos de Negócio)
-
-```
-erp_segments
-├── id              serial PK
-├── name            Nome (Varejo, Serviços, Indústria, etc.)
-├── description     Descrição
-├── icon            Ícone
-└── createdAt
-```
-
-### 6.3 — erp_config (Configuração da Empresa)
-
-```
-erp_config
-├── id              serial PK
-├── userId          FK → users.id
-├── companyName     Razão Social
-├── tradeName       Nome Fantasia
-├── taxId           CNPJ
-├── taxRegime       simples | lucro_presumido | lucro_real
-├── stateRegistration  Inscrição Estadual
-├── cityRegistration   Inscrição Municipal
-├── segmentId       FK → erp_segments.id
-├── address         Endereço completo
-└── createdAt, updatedAt
-```
-
-### 6.4 — customers (Clientes)
-
-```
-customers
-├── id              serial PK
-├── userId          FK → users.id
-├── code            Código interno
-├── name            Nome
-├── email           E-mail
-├── phone           Telefone
-├── document        CPF/CNPJ
-├── type            company | individual
-├── address         Endereço
-└── createdAt, updatedAt
-```
-
-### 6.5 — suppliers (Fornecedores)
-
-```
-suppliers
-├── id              serial PK
-├── userId          FK → users.id
-├── code            Código interno
-├── name            Nome/Razão Social
-├── email, phone
-├── document        CNPJ/CPF
-└── createdAt, updatedAt
-```
-
-### 6.6 — products (Produtos)
-
-```
-products
-├── id              serial PK
-├── userId          FK → users.id
-├── code            Código/SKU
-├── name            Nome do produto
-├── description
-├── price           Decimal(10,2)
-├── costPrice       Preço de custo
-├── unit            UN | KG | M | L | CX | PC
-├── stock           Estoque atual
-├── minStock        Estoque mínimo
-├── groupId         Grupo de produto
-├── requiresSerialTracking  boolean
-├── trackingType    none | imei | serial
-└── createdAt, updatedAt
-```
-
-### 6.7 — sales_orders + sales_order_items
-
-```
-sales_orders
-├── id              serial PK
-├── userId          FK → users.id
-├── customerId      FK → customers.id
-├── orderNumber     Número do pedido
-├── status          draft | confirmed | delivered | cancelled
-├── total           Decimal(10,2)
-├── paymentMethod   dinheiro | cartao_credito | pix | boleto | prazo
-└── createdAt, updatedAt
-
-sales_order_items
-├── id              serial PK
-├── orderId         FK → sales_orders.id
-├── productId       FK → products.id
-├── quantity        integer
-├── unitPrice       Decimal(10,2)
-└── total           Decimal(10,2)
-```
-
-### 6.8 — purchase_orders + purchase_order_items
-
-```
-purchase_orders
-├── id              serial PK
-├── userId          FK → users.id
-├── supplierId      FK → suppliers.id
-├── orderNumber
-├── status          draft | confirmed | received | cancelled
-├── total           Decimal(10,2)
-└── createdAt, updatedAt
-
-purchase_order_items
-├── id              serial PK
-├── orderId         FK → purchase_orders.id
-├── productId       FK → products.id
-├── quantity, unitPrice, total
-```
-
-### 6.9 — persons + person_roles (Cadastro Unificado)
-
-```
-persons
-├── id              serial PK
-├── tenantId        FK → tenants.id
-├── fullName
-├── cpfCnpj
-├── email, phone
-├── address, city, state, zipCode
-├── type            company | individual
-└── notes, createdAt, updatedAt
-
-person_roles
-├── id              serial PK
-├── personId        FK → persons.id
-├── role            customer | supplier | employee | technician | partner
-└── isActive
-```
-
----
-
-## 7. Tabelas PostgreSQL — Módulo Varejo (Retail)
-
-### 7.1 — Estrutura Operacional
-
-```
-retail_stores           → Lojas físicas
-retail_warehouses       → Depósitos/Almoxarifados
-retail_payment_methods  → Formas de pagamento
-retail_sellers          → Vendedores
-retail_commission_plans → Planos de comissão
-retail_seller_goals     → Metas por vendedor
-retail_store_goals      → Metas por loja
-```
-
-### 7.2 — Estoque
-
-```
-stock_transfers         → Transferências entre depósitos
-stock_transfer_items    → Itens da transferência
-```
-
-### 7.3 — Dispositivos Móveis (Eletrônicos)
-
-```
-mobile_devices
-├── id              serial PK
-├── productId       FK → products.id
-├── imei            varchar (único)
-├── imei2           varchar (chip duplo)
-├── serial          Número de série
-├── status          em_estoque | vendido | locado | devolucao | avaliacao
-├── color, storage, ram
-├── purchasePrice, salePrice
-└── supplierId, createdAt
-
-device_evaluations      → Avaliação de aparelhos usados
-device_history          → Histórico completo do dispositivo
-```
-
-### 7.4 — PDV (Ponto de Venda)
-
-```
-pos_sessions            → Sessões de caixa (abertura/fechamento)
-pos_sales               → Vendas PDV
-pos_sale_items          → Itens das vendas PDV
-```
-
-### 7.5 — Planos de Pagamento
-
-```
-payment_plans           → Planos parcelados
-payment_plan_installments → Parcelas
-lease_payments          → Pagamentos de locação
-```
-
----
-
-## 8. API REST Completa (/api/soe/* = /api/erp/*)
-
-> O alias `/api/soe/*` é convertido automaticamente para `/api/erp/*`
-> no middleware do `server/erp/index.ts`.
-
-### 8.1 — Conexões ERP
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/connections` | Lista conexões do usuário |
-| POST | `/api/soe/connections` | Cria nova conexão |
-| POST | `/api/soe/connections/:id/test` | Testa conectividade |
-| DELETE | `/api/soe/connections/:id` | Remove conexão |
-
-### 8.2 — Tarefas ERP (Sync Jobs)
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/tasks` | Lista tarefas de sync |
-| POST | `/api/soe/tasks` | Cria nova tarefa |
-| POST | `/api/soe/tasks/:id/execute` | Executa tarefa manualmente |
-| DELETE | `/api/soe/tasks/:id` | Remove tarefa |
-| GET | `/api/soe/tasks/:id/executions` | Histórico de execuções |
-
-### 8.3 — Clientes
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/customers` | Lista clientes (paginado) |
-| POST | `/api/soe/customers` | Cria cliente |
-| PUT | `/api/soe/customers/:id` | Atualiza cliente |
-| DELETE | `/api/soe/customers/:id` | Exclui cliente |
-
-### 8.4 — Fornecedores
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/suppliers` | Lista fornecedores |
-| POST | `/api/soe/suppliers` | Cria fornecedor |
-| PUT | `/api/soe/suppliers/:id` | Atualiza |
-| DELETE | `/api/soe/suppliers/:id` | Exclui |
-
-### 8.5 — Pessoas (Cadastro Unificado)
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/persons` | Lista com filtro por role/search |
-| GET | `/api/soe/persons/:id` | Detalhe + roles |
-| POST | `/api/soe/persons` | Cria pessoa + roles |
-| PUT | `/api/soe/persons/:id` | Atualiza pessoa + roles |
-| DELETE | `/api/soe/persons/:id` | Exclui pessoa (cascade roles) |
-
-### 8.6 — Produtos
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/products` | Lista produtos |
-| POST | `/api/soe/products` | Cria produto |
-| PUT | `/api/soe/products/:id` | Atualiza |
-| DELETE | `/api/soe/products/:id` | Exclui |
-| GET | `/api/soe/products/:id/devices` | Dispositivos do produto |
-| POST | `/api/soe/products/:id/devices/batch` | Import batch de IMEIs |
-| GET | `/api/soe/products/:id/stock-count` | Contagem de estoque |
-
-### 8.7 — Pedidos de Venda
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/sales-orders` | Lista pedidos |
-| POST | `/api/soe/sales-orders` | Cria pedido (com itens) |
-| POST | `/api/soe/sales-orders/:id/confirm` | Confirma pedido |
-| POST | `/api/soe/sales-orders/:id/generate-nfe` | Gera NF-e |
-| DELETE | `/api/soe/sales-orders/:id` | Cancela/Exclui |
-
-### 8.8 — Pedidos de Compra
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/purchase-orders` | Lista pedidos |
-| POST | `/api/soe/purchase-orders` | Cria pedido |
-| DELETE | `/api/soe/purchase-orders/:id` | Exclui |
-
-### 8.9 — Dados e Configuração
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/stats` | Dashboard — totais de clientes/produtos/pedidos/receita |
-| GET | `/api/soe/data/:connectionId/:dataType` | Dados via conexão ERP |
-| GET | `/api/soe/segments` | Lista segmentos |
-| POST | `/api/soe/segments` | Cria segmento |
-| POST | `/api/soe/segments/seed` | Popula segmentos padrão |
-| GET | `/api/soe/config` | Configuração da empresa |
-| POST | `/api/soe/config` | Salva configuração |
-
-### 8.10 — Módulos do Tenant
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/api/soe/tenant/modules` | Módulos ativos do tenant atual |
-| PUT | `/api/soe/tenant/modules` | Ativa/desativa módulos |
-
----
-
-## 9. API REST — Módulo Varejo (/api/retail/*)
-
-### 9.1 — Estrutura Operacional
-
-| Módulo | Endpoints | Operações |
-|--------|-----------|-----------|
-| Activity Feed | `/activity-feed` | GET, mark-read |
-| Payment Methods | `/payment-methods` | CRUD |
-| Sellers | `/sellers` | CRUD |
-| Commission Plans | `/commission-plans` | CRUD |
-| Price Tables | `/price-tables` | CRUD |
-| Promotions | `/promotions` | CRUD |
-| Product Types | `/product-types` | CRUD + detail |
-| Stores | `/stores` | CRU |
-| Warehouses | `/warehouses` | CRUD |
-
-### 9.2 — Estoque
-
-| Módulo | Endpoints | Operações |
-|--------|-----------|-----------|
-| Warehouse Stock | `/warehouse-stock` | GET list + summary |
-| Stock Movements | `/stock-movements` | GET + POST |
-| Product Serials | `/product-serials` | CRUD |
-| Stock Transfers | `/stock-transfers` | CRUD + status |
-| Stock Alerts | `/stock-alerts` | GET |
-| Inventories | `/inventories` | CRUD + count + apply |
-
-### 9.3 — Dispositivos (Mobile/Eletrônicos)
-
-| Módulo | Endpoints | Operações |
-|--------|-----------|-----------|
-| Devices | `/devices` | CRUD + IMEI lookup |
-| Evaluations | `/evaluations` | CRUD + approve + reject |
-
-### 9.4 — Serviços
-
-| Módulo | Endpoints | Operações |
-|--------|-----------|-----------|
-| Service Orders | `/service-orders` | CRUD + complete-preparation + items |
-| Warranties | `/warranties` | CRUD + check IMEI + claim |
-
-### 9.5 — PDV
-
-| Módulo | Endpoints | Operações |
-|--------|-----------|-----------|
-| POS Sessions | `/pos-sessions` | GET + open + close |
-| Cash Movements | `/cash-movements` | GET + POST |
-
-### 9.6 — Relatórios
-
-| Endpoint | Descrição |
-|----------|-----------|
-| `/reports/os-by-status` | OS agrupadas por status |
-| `/reports/os-by-technician` | OS agrupadas por técnico |
-
-**Total: ~120 endpoints no módulo SOE (Core + Retail)**
-
----
-
-## 10. Dependências Externas do SOE
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    DEPENDÊNCIAS DO SOE                               │
-│                                                                      │
-│  ┌──── Arcádia Plus (Laravel) ────────────────────────────────┐    │
-│  │  Host: :8080 (mesmo servidor) ou externo                   │    │
-│  │  Env: PLUS_URL (se externo)                                │    │
-│  │  Proxy: /plus/* → :8080                                   │    │
-│  │  SSO: token compartilhado via plus/sso.ts                  │    │
-│  │  Sync: retail/plus-sync.ts + retail/sync-service.ts       │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌──── ERPNext/Frappe ─────────────────────────────────────────┐   │
-│  │  Host: ERPNEXT_URL (env var no servidor)                    │   │
-│  │  Auth: ERPNEXT_API_KEY + ERPNEXT_API_SECRET                 │   │
-│  │  Entidades: Customer, Supplier, Item, Sales Order           │   │
-│  │  Rotas: server/erpnext/routes.ts → /api/erpnext/*          │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌──── Arcádia Fisco (:8002) ──────────────────────────────────┐   │
-│  │  Geração de NF-e a partir do pedido de venda               │   │
-│  │  POST /api/soe/sales-orders/:id/generate-nfe               │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌──── PostgreSQL ─────────────────────────────────────────────┐   │
-│  │  DATABASE_URL env var                                       │   │
-│  │  Motor padrão (nativo) sem Plus/ERPNext                     │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 11. Variáveis de Ambiente Necessárias para Deploy
-
-```bash
-# PostgreSQL (obrigatório)
-DATABASE_URL=postgresql://user:pass@host:5432/arcadia
-
-# ERPNext (opcional — apenas se motor = "erpnext")
-ERPNEXT_URL=https://seu-erpnext.com
-ERPNEXT_API_KEY=sua-chave
-ERPNEXT_API_SECRET=seu-secret
-
-# Arcádia Plus (opcional — apenas se motor = "plus")
-PLUS_URL=http://localhost:8080    # ou URL externa do Plus
-
-# Fisco (para geração de NF-e via SOE)
-FISCO_URL=http://localhost:8002   # ou URL externa do Fisco
-```
-
----
-
-## 12. Checklist de Export para Deploy Manual
-
-### Frontend
-- [ ] `client/src/pages/SOE.tsx`
-- [ ] `client/src/pages/ERP.tsx`
-- [ ] `client/src/contexts/SoeMotorContext.tsx`
-- [ ] `client/src/contexts/ErpProfileContext.tsx`
-
-### Backend
-- [ ] `server/erp/routes.ts`
-- [ ] `server/erp/index.ts`
-- [ ] `server/retail/routes.ts`
-- [ ] `server/retail/index.ts`
-- [ ] `server/retail/sync-service.ts`
-- [ ] `server/retail/plus-sync.ts`
-- [ ] `server/plus/client.ts`
-- [ ] `server/plus/routes.ts`
-- [ ] `server/plus/proxy.ts`
-- [ ] `server/plus/launcher.ts`
-- [ ] `server/plus/sso.ts`
-- [ ] `server/erpnext/routes.ts`
-- [ ] `server/erpnext/index.ts`
-
-### Schema e Banco
-- [ ] `shared/schema.ts` (tabelas: L348, L3303–3517, L5082–5617, L6204)
-- [ ] Rodar `drizzle-kit push` no servidor para criar as tabelas
-- [ ] Verificar variável `DATABASE_URL` no servidor
-
-### Configuração do Servidor
-- [ ] `.env` com `DATABASE_URL` (obrigatório)
-- [ ] `.env` com `ERPNEXT_*` (se usar motor ERPNext)
-- [ ] `.env` com `PLUS_URL` (se usar motor Plus)
-- [ ] Confirmar que `:8080` (Plus) está acessível se necessário
-
----
-
-## 13. Resumo Visual do Módulo
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    ARCÁDIA SOE — STACK COMPLETO                      │
-│                                                                      │
-│  URL /soe → SOE.tsx (2.414L)                                        │
-│                                                                      │
-│  9 Abas: Dashboard │ Pessoas │ Produtos │ Vendas │ Compras           │
-│          Financeiro │ CRM    │ Sync     │ Config                     │
-│                                                                      │
-│  ┌─── Motor (Adapter) ────────────────────────────────────────┐    │
-│  │  localStorage["arcadia_soe_motor"] = "plus" | "erpnext"   │    │
-│  │                                                             │    │
-│  │  plus    → /plus/api/*  → Arcádia Plus :8080 (Laravel)    │    │
-│  │  erpnext → ERPNext API  → ERPNEXT_URL externo             │    │
-│  │  nativo  → /api/soe/*  → PostgreSQL local (Drizzle)       │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌─── Backend ────────────────────────────────────────────────┐    │
-│  │  /api/soe/* → /api/erp/*  (alias automático)              │    │
-│  │  server/erp/routes.ts (1.343L) → 35+ endpoints core       │    │
-│  │  server/retail/routes.ts (5.218L) → 85+ endpoints varejo  │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌─── Banco de Dados ─────────────────────────────────────────┐    │
-│  │  Core: customers, suppliers, products, sales_orders,        │    │
-│  │        purchase_orders, persons, erp_config, erp_segments   │    │
-│  │                                                             │    │
-│  │  Retail: retail_stores, retail_warehouses, mobile_devices,  │    │
-│  │          device_evaluations, pos_sessions, pos_sales,        │    │
-│  │          stock_transfers, payment_plans (20+ tabelas)       │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌─── Integrações ────────────────────────────────────────────┐    │
-│  │  Arcádia Plus :8080 │ ERPNext/Frappe │ Fisco :8002         │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-└─────────────────────────────────────────────────────────────────────┘
-```

docs/MAPA_TENANTS_ARCADIA.md

@@ -1,812 +0,0 @@
-# Arcádia Tenants — Mapa Completo da Gestão Multi-Tenant
-
-> Mapa da arquitetura multi-tenant da Arcádia Suite: hierarquia
-> Master/Parceiro/Cliente, sistema de planos, ativação de módulos,
-> empresas (Matriz/Filiais), comissões de parceiros, controle de acesso,
-> e middleware de isolamento.
-> Atualizado em: Março 2026
-
----
-
-## 1. Visão Geral
-
-A Arcádia Suite opera em modelo **multi-tenant hierárquico** com três níveis. Cada tenant possui um plano que define quais módulos da plataforma estão habilitados, e pode conter múltiplas empresas (CNPJ) para operações fiscais.
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                      HIERARQUIA DE TENANTS                           │
-│                                                                      │
-│                    ┌──────────────┐                                  │
-│                    │   MASTER     │  ← Operador da plataforma        │
-│                    │              │  ← Vê tudo, controla tudo        │
-│                    │  tenantType: │  ← Pode criar parceiros          │
-│                    │  "master"    │  ← Pode excluir tenants          │
-│                    └──────┬───────┘                                  │
-│                           │                                          │
-│              ┌────────────┼────────────┐                            │
-│              ▼            ▼            ▼                            │
-│     ┌──────────────┐ ┌──────────────┐ ┌──────────────┐             │
-│     │  PARCEIRO A  │ │  PARCEIRO B  │ │  PARCEIRO C  │             │
-│     │              │ │              │ │              │             │
-│     │ tenantType:  │ │ Consultorias │ │ Integradores │             │
-│     │ "partner"    │ │ Revendas     │ │ Franquias    │             │
-│     │              │ │              │ │              │             │
-│     │ partnerCode: │ │ comissão: %  │ │ plano:       │             │
-│     │ "PARC-001"   │ │ sobre clientes│ │partner_pro  │             │
-│     └──────┬───────┘ └──────┬───────┘ └──────┬───────┘             │
-│            │                │                │                      │
-│       ┌────┴────┐      ┌───┴───┐        ┌───┴───┐                 │
-│       ▼         ▼      ▼       ▼        ▼       ▼                 │
-│   ┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐   │
-│   │Cliente1││Cliente2││Cliente3││Cliente4││Cliente5││Cliente6│   │
-│   │        ││        ││        ││        ││        ││        │   │
-│   │tenant  ││tenant  ││tenant  ││tenant  ││tenant  ││tenant  │   │
-│   │Type:   ││Type:   ││Type:   ││Type:   ││Type:   ││Type:   │   │
-│   │"client"││"client"││"client"││"client"││"client"││"client"│   │
-│   │        ││        ││        ││        ││        ││        │   │
-│   │parent: ││parent: ││parent: ││parent: ││parent: ││parent: │   │
-│   │Parc.A  ││Parc.A  ││Parc.B  ││Parc.B  ││Parc.C  ││Parc.C  │   │
-│   │        ││        ││        ││        ││        ││        │   │
-│   │Plano:  ││Plano:  ││Plano:  ││Plano:  ││Plano:  ││Plano:  │   │
-│   │starter ││pro     ││free    ││enterpr.││starter ││pro     │   │
-│   └────────┘└────────┘└────────┘└────────┘└────────┘└────────┘   │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
-### Visibilidade por tipo:
-
-| Tipo | Vê | Cria | Exclui |
-|------|-----|------|--------|
-| **Master** | Todos os tenants | Parceiros e Clientes | Qualquer (exceto master) |
-| **Partner** | Seu tenant + seus clientes | Apenas clientes vinculados | Nenhum |
-| **Client** | Apenas seu próprio tenant | Nenhum | Nenhum |
-
----
-
-## 2. Banco de Dados — Tabelas de Tenant
-
-### 2.1 — tenants (Tabela Principal)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  tenants                                                          │
-│  Tabela: "tenants" — shared/schema.ts:849                        │
-│                                                                   │
-│  ┌─────────── Identificação ──────────────────┐                  │
-│  │ id              serial PK                   │                  │
-│  │ name            text NOT NULL                │                  │
-│  │ slug            text UNIQUE                  │                  │
-│  │ email           text                         │                  │
-│  │ phone           text                         │                  │
-│  │ logoUrl         text                         │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Hierarquia ─────────────────────┐                  │
-│  │ tenantType      "master" | "partner" |      │                  │
-│  │                 "client"                     │                  │
-│  │ parentTenantId  integer (self-ref FK)        │                  │
-│  │ partnerCode     text (código único parceiro) │                  │
-│  │ commissionRate  numeric(5,2) (% comissão)    │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Plano e Limites ────────────────┐                  │
-│  │ plan            "free" | "starter" | "pro"  │                  │
-│  │                 | "enterprise" |            │                  │
-│  │                 "partner_starter" |          │                  │
-│  │                 "partner_pro"                │                  │
-│  │ status          "active" | "trial" |        │                  │
-│  │                 "suspended" | "cancelled"   │                  │
-│  │ maxUsers        integer (default 5)          │                  │
-│  │ maxStorageMb    integer (default 1000)        │                  │
-│  │ features        JSONB → TenantFeatures       │  ← Módulos      │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Billing ────────────────────────┐                  │
-│  │ billingEmail    text                         │                  │
-│  │ trialEndsAt     timestamp                    │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Dados Empresariais ─────────────┐                  │
-│  │ cnpj            text                         │                  │
-│  │ tradeName       text                         │                  │
-│  │ address         text                         │                  │
-│  │ city, state     text                         │                  │
-│  │ segment         text                         │                  │
-│  │ notes, source   text                         │                  │
-│  │ commercialContact / commercialPhone          │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Metadata ───────────────────────┐                  │
-│  │ settings        text (JSON config)           │                  │
-│  │ createdAt       timestamp                    │                  │
-│  │ updatedAt       timestamp                    │                  │
-│  └─────────────────────────────────────────────┘                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.2 — TenantFeatures (JSONB — Sistema de Módulos)
-
-O campo `features` na tabela `tenants` é um JSONB que controla **quais módulos da Arcádia estão habilitados** para cada tenant. O tipo é definido em `shared/schema.ts:821` e espelhado no frontend em `client/src/hooks/use-tenant-features.ts:3`.
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  TenantFeatures (JSONB)                                           │
-│                                                                   │
-│  ┌─────────── Módulos Booleanos ──────────────┐                  │
-│  │                                             │                  │
-│  │  ide           → IDE integrada              │                  │
-│  │  whatsapp      → WhatsApp multi-sessão      │                  │
-│  │  crm           → CRM completo               │                  │
-│  │  erp           → SOE/ERP                     │                  │
-│  │  bi            → Business Intelligence       │                  │
-│  │  manus         → IA Manus (GPT-4o)          │                  │
-│  │  centralApis   → APIs centrais              │                  │
-│  │  centralApisManage → Gerenciar APIs          │                  │
-│  │  comunidades   → Chat interno               │                  │
-│  │  biblioteca    → Biblioteca de conhecimento  │                  │
-│  │  bibliotecaPublish → Publicar na biblioteca  │                  │
-│  │  suporteN3     → Suporte nível 3            │                  │
-│  │  retail        → Módulo Varejo              │                  │
-│  │  plus          → ERP Plus (Laravel)          │                  │
-│  │  fisco         → Motor Fiscal               │                  │
-│  │  cockpit       → Cockpit executivo          │                  │
-│  │  compass       → Process Compass            │                  │
-│  │  production    → Módulo Produção            │                  │
-│  │  support       → Módulo Suporte             │                  │
-│  │  xosCrm        → XOS CRM (Kanban)           │                  │
-│  │                                             │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Configurações Numéricas ────────┐                  │
-│  │                                             │                  │
-│  │  whatsappSessions  → Nº sessões WA (0-N)   │                  │
-│  │  maxChannels       → Nº canais permitidos   │                  │
-│  │                                             │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Configurações de Texto ─────────┐                  │
-│  │                                             │                  │
-│  │  ideMode       → "none" | "no-code" |       │                  │
-│  │                  "low-code" | "pro-code"    │                  │
-│  │  manusTools[]  → Lista de tools habilitadas │                  │
-│  │                                             │                  │
-│  └─────────────────────────────────────────────┘                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.3 — tenant_empresas (Matriz/Filiais)
-
-Cada tenant pode ter **múltiplas empresas** (CNPJs) cadastradas — essencial para operações fiscais (NF-e/NFC-e) por filial.
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  tenant_empresas                                                  │
-│  Tabela: "tenant_empresas" — shared/schema.ts:889                │
-│                                                                   │
-│  ┌─────────── Identificação ──────────────────┐                  │
-│  │ id              serial PK                   │                  │
-│  │ tenantId        FK → tenants.id (CASCADE)   │                  │
-│  │ razaoSocial     text NOT NULL                │                  │
-│  │ nomeFantasia    text                         │                  │
-│  │ cnpj            text NOT NULL                │                  │
-│  │ ie              text (inscrição estadual)    │                  │
-│  │ im              text (inscrição municipal)   │                  │
-│  │ email, phone    text                         │                  │
-│  │ tipo            "matriz" | "filial"          │                  │
-│  │ status          "active" | "inactive"        │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Endereço ───────────────────────┐                  │
-│  │ cep, logradouro, numero, complemento,      │                  │
-│  │ bairro, cidade, uf, codigoIbge             │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Fiscal ─────────────────────────┐                  │
-│  │ regimeTributario  "simples" | "presumido"   │                  │
-│  │                   | "real"                  │                  │
-│  │ certificadoDigitalId  FK certificado        │                  │
-│  │ ambienteFiscal  "producao" | "homologacao"  │                  │
-│  │ serieNfe        integer (default 1)          │                  │
-│  │ serieNfce       integer (default 1)          │                  │
-│  │ plusEmpresaId   integer (link ERP Plus)      │                  │
-│  └─────────────────────────────────────────────┘                  │
-│                                                                   │
-│  ┌─────────── Metadata ───────────────────────┐                  │
-│  │ createdAt, updatedAt  timestamp              │                  │
-│  └─────────────────────────────────────────────┘                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-**Uso típico:**
-
-```
-Tenant "Empresa ABC" (id: 5)
-├── Empresa Matriz: "ABC Comércio LTDA" (CNPJ: 12.345.678/0001-00)
-│   regime: simples, ambiente: producao, série NF-e: 1
-├── Filial SP: "ABC Comércio SP" (CNPJ: 12.345.678/0002-81)
-│   regime: simples, ambiente: producao, série NF-e: 2
-└── Filial RJ: "ABC Comércio RJ" (CNPJ: 12.345.678/0003-62)
-    regime: simples, ambiente: homologacao, série NF-e: 1
-```
-
-### 2.4 — tenant_users (Membership)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  tenant_users                                                     │
-│  Tabela: "tenant_users" — shared/schema.ts:923                   │
-│                                                                   │
-│  id           serial PK                                           │
-│  tenantId     FK → tenants.id (CASCADE)                           │
-│  userId       FK → users.id (CASCADE)                             │
-│  role         "owner" | "admin" | "member"                        │
-│  isOwner      "true" | "false"                                    │
-│  createdAt    timestamp                                           │
-│                                                                   │
-│  → Link N:N entre users e tenants                                 │
-│  → Um usuário pode pertencer a múltiplos tenants                  │
-│  → Cada tenant tem um owner + admins + members                    │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.5 — tenant_plans (Planos Disponíveis)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  tenant_plans                                                     │
-│  Tabela: "tenant_plans" — shared/schema.ts:933                   │
-│                                                                   │
-│  id            serial PK                                          │
-│  code          text UNIQUE ("free", "starter", "pro",             │
-│                "enterprise", "partner_starter", "partner_pro")    │
-│  name          text NOT NULL                                      │
-│  description   text                                               │
-│  tenantType    "master" | "partner" | "client"                    │
-│  maxUsers      integer (default 5)                                │
-│  maxStorageMb  integer (default 1000)                             │
-│  features      JSONB → TenantFeatures                             │
-│  monthlyPrice  integer (centavos)                                 │
-│  yearlyPrice   integer (centavos)                                 │
-│  trialDays     integer (default 14)                               │
-│  isActive      "true" | "false"                                   │
-│  sortOrder     integer                                            │
-│  createdAt     timestamp                                          │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.6 — partner_clients (Relacionamento Parceiro↔Cliente)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  partner_clients                                                  │
-│  Tabela: "partner_clients" — shared/schema.ts:951                │
-│                                                                   │
-│  id              serial PK                                        │
-│  partnerId       FK → tenants.id (CASCADE)                        │
-│  clientId        FK → tenants.id (CASCADE)                        │
-│  commissionRate  numeric(5,2) — Override do rate do parceiro      │
-│  status          "active" | "suspended" | "ended"                 │
-│  notes           text                                             │
-│  startedAt       timestamp                                        │
-│  endedAt         timestamp                                        │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-### 2.7 — partner_commissions (Comissões dos Parceiros)
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  partner_commissions                                              │
-│  Tabela: "partner_commissions" — shared/schema.ts:963            │
-│                                                                   │
-│  id               serial PK                                       │
-│  partnerId        FK → tenants.id (CASCADE)                       │
-│  clientId         FK → tenants.id (CASCADE)                       │
-│  referenceMonth   text ("2026-01", "2026-02", ...)                │
-│  clientPlanCode   text (código do plano do cliente)                │
-│  clientPlanValue  integer (valor do plano em centavos)             │
-│  commissionRate   numeric(5,2) NOT NULL                           │
-│  commissionValue  integer NOT NULL (valor em centavos)             │
-│  status           "pending" | "approved" | "paid" | "cancelled"   │
-│  approvedAt       timestamp                                       │
-│  paidAt           timestamp                                       │
-│  paymentReference text                                            │
-│  createdAt        timestamp                                       │
-│                                                                   │
-│  Fluxo: pending → approved → paid                                 │
-│                                                                   │
-│  Exemplo:                                                         │
-│  Parceiro A tem Cliente X no plano "pro" (R$ 299/mês)            │
-│  commissionRate: 20%                                              │
-│  commissionValue: 5980 centavos (R$ 59,80)                        │
-└──────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 3. Planos Pré-definidos (Seed)
-
-A rota `POST /api/admin/plans/seed` cria os 6 planos padrão:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                        PLANOS PARA CLIENTES                          │
-├────────────┬──────────┬──────────┬──────────────────────────────────┤
-│ Plano      │ Preço/mês│ Usuários │ Módulos                          │
-├────────────┼──────────┼──────────┼──────────────────────────────────┤
-│ Gratuito   │ R$ 0     │ 2        │ erp, crm                         │
-│ (free)     │          │          │                                  │
-├────────────┼──────────┼──────────┼──────────────────────────────────┤
-│ Starter    │ R$ 99    │ 5        │ erp, crm, bi, fisco,             │
-│            │          │          │ whatsapp, compass                │
-├────────────┼──────────┼──────────┼──────────────────────────────────┤
-│ Pro        │ R$ 299   │ 15       │ erp, crm, bi, fisco, retail,     │
-│            │          │          │ plus, whatsapp, manus, cockpit,  │
-│            │          │          │ compass, support, biblioteca     │
-├────────────┼──────────┼──────────┼──────────────────────────────────┤
-│ Enterprise │ R$ 999   │ 100      │ TODOS os módulos                 │
-│            │          │ 50GB     │ (erp, crm, bi, fisco, retail,    │
-│            │          │          │ plus, whatsapp, manus, ide,      │
-│            │          │          │ cockpit, compass, production,    │
-│            │          │          │ support, xosCrm, centralApis,    │
-│            │          │          │ comunidades, biblioteca)         │
-└────────────┴──────────┴──────────┴──────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────────┐
-│                       PLANOS PARA PARCEIROS                          │
-├──────────────────┬──────────┬──────────┬────────────────────────────┤
-│ Plano            │ Preço/mês│ Usuários │ Módulos                    │
-├──────────────────┼──────────┼──────────┼────────────────────────────┤
-│ Parceiro Starter │ R$ 199   │ 10       │ erp, crm, bi, fisco,       │
-│                  │          │          │ retail, whatsapp, compass,  │
-│                  │          │          │ support                    │
-├──────────────────┼──────────┼──────────┼────────────────────────────┤
-│ Parceiro Pro     │ R$ 499   │ 50       │ TODOS os módulos           │
-│                  │          │ 25GB     │ (igual Enterprise)         │
-└──────────────────┴──────────┴──────────┴────────────────────────────┘
-```
-
----
-
-## 4. Sistema de Papéis (Roles)
-
-A Arcádia opera com **dois níveis de papéis** que se complementam:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                    SISTEMA DUPLO DE ROLES                            │
-│                                                                      │
-│  ┌─────────── Papel do Sistema (users.role) ──────────────────┐    │
-│  │                                                             │    │
-│  │  "master"  → Superadmin, acesso total, bypass de tenant    │    │
-│  │  "admin"   → Administrador, acessa /api/admin/*            │    │
-│  │  "user"    → Usuário padrão, sem acesso admin              │    │
-│  │                                                             │    │
-│  │  Verificado no middleware global de admin:                  │    │
-│  │  if (role !== "admin" && role !== "master") → 403           │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  ┌─────────── Papel no Tenant (tenant_users.role) ────────────┐    │
-│  │                                                             │    │
-│  │  "owner"   → Dono do tenant, criador, full control         │    │
-│  │  "admin"   → Administrador do tenant                       │    │
-│  │  "member"  → Membro comum, acesso operacional              │    │
-│  │                                                             │    │
-│  │  Usado para scoping de dados e permissões intra-tenant     │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                                                                      │
-│  Combinação no login (getEnrichedUser):                              │
-│  user.role + user.tenantId + user.tenantType + user.tenantRole       │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 5. Controle de Acesso — Helpers
-
-O backend implementa dois helpers essenciais em `server/admin/routes.ts`:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  getAllowedTenantIds(user)                                            │
-│                                                                      │
-│  Retorna os IDs de tenants que o usuário pode acessar:              │
-│                                                                      │
-│  • master      → null (acesso total, sem filtro)                    │
-│  • partner     → [seu tenantId, ...clientIds vinculados]            │
-│  • client      → [apenas seu tenantId]                              │
-│                                                                      │
-│  Usado em: GET /tenants, GET /partner-clients, GET /commissions,    │
-│  GET /empresas, GET /tenants/hierarchy                               │
-└─────────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────────┐
-│  canAccessTenant(user, tenantId)                                     │
-│                                                                      │
-│  Verifica se o usuário pode operar sobre um tenant específico:      │
-│                                                                      │
-│  • master → true (sempre)                                            │
-│  • partner → true se tenantId ∈ getAllowedTenantIds()               │
-│  • client → true apenas se tenantId === user.tenantId               │
-│                                                                      │
-│  Usado em: PATCH /tenants/:id, DELETE /empresas/:id,                │
-│  POST /empresas, etc.                                                │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 6. Middleware de Módulos (requireModule)
-
-O middleware `requireModule` em `server/retail/routes.ts:25` bloqueia endpoints quando um módulo não está ativo para o tenant:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  requireModule(moduleKey: keyof TenantFeatures)                      │
-│                                                                      │
-│  Fluxo:                                                              │
-│  1. Identifica tenantId do usuário logado                           │
-│  2. Busca tenant no banco                                            │
-│  3. Verifica features[moduleKey] === true                            │
-│  4. Se false → 403 com mensagem:                                    │
-│     {                                                                │
-│       error: "Módulo 'X' não está ativo para este tenant",          │
-│       moduleKey: "plus",                                             │
-│       action: "Ative o módulo em Admin → Módulos"                   │
-│     }                                                                │
-│                                                                      │
-│  Exemplo de uso:                                                     │
-│  router.post("/plus/sync/customers",                                │
-│    requireModule("plus"),     ← Bloqueia se Plus não está ativo     │
-│    async (req, res) => { ... }                                      │
-│  );                                                                  │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 7. Hook Frontend (useTenantFeatures)
-
-O hook `useTenantFeatures()` em `client/src/hooks/use-tenant-features.ts` fornece acesso às features do tenant no frontend:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  useTenantFeatures()                                                 │
-│                                                                      │
-│  Fonte: GET /api/soe/tenant/modules                                 │
-│  Cache: 60 segundos (staleTime: 60000)                              │
-│                                                                      │
-│  Retorna:                                                            │
-│  {                                                                   │
-│    features: TenantFeatures,  ← Objeto completo de features         │
-│    isLoading: boolean,                                               │
-│    plan: string,              ← Código do plano atual                │
-│    isEnabled: (key) => bool,  ← Verificação rápida                  │
-│  }                                                                   │
-│                                                                      │
-│  Defaults (quando não logado / sem tenant):                         │
-│  ide: true, crm: true, erp: true, manus: true, compass: true       │
-│  Todos os demais: false                                              │
-│                                                                      │
-│  Uso no componente:                                                  │
-│  const { isEnabled } = useTenantFeatures();                          │
-│  if (isEnabled("bi")) { /* mostra menu BI */ }                      │
-│  if (isEnabled("retail")) { /* mostra módulo varejo */ }            │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 8. Interface de Administração
-
-### 8.1 — Admin.tsx (Página Principal)
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  Admin.tsx — client/src/pages/Admin.tsx (2.635 linhas)               │
-│  Rota: /admin                                                        │
-│                                                                      │
-│  6 Abas:                                                             │
-│  ┌─────────────┬──────────┬────────────┬───────────┬──────────────┐ │
-│  │ Conexões    │ Tarefas  │ Knowledge  │ Bibliotecas│ Módulos     │ │
-│  │             │          │            │            │             │ │
-│  │ WhatsApp    │ Dev      │ Knowledge  │ Conteúdo   │ Ativação    │ │
-│  │ ERPNext     │ Center   │ Graph      │ Docs       │ por tenant  │ │
-│  │ APIs        │ Pipeline │ Q&A        │ Templates  │ Toggle on/  │ │
-│  │             │          │            │            │ off módulos │ │
-│  └─────────────┴──────────┴────────────┴───────────┴──────────────┘ │
-│  ┌─────────────┐                                                     │
-│  │Casa de      │                                                     │
-│  │Máquinas     │                                                     │
-│  │             │                                                     │
-│  │ Status dos  │                                                     │
-│  │ motores     │                                                     │
-│  │ (:8002-8006)│                                                     │
-│  └─────────────┘                                                     │
-│                                                                      │
-│  Aba "Módulos" renderiza: <MultiTenantSection />                    │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
-### 8.2 — MultiTenantSection (Gestão Completa)
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  MultiTenantSection.tsx (1.486 linhas)                               │
-│  client/src/components/MultiTenantSection.tsx                        │
-│                                                                      │
-│  4 Abas internas:                                                    │
-│                                                                      │
-│  ┌─ Tenants ──────────────────────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  Lista de tenants com:                                      │     │
-│  │  • Nome, tipo (Master/Parceiro/Cliente)                    │     │
-│  │  • Plano atual e status                                     │     │
-│  │  • Nº de filhos (childCount)                                │     │
-│  │  • Tenant pai (parentTenant)                                │     │
-│  │  • Ações: Editar, Ativar/Desativar módulos                 │     │
-│  │                                                             │     │
-│  │  Formulário de criação:                                     │     │
-│  │  • Nome, email, phone                                       │     │
-│  │  • Tipo (master/partner/client)                             │     │
-│  │  • Plano (seleciona do tenant_plans)                        │     │
-│  │  • Tenant pai (para hierarquia)                             │     │
-│  │  • Features auto-preenchidas pelo plano selecionado        │     │
-│  │  • Toggle individual de cada módulo                        │     │
-│  │                                                             │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌─ Planos ───────────────────────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  CRUD de planos com:                                        │     │
-│  │  • Código, nome, descrição                                  │     │
-│  │  • Tipo de tenant (client/partner)                          │     │
-│  │  • Preço mensal e anual (centavos)                          │     │
-│  │  • Max usuários e storage                                   │     │
-│  │  • Features (toggle de cada módulo)                         │     │
-│  │  • Botão "Seed" para criar planos padrão                   │     │
-│  │  • Botão "Propagar" para aplicar features do plano          │     │
-│  │    a todos os tenants que usam esse plano                   │     │
-│  │                                                             │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌─ Comissões ────────────────────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  Lista de comissões de parceiros:                           │     │
-│  │  • Parceiro, Cliente, Mês referência                        │     │
-│  │  • Valor do plano, taxa de comissão, valor da comissão     │     │
-│  │  • Status (pending → approved → paid)                      │     │
-│  │  • Ações: Aprovar, Marcar como paga                        │     │
-│  │                                                             │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-│                                                                      │
-│  ┌─ Empresas ─────────────────────────────────────────────────┐     │
-│  │                                                             │     │
-│  │  EmpresasSubSection:                                        │     │
-│  │  • Lista de empresas (Matriz/Filiais) por tenant            │     │
-│  │  • CNPJ, Razão Social, Nome Fantasia                        │     │
-│  │  • IE, IM, Regime Tributário                                │     │
-│  │  • Endereço completo (CEP, logradouro, cidade, UF)         │     │
-│  │  • Config Fiscal (ambiente, série NF-e, série NFC-e)       │     │
-│  │  • Link com ERP Plus (plusEmpresaId)                        │     │
-│  │  • Ações: Criar, Editar, Excluir                           │     │
-│  │                                                             │     │
-│  └─────────────────────────────────────────────────────────────┘     │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 9. API REST Completa (/api/admin/*)
-
-### Tenants
-
-| Método | Endpoint | Função | Acesso |
-|--------|----------|--------|--------|
-| GET | `/tenants` | Lista tenants (filtrado por acesso) | master/partner/client |
-| POST | `/tenants` | Cria tenant (resolve features do plano) | master/admin |
-| PATCH | `/tenants/:id` | Atualiza tenant (canAccessTenant) | master/partner |
-| DELETE | `/tenants/:id` | Exclui tenant (proteção master) | somente master |
-| GET | `/tenants/hierarchy` | Árvore hierárquica de tenants | master/partner |
-| GET | `/tenants/stats` | Estatísticas (total, por tipo, por status) | master/admin |
-
-### Planos
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/plans` | Lista todos os planos |
-| POST | `/plans` | Cria novo plano |
-| PATCH | `/plans/:id` | Atualiza plano |
-| DELETE | `/plans/:id` | Exclui plano |
-| POST | `/plans/:id/propagate` | Propaga features do plano para todos os tenants que o usam |
-| POST | `/plans/seed` | Cria 6 planos padrão |
-
-### Parceiro-Cliente
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/partner-clients` | Lista relacionamentos parceiro↔cliente |
-| POST | `/partner-clients` | Cria vínculo parceiro↔cliente |
-
-### Comissões de Parceiros
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/commissions` | Lista comissões (filtro por partnerId, status) |
-| PATCH | `/commissions/:id/approve` | Aprova comissão |
-| PATCH | `/commissions/:id/pay` | Marca como paga |
-
-### Empresas (Matriz/Filiais)
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/empresas` | Lista empresas (filtro por tenantId + acesso) |
-| GET | `/empresas/:id` | Detalhe da empresa |
-| POST | `/empresas` | Cria empresa (verifica canAccessTenant) |
-| PATCH | `/empresas/:id` | Atualiza empresa |
-| DELETE | `/empresas/:id` | Exclui empresa |
-
-### Outros Admin
-
-| Método | Endpoint | Função |
-|--------|----------|--------|
-| GET | `/profiles` | Lista perfis de usuários |
-| POST | `/profiles` | Cria perfil |
-| PATCH | `/profiles/:id` | Atualiza perfil |
-| DELETE | `/profiles/:id` | Exclui perfil |
-| GET | `/users` | Lista usuários (com tenant info) |
-| PATCH | `/users/:id` | Atualiza usuário |
-| PATCH | `/users/:id/status` | Altera status do usuário |
-| PATCH | `/partners/:id/status` | Altera status de parceiro |
-| PATCH | `/clients/:id/status` | Altera status de cliente |
-| GET | `/stats` | Estatísticas gerais (tenants, users, leads) |
-| GET | `/libraries` | Lista bibliotecas de conteúdo |
-
-**Total: 33 endpoints de administração**
-
----
-
-## 10. Fluxo Completo — Onboarding de Tenant
-
-```
-┌──────────┐    ┌────────────┐    ┌──────────────┐    ┌──────────────┐
-│  1. CRIAR │───▶│ 2. PLANO   │───▶│ 3. FEATURES  │───▶│ 4. EMPRESAS  │
-│  TENANT   │    │            │    │              │    │              │
-│           │    │ Seleciona  │    │ Auto-resolve │    │ Cadastra     │
-│ POST      │    │ plano      │    │ do plano ou  │    │ Matriz       │
-│ /admin/   │    │ (free,     │    │ toggle       │    │ + Filiais    │
-│ tenants   │    │ starter,   │    │ individual   │    │              │
-│           │    │ pro, etc)  │    │ de módulos   │    │ CNPJ, IE,    │
-│ name,     │    │            │    │              │    │ endereço,    │
-│ email,    │    │ maxUsers   │    │ ide: true    │    │ regime       │
-│ type      │    │ maxStorage │    │ crm: true    │    │ tributário,  │
-│           │    │ preço      │    │ bi: false    │    │ certificado  │
-│           │    │            │    │ ...          │    │ digital      │
-└──────────┘    └────────────┘    └──────────────┘    └──────────────┘
-                                                              │
-                                                              ▼
-┌──────────────┐    ┌──────────────┐    ┌──────────────────────────┐
-│ 5. VINCULAR  │    │ 6. COMISSÕES │    │ 7. USUÁRIOS              │
-│ PARCEIRO     │    │              │    │                          │
-│ (se partner) │    │ Automáticas  │    │ Convida users            │
-│              │    │ mensais      │    │ tenant_users             │
-│ POST /admin/ │    │ baseadas no  │    │ roles: owner/admin/      │
-│ partner-     │    │ plano do     │    │ member                   │
-│ clients      │    │ cliente      │    │                          │
-│              │    │              │    │ Scoping automático       │
-│ partnerId    │    │ pending →    │    │ de todos os dados        │
-│ clientId     │    │ approved →   │    │ por tenantId             │
-│ commission%  │    │ paid         │    │                          │
-└──────────────┘    └──────────────┘    └──────────────────────────┘
-```
-
----
-
-## 11. Propagação de Plano
-
-Quando um plano é atualizado, a feature de **propagação** atualiza todos os tenants que usam esse plano:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  POST /api/admin/plans/:id/propagate                                 │
-│                                                                      │
-│  1. Busca o plano por ID                                            │
-│  2. Pega features, maxUsers, maxStorageMb do plano                  │
-│  3. Atualiza TODOS os tenants onde plan === plan.code:              │
-│     UPDATE tenants SET                                               │
-│       features = plan.features,                                      │
-│       maxUsers = plan.maxUsers,                                      │
-│       maxStorageMb = plan.maxStorageMb                               │
-│     WHERE plan = 'pro'                                               │
-│  4. Retorna: { propagated: 15, planCode: "pro" }                    │
-│                                                                      │
-│  Exemplo:                                                            │
-│  Plano "pro" ganha módulo "production" →                            │
-│  Propagar → 15 tenants "pro" recebem production: true               │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 12. Isolamento de Dados
-
-Toda query de dados respeita o escopo do tenant:
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│  ISOLAMENTO POR tenantId                                             │
-│                                                                      │
-│  Padrão em todas as queries:                                         │
-│                                                                      │
-│  const tenantId = (req.user as any).tenantId;                       │
-│  const data = await db.select()                                      │
-│    .from(tabela)                                                     │
-│    .where(eq(tabela.tenantId, tenantId));                            │
-│                                                                      │
-│  Tabelas com tenantId:                                               │
-│  • tenants (hierarquia)        • crm_channels                       │
-│  • tenant_empresas             • crm_threads                        │
-│  • crm_leads                   • crm_events                         │
-│  • crm_clients                 • crm_campaigns                      │
-│  • crm_opportunities           • crm_products                       │
-│  • crm_partners                • crm_contracts                      │
-│  • crm_pipeline_stages         • crm_commission_rules               │
-│  • crm_proposals               • crm_quick_messages                 │
-│  • retail_activity_feed        • valuation_*                         │
-│                                                                      │
-│  Resultado: Dados do Tenant A NUNCA são vistos pelo Tenant B        │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 13. Arquivos-Chave
-
-| Arquivo | Função | Linhas |
-|---------|--------|--------|
-| `shared/schema.ts` (L821-977) | TenantFeatures type + 6 tabelas tenant | ~160 |
-| `server/admin/routes.ts` | API admin (33 endpoints) | 876 |
-| `client/src/pages/Admin.tsx` | Página admin (6 abas) | 2.635 |
-| `client/src/components/MultiTenantSection.tsx` | Gestão multi-tenant (4 sub-abas) | 1.486 |
-| `client/src/hooks/use-tenant-features.ts` | Hook de features no frontend | 59 |
-| `server/retail/routes.ts` (L25) | Middleware requireModule | ~25 |
-| `server/storage.ts` (getEnrichedUser) | Enriquece user com tenant info | — |
-
----
-
-## 14. Resumo Visual
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                  ARCÁDIA MULTI-TENANT STACK                          │
-│                                                                      │
-│  ┌───── Autenticação ──────────────────────────────────────────┐   │
-│  │  Login → getEnrichedUser → user + tenantId + tenantType     │   │
-│  │                            + tenantRole + features           │   │
-│  └─────────────────────────────────────────┬───────────────────┘   │
-│                                             │                       │
-│  ┌─────────────────────────────────────────▼───────────────────┐   │
-│  │  Middleware                                                  │   │
-│  │  ┌──────────┐  ┌─────────────┐  ┌────────────────────┐     │   │
-│  │  │requireAuth│  │requireModule │  │getAllowedTenantIds │     │   │
-│  │  │role check │  │feature check │  │canAccessTenant     │     │   │
-│  │  └──────────┘  └─────────────┘  └────────────────────┘     │   │
-│  └─────────────────────────────────────────┬───────────────────┘   │
-│                                             │                       │
-│  ┌─────────────────────────────────────────▼───────────────────┐   │
-│  │  API /api/admin/*                                            │   │
-│  │  33 endpoints: Tenants, Plans, Empresas, Comissões          │   │
-│  └─────────────────────────────────────────┬───────────────────┘   │
-│                                             │                       │
-│  ┌─────────────────────────────────────────▼───────────────────┐   │
-│  │  PostgreSQL                                                  │   │
-│  │  6 tabelas: tenants, tenant_users, tenant_plans,            │   │
-│  │  tenant_empresas, partner_clients, partner_commissions      │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-│                                                                      │
-│  ┌───── Frontend ──────────────────────────────────────────────┐   │
-│  │  Admin.tsx (6 abas) → MultiTenantSection (4 sub-abas)       │   │
-│  │  useTenantFeatures() hook → GET /api/soe/tenant/modules     │   │
-│  └─────────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────────┘
-```

docs/PLANO_BI_SUPERSET.md

@@ -1,292 +0,0 @@
-# PLANO BI — MetaSet (Apache Superset)
-## Arquitetura Consolidada
-### Versão 2.0 — Abril 2026
-
----
-
-## 1. STATUS — CONSOLIDAÇÃO CONCLUÍDA ✅
-
-### 1.1 O que foi realizado
-
-A migração do Metabase para o Apache Superset foi **concluída** em abril de 2026.
-
-| Componente | Status | Localização |
-|---|---|---|
-| **MetaSet (Apache Superset 4.1.0)** | ✅ Implementado | `/server/bi/metaset/` |
-| **Cliente TypeScript** | ✅ Implementado | `/server/bi/metaset-client/` |
-| **Rotas Express** | ✅ Implementado | `/server/bi/metaset-client/routes.ts` |
-| **Código legado Metabase** | ✅ Backup | `/server/metaset/backup/` |
-| **Integração Kernel** | ✅ Ativa | Porta 8100 |
-| **Documentação** | ✅ Atualizada | `/server/metaset/README.md` |
-
-### 1.2 Arquitetura Consolidada
-
-```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                         ARCÁDIA SUITE (Porta 5000)                          │
-│  ┌─────────────────────────────────────────────────────────────────────┐   │
-│  │                    BI-API GATEWAY (Porta 8004)                      │   │
-│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────────┐  │   │
-│  │  │ /bi/api/*   │  │/bi/metaset/*│  │ /bi/fdb/*                   │  │   │
-│  │  │ (nativo)    │  │ (proxy)     │  │ (proxy)                     │  │   │
-│  │  └──────┬──────┘  └──────┬──────┘  └─────────────┬───────────────┘  │   │
-│  │         └─────────────────┴───────────────────────┘                  │   │
-│  └─────────────────────────────┬────────────────────────────────────────┘   │
-└────────────────────────────────┼────────────────────────────────────────────┘
-                                 │
-         ┌───────────────────────┴───────────────────────┐
-         ▼                                               ▼
-┌─────────────────────────┐                 ┌─────────────────────────┐
-│   METASET BI (Porta 8100)│                 │   FDB-BRIDGE (8200)     │
-│  Apache Superset 4.1.0   │                 │  Sync Firebird → PG     │
-│  ┌─────────────────┐     │                 │  - Change Data Capture  │
-│  │  superset-src/  │     │                 │  - Real-time sync       │
-│  │  - Dashboards   │     │                 │  - Tenant isolation     │
-│  │  - SQL Lab      │     │                 │                         │
-│  │  - Charts       │     │                 │                         │
-│  │  - RLS          │     │                 │                         │
-│  └─────────────────┘     │                 │                         │
-└─────────────────────────┘                 └─────────────────────────┘
-         │
-         ▼
-┌─────────────────────────┐
-│  PostgreSQL + Redis     │
-│  (metaset_db + cache)   │
-└─────────────────────────┘
-```
-
----
-
-## 2. ESTRUTURA DE ARQUIVOS
-
-### 2.1 Implementação Atual (Apache Superset)
-
-```
-/server/bi/metaset/
-├── main.py                    # FastAPI wrapper (Porta 8100)
-├── run.py                     # Entry point Gunicorn
-├── superset_config.py         # Configuração Superset
-├── security_manager.py        # ArcadiaSecurityManager (JWT + RLS)
-├── Dockerfile                 # Container MetaSet
-├── init.sh                    # Script de inicialização
-├── requirements.txt           # Dependências Python
-├── superset-src/              # Código fonte Apache Superset 4.1.0
-├── config/                    # Configurações adicionais
-├── branding/                  # Assets de branding
-├── security/                  # Módulos de segurança
-├── extensions/                # Extensões
-└── templates/                 # Templates customizados
-
-/server/bi/metaset-client/
-├── index.ts                   # Cliente TypeScript completo
-└── routes.ts                  # Rotas Express /api/bi/metaset/*
-```
-
-### 2.2 Código Legado (Backup)
-
-```
-/server/metaset/backup/
-├── client.ts                  # Cliente Metabase (legado)
-└── routes.ts                  # Rotas Metabase (legado)
-```
-
----
-
-## 3. API ENDPOINTS
-
-### 3.1 BI-API Gateway (Porta 8004)
-
-| Endpoint | Método | Descrição |
-|----------|--------|-----------|
-| `/api/bi/metaset/health` | GET | Health check |
-| `/api/bi/metaset/databases` | GET/POST | Lista/Cria databases |
-| `/api/bi/metaset/databases/:id/sync` | POST | Sincroniza schema |
-| `/api/bi/metaset/databases/:id/tables` | GET | Lista tabelas |
-| `/api/bi/metaset/tables/:id` | GET | Metadata da tabela |
-| `/api/bi/metaset/query` | POST | Executa SQL |
-| `/api/bi/metaset/charts` | GET/POST | Lista/Cria charts |
-| `/api/bi/metaset/charts/:id` | GET/DELETE | Obtém/Deleta chart |
-| `/api/bi/metaset/dashboards` | GET/POST | Lista/Cria dashboards |
-| `/api/bi/metaset/dashboards/:id` | GET/PUT/DELETE | CRUD dashboard |
-| `/api/bi/metaset/guest-token` | POST | Cria guest token |
-| `/api/bi/metaset/embed/dashboard/:id` | GET | URL de embed |
-| `/api/bi/metaset/suggest/:table` | GET | Sugestões de análise |
-
-### 3.2 MetaSet Direto (Porta 8100)
-
-API nativa do Apache Superset:
-
-```
-GET    /health
-GET    /api/v1/dashboard/
-GET    /api/v1/dashboard/:id
-POST   /api/v1/dashboard/
-GET    /api/v1/chart/
-GET    /api/v1/dataset/
-POST   /api/v1/security/guest_token/
-GET    /api/v1/database/
-GET    /sqllab/
-```
-
----
-
-## 4. CONFIGURAÇÃO
-
-### 4.1 Variáveis de Ambiente
-
-```bash
-# MetaSet Connection
-METASET_HOST=metaset
-METASET_PORT=8100
-
-# Database
-DATABASE_URL=postgresql://arcadia:arcadia123@db:5432/metaset_db
-ARCADIA_DATABASE_URL=postgresql://arcadia:arcadia123@db:5432/arcadia
-
-# Redis (Cache)
-REDIS_URL=redis://redis:6379/1
-
-# Security
-METASET_SECRET_KEY=change-in-production
-JWT_SECRET_KEY=arcadia-jwt-secret
-
-# Admin
-METASET_ADMIN_USER=admin
-METASET_ADMIN_EMAIL=admin@arcadia.app
-METASET_ADMIN_PASSWORD=metaset2026
-```
-
-### 4.2 Feature Flags
-
-```python
-FEATURE_FLAGS = {
-    "EMBEDDED_SUPERSET": True,           # Embedding de dashboards
-    "GUEST_EMBEDDING_ENABLED": True,     # Guest tokens
-    "DASHBOARD_RBAC": True,              # Controle de acesso
-    "SQLLAB_BACKEND_PERSISTENCE": True,  # Persistência SQL Lab
-    "DRILL_BY": True,                    # Drill-down
-    "DASHBOARD_CROSS_FILTERS": True,     # Filtros cruzados
-}
-```
-
----
-
-## 5. SEGURANÇA
-
-### 5.1 ArcadiaSecurityManager
-
-- Extrai JWT do header `Authorization: Bearer <token>`
-- Identifica tenant do payload JWT (`tenant_id`)
-- Aplica RLS automaticamente via `SET LOCAL app.current_tenant`
-- Mapeia roles: superadmin→Admin, admin→Alpha, analyst→Gamma, viewer→Public
-
-### 5.2 Row Level Security (RLS)
-
-```sql
--- Política aplicada automaticamente
-SET LOCAL app.current_tenant = <tenant_id>;
-
--- Views filtram por tenant
-CREATE VIEW tenant_data AS
-SELECT * FROM data 
-WHERE tenant_id = current_setting('app.current_tenant')::int;
-```
-
----
-
-## 6. CLIENTE TYPESCRIPT
-
-### 6.1 Uso Básico
-
-```typescript
-import { metasetClient } from "./server/bi/metaset-client";
-
-// Health check
-const health = await metasetClient.isHealthy();
-
-// Listar dashboards
-const dashboards = await metasetClient.listDashboards();
-
-// Executar query
-const result = await metasetClient.executeSql(1, "SELECT * FROM sales LIMIT 100");
-
-// Criar dashboard
-const dashboard = await metasetClient.createDashboard({
-  name: "Vendas Q1 2026",
-  description: "Dashboard de vendas"
-});
-
-// Guest token para embedding
-const token = await metasetClient.createGuestToken({
-  resources: [{ type: "dashboard", id: "1" }],
-  rls: [{ dataset: 1, clause: "tenant_id = 123" }]
-});
-```
-
-### 6.2 Ferramentas do Manus (Agente IA)
-
-| Ferramenta | Descrição |
-|------------|-----------|
-| `metaset.query` | Executa SQL |
-| `metaset.list_tables` | Lista tabelas |
-| `metaset.table_fields` | Campos da tabela |
-| `metaset.create_chart` | Cria gráfico |
-| `metaset.list_charts` | Lista gráficos |
-| `metaset.create_dashboard` | Cria dashboard |
-| `metaset.list_dashboards` | Lista dashboards |
-| `metaset.suggest_analysis` | Sugere análises |
-| `metaset.sync_database` | Sincroniza schema |
-| `metaset.health` | Verifica status |
-
----
-
-## 7. DEPLOYMENT
-
-### 7.1 Docker Compose
-
-```yaml
-services:
-  metaset:
-    build: ./server/bi/metaset
-    ports:
-      - "8100:8100"
-    environment:
-      - DATABASE_URL=postgresql://arcadia:arcadia123@db:5432/metaset_db
-      - REDIS_URL=redis://redis:6379/1
-    labels:
-      - "arcadia.discovery.enabled=true"
-      - "arcadia.name=MetaSet BI"
-      - "arcadia.type=python"
-      - "arcadia.port=8100"
-      - "arcadia.capabilities=dashboards,charts,sql_lab,rls,embedding"
-```
-
-### 7.2 Inicialização
-
-```bash
-# Via docker compose
-docker compose up metaset
-
-# Ou diretamente
-cd server/bi/metaset
-python run.py --host 0.0.0.0 --port 8100 --workers 2
-```
-
----
-
-## 8. HISTÓRICO DE MUDANÇAS
-
-| Data | Versão | Mudança |
-|------|--------|---------|
-| 2026-03 | 1.0 | Plano inicial de migração Metabase → Superset |
-| 2026-04-08 | 2.0 | **Consolidação concluída** - Cliente TypeScript, rotas, documentação |
-
----
-
-## 9. REFERÊNCIAS
-
-- `/server/metaset/README.md` - Documentação completa do MetaSet
-- `/server/bi/metaset-client/index.ts` - Cliente TypeScript
-- `/server/bi/metaset-client/routes.ts` - Rotas Express
-- [Apache Superset Docs](https://superset.apache.org/docs/)
-- [Superset API Reference](https://superset.apache.org/docs/api/)