Sobre o acervo e a aplicação
Ferramenta de consulta e gestão documental do acervo da Reparação da Bacia do Rio Doce, construída sobre o catálogo produzido pelo coletor deste projeto.
Origem e crédito
Este é o acervo de documentos da Fundação Renova, que disponibilizou publicamente o material para consulta. Os arquivos foram publicados originalmente em reparacaobaciariodoce.com/documentos.
A aplicação não é a fonte original: ela preserva a autoria e a rastreabilidade de cada documento, mantendo o identificador, a URL de origem e o arquivo exatamente como disponibilizado pela Fundação Renova.
O acervo
O acervo reúne 902 documentos disponibilizados pela Fundação Renova e publicados em reparacaobaciariodoce.com/documentos, entre 2016 e 2026: relatórios anuais e financeiros, atas de conselho, boletins de qualidade da água, relatórios CIF, masterplans, cartilhas e materiais educativos.
O conteúdo é de responsabilidade das instituições que o publicaram. Esta aplicação apenas organiza, indexa e facilita o acesso ao que já é público, preservando a rastreabilidade de cada arquivo até a URL original.
Como os dados foram produzidos
- Inventário: a REST API do site é percorrida por completo (documentos, taxonomia e mídias), reconstruindo o vínculo entre cada documento e seu arquivo.
- Resolução de URL: cada documento tem suas URLs candidatas testadas até encontrar o arquivo real; links quebrados são registrados como indisponíveis.
- Download íntegro: gravação atômica, validação de tamanho, SHA-256 calculado durante a transferência e retomada automática em caso de interrupção.
- Enriquecimento: tipo documental, família, período de referência, temas, órgãos, municípios e programas são derivados dos títulos, descrições e do texto dos PDFs.
- Catálogo: os metadados são consolidados em SQLite com índice de busca textual (FTS5), consumido por esta aplicação.
Catálogo gerado em 2026-11-03T19:24:17+00:00 · 902 documentos · 44.621 páginas · 715 documentos com texto pesquisável.
Stack e arquitetura
Interface
Design System do Governo Federal (Gov.br DS 3.7), fonte Rawline e ícones Font Awesome, empacotados localmente — sem dependência de CDN.
Servidor
Python 3.12 + FastAPI + Jinja2, renderização no servidor e aprimoramento progressivo com JavaScript. Sem build de front-end para manter.
Dados
SQLite com FTS5: busca textual com remoção de acentos e facetas por categoria, tipo, ano, tema, órgão, município e programa.
Implantação
Nginx + systemd em VPS Linux. O acervo de arquivos fica em volume separado, servido diretamente pelo Nginx.
Dicionário de metadados
| Campo | Descrição |
|---|---|
tipo / familia | Classificação documental (ata, boletim, relatório CIF, cartilha…) e agrupamento funcional. |
periodo | Período de referência do conteúdo, extraído do título (ex.: 2024-09), que pode diferir da publicação. |
tags | Temas derivados de palavras-chave (qualidade da água, indenização, biodiversidade…). |
orgaos | Instituições citadas (CIF, TTAC, Conselho Curador, MPMG…). |
municipios | Municípios da área de abrangência mencionados no documento. |
programas | Códigos de programa do TTAC (PG06, PG28, PG30…). |
paginas, sha256 | Extensão do PDF e hash de integridade do arquivo. |
status | Disponibilidade do arquivo local (disponível ou indisponível na fonte). |
API de consulta
Os mesmos filtros da interface estão disponíveis em JSON, para integrações e reuso dos dados.
| Endpoint | Descrição |
|---|---|
/api/documentos | Lista paginada; aceita q, categoria, tipo, ano, tag, orgao, municipio, programa, status, pagina. |
/api/documentos/{id} | Metadados completos de um documento. |
/api/facetas | Contagens por faceta para o recorte atual. |
/api/estatisticas | Séries e indicadores do recorte. |
/api/painel | Séries com cross-filtering: cada faceta ignora o próprio filtro, para os painéis interativos. |
/api/qualidade | Cobertura, indisponíveis e duplicatas. |
/exportar.csv · /exportar.json | Exportação do recorte filtrado. |
/healthz | Verificação de saúde para monitoramento. |
Acessibilidade
A interface segue o Design System do Governo Federal e busca conformidade com as diretrizes WCAG 2.1 nível AA:
- estrutura semântica com marcos de navegação, títulos hierárquicos e link de salto;
- atalhos de teclado (teclas 1 a 4) para conteúdo, menu, busca e rodapé;
- foco visível, contraste adequado e navegação completa sem mouse;
- todos os gráficos têm tabela equivalente e descrição textual;
- formulários com rótulos explícitos e mensagens de status anunciadas;
- respeito a
prefers-reduced-motione layout responsivo até 320 px.
Encontrou alguma barreira? Registre para a equipe responsável pela implantação com a página, o dispositivo e o navegador utilizados.
Versão e uso
Aplicação v2.1.0, em execução sobre o catálogo gerado pelo coletor do projeto. Os arquivos originais ficam em volume de dados separado do código, servidos diretamente pelo servidor web.
Uso permitido para pesquisa, jornalismo, controle social e gestão pública, observados os direitos e os termos das instituições de origem.