🇧🇷 Brasil Preço Justo

Dashboard interativo de monitoramento de inflação, cesta básica e poder de compra no Brasil.

✨ Funcionalidades

📊 KPIs em tempo real: IPCA acumulado 12M, Dólar, Selic e Cesta Básica SP
📈 Gráficos interativos: Evolução histórica de IPCA, IGP-M e Dólar (24 meses)
🛒 Cesta Básica: Cards dos 8 itens essenciais com variação de preço
🧮 Calculadora de Poder de Compra: Simule quanto da sua renda é consumida pela cesta
💸 Simulador de Perda: Visualize como a inflação erode seu salário ao longo dos anos
🎨 Design premium: Dark theme fintech com glassmorphism e animações refinadas

🚀 Deploy

Este projeto utiliza GitHub Actions para deploy automático no GitHub Pages.

Passo a passo:

Crie um novo repositório no GitHub
Faça upload destes arquivos para a branch main
Acesse Settings → Pages e selecione a fonte "GitHub Actions"
O workflow será executado automaticamente. Acesse a aba Actions para acompanhar
Seu site estará disponível em https://seuusuario.github.io/nome-do-repo

Deploy manual (alternativo):

git init
git add .
git commit -m "Primeiro commit - Brasil Preço Justo v1.0"
git branch -M main
git remote add origin https://github.com/SEU_USUARIO/nome-do-repo.git
git push -u origin main

🏗️ Arquitetura

brasil-preco-justo/
├── index.html              # Aplicação SPA completa
├── .github/
│   └── workflows/
│       └── deploy.yml      # GitHub Actions para deploy
├── docs/
│   ├── PLANEJAMENTO.md     # Documento de planejamento
│   ├── REDTEAM.md          # Validação de segurança
│   └── QA.md               # Checklist de qualidade
└── README.md               # Este arquivo

🔌 APIs Utilizadas

Fonte	Endpoint	Dado
Banco Central	`api.bcb.gov.br/dados/serie/bcdata.sgs.433`	IPCA mensal
Banco Central	`api.bcb.gov.br/dados/serie/bcdata.sgs.189`	IGP-M
Banco Central	`api.bcb.gov.br/dados/serie/bcdata.sgs.432`	Selic
AwesomeAPI	`economia.awesomeapi.com.br/json/last/USD-BRL`	Dólar comercial

⚠️ Fallback: Quando APIs estão indisponíveis (CORS, timeout, manutenção), o sistema utiliza dados mockados realistas para manter a experiência funcional. Um indicador visual mostra se os dados são "em tempo real" ou "de demonstração".

🛡️ Segurança (RED TEAM)

Consulte docs/REDTEAM.md para o relatório completo de validação de segurança.

Pontos principais:

✅ Zero dados pessoais coletados
✅ Cálculos 100% client-side
✅ Sem cookies de rastreamento
✅ Sanitização de inputs
✅ CSP-ready (Content Security Policy)
✅ HTTPS-only via GitHub Pages

🧪 QA / Testes

Consulte docs/QA.md para o checklist completo de qualidade.

Categoria	Status
Responsividade	✅ Mobile, Tablet, Desktop
Performance	✅ Lighthouse > 90
Acessibilidade	✅ Contraste WCAG AA, navegação por teclado
Cross-browser	✅ Chrome, Firefox, Safari, Edge
Offline	⚠️ Parcial (dados mock funcionam)

📄 Licença

MIT License — livre para uso, modificação e distribuição.

Feito com 💜 para a população brasileira.

3.5 KiB Raw Blame History