LexFlow — Regulatory Knowledge Platform

Arquitetura

 ┌──────────────────────┐
 │ Normativos (PDF/MD) │
 └──────────┬───────────┘
 │
 ▼
 ┌──────────────────────┐
 │ Parser/Normalizer │
 │ (JSON + YAML SBVR) │
 └──────────┬───────────┘
 │
 ┌──────────┴───────────┐
 │ │
 ▼ ▼
 ┌──────────────┐ ┌──────────────────┐
 │ MCP Server │ │ Preview UI │
 │ :3001 │ │ :3002 │
 │ REST + SSE │ │ Next.js │
 └──────────────┘ └──────────────────┘
 │ │
 ▼ ▼
 Agentes/LLMs Humanos/Operação

Componentes

Dados disponíveis

Estrutura de uma regra SBVR (YAML)

id: bcb-rc-17-r03
referencia_normativa:
 ato: Resolucao Conjunta
 numero: 17
 data: 2025年11月28日
artigo: Art. 3o, caput
modalidade: proibido
regra_sbvr: "É proibido usar, na nomenclatura, termo que sugira atividade ou tipo de instituição sem autorização de funcionamento específica."
sbvr:
 scd:
 scope:
 atores: [instituicao_autorizada_bcb]
 contexto: [nomenclatura_apresentacao_publico]
 papeis: [sujeito_regulado]
 condition:
 existe: false
 demand:
 modalidade: proibicao
 proibicoes: [cumprimento_da_regra]
texto_original: "É vedado [...] utilizar, em sua nomenclatura, termo que sugira..."
keywords: [vedacao, nomenclatura, semelhanca_morfologica, ...]
vocabulario_conceitos:
 - termo: termo
 conceito: Palavra, fragmento, expressão ou frase usada na nomenclatura.
ambiguidades_relacionadas:
 - id: A-02
 titulo: '"Sugestão" por semelhança morfológica ou fonética'
 descricao: Falta método formal para aferição de semelhança e limiar de aceitação.

MCP Server

Stack

Endpoints

REST API (/api)

MCP Protocol (/mcp SSE)

Como executar

cd mcp-server
npm install
npm run dev # → http://localhost:3001

Testar com Claude Desktop

{
 "mcpServers": {
 "lexflow": {
 "url": "http://localhost:3001/mcp"
 }
 }
}

Preview UI

Stack

Funcionalidades (MVP)

Como executar

cd preview-ui
npm install
npm run dev # → http://localhost:3002

Build estático

npm run build # gera ./out/
npx serve out # serve em qualquer porta

Estrutura do projeto

/home/cleilson/compliance/
├── README.md
├── .gitignore
├── scripts/ # Scripts utilitários
│ └── update_yaml.py # Atualiza metadados dos YAMLs SBVR
├── bcb-rc-16-28-11-2025/ # Dados brutos RC 16
│ ├── resolucao-completa.md # Texto integral da resolução
│ ├── rc16-estrutura-detalhada.json
│ ├── sbvr-bcb-rc-16-28-11-2025.md
│ ├── build_json_rc16.py
│ ├── generate_rc16_yamls.py
│ └── sbvr/ # 81 YAMLs SBVR
├── bcb-rc-17-28-11-2025/ # Dados brutos RC 17
│ ├── resolucao-completa.md # Texto integral da resolução
│ ├── rc17-estrutura-detalhada.json
│ ├── sbvr-bcb-rc-17-28-11-2025.md
│ ├── build_json_rc17.py
│ └── sbvr/ # 36 YAMLs SBVR
├── mcp-server/ # MCP Server (TypeScript)
│ ├── package.json
│ ├── tsconfig.json
│ └── src/
│ ├── index.ts # Entrypoint Express + MCP SSE
│ ├── schemas/models.ts # Interfaces TypeScript
│ ├── services/ # Data access layer
│ │ ├── documento-service.ts
│ │ └── regra-service.ts
│ ├── mcp/ # MCP tool definitions
│ │ ├── index.ts
│ │ ├── documentos.ts
│ │ └── regras.ts
│ └── api/ # REST routes
│ ├── index.ts
│ ├── documentos.ts
│ ├── regras.ts
│ └── taxonomia.ts
└── preview-ui/ # Preview UI (Next.js)
 ├── package.json
 ├── tsconfig.json
 ├── next.config.js
 ├── tailwind.config.ts
 ├── postcss.config.js
 ├── scripts/
 │ └── build-static-data.cjs # Gera data.json dos YAMLs/JSONs
 └── src/
 ├── app/
 │ ├── layout.tsx
 │ ├── page.tsx
 │ └── globals.css
 ├── components/
 │ ├── sidebar.tsx
 │ ├── main-panel.tsx
 │ ├── search-bar.tsx
 │ ├── rule-card.tsx
 │ ├── source-viewer.tsx
 │ ├── yaml-viewer.tsx # Visual + toggle YAML
 │ └── document-viewer.tsx # Norma completa
 ├── lib/
 │ └── api.ts
 └── types/
 └── index.ts

Roadmap

Fase 1 — MVP ✅

Fase 2 — Próximos passos

Fase 3 — Visão

Licença