20 KiB

Raw Blame History

Arcádia Suite - Mapa Geral do Sistema

Visão Geral

Arcádia Suite é o Escritório Estratégico para a Empresa Moderna. Uma plataforma que centraliza produtividade, inteligência, tomada de decisão e governança, orquestrando ERPs, pessoas e dados.

Princípio Central: Separação absoluta entre decisão e execução.

Arcádia pensa, governa e orienta
ERPs executam, registram e obedecem

Arquitetura de 4 Camadas

┌─────────────────────────────────────────────────────────────────────┐
│                      CAMADA DE APRESENTAÇÃO                        │
│   React 18 + TypeScript + Tailwind CSS + shadcn/ui                 │
│   Interface tipo browser com abas + omnibox                        │
│   66 páginas/módulos                                               │
└─────────────────────────────────────────────────────────────────────┘
                                  ▼
┌─────────────────────────────────────────────────────────────────────┐
│                     CAMADA DE ORQUESTRAÇÃO                         │
│   Express.js + Socket.IO + Manus Agent                             │
│   Porta 5000 (API + WebSocket)                                     │
│   38 arquivos de rotas / 23 ferramentas registradas                │
└─────────────────────────────────────────────────────────────────────┘
                                  ▼
┌─────────────────────────────────────────────────────────────────────┐
│                     CAMADA DE INTELIGÊNCIA                         │
│   FastAPI (Contábil 8003, BI 8004, Automação 8005)                 │
│   Communication Engine (Node 8006)                                 │
│   OpenAI GPT-4o (Manus/Dev Center) + GPT-4o-mini (WhatsApp)       │
└─────────────────────────────────────────────────────────────────────┘
                                  ▼
┌─────────────────────────────────────────────────────────────────────┐
│                       CAMADA DE DADOS                              │
│   PostgreSQL + Drizzle ORM                                         │
│   Knowledge Graph + ChromaDB (embeddings)                          │
│   Session Store + Multi-tenant                                     │
└─────────────────────────────────────────────────────────────────────┘

Mapa de Portas

Porta	Serviço	Tecnologia	Observação
5000	API Principal + Frontend	Express.js + React	Exposta publicamente
5001	Arcadia Kernel	Node.js/Express	Dashboard interno (mesmo container)
8002	Motor Fiscal (Fisco)	FastAPI (Python)	Via Docker network
8003	Motor Contábil	FastAPI (Python)	Via Docker network
8004	Motor BI (Insights)	FastAPI (Python)	Via Docker network
8005	Motor Automação	FastAPI (Python)	Via Docker network
8006	Motor Comunicação	Node.js/Express	Via Docker network
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.

Módulos do Frontend (66 páginas)

Núcleo & Administração

Página	Rota	Descrição
Home	`/`	Dashboard principal
SOE	`/soe`	Sistema Operacional Empresarial
ERP	`/erp`	Módulo ERP legado
Admin	`/admin`	Administração do sistema
SuperAdmin	`/super-admin`	Gestão multi-tenant

Módulos de Negócio

Página	Rota	Descrição
Financeiro	`/financeiro`	Contas a pagar/receber, fluxo de caixa
Contábil	`/contabil`	Contabilidade, DRE, balancetes
Fiscal	`/fisco`	NF-e, NFC-e, CFOP, NCM, CEST
CRM	`/crm`	Gestão de relacionamento com cliente
People	`/people`	RH, colaboradores, folha
Production	`/production`	Ordens de produção
Quality	`/quality`	Controle de qualidade

Varejo & Comércio

Página	Rota	Descrição
Retail	`/retail`	Varejo (celulares, assistência técnica)
RetailReports	`/retail-reports`	Relatórios do varejo
Marketplace	`/marketplace`	Marketplace integrado
Valuation	`/valuation`	Avaliação de trade-in

Comunicação

