# Projeto — BR Versus

> Arquitetura, stack técnica e fluxo do jogo do BR Versus.

## O que é

BR Versus é uma plataforma web de torneio eliminatório 1v1 com tema "Brasil vs Mundo". O MVP é um torneio de 64 comidas (32 brasileiras vs 32 do mundo) com bracket interativo, votação em tempo real e dashboard de estatísticas acumuladas.

Futuro: torneios ilimitados — futebol, cidades, músicas, praias, filmes.

## Stack

| Camada | Tecnologia |
|--------|-----------|
| Framework | Nuxt 4 (SSR via Nitro) |
| UI | Nuxt UI v4 (125+ componentes) |
| Estilo | Tailwind CSS v4 |
| Animações | motion-v |
| ORM | Drizzle ORM |
| Banco | SQLite (better-sqlite3) |
| Runtime | Node.js 22 LTS |
| Deploy | Docker + Coolify em VPS |

## Fluxo do Jogo

1. Visitante clica "INICIAR JOGO"
2. Servidor embaralha 64 pratos (Fisher-Yates), pareia BR vs Mundo
3. Cliente monta bracket visual com 63 slots
4. Visitante vota clicando na foto do prato preferido
5. Vencedor avança automaticamente para o próximo round
6. Após 63 votos, o campeão é revelado com celebração
7. Estatísticas são atualizadas atomicamente via transação SQLite

## Identidade Visual

| Token | Cor | Uso |
|-------|-----|-----|
| br-green | #009739 | Brasil, botões, primária |
| br-yellow | #FEDD00 | Destaques Brasil |
| world-blue | #0057B7 | Mundo |
| vs-red | #DC2626 | VS, estrela, accent |

## Segurança

- CSP, X-Frame-Options, HSTS
- Rate limiting (100 req/min votos, 10 req/min start)
- IP hasheado SHA-256 (LGPD)
- Query builder tipada (sem sql.raw com input)

## Documentação Relacionada

- [/llms.txt](https://brversus.com/llms.txt) — Índice principal
- [/llms-foods.txt](https://brversus.com/llms-foods.txt) — Fichas dos 64 pratos
- [/llms-stats.txt](https://brversus.com/llms-stats.txt) — Sistema de estatísticas
- [/llms-api.txt](https://brversus.com/llms-api.txt) — Referência da API