Add files via upload

README.md

@@ -1 +1,97 @@
-# brasil-preco-justo
+# 🇧🇷 Brasil Preço Justo
+
+> Dashboard interativo de monitoramento de inflação, cesta básica e poder de compra no Brasil.
+
+![Version](https://img.shields.io/badge/version-1.0.0-purple)
+![License](https://img.shields.io/badge/license-MIT-blue)
+![Status](https://img.shields.io/badge/status-stable-green)
+
+## ✨ 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):
+
+```bash
+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](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](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.**