Página	Rota	Descrição
WhatsApp	`/whatsapp`	Multi-sessão WhatsApp
Chat	`/chat`	Chat interno
XOS Inbox	`/xos/inbox`	Caixa de entrada unificada
XOS CRM	`/xos/crm`	CRM unificado
XOS Campaigns	`/xos/campaigns`	Campanhas de marketing
XOS Tickets	`/xos/tickets`	Sistema de tickets

Inteligência & IA

Página	Rota	Descrição
Scientist	`/scientist`	Auto-programação com IA
Knowledge	`/knowledge`	Base de conhecimento/grafo
BI Workspace	`/bi`	Business Intelligence
Manus	`/agent`	Agente autônomo central

Desenvolvimento & DevOps

Página	Rota	Descrição
IDE	`/ide`	Editor Monaco + Terminal
Dev Center	`/dev-center`	Centro de desenvolvimento XOS
XOS Pipeline	`/xos/pipeline`	Pipeline autônomo de código
XOS Governance	`/xos/governance`	Governança e políticas
API Hub	`/api-hub`	Central de APIs
API Tester	`/api-tester`	Testador de APIs
DocType Builder	`/doctype-builder`	Construtor de tipos
Page Builder	`/page-builder`	Construtor de páginas
Workflow Builder	`/workflow-builder`	Construtor de workflows

Operações & Engenharia

Página	Rota	Descrição
Engineering Hub	`/engineering`	Hub de engenharia
Field Operations	`/field-ops`	Operações de campo
Process Compass	`/compass`	Bússola de processos
Suppliers Portal	`/suppliers`	Portal de fornecedores

Plataforma

Página	Rota	Descrição
Engine Room	`/engine-room`	Casa de Máquinas (status dos motores)
Automations	`/automations`	Motor de automações
Plus	`/plus`	ERP Laravel (proxy)
LMS	`/lms`	Sistema de aprendizagem
Communities	`/communities`	Comunidades
Support	`/support`	Central de suporte
Migration	`/migration`	Migração de dados
Central APIs	`/central-apis`	APIs centrais

APIs do Backend (38 grupos de rotas)

Core

Rota Base	Arquivo	Descrição
`/api/login`, `/api/register`	`server/auth.ts`	Autenticação
`/api/admin/*`	`server/admin/routes.ts`	Administração
`/api/erp/*`	`server/erp/routes.ts`	ERP principal
`/api/soe/*`	`server/erp/routes.ts`	SOE (alias)
`/api/users/*`	`server/routes.ts`	Gestão de usuários

Negócio

Rota Base	Arquivo	Descrição
`/api/financeiro/*`	`server/financeiro/routes.ts`	Financeiro
`/api/contabil/*`	`server/contabil/routes.ts`	Contabilidade
`/api/fisco/*`	`server/fisco/routes.ts`	Fiscal
`/api/crm/*`	`server/crm/routes.ts`	CRM
`/api/people/*`	`server/people/routes.ts`	RH/Pessoas
`/api/production/*`	`server/production/routes.ts`	Produção
`/api/quality/*`	`server/quality/routes.ts`	Qualidade
`/api/retail/*`	`server/retail/routes.ts`	Varejo
`/api/valuation/*`	`server/valuation/routes.ts`	Avaliação trade-in
`/api/marketplace/*`	`server/marketplace/routes.ts`	Marketplace

Comunicação

Rota Base	Arquivo	Descrição
`/api/whatsapp/*`	`server/whatsapp/routes.ts`	WhatsApp multi-sessão
`/api/chat/*`	`server/chat/routes.ts`	Chat interno
`/api/email/*`	`server/email/routes.ts`	E-mail
`/api/comm/*`	proxy	Motor de Comunicação
`/api/xos/*`	`server/xos/routes.ts`	XOS CRM unificado

Inteligência

