Vozes Ausentes PB

MVP analítico construído somente com os arquivos locais de data/. O sistema preserva a base eleitoral completa, integra o subconjunto socioeconômico disponível, publica snapshots auditáveis e expõe dashboard, API e assistente local orientado por ferramentas.

Execução

make pipeline
make test
make serve

Abra http://localhost:8000. Também é possível executar podman compose up --build.

Os alvos do Makefile executam pipeline, testes e servidor dentro do Podman. Não é necessário instalar dependências Python no host.

Configuração

• Regras do pipeline, caminhos e pesos do score: config/settings.json.
• Consulta oficial SIDRA e parâmetros de ingestão: config/sidra.json.
• Provedor, nomes de variáveis de ambiente e guardrails de IA: config/ai.json.
• Comportamento editável do assistente: ai/prompts/.
• Credenciais opcionais: variáveis descritas em .env.example; nenhuma chave é versionada.

O MVP usa SQLite e a biblioteca padrão do Python para funcionar sem instalação de pacotes. A evolução para PostgreSQL pode substituir o repositório em app/repositories/ sem alterar os contratos HTTP.

Cobertura local

O eleitoral, a renda municipal de 2022 e a malha geográfica contêm os 223 municípios da Paraíba. O dashboard usa data/geo/geojs-25-mun.json para exibir o mapa de calor completo.

Para atualizar os indicadores socioeconômicos pela API oficial do SIDRA:

make ingest
make pipeline

Deploy na Vercel

O deploy da Vercel usa uma Function Python e um snapshot SQLite somente leitura. O assistente local funciona sem chave de LLM.

Atualize e valide o snapshot antes de publicar:

make pipeline
make test
make deploy-snapshot
vercel --prod

O arquivo versionável data/deploy/vozes_ausentes_pb.sqlite3 deve acompanhar o deploy. A Vercel não executa o Containerfile; o fluxo Podman continua sendo usado para ingestão, pipeline e testes locais.

Comece a leitura técnica por docs/llm-wiki/00-index.md. A matriz de entregas e bloqueios locais está em docs/llm-wiki/09-requirements-traceability.md.