architecture.md

Arquitetura em Alto Nivel

Idioma: pt-BR | English

Esta pagina descreve a arquitetura do produto em termos de funcoes, nao em termos de implementacao privada.

Camadas

• Interface principal: onde o advogado interage com o produto
• Motor de inteligencia: busca, composicao, raciocinio e orquestracao central
• Grounding legislativo: resolucao e contexto de dispositivos legais
• Inteligencia documental: leitura de acervo, sinais e priorizacao
• Avaliacao e validacao: comparativos, testes e evidencias de qualidade

Fluxo simplificado

flowchart LR
    U["Advogado"] --> I["Interface Principal"]
    I --> M["Motor de Inteligencia"]
    I --> G["Grounding Legislativo"]
    M --> G
    D["Inteligencia Documental"] --> M
    V["Camada de Avaliacao"] --> M
    M --> O["Resposta Rastreavel"]

Loading

O que cada camada faz

Interface principal

Recebe a pergunta, o contexto do caso e o fluxo de trabalho do usuario. Ela precisa manter a experiencia simples, sem empurrar complexidade tecnica para o advogado.

Motor de inteligencia

E a camada central que combina busca, estrutura juridica, composicao de resposta e mecanismos de auditabilidade.

Grounding legislativo

Entrega resolucao canonica de normas, dispositivos e contexto legal para que o restante do sistema nao trate legislacao como texto solto.

Inteligencia documental

Ajuda a transformar documentos e acervos em sinais uteis para o sistema, inclusive priorizacao do que vale aprofundar primeiro.

Avaliacao e validacao

Mede o quanto o sistema gera valor acima de um fluxo sem estrutura. Essa camada inclui comparativos, casos de teste e verificacao externa.

O que este documento nao cobre

Nao detalhamos aqui:

• nomes internos de repositorios ou servicos
• infraestrutura privada
• endpoints internos
• backlog tecnico

Esses detalhes ficam fora do repo publico por enquanto.