Rota Base	Arquivo	Descrição
`/api/manus/*`	`server/manus/routes.ts`	Agente Manus IA
`/api/knowledge/*`	`server/learning/routes.ts`	Knowledge Graph
`/api/bi/*`	`server/bi/routes.ts`	Business Intelligence
`/api/bi/metaset/*`	`server/metaset/routes.ts`	Motor BI MetaSet
`/api/scientist/*`	`server/routes.ts`	Cientista de dados

Desenvolvimento

Rota Base	Arquivo	Descrição
`/api/ide/*`	`server/ide/routes.ts`	IDE integrada
`/api/dev-center/*`	`server/blackboard/routes.ts`	Dev Center/Blackboard
`/api/xos/pipeline`	`server/blackboard/routes.ts`	Pipeline autônomo
`/api/governance/*`	`server/governance/routes.ts`	Governança
`/api/lowcode/*`	`server/lowcode/routes.ts`	Low-code engine

Protocolos de Interoperabilidade

Rota Base	Arquivo	Descrição
`/api/mcp/v1/*`	`server/mcp/routes.ts`	Model Context Protocol
`/api/a2a/v1/*`	`server/routes.ts`	Agent to Agent Protocol
`/api/api-central/*`	`server/api-central/routes.ts`	Central de APIs

Infraestrutura

Rota Base	Arquivo	Descrição
`/api/engine-room/*`	`server/engine-room/routes.ts`	Casa de Máquinas
`/api/automations/*`	`server/automations/routes.ts`	Motor de Automação
`/api/modules/*`	`server/modules/loader.ts`	Módulos dinâmicos
`/api/login-bridge/*`	`server/login-bridge/routes.ts`	SSO Bridge
`/api/migration/*`	`server/migration/routes.ts`	Migração

Motores (Engines)

Motor IA - Manus (Node.js, porta 5000)

Modelo: GPT-4o (Dev Center), GPT-4o-mini (WhatsApp)
Agentes: 6 agentes autônomos (Architect, Generator, Validator, Executor, Researcher, Evolution)
Ferramentas: 23 ferramentas registradas (GitHub, filesystem, BI, git)
Pipeline: Design → Codegen → Validation → Staging → Evolution

Motor Fiscal - Fisco (Python, porta 8002)

NF-e / NFC-e via nfelib
NCMs, CFOPs, CESTs, grupos tributários
Certificados digitais
Comunicação com SEFAZ

Motor Contábil (Python, porta 8003)

Plano de contas
Lançamentos contábeis
DRE, Balanço Patrimonial

Motor BI - Insights (Python, porta 8004)

Execução SQL
Geração de gráficos
Análise com Pandas
Cache inteligente

Motor Automação (Python, porta 8005)

Cron scheduler
Event bus
Executor de workflows

Motor Comunicação (Node.js, porta 8006)

Unifica XOS CRM + WhatsApp + Email
Contatos, threads, mensagens unificados
Filas de atendimento
Eventos para Knowledge Graph

Arcádia Plus - ERP Laravel (PHP, porta 8080)

NF-e/NFC-e/CT-e/MDF-e
PDV (ponto de venda)
Cardápio digital
Ordens de serviço
Estoque com rastreabilidade
Integrações e-commerce (WooCommerce, Mercado Livre, NuvemShop)
Integrações delivery (iFood)

Dev Center XOS - 6 Agentes Autônomos

Prompt em Português
        │
        ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Architect   │ ──▶ │  Generator   │ ──▶ │  Validator   │
│  (Design)    │     │  (Codegen)   │     │  (Typecheck) │
└──────────────┘     └──────────────┘     └──────────────┘
                                                  │
                                                  ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Evolution   │ ◀── │  Researcher  │ ◀── │  Executor    │
│  (Aprende)   │     │  (Pesquisa)  │     │  (Staging)   │
└──────────────┘     └──────────────┘     └──────────────┘

Módulo Retail (Varejo de Celulares)

Funcionalidades Core

