NEXUS OFFICE

Visão Geral

O NEXUS OFFICE é uma plataforma operacional que combina um escritório virtual em pixel art com um ERP leve e agentes de IA autônomos. Ele mostra em tempo real o que cada agente (Claude Code, Codex, OpenCode, n8n) está fazendo, e permite operar as duas empresas da Connecta — Lava Já! e Ferreira Alumínio — via interface visual ou API.

Arquitetura

Cloudflare Worker

Arquivo principal: cloud/empresa/index.ts. Deploy via cf deploy (cf CLI, não Wrangler).

Variáveis de ambiente (Secrets)

Fluxo de autenticação

Toda requisição (exceto /visita/* e /api/connecta/eventos) passa por accessOk():

GET /qualquer-rota
  → Worker verifica header cf-access-jwt-assertion
  → Busca chaves JWKS de https://{ACCESS_TEAM}/cdn-cgi/access/certs
  → Valida RS256, aud, iss, exp
  → 403 se falhar, segue se ok

n8n (Railway)

Instância self-hosted em https://primary-production-db42.up.railway.app. Credential principal: CONNECTA | ANIMUS API (httpTemplatedCustomAuth, id alCluSaU0zLe6UEM) — injeta o header de autenticação do CF Access em todas as chamadas ao Worker.

Credentials cadastradas

Servidor Local (Node)

Roda localmente; não tem acesso externo por padrão. Alimenta o cliente via SSE (GET /api/stream) com o snapshot do escritório (agentes, salas, feed).

Os endpoints /api/connecta/* (dashboard, clientes, agendamentos, pagamentos, agentes, sentinela) existem no servidor local — não no Worker. Para que o n8n (Railway) acesse esses dados, o Worker precisa fazer proxy via NEXUS_CONNECTA_URL.

Cliente Browser

Pixel art puro em client/src/ — TypeScript compilado, sem frameworks. Usa <canvas> para o mapa e elementos HTML para os painéis. SSE para estado em tempo real.

• art/ — tilemap, sprites, rendering
• ui/ — painéis, modais, sidebars, command center
• world/ — layout do prédio, constantes, posicionamento

Shared / Tipos

Código puro (sem APIs Node/DOM) em shared/. Usado tanto pelo servidor local quanto pelo Worker e pelo cliente.

Worker API — Referência Completa

Base: https://nexus-empresa.app-ai.workers.dev. Todas as rotas requerem JWT do CF Access, exceto /api/connecta/eventos.

Escritório (Snapshot / SSE)

ERP Endpoints

Persistência em Cloudflare D1 (ERP_DB). Dados reais das empresas.

Companies

Activities

State

Schema D1 (ERP_DB)

CREATE TABLE erp_activities (
  id TEXT PRIMARY KEY,
  company_id TEXT,
  type TEXT,
  sector TEXT,
  description TEXT,
  animus_id TEXT,
  animus_name TEXT,
  room_id TEXT,
  created_at INTEGER
);

CREATE TABLE erp_events (
  id TEXT PRIMARY KEY,
  company_id TEXT,
  event_type TEXT,
  source TEXT,
  payload_json TEXT,
  created_at INTEGER
);

CREATE TABLE erp_company_state (
  company_id TEXT PRIMARY KEY,
  company_name TEXT,
  group_code TEXT,
  group_position INTEGER,
  state_json TEXT,
  updated_at INTEGER
);

CREATE TABLE erp_company_directory (
  company_id TEXT PRIMARY KEY,
  company_name TEXT,
  segment TEXT,
  plan TEXT,
  room_id TEXT,
  room_name TEXT,
  animus_id TEXT,
  animus_name TEXT,
  animus_role TEXT,
  group_code TEXT,
  group_position INTEGER,
  state_summary_json TEXT,
  updated_at INTEGER
);

CREATE TABLE erp_tasks (id TEXT PRIMARY KEY, title TEXT, priority TEXT, status TEXT, company_id TEXT, created_at INTEGER);
CREATE TABLE erp_leads (id TEXT PRIMARY KEY, name TEXT, contact TEXT, request TEXT, status TEXT, company_id TEXT, created_at INTEGER);
CREATE TABLE erp_finance (id TEXT PRIMARY KEY, kind TEXT, description TEXT, amount REAL, status TEXT, company_id TEXT, created_at INTEGER);

Connecta Endpoints

Setores operacionais das duas empresas. Os endpoints GET fazem proxy para o servidor local via NEXUS_CONNECTA_URL.

Informação

Operações

Chat (ANIMUS Nucleo)

// Exemplo
const res = await fetch('https://nexus-empresa.app-ai.workers.dev/api/connecta/gestor/chat', {
  method: 'POST',
  headers: {
    'content-type': 'application/json',
    'cf-access-jwt-assertion': TOKEN,
  },
  body: JSON.stringify({ message: 'quais pagamentos estão pendentes?', sessionId: 'sess_123' }),
});
const { response, sessionId } = await res.json();

Ingress de Eventos (n8n → Worker)

Rota especial sem CF Access — autenticada por HMAC-SHA256:

Autenticação

Header x-connecta-ingress-key ou x-connecta-animus-key com o valor de NEXUS_SECTOR_KEY ou N8N_BRIDGE_KEY.

Body

{
  "companyId": "nexus-central",   // obrigatório
  "description": "Lead chegou",   // obrigatório
  "type": "lead_chegada",
  "sector": "Recepcao",
  "source": "whatsapp",
  "animusId": "animus:recepcao",
  "animusName": "ANIMUS Recepção",
  "roomId": "core:recepcao"
}

Resposta: 201 { ok: true, received: true, id: "ingress:uuid" }

O evento é gravado em erp_events e erp_activities simultaneamente.

ANIMUS Nucleo — Agente Operacional

Workflow n8n 00x78dEACc6Mz0JL (abrir no n8n).

Webhook: POST https://primary-production-db42.up.railway.app/webhook/nexus-nucleo-v1

Tools disponíveis

LLM + Memória

Groq llama-3.3-70b-versatile, temperatura 0.3. Memória por sessão via sessionId (janela de 10 turnos).

Workflows n8n

MCP Server — Integração com Qualquer IA

Para conectar Claude Code, OpenCode, Cursor ou qualquer IA ao NEXUS via MCP, crie um servidor MCP que expõe as tools do Worker. Exemplo mínimo:

Instalação rápida (Claude Code)

Adicione ao ~/.claude/settings.json:

{
  "mcpServers": {
    "nexus-office": {
      "command": "node",
      "args": ["C:/caminho/para/nexus-mcp/index.js"],
      "env": {
        "NEXUS_WORKER_URL": "https://nexus-empresa.app-ai.workers.dev",
        "NEXUS_CF_ACCESS_TOKEN": "seu-service-token-aqui"
      }
    }
  }
}

Implementação do servidor MCP (nexus-mcp/index.js)

// nexus-mcp/index.js — MCP Server para NEXUS OFFICE
// Requer: npm install @modelcontextprotocol/sdk
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const BASE = process.env.NEXUS_WORKER_URL;
const TOKEN = process.env.NEXUS_CF_ACCESS_TOKEN;

const nexus = async (path, opts = {}) => {
  const res = await fetch(`${BASE}${path}`, {
    ...opts,
    headers: {
      'cf-access-jwt-assertion': TOKEN,
      'content-type': 'application/json',
      ...(opts.headers ?? {}),
    },
  });
  return res.json();
};

const server = new Server({ name: 'nexus-office', version: '1.0.0' }, {
  capabilities: { tools: {} },
});

server.setRequestHandler('tools/list', async () => ({
  tools: [
    { name: 'nexus_snapshot',       description: 'Retorna snapshot atual do escritório NEXUS (agentes ativos, status).',   inputSchema: { type: 'object', properties: {} } },
    { name: 'nexus_erp_state',      description: 'Estado ERP da Connecta (tarefas, leads, financeiro).',                   inputSchema: { type: 'object', properties: { companyId: { type: 'string' } } } },
    { name: 'nexus_erp_companies',  description: 'Lista empresas cadastradas no NEXUS.',                                  inputSchema: { type: 'object', properties: {} } },
    { name: 'nexus_activities',     description: 'Feed de atividades recentes. Param: companyId (opcional).',              inputSchema: { type: 'object', properties: { companyId: { type: 'string' } } } },
    { name: 'nexus_health',         description: 'Health check dos serviços externos da Connecta.',                        inputSchema: { type: 'object', properties: {} } },
    { name: 'nexus_chat',           description: 'Envia mensagem ao ANIMUS Nucleo (agente IA com tools operacionais).',   inputSchema: { type: 'object', required: ['message'], properties: { message: { type: 'string' }, sessionId: { type: 'string' } } } },
    { name: 'nexus_add_activity',   description: 'Registra atividade no ERP.',                                             inputSchema: { type: 'object', required: ['type','sector','description'], properties: { companyId: {type:'string'}, type:{type:'string'}, sector:{type:'string'}, description:{type:'string'} } } },
    { name: 'nexus_ingest_event',   description: 'Injeta evento externo no ERP (requer N8N_BRIDGE_KEY).',                 inputSchema: { type: 'object', required: ['companyId','description','bridgeKey'], properties: { companyId:{type:'string'}, description:{type:'string'}, type:{type:'string'}, sector:{type:'string'}, animusName:{type:'string'}, bridgeKey:{type:'string'} } } },
  ],
}));

server.setRequestHandler('tools/call', async ({ params }) => {
  const { name, arguments: args } = params;
  let result;
  if (name === 'nexus_snapshot')      result = await nexus('/api/snapshot');
  else if (name === 'nexus_erp_state')  result = await nexus(`/api/erp/state${args.companyId ? `?companyId=${args.companyId}` : ''}`);
  else if (name === 'nexus_erp_companies') result = await nexus('/api/erp/companies');
  else if (name === 'nexus_activities')  result = await nexus(`/api/erp/activities${args.companyId ? `?companyId=${args.companyId}` : ''}`);
  else if (name === 'nexus_health')      result = await nexus('/api/connecta/health');
  else if (name === 'nexus_chat')        result = await nexus('/api/connecta/gestor/chat', { method: 'POST', body: JSON.stringify(args) });
  else if (name === 'nexus_add_activity') result = await nexus('/api/erp/activities', { method: 'POST', body: JSON.stringify(args) });
  else if (name === 'nexus_ingest_event') {
    const { bridgeKey, ...body } = args;
    result = await fetch(`${BASE}/api/connecta/eventos`, {
      method: 'POST',
      headers: { 'content-type': 'application/json', 'x-connecta-animus-key': bridgeKey },
      body: JSON.stringify(body),
    }).then(r => r.json());
  }
  return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);

Autenticação

Criando um Service Token para o MCP

1. Acesse one.dash.cloudflare.com
2. Vá em Access → Service Auth → Service Tokens
3. Clique Create Service Token
4. Copie CF-Access-Client-Id e CF-Access-Client-Secret
5. Adicione o token à sua Access Application em Access Policies
6. O JWT gerado pelo CF Access ao usar o service token vai no header cf-access-jwt-assertion

Secrets — Regras de Segurança

Deploy

Este projeto usa cf CLI (não Wrangler) conforme configurado no projeto.

Worker (Cloud)

# A partir de nexus-office-2026-11-01/nexus-office/cloud/empresa/
./node_modules/.bin/cf.ps1 deploy

Verificar versão deployada

./node_modules/.bin/cf.ps1 deployments list

Servidor local

# A partir de nexus-office/
npm run dev

Build do cliente

npm run build

Verificação i18n

npm run i18n:check