Transparência também no código
O Observa o Fiscal é um projeto de código aberto. Acreditamos que a transparência pública começa pela transparência técnica — qualquer pessoa pode auditar, contribuir ou reutilizar este projeto.
O repositório será publicado em breve. Cadastre-se para ser notificado.
Stack tecnológica
Tecnologias modernas, abertas e bem documentadas.
React 19 + TypeScript
Interface reativa com tipagem estática. Componentes funcionais com hooks modernos.
Vite + SSR
Build ultrarrápido com renderização no servidor para SEO e performance.
Tailwind CSS + shadcn/ui
Estilização utilitária com componentes acessíveis baseados em Radix UI.
React Router v7
Roteamento com data loaders para SSR e navegação client-side.
Express.js
Servidor HTTP leve para rotas de API e renderização SSR.
Node.js
Runtime JavaScript no servidor. Compatível com Alpine Linux (musl).
JSON + content layer
Dados fiscais em arquivos JSON versionados, editáveis inline pelo CMS.
Siconfi / STN
Fonte primária: Sistema de Informações Contábeis e Fiscais do Setor Público Brasileiro.
Arquitetura
Estrutura de pastas e decisões de design do projeto.
src/pages/Páginas da aplicação — cada arquivo é uma rota pública.
src/components/Componentes reutilizáveis de UI, incluindo gráficos e visualizações.
src/content/Dados e textos editáveis — publicações, ranking, indicadores.
src/server/Servidor Express: rotas de API e pipeline de SSR.
src/layouts/Header, Footer e shell da aplicação.
src/lib/Utilitários, rotas SEO, metadados do site.
Como contribuir
Toda contribuição é bem-vinda — de correções de dados a novas funcionalidades.
Fork o repositório
Crie uma cópia do projeto na sua conta GitHub.
Crie uma branch
Use nomes descritivos: feature/novo-indicador ou fix/calculo-icf.
Faça suas alterações
Siga os padrões de código existentes. Documente mudanças nos dados fiscais.
Abra um Pull Request
Descreva o que foi alterado e por quê. A equipe revisará em até 5 dias úteis.
Licença
Você pode usar, copiar, modificar, distribuir e sublicenciar este software livremente, inclusive para fins comerciais, desde que mantenha o aviso de copyright original.
MIT License Copyright (c) 2025 Observa o Fiscal Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
Quer colaborar com os dados?
Se você é pesquisador, jornalista ou servidor público com acesso a dados fiscais, entre em contato. Juntos podemos ampliar a cobertura do observatório.
Entrar em contato