Vendas com IMEI: Rastreamento individual de aparelhos
Trade-in: Avaliação com checklist de 19 itens
Ordens de Serviço: Gestão completa de assistência técnica
Garantia: Controle de garantias por IMEI
Caixa Diário: Reconciliação de caixa com fechamento
Comissões: Cálculo automático por vendedor

Checklist Trade-in (19 itens)

Liga normalmente
Problemas na tela
WiFi funcionando
Bluetooth funcionando
Câmera frontal
Câmera traseira
Microfone
Alto-falante
Botões físicos
Sensor biométrico
Carregamento
Bateria saudável
GPS funcionando
Giroscópio
Acelerômetro
NFC
Resistência à água
Face ID / reconhecimento facial
Vibração

Banco de Dados (PostgreSQL + Drizzle ORM)

Tabelas Principais

Grupo	Tabelas
Identidade	`users`, `profiles`, `tenants`
Produtividade	`workspace_pages`, `page_blocks`, `dashboard_widgets`, `quick_notes`
Comunicação	`conversations`, `messages`, `chat_threads`, `chat_messages`
WhatsApp	`whatsapp_sessions`, `whatsapp_contacts`, `whatsapp_messages`, `whatsapp_tickets`
ERP Core	`applications`, `erp_connections`, `agent_tasks`, `task_executions`
Conhecimento	`knowledge_base`, `knowledge_graph_nodes`, `knowledge_graph_edges`
Governança	`xos_governance_*`, `xos_job_queue`, `xos_agent_metrics`
Pipeline	`xos_staging_changes`, `xos_dev_pipelines`
Comunicação Unificada	`comm_contacts`, `comm_threads`, `comm_messages`, `comm_channels`
Varejo	Via módulos dinâmicos (`/api/modules/retail-reports`)
Financeiro	Contas, lançamentos, conciliação
Fiscal	NCMs, CFOPs, notas fiscais

Integrações Externas

Serviço	Uso
OpenAI	GPT-4o (Manus, Dev Center), GPT-4o-mini (WhatsApp)
GitHub	Commits automáticos, análise de repositórios
ERPNext	Integração com ERP externo (clientes, produtos, vendas)
WhatsApp/Baileys	Multi-sessão de atendimento
SEFAZ	NF-e/NFC-e via nfelib
Cloud-DFE	SDK fiscal (NF-e, NFC-e, CT-e, MDF-e)
WooCommerce	E-commerce integration
Mercado Livre	Marketplace
NuvemShop	E-commerce
iFood	Delivery (pedidos, cardápio)
Asaas	Pagamentos, boletos

Protocolos de Interoperabilidade

Protocolo	Rota	Descrição
MCP	`/api/mcp/v1/`	Model Context Protocol - exposição de ferramentas
A2A	`/api/a2a/v1/`	Agent to Agent - comunicação bidirecional
AP2	Planejado	Agent Payment Protocol
UCP	Planejado	Unified Commerce Protocol

Como Rodar Localmente

Pré-requisitos

Node.js 20+
Python 3.11+
PostgreSQL 16+
PHP 8.2+ (opcional, para Arcádia Plus)

Instalação

# 1. Extrair o backup
tar xzf arcadia-suite-backup.tar.gz

# 2. Instalar dependências Node
npm install

# 3. Instalar dependências Python
pip install fastapi uvicorn pandas numpy psycopg2-binary nfelib lxml cryptography

# 4. Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com suas credenciais:
# DATABASE_URL=postgresql://user:pass@localhost:5432/arcadia
# OPENAI_API_KEY=sk-...
# GITHUB_TOKEN=ghp_...

# 5. Criar banco de dados
createdb arcadia

# 6. Executar migrations
npx drizzle-kit push

# 7. Iniciar em desenvolvimento
npm run dev

Variáveis de Ambiente Necessárias

Variável	Descrição
`DATABASE_URL`	URL de conexão PostgreSQL
`OPENAI_API_KEY`	Chave da API OpenAI
`GITHUB_TOKEN`	Token GitHub para integrações
`ERPNEXT_URL`	URL do ERPNext (opcional)
`ERPNEXT_API_KEY`	Chave API ERPNext (opcional)
`ERPNEXT_API_SECRET`	Segredo API ERPNext (opcional)
`SESSION_SECRET`	Segredo para sessões Express

Credenciais Padrão

Usuário: admin
Senha: admin
Role: master

Estrutura de Diretórios

arcadia-suite/
├── client/                    # Frontend React
│   ├── src/
│   │   ├── pages/             # 66 páginas
│   │   ├── components/        # Componentes reutilizáveis
│   │   ├── hooks/             # Custom hooks
│   │   └── lib/               # Utilitários
│   └── public/                # Assets estáticos
├── server/                    # Backend Express
│   ├── admin/                 # Administração
│   ├── autonomous/            # Ferramentas autônomas
│   ├── bi/                    # Business Intelligence
│   ├── blackboard/            # Dev Center (6 agentes)
│   ├── chat/                  # Chat interno
│   ├── communication/         # Motor de comunicação
│   ├── contabil/              # Motor contábil
│   ├── crm/                   # CRM
│   ├── engine-room/           # Casa de Máquinas
│   ├── erp/                   # ERP/SOE
│   ├── financeiro/            # Financeiro
│   ├── fisco/                 # Fiscal
│   ├── governance/            # Governança XOS
│   ├── ide/                   # IDE integrada
│   ├── integrations/          # Integrações externas
│   ├── learning/              # Knowledge Graph
│   ├── manus/                 # Agente Manus
│   ├── mcp/                   # Model Context Protocol
│   ├── modules/               # Módulos dinâmicos
│   ├── people/                # RH
│   ├── plus/                  # Proxy Laravel
│   ├── production/            # Produção
│   ├── python/                # Scripts Python
│   ├── quality/               # Qualidade
│   ├── retail/                # Varejo
│   ├── whatsapp/              # WhatsApp
│   └── xos/                   # XOS unificado
├── shared/                    # Código compartilhado
│   ├── schema.ts              # Schema principal (Drizzle)
│   └── schemas/               # Schemas modulares
├── plus/                      # ERP Laravel (PHP)
├── python-service/            # Serviço Python
├── db/                        # Configuração do banco
├── migrations/                # Migrations Drizzle
└── docs/                      # Documentação

Arcádia Suite v2.0 - O Escritório Estratégico para a Empresa Moderna

20 KiB Raw Blame History

Arcádia Suite - Mapa Geral do Sistema

Visão Geral

Arquitetura de 4 Camadas

Mapa de Portas

Sobre o Kernel (Porta 5001)

Módulos do Frontend (66 páginas)

Núcleo & Administração

Módulos de Negócio

Varejo & Comércio

Comunicação

Inteligência & IA

Desenvolvimento & DevOps

Operações & Engenharia

Plataforma

APIs do Backend (38 grupos de rotas)

Core

Negócio

Comunicação

Inteligência

Desenvolvimento

Protocolos de Interoperabilidade

Infraestrutura

Motores (Engines)

Motor IA - Manus (Node.js, porta 5000)

Motor Fiscal - Fisco (Python, porta 8002)

Motor Contábil (Python, porta 8003)

Motor BI - Insights (Python, porta 8004)

Motor Automação (Python, porta 8005)

Motor Comunicação (Node.js, porta 8006)

Arcádia Plus - ERP Laravel (PHP, porta 8080)

Dev Center XOS - 6 Agentes Autônomos

Módulo Retail (Varejo de Celulares)

Funcionalidades Core

Checklist Trade-in (19 itens)

Banco de Dados (PostgreSQL + Drizzle ORM)

Tabelas Principais

Integrações Externas

Protocolos de Interoperabilidade

Como Rodar Localmente

Pré-requisitos

Instalação

Variáveis de Ambiente Necessárias

Credenciais Padrão

Estrutura de Diretórios

20 KiB

Raw Blame History