← Voltar aos projetos

Dados e transparência

Analisador de Gastos Públicos

Ement: aplicação para comparar a destinação de emendas parlamentares entre estados, consultar registros e exportar dados do Portal da Transparência.

Ano2026
Minha contribuiçãoDesenvolvimento full stack
TecnologiasNuxt · TypeScript · FastAPI · PostgreSQL · D3
Visão geral do Ement com valores empenhados, liquidados e pagos, evolução por ano e principais áreas de destinação.

Entender a destinação dos recursos

Consultar uma emenda na base pública é diferente de entender como os recursos se distribuem pelo país. Para comparar estados ou investigar uma área como saúde, é preciso filtrar milhares de registros, somar valores e distinguir o que foi empenhado, liquidado e pago.

Desenvolvi o Ement para reunir essas consultas em uma aplicação: partir de uma visão nacional, escolher um recorte e chegar aos detalhes de cada destinação sem perder os filtros usados na análise.

Da importação à consulta

Meu trabalho abrange a importação da base, as consultas e agregações na API e a interface de exploração. A visão geral mostra os valores empenhados, liquidados e pagos, a distribuição por ano de proposição e as principais áreas e unidades federativas de aplicação.

No mapa, é possível comparar os estados por valor empenhado, pago ou empenhado por habitante. A consulta de registros combina ano, estado, área e busca por texto, com ordenação e paginação. Cada registro reúne autor, localidade, programa, ação orçamentária e valores detalhados. Os filtros ficam na URL, preservando o recorte ao navegar entre as telas.

Arquitetura

A base de emendas do Portal da Transparência é importada por scripts Python para PostgreSQL. Uma API FastAPI consulta os registros e calcula as agregações no servidor, usando asyncpg.

O frontend usa Nuxt, Vue e TypeScript. Os componentes organizam filtros, indicadores, gráficos e detalhes. O D3 desenha o mapa a partir de um arquivo geográfico local com os 26 estados e o Distrito Federal. O cálculo por habitante usa a população do Censo 2022 do IBGE.

Decisões para consultar e interpretar os dados

  • O mesmo recorte em cada visualização: indicadores, mapa, lista e CSV usam os mesmos parâmetros. A exportação inclui todos os registros encontrados, não apenas a página visível.
  • Entrada do usuário nas consultas: os valores são enviados como parâmetros SQL, e a ordenação aceita opções predefinidas. Assim, filtros e escolha de ordenação não são inseridos livremente no texto da consulta.
  • Leitura dos resultados: totais e agrupamentos são consultados em uma mesma transação. A exportação percorre os resultados em lotes, sem carregar todo o CSV na memória de uma vez.
  • Etapas do gasto separadas: empenhado, liquidado e pago têm indicadores próprios. Os pagamentos de restos a pagar também são identificados, preservando a distinção entre as etapas e os compromissos de exercícios anteriores.
  • Limites da comparação geográfica: registros sem UF permanecem nos totais, mas não são atribuídos a um estado. O indicador por habitante informa o ano da população usada, para explicitar a referência da comparação.
  • Consulta por teclado e no celular: o layout é responsivo; o mapa permite seleção por teclado e o diálogo de detalhes tem navegação por foco.

Escopo e validação

A base apresentada contém 86.871 registros, com anos de proposição de 2014 a 2025. Na aplicação, é possível comparar a distribuição dos recursos, consultar uma destinação e exportar o recorte escolhido.

A validação compara os totais da API com o CSV de origem, centavo a centavo, e verifica filtros combinados, paginação, exportação e tratamento de consultas inválidas. A página de fontes explica a cobertura e o significado dos indicadores, com links para conferência. As capturas mostram a aplicação em execução com essa base.

Tecnologias

Python · FastAPI · asyncpg · PostgreSQL · Piccolo · Nuxt · Vue · TypeScript · Nuxt UI · D3

← Voltar aos projetos

PROJETOS E OPORTUNIDADES

Vamos conversar?

Estou disponível para projetos freelance e para integrar uma equipe de desenvolvimento.

Entre em contato