GovData 2.0

Painel de dados públicos do Brasil. Consulta empresas, indicadores econômicos, municípios, servidores públicos e beneficiários do Bolsa Família — tudo em um lugar só.

Funcionalidades

Módulo	O que faz	Fonte
🏢 Empresa	Dados completos por CNPJ + exportar CSV	BrasilAPI / Receita Federal
⚖️ Comparar	Dois CNPJs lado a lado + exportar CSV	BrasilAPI / Receita Federal
📈 Economia	SELIC, IPCA, Dólar, Euro em tempo real	BrasilAPI / Banco Central
🗺️ Cidades	Municípios por estado + exportar CSV	BrasilAPI / IBGE
👤 Servidores	Busca por nome — dados públicos federais	Portal da Transparência
💸 Bolsa Família	Busca por nome — beneficiários	Portal da Transparência
🕐 Histórico	Últimas 20 consultas salvas localmente	localStorage

Rodar localmente

Pré-requisitos

• Node.js 18+

Passos

# 1. Instalar dependências
npm install

# 2. Rodar
npm start

# 3. Abrir no navegador
# http://localhost:3000

Variável de ambiente (opcional)

Para usar a API do Portal da Transparência sem limite de requisições, cadastre-se gratuitamente em https://portaldatransparencia.gov.br/api e crie um arquivo .env:

TRANSPARENCIA_API_KEY=sua_chave_aqui

---

Deploy gratuito no Railway

Passo 1 — Criar conta

Acesse https://railway.app e crie uma conta gratuita (pode usar o GitHub).

Passo 2 — Subir o código no GitHub

git init
git add .
git commit -m "feat: govdata v2"
git branch -M main
git remote add origin https://github.com/SEU_USUARIO/govdata.git
git push -u origin main

Passo 3 — Criar projeto no Railway

1. No Railway, clique em New Project
2. Escolha Deploy from GitHub repo
3. Selecione o repositório govdata
4. Railway detecta automaticamente que é Node.js e faz o deploy

Passo 4 — Gerar URL pública

1. Na aba do projeto, clique em Settings
2. Em Domains, clique em Generate Domain
3. Você receberá uma URL como govdata-production.up.railway.app

Passo 5 (opcional) — Adicionar chave da Transparência

1. Vá em Variables
2. Adicione: TRANSPARENCIA_API_KEY = sua chave

---

Estrutura do projeto

govdata/
├── src/
│   ├── server.js              ← servidor Express + rate limit
│   ├── routes/
│   │   └── api.js             ← endpoints REST
│   └── providers/
│       └── brasilapi.js       ← integrações + cache em memória
├── public/
│   └── index.html             ← frontend completo (HTML/CSS/JS)
├── railway.toml               ← configuração de deploy
├── .gitignore
└── package.json

Cache

Dado	Duração
CNPJ	24 horas
Indicadores econômicos	1 hora
Municípios	7 dias
Servidores / Bolsa Família	1 hora

Cache fica em memória RAM. Reiniciar o servidor limpa tudo.

APIs utilizadas

• BrasilAPI — https://brasilapi.com.br (gratuita, sem chave)
• Portal da Transparência — https://portaldatransparencia.gov.br/api (gratuita com cadastro)