Resumo
Produto analítico demonstrativo para explorar arrecadação, metas, variações temporais e composição das receitas em uma interface executiva.
Case de projeto
- Projeto demonstrativo
- Dados sintéticos
- Implementação web
Receita Pública Intelligence Platform
Produto analítico web demonstrativo para explorar arrecadação sintética, metas, variações temporais e composição das receitas em uma interface executiva.
Código-fonte privadoAs evidências técnicas verificáveis estão documentadas neste case.
Visão geral
Problema
Bases fiscais podem ser extensas e fragmentadas, dificultando a identificação de tendências, desvios e fontes relevantes de arrecadação.
Meu papel
Estruturação dos indicadores, modelagem do cenário analítico, desenvolvimento das visualizações e organização da narrativa executiva.
- Atingimento da meta
- 97,2%
- Demo publicada / /api/revenue?year=2026, dados sintéticos / 13 out. 2026
- Score de saúde fiscal
- 99/100
- Demo publicada / /api/revenue?year=2026, heurística de concentração / 13 out. 2026
- Registros mensais em 2026
- 120
- Demo publicada / contagem em /api/revenue?year=2026 / 13 out. 2026
Dados e premissas
Os dados são integralmente sintéticos e reproduzíveis. Um gerador TypeScript determinístico cria registros mensais com sazonalidade, tendência e anomalias controladas; não existe banco, carga de CSV, API oficial ou informação pessoal na fonte atual.
Projeto independente e demonstrativo, sem vínculo institucional, desenvolvido para representar como indicadores de arrecadação podem apoiar análise fiscal e tomada de decisão.
O projeto foi inspirado em conhecimentos adquiridos em rotinas profissionais de análise de dados públicos, sem utilizar sistemas internos, dados sigilosos ou materiais institucionais.
- Volume
- 600 registros sintéticos
- Período
- Janeiro de 2022 a dezembro de 2026
- Granularidade
- Um mês por tributo e município fictício
Estrutura dos dados
Entidades modeladas
- Fato de arrecadação: período, tributo, categoria, valor estimado, valor arrecadado, comparações e status frente à meta.
- Tributos: ISS, IPTU, ITBI, TLP, TLF, CIP, Dívida Ativa, Multas e Juros, Receitas Patrimoniais e Outras Receitas.
- Categorias efetivamente populadas: Receitas Próprias, Receitas Patrimoniais e Outras Receitas.
- Calendário: ano, mês, nome do mês e chave mensal entre 2022 e 2026.
- Município: uma entidade inteiramente fictícia identificada como mun-001.
Arquitetura da solução
O fluxo separa geração dos dados, contrato de acesso, cálculos, APIs e visualização para manter as regras reproduzíveis e permitir uma fonte real futura sem reescrever a interface.
Gerador sintético determinístico
Entradas de calendário, tributos, sazonalidade e ruído com seed produzem 600 registros TypeScript identificados como simulated-model-v1.
Contrato e provider de dados
Tipos de domínio e o RevenueDataProvider recebem filtros e entregam registros e agregados; a implementação atual é exclusivamente mock em memória.
Cálculos e regras analíticas
Funções puras calculam totais, gap, atingimento, variações, participação, acumulado, forecast, score e insights explicáveis.
Route Handlers e validação
APIs Next.js aplicam filtros validados com Zod e devolvem JSON em um envelope consistente.
Dashboard executivo web
Server Components carregam a base e ilhas cliente aplicam filtros, simulador e gráficos Recharts na interface responsiva.
Indicadores e regras de negócio
As definições abaixo correspondem às funções TypeScript e à metodologia da aplicação. Todos os resultados são calculados sobre dados sintéticos.
| Definição | Unidade | Regra de cálculo | Uso | Limitação |
|---|---|---|---|---|
| Receita estimadaSoma dos valores de referência do recorte selecionado. | R$ | Soma de estimatedAmount. | Estabelecer a base comparativa para metas e projeções. | A estimativa é gerada pelo modelo sintético e não por uma lei orçamentária real. |
| Receita arrecadadaSoma dos valores simulados como arrecadados no recorte. | R$ | Soma de collectedAmount. | Comparar realização, composição e evolução temporal. | Os valores não representam arrecadação oficial ou resultado fiscal real. |
| Gap financeiroDiferença entre o arrecadado e o estimado. | R$ | Receita arrecadada − receita estimada. | Identificar desvios positivos ou negativos frente à referência. | O sinal depende de duas medidas sintéticas e não expressa impacto orçamentário real. |
| Atingimento da metaPercentual arrecadado em relação ao valor estimado. | % | Receita arrecadada ÷ receita estimada × 100. | Monitorar aderência à meta no período filtrado. | Retorna zero quando a base estimada é zero e usa metas apenas demonstrativas. |
| Variação mensalMudança percentual do arrecadado entre meses consecutivos. | % | (Mês atual − mês anterior) ÷ mês anterior × 100. | Observar aceleração, queda e sazonalidade de curto prazo. | O primeiro ponto não possui comparação anterior e recebe variação zero. |
| Variação anualMudança percentual da arrecadação agregada entre anos consecutivos. | % | (Ano atual − ano anterior) ÷ ano anterior × 100. | Comparar tendência de crescimento no horizonte de cinco anos. | A série incorpora a tendência artificial definida pelo gerador. |
| Participação por tributoParcela de cada tributo no total arrecadado do recorte. | % | Arrecadado do tributo ÷ arrecadação total × 100. | Analisar concentração e dependência da composição fiscal simulada. | Os pesos de cada tributo foram definidos para o cenário demonstrativo. |
| Projeção anualEstimativa de fechamento com base no ritmo arrecadado até o mês de corte. | R$ e % | Média mensal observada × 12, comparada à meta anual. | Sinalizar cenários de fechamento saudável, atenção ou risco. | Forecast heurístico com corte padrão no mês 9, sem modelo estatístico. |
| Revenue Health ScoreScore composto para sintetizar a saúde da arrecadação demonstrativa. | 0 a 100 | Combina atingimento, tendência, concentração, meses abaixo da meta e anomalias com pesos fixos. | Oferecer uma leitura executiva consolidada do recorte. | Pesos e faixas são heurísticos e não foram calibrados com dados fiscais reais. |
Receita estimada
Soma dos valores de referência do recorte selecionado.
- Unidade
- R$
- Regra de cálculo
- Soma de estimatedAmount.
- Uso
- Estabelecer a base comparativa para metas e projeções.
- Limitação
- A estimativa é gerada pelo modelo sintético e não por uma lei orçamentária real.
Receita arrecadada
Soma dos valores simulados como arrecadados no recorte.
- Unidade
- R$
- Regra de cálculo
- Soma de collectedAmount.
- Uso
- Comparar realização, composição e evolução temporal.
- Limitação
- Os valores não representam arrecadação oficial ou resultado fiscal real.
Gap financeiro
Diferença entre o arrecadado e o estimado.
- Unidade
- R$
- Regra de cálculo
- Receita arrecadada − receita estimada.
- Uso
- Identificar desvios positivos ou negativos frente à referência.
- Limitação
- O sinal depende de duas medidas sintéticas e não expressa impacto orçamentário real.
Atingimento da meta
Percentual arrecadado em relação ao valor estimado.
- Unidade
- %
- Regra de cálculo
- Receita arrecadada ÷ receita estimada × 100.
- Uso
- Monitorar aderência à meta no período filtrado.
- Limitação
- Retorna zero quando a base estimada é zero e usa metas apenas demonstrativas.
Variação mensal
Mudança percentual do arrecadado entre meses consecutivos.
- Unidade
- %
- Regra de cálculo
- (Mês atual − mês anterior) ÷ mês anterior × 100.
- Uso
- Observar aceleração, queda e sazonalidade de curto prazo.
- Limitação
- O primeiro ponto não possui comparação anterior e recebe variação zero.
Variação anual
Mudança percentual da arrecadação agregada entre anos consecutivos.
- Unidade
- %
- Regra de cálculo
- (Ano atual − ano anterior) ÷ ano anterior × 100.
- Uso
- Comparar tendência de crescimento no horizonte de cinco anos.
- Limitação
- A série incorpora a tendência artificial definida pelo gerador.
Participação por tributo
Parcela de cada tributo no total arrecadado do recorte.
- Unidade
- %
- Regra de cálculo
- Arrecadado do tributo ÷ arrecadação total × 100.
- Uso
- Analisar concentração e dependência da composição fiscal simulada.
- Limitação
- Os pesos de cada tributo foram definidos para o cenário demonstrativo.
Projeção anual
Estimativa de fechamento com base no ritmo arrecadado até o mês de corte.
- Unidade
- R$ e %
- Regra de cálculo
- Média mensal observada × 12, comparada à meta anual.
- Uso
- Sinalizar cenários de fechamento saudável, atenção ou risco.
- Limitação
- Forecast heurístico com corte padrão no mês 9, sem modelo estatístico.
Revenue Health Score
Score composto para sintetizar a saúde da arrecadação demonstrativa.
- Unidade
- 0 a 100
- Regra de cálculo
- Combina atingimento, tendência, concentração, meses abaixo da meta e anomalias com pesos fixos.
- Uso
- Oferecer uma leitura executiva consolidada do recorte.
- Limitação
- Pesos e faixas são heurísticos e não foram calibrados com dados fiscais reais.
Decisões técnicas
Modelagem fiscal sintética e determinística
- Motivo
- Criar uma série reproduzível com tendência, sazonalidade e anomalias sem expor dados institucionais.
- Consequência / trade-off
- O realismo depende de parâmetros artificiais e não permite inferir desempenho de um município real.
Separação entre dados, cálculos e visualização
- Motivo
- Reutilizar as mesmas regras em páginas, APIs, gráficos, tabela, insights e simulador.
- Consequência / trade-off
- A arquitetura adiciona contratos que precisam permanecer sincronizados.
Leitura executiva responsiva
- Motivo
- Manter KPIs, filtros, gráficos e tabela utilizáveis em desktop e dispositivos menores.
- Consequência / trade-off
- A densidade analítica precisa ser distribuída em blocos e representações adaptadas por viewport.
Outras decisões técnicas
Server-first com ilhas cliente
- Motivo
- Carregar dados no servidor e limitar JavaScript interativo a filtros, gráficos, insights e simulador.
- Consequência / trade-off
- Os limites entre componentes servidor e cliente exigem contratos serializáveis.
Provider substituível
- Motivo
- Evitar acoplamento direto da interface ao gerador mock e preparar uma fonte autorizada futura.
- Consequência / trade-off
- A abstração não adiciona persistência: a implementação atual continua em memória.
Insights e forecast explicáveis
- Motivo
- Centralizar alertas, evidências e recomendações em regras TypeScript testáveis.
- Consequência / trade-off
- Regras e pesos fixos simplificam auditoria, mas não substituem validação estatística ou fiscal.
Evidências técnicas
Aplicação, endpoints, metodologia e referências locais são apresentados conforme seu nível real de acesso.
Aplicação pública
Aplicação publicada
Landing page pública com declaração de produto demonstrativo, KPIs sintéticos e acesso ao dashboard.
Abrir evidênciaAplicação pública
Dashboard executivo
Interface pública com filtros, KPIs, score, forecast, gráficos, tabela, insights e exportação CSV.
Abrir evidênciaEndpoint público
API de arrecadação
Endpoint público com registros sintéticos, totais, ranking, categorias, score e forecast do recorte de 2026.
Abrir evidênciaEndpoint público
API de projeção
Endpoint público com fechamento projetado, gap, atingimento, meta anual e status do cenário.
Abrir evidênciaDocumentação pública
Metodologia publicada
Página pública que documenta dados fictícios, fórmulas, score, insights e simulação.
Abrir evidênciaReferências de implementação
Referência de código
Gerador dos dados sintéticos
Série determinística de 2022 a 2026 com dez tributos, sazonalidade e anomalias controladas.
Referência de códigosrc/data/mock-revenue.ts · src/data/dictionary.ts
Referência de código
Regras dos indicadores
Funções puras de totais, variações, participação, acumulado, forecast e Revenue Health Score.
Referência de códigosrc/lib/calculations.ts · src/lib/forecast.ts
Código-fonte privado
Repositório privado
O código-fonte é privado; a aplicação publicada e as APIs são a evidência verificável.
Indicadores do cenário demonstrativo
- Dados simulados
- R$ 248.587.119
- Receita arrecadada
- Soma de collectedAmount no conjunto sintético de 2026.
- Dados simulados
- 97,2%
- Atingimento da meta
- Relação entre receita sintética arrecadada e estimada em 2026.
- Dados simulados
- 99/100
- Revenue Health Score
- Score heurístico calculado sobre o mesmo recorte demonstrativo.
Indicadores calculados para o recorte padrão de 2026 sobre 120 registros sintéticos. Eles não representam arrecadação oficial, resultado fiscal real ou desempenho de uma instituição.
Valores reproduzidos pela aplicação publicada e pelos endpoints /api/revenue?year=2026 e /api/forecast?year=2026.
Competências demonstradas
- Modelagem de indicadores fiscais.
- Análise temporal e comparativa.
- Estruturação de narrativa executiva.
- Visualização de dados sintéticos inspirados no setor público.
- Desenvolvimento de produto analítico web.
- Documentação de premissas e limitações.
Limitações e próximos passos
Limitações
- Dados, município, metas e resultados integralmente sintéticos.
- Projeto independente, sem vínculo institucional ou integração com sistemas governamentais.
- Sem banco de dados, atualização oficial ou fonte pública conectada na implementação atual.
- Forecast, score e insights baseados em heurísticas demonstrativas.
- O repositório é privado e os mockups não reproduzem os valores atuais da API.
Próximas evoluções
- Integração autorizada com uma fonte oficial de dados abertos.
- Validação de qualidade, proveniência e atualização incremental.
- Histórico ampliado e alertas configuráveis de desvio.
- Autenticação e controle de acesso para cenários institucionais.
- Versão Power BI real, documentada separadamente da aplicação web.
- Observabilidade e ampliação dos testes automatizados.
Galeria
As imagens são conceitos visuais e mockups de produto. Elas não representam uma plataforma governamental, nem reproduzem os valores atuais calculados pela aplicação publicada.
Detalhes técnicos opcionais
Como executar
- Acesse a aplicação publicada na Vercel.
- Abra o dashboard para explorar filtros, KPIs, gráficos, ranking e insights.
- Consulte a metodologia pública para revisar fórmulas, score e regras de simulação.
- Use as APIs públicas para verificar os registros e agregados do conjunto sintético.
Próximo projeto
Interface Web de Gestos Sem Contato
Workspace controlado por gestos da mão na câmera, com pipeline de quadro adaptativo e motor de gestos próprio.
Ver case completo