Visão geral

Contexto antes da tecnologia.

Um projeto educacional e evolutivo para estudar processamento documental, recuperação de informação, RAG, regras e grafos em um domínio que exige proveniência, abstention, versionamento e revisão humana.

O desafio

Problema

Documentos extensos, versões temporais, regras distribuídas e relações entre entidades dificultam localizar e correlacionar evidências. Em um domínio sensível, o sistema também precisa reconhecer evidência insuficiente, preservar a origem dos fatos e interromper fluxos que não atendam aos critérios de segurança.

Construção

Abordagem

O sistema parte de ingestão local, BM25 e roteamento determinístico. Um caminho experimental compila e sela contextos, orquestra síntese opt-in e verifica fatos estruturados antes de liberar uma saída. O ciclo mais recente adicionou regras revisadas e um gateway de grafo explícito: no holdout sintético, o gateway recuperou 4/4 cadeias em que o BM25 obteve 0/4; admissão e publicação versionada do catálogo também atingiram 8/8. A suíte atual soma 337 testes. Os resultados são restritos a dados sintéticos: modelo local, extração automática, runtime padrão e corpus privado continuam bloqueados.

Arquitetura atual

Como as partes se conectam.

  1. Documentos e snapshots
  2. Retrieval e roteamento
  3. Contexto e verificação
  4. Regras estruturadas
  5. Grafo explícito e opt-in
Decisões

Escolhas que orientam o projeto.

  • ✓BM25 permanece como baseline até outra abordagem demonstrar ganho mensurável
  • ✓Regras e grafos aceitam apenas entradas revisadas, versionadas e com provenance
  • ✓Falhas de qualidade ou segurança bloqueiam geração, publicação e acesso ao corpus privado
Próximos passos

O que vem depois.

  • +Escolher o próximo gate a partir do roadmap arquitetural
  • +Comparar tools tipadas e workflows determinísticos antes de introduzir agentes
  • +Manter extração automática, runtime padrão e corpus privado fora dos caminhos experimentais
Código e contexto

Um estudo de caso sobre decisões, arquitetura e evolução.

Abrir repositório
Falar no WhatsApp