snapshot.md

# Snapshot do Projeto para.AI

## Objetivo

Plataforma de análise de acórdãos com:

- Segmentação estrutural (ementa, relatório, voto, dispositivo).
- Extração de metadados.
- Fundamentação jurídica estruturada.
- Geração de relatórios por múltiplos “especialistas” IA.
- Auditoria completa de acessos e análises.

## Módulos Principais

- `database/`
  - Conexão PostgreSQL (`db_manager.py`).
  - Modelos ORM (`models.py`).
  - Script DDL inicial (`init_db.sql`).
  - Migrações Alembic.
- `files/`
  - Empacotamento e extração TAR/TAR.GZ.
  - Backup e verificação de integridade (SHA-256).
- `prompts/`
  - 9 especialistas (constitucional, civil, penal, etc.).
  - Prompts auxiliares (segmentação, contexto, transcrição).
  - Schemas JSON para validação de saídas (metadados, decisão, auditoria, etc.).
- `llm/`
  - Manager centralizado de provedores (Groq, OpenAI, Anthropic).
  - Coletor de métricas de custo, tokens e latência.

## Fluxo Alto Nível

1. Ingestão de acórdão (upload ou pipeline externo).
2. Normalização e transcrição (`prompts` + `transcricao_schema.json`).
3. Segmentação estrutural (`segmentacao_schema.json`).
4. Extração de metadados e decisão (`metadados_schema.json`, `decisao_schema.json`).
5. Análises por especialistas e geração de relatórios (`relatorio_schema.json`).
6. Armazenamento de resultados em PostgreSQL.
7. Registro de auditoria (`auditoria_schema.json` + `auditoria_acessos`).