DOCUMENTO 08 · ARQUITETURA TÉCNICA

Não é um aplicativo.
É uma plataforma distribuída.

O NEXUS Core é a camada de experiência. A inteligência vive distribuída entre banco relacional, memória vetorial, orquestrador de agentes, integrações, eventos e serviços especializados.

As Quatro Camadas

CAMADA 01

Experiência do Usuário

Nexus Core • React 19 • Three.js • Voice

CAMADA 02

Nexus Operating System

Orchestrator • Memória • Agentes • RAG

CAMADA 03

Backend Cloud Platform

PostgreSQL • Edge Functions • Storage

CAMADA 04

Serviços e Integrações

Inteligência • Mapas • Finanças • ERPs

Stack Principal

Frontend

React 19TypeScriptViteThree.jsR3FFramer MotionGSAPTailwindShadcn UIReact QueryZustand

Backend

PostgreSQLEdge FunctionsStorageAuthRealtimeRow Level Security

Inteligência

OpenAIAnthropicGeminiMistralDeepSeekElevenLabsWhisperOpenRouterModelos locais

Dados & Infra

pgvectorQdrantRedisUpstashNATSOpenTelemetryFeature FlagsMCP

Estrutura do Banco

Não teremos poucas tabelas. Teremos centenas — mas organizadas por domínio.

Núcleo

  • users
  • profiles
  • organizations
  • teams
  • permissions
  • roles
  • devices
  • sessions
  • subscriptions
  • plans

Memória

  • memories
  • memory_nodes
  • memory_links
  • memory_tags
  • memory_embeddings
  • memory_events
  • memory_versions
  • memory_context
  • memory_categories

IA

  • ai_agents
  • ai_models
  • agent_tasks
  • agent_logs
  • agent_memory
  • agent_skills
  • prompts
  • prompt_versions
  • conversations
  • messages

Financeiro

  • accounts
  • banks
  • transactions
  • cards
  • wallets
  • budgets
  • investments
  • assets
  • debts
  • cashflow
  • financial_goals

Empresa

  • companies
  • departments
  • employees
  • clients
  • projects
  • contracts
  • sales
  • products
  • services
  • inventory
  • tickets
  • tasks

CRM

  • leads
  • opportunities
  • funnels
  • followups
  • contacts
  • communications

Agenda

  • calendar_events
  • meetings
  • reminders
  • notifications
  • travel
  • locations

Documentos

  • documents
  • folders
  • files
  • versions
  • signatures
  • summaries

Voz

  • voice_sessions
  • transcriptions
  • voice_profiles
  • voice_commands

Imagens

  • images
  • generations
  • image_edits
  • image_history

Automações

  • workflows
  • workflow_runs
  • workflow_logs
  • api_connections
  • webhooks
  • triggers

Segurança

  • audit_logs
  • security_events
  • mfa
  • passkeys
  • trusted_devices
  • consents
  • api_keys
  • encryption_keys

Configurações

  • preferences
  • themes
  • personalities
  • avatars
  • languages
  • modules

Memória em Camadas

01

RAM

Contexto da conversa atual.

02

Curto Prazo

Últimos dias de interação.

03

Longo Prazo

Histórico completo e consolidado.

04

Conhecimento

Projetos, empresa, família, clientes, objetivos e documentos.

Pipeline RAG

Documento
OCR
Limpeza
Chunks
Embeddings
Vetorial
Relevância
Resposta

Sempre preservando metadados: origem, data, autor e permissões.

Orquestrador & Agentes

Fluxo de Execução

O Orchestrator nunca fica no frontend.

01
Usuário
02
Frontend
03
API
04
Orchestrator
05
Agentes
06
Ferramentas
07
Resposta

Anatomia de um Agente

Cada agente evolui de forma independente.

CONFIGURAÇÃOPROMPT BASEMEMÓRIAFERRAMENTASPERMISSÕESLOGSESPECIALIDADEMODELOTEMPERATURACUSTOSMÉTRICAS

API First

Cada domínio é independente e versionado.

/api/auth/api/users/api/memory/api/chat/api/voice/api/vision/api/finance/api/company/api/calendar/api/documents/api/crm/api/workflows/api/reports/api/notifications/api/agents/api/search/api/settings

Edge Functions

  • Criar embeddings
  • Enviar notificações
  • Assinar URLs
  • Executar pequenos fluxos
  • Validar permissões
  • Atualizar índices
  • Registrar auditoria

Tempo Real

  • Chat
  • Voz
  • Notificações
  • Agenda
  • CRM
  • Atualizações financeiras
  • Execução de tarefas
  • Status dos agentes

Observabilidade

Toda execução gera eventos. Esses dados alimentam métricas e otimizam desempenho e custos.

Usuário
Intent
Agente
Ferramenta
Tempo
Tokens
Resultado
Feedback
Aprendizado

Sistema de Plugins

Um marketplace de módulos instaláveis sem alterar o núcleo.

ManifestoPermissõesEventosFerramentasBancoFrontendÍconesRotasConfiguração

Sistema de Eventos

Tudo gera eventos — e eventos disparam automações ou agentes.

onLoginonLogoutonMemoryCreatedonMeetingStartedonMeetingFinishedonImageGeneratedonDocumentUploadedonVoiceStartedonVoiceEndedonPaymentReceivedonTaskCompleted

Escalabilidade por Domínio

Frontend

Experiência do usuário.

Core API

Autenticação, usuários e orquestração.

AI Services

Agentes, memória, RAG e modelos.

Business Services

Financeiro, CRM, agenda e documentos.

Integration Services

Google, Microsoft, WhatsApp, Open Finance, ERPs.

Automation Services

Workflows, eventos e execução.

Autenticação Premium

EMAILGOOGLEAPPLEMICROSOFTGITHUBLINKEDINPASSKEYFACE IDTOUCH IDOTPMFAMAGIC LINKQR LOGIN

Controle de acesso híbrido RBAC + ABAC: cada ação depende do papel, do contexto, do recurso e da autorização concedida.

Segurança Central

  • Criptografia em trânsito (TLS) e em repouso
  • Chaves gerenciadas com rotação automática
  • Segredos em cofre, nunca no frontend
  • Auditoria de todas as ações críticas
  • Políticas de retenção e exclusão de dados
  • Consentimento explícito para memória persistente
  • Logs separados de dados sensíveis
  • Rate limiting e proteção contra abuso
  • Backups automáticos e plano de recuperação

Evoluir de um MVP para uma plataforma global sem reescrever o núcleo do produto.

INICIAR PRESENÇA