🇧🇷 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:

1. Crie um novo repositório no GitHub
2. Faça upload destes arquivos para a branch main
3. Acesse Settings → Pages e selecione a fonte "GitHub Actions"
4. O workflow será executado automaticamente. Acesse a aba Actions para acompanhar
5. 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.