Fundação/Arquitetura Core

Fundação

Arquitetura Core

O kernel compartilhado — 11 subsistemas em ordem de dependência. Cada pilar futuro é um plugin sobre esta fundação. Todos com decisão travada.

11/11 fechadosda fundação de dados à APItraceId costura tudo

A pilha

Da fundação de dados até a experiência.

Experience · ReactNext.js

App RouterAdmin consoleClient Portal

API Gateway · #9Edge

tRPC · BFFREST /v1Realtime WS

Domain KernelService layer

Tenancy #1AuthZ #2Billing #4AI Orchestration #8 ★

Async BackboneWorkers

BullMQ #6OutboxEvent Bus #7

Integration · #5Connectors

Uniform ConnectorWindsor.aiOAuth vault · KMS

Data FoundationPersistence

Postgres · RLSpgvectorTimescaleRedis

Fluxo de uma ação

Um único traceId costura a jornada inteira.

01 · EDGERequestAuth → AuthContext + SET LOCAL + guard

02 · DOMAINServiceregra de negócio; RLS backstop

03 · ATOMICDB + Outboxmuda estado e emite evento juntos

04 · FAN-OUTEvent Busrelay → subscribers (jobs)

05 · EFFECTSJobs · Agentssync, agente, metering, notificação

Cada token de LLM e cada chamada de connector viram usage_event com cost_micros → margem por tenant/agente/modelo em tempo real. Uso é dinheiro; por isso o outbox garante entrega exatamente-uma-vez.

Registro dos 11 subsistemas

01Tenancy & Identityfechado

Hierarquia account→workspace→client. Fronteira de isolamento no workspace, RLS ativa no Postgres.

accountworkspaceclientmembership

02AuthZ / RBACfechado

Permissões resource:action; roles em código. Ações perigosas com approval gate. Agentes = service accounts.

AuthContextapi_keyapproval_request

03Data Conventionsfechado

UUIDv7, dinheiro em bigint (nunca float), soft-delete, audit append-only, particionamento por tempo.

DrizzleJSONBBase Table

04Billing & Meteringfechado

Stripe + planos/entitlements. Ledger usage_event mede tokens, calls e posts. Fee 3,5%+$0,30.

cost_microsmargemStripe Tax

05Connector Frameworkfechado

Interface uniforme; módulos nunca falam com API externa direto. Windsor.ai dá breadth; nativos depois.

connectionvault·KMSsync engine

06Jobs & Schedulingfechado

BullMQ, filas por classe de workload, fairness anti-noisy-neighbor. Outbox. Publicação time-critical.

RedisidempotencyDLQ

07Event Busfechado

Messaging (não event sourcing). Catálogo Zod tipado. Choreography + sagas. Webhooks de saída.

packages/eventsat-least-once

08AI Orchestration Kernel ★fechado

O diferencial. Registry de agentes, runtime com trace billing-grade, model routing→custo, RAG por client.

ClaudepgvectorLangfuse

09API Gatewayfechado

tRPC interno + REST /v1 público sobre service layer única. Choke point de auth. Realtime.

OpenAPIcursorWebSocket

10Observability & Auditfechado

OTel com traceId como espinha. Sentry + Langfuse. Métricas em 4 camadas incluindo custo & margem.

Grafanaaudit_logSLOs

11Notifications & Storagefechado

SES + in-app, templates MJML multi-locale. S3 + CloudFront; imagem via Cloudflare Images.

presignedassetsuppression