# 📋 Documento de Planejamento — Brasil Preço Justo

## 1. Visão do Produto

**Brasil Preço Justo** é um dashboard fintech que democratiza o acesso à informação econômica no Brasil. Resolve a dor da população de não conseguir visualizar, de forma simples e intuitiva, como a inflação e os preços da cesta básica impactam seu poder de compra real.

### Público-alvo
- Classe média e trabalhadora (renda entre 1-10 salários mínimos)
- Estudantes de economia e ciências sociais
- Jornalistas e pesquisadores
- Qualquer cidadão preocupado com o poder aquisitivo

## 2. Requisitos Funcionais

### RF-001: Dashboard de KPIs
- Exibir IPCA acumulado 12 meses
- Exibir cotação do Dólar comercial
- Exibir taxa Selic meta
- Exibir valor da cesta básica em São Paulo

### RF-002: Gráfico Histórico
- Linha temporal de 24 meses
- Alternância entre IPCA, IGP-M e Dólar
- Tooltips interativos
- Animação de carregamento

### RF-003: Cesta Básica
- 8 itens essenciais com preço médio
- Indicador de variação percentual (12 meses)
- Alerta visual quando variação > 20%

### RF-004: Calculadora de Poder de Compra
- Input de salário mensal
- Seleção de dependentes (1-4+)
- Seleção de ano de referência (2020-2024)
- Cálculo de % da renda consumida pela cesta
- Cálculo de poder de compra vs ano selecionado
- Cálculo de salário necessário para manter poder aquisitivo

### RF-005: Simulador de Perda Salarial
- Visualização gráfica (barras) de salário nominal vs real
- Projeção de 5 anos com inflação acumulada
- Atualização dinâmica baseada na calculadora

## 3. Requisitos Não-Funcionais

### RNF-001: Performance
- First Contentful Paint < 1.5s
- Time to Interactive < 3s
- Bundle size < 100KB (excluindo CDN)

### RNF-002: Design
- Dark theme premium (preto, cinza escuro, roxo/violeta)
- Glassmorphism nos cards
- Animações sutis (fade-in, hover, contadores)
- Totalmente responsivo (mobile-first)

### RNF-003: Confiabilidade
- Fallback para dados mockados quando APIs falharem
- Indicador visual de status da API
- Dados sempre atualizados quando online

### RNF-004: Segurança
- Zero persistência de dados pessoais
- Sanitização de inputs
- HTTPS-only
- Sem cookies de rastreamento

## 4. Arquitetura Técnica

### Stack
- **Frontend**: HTML5, Tailwind CSS (CDN), Vanilla JS
- **Gráficos**: Chart.js (CDN)
- **Ícones**: SVG inline (sem dependência externa)
- **Fonte**: Inter (Google Fonts)
- **Deploy**: GitHub Pages via GitHub Actions

### Estrutura de Dados
```javascript
// IPCA/IGP-M/Dólar
{ data: "MM/YYYY", valor: float }

// Itens da cesta
{ nome: string, preco: float, variacao: float, icone: string }

// Configurações
{ cestaBasicaAtual, cestaBasicaAnterior, salarioMinimo, ... }
```

### APIs
1. Banco Central (IPCA, IGP-M, Selic) — JSON via CORS
2. AwesomeAPI (Dólar) — JSON via CORS
3. Fallback: dados mockados realistas

## 5. Fluxo de Dados

```
Usuário → Carrega página → JS tenta fetch APIs
    ├── Sucesso → Exibe dados reais + badge "Live"
    └── Falha → Exibe dados mock + badge "Demo"

Usuário → Interage com calculadora → Cálculo client-side
    └── Resultado exibido instantaneamente (zero latência)
```

## 6. Roadmap

### v1.0 (Atual)
- Dashboard com KPIs e gráficos
- Calculadora de poder de compra
- Simulador de perda salarial
- Deploy GitHub Pages

### v1.1 (Futuro)
- Geolocalização para cesta básica regional
- Alertas por e-mail/SMS quando inflação subir
- Modo offline completo (Service Worker)
- Comparador entre cidades

### v1.2 (Futuro)
- Backend Node.js para cache de APIs
- Autenticação para salvar simulações
- API própria REST
- App PWA instalável

## 7. Métricas de Sucesso

- Tempo médio na página > 2 minutos
- Taxa de interação com calculadora > 40%
- Score Lighthouse > 90 em todas as categorias
- 0 vulnerabilidades críticas no RED TEAM