Arquitetura

Plataforma compartilhada

Um único motor de fluxos semânticos conecta as interfaces do produto, as integrações e os adaptadores de execução com limites.

As interfaces convergem para um motor

Chat, construtor visual, API para desenvolvedores, SDK, MCP e canais de conversa alimentam a mesma plataforma FloFi. O Semantic Workflow IR canônico é checado no registro de capacidades e validado antes de gerar resultados.

Ciclo · bash

Chat / Builder / API / MCP
            ↓
Canonical Semantic Workflow IR
            ↓
Capabilities → Validation → Simulation
            ↓
Strategy Manifest → Owner wallet authorization
            ↓
Execution → Reconciliation → Evidence Bundle

Responsabilidades no repositório

Local	Responsabilidade
apps/reference-dapp	Produto em Next.js, site público, docs e rotas de integração
packages/workflow-contracts	Esquemas canônicos, hashes e contratos do ciclo
packages/action-registry	Definições de ações e capacidades
packages/reference-linter / reference-compiler	Validação e planejamento de execução com limites
packages/reference-executor / reference-reconciler	Acompanhamento da execução e verificação do resultado
packages/cloud-runtime	Infraestrutura persistente da plataforma
packages/developer-sdk	Cliente fino de API e webhooks para servidor

Estado persistente, ambientes específicos

O runtime de nuvem usa PostgreSQL para o estado da plataforma. Os ambientes de cada fluxo financeiro são configurados à parte. A disponibilidade numa implantação não é deduzida só porque existe uma rota ou um adaptador.

A recuperação preserva o histórico de tentativas e a origem das evidências. Uma edição no fluxo invalida os compromissos seguintes; uma edição só visual, não. Leia os guias Strategy Manifest e Segurança para entender os limites de confiança.

Fontes: README.md · docs/contracts/CANONICALIZATION_V1.md · docs/deploy/CLOUD.md · docs/AUTHORITY_MATRIX.md