# Sistema de Troca de Figurinhas - Copa do Mundo 2026 ⚽

Um ecossistema completo para colecionadores, focado em velocidade de cadastro, visual moderno (Glassmorphism) e algoritmos inteligentes de match para trocas locais.

## ✨ Destaques & Diferenciais

A aplicação foi evoluída para oferecer a melhor experiência de UI/UX para colecionadores:

*   **⚡ Cadastro Ultra-Rápido (AJAX):** Interface futurista onde você cadastra pacotinhos inteiros apenas digitando o código (ex: BRA1) sem recarregar a página. O sistema identifica automaticamente se é um item novo ou repetido.
*   **🤝 Algoritmo de Match Local:** Sistema de "Tinder das Figurinhas" que cruza interesses mútuos apenas entre colecionadores da **mesma cidade**, gerando mensagens prontas para WhatsApp com formatação e emojis.
*   **⭐ Gestão de Legends:** Módulo exclusivo para figurinhas raras (Ouro, Prata, Bronze, Bordô) com suporte a fotos dos jogadores e controles de incremento otimizados para mobile.
*   **📱 Design Mobile-First Premium:** Interface 100% responsiva com abas deslizantes, rodapé fixo inteligente e menus em estilo "hamburger" com desfoque de fundo.
*   **📈 Estatísticas de Precisão:** Acompanhamento de progresso por seleção (brasões, fotos e brilhantes) e cálculo do **Volume Físico Total** da sua coleção.

## 🛠️ Tecnologia & Arquitetura

O sistema preza pela performance e facilidade de instalação:

- **Backend:** Padrão MVC (Model-View-Controller) em **Vanilla PHP 8.1+**.
- **Segurança:** Camada de banco de dados via **PDO** com Prepared Statements.
- **Frontend:** **Vanilla JS (ES6+)** e **CSS Moderno** (Variáveis, Grid, Flexbox, Glassmorphism). Sem dependência de frameworks pesados.
- **Banco de Dados:** **MySQL** otimizado com índices nos campos de código e localização.

## 🚀 Instalação e Execução

### 1. Preparação
- Coloque a pasta do projeto em seu servidor local (ex: `htdocs` do XAMPP).
- Crie um banco de dados chamado `figurinhas_db`.

### 2. Migrations e Seeds
Abra o terminal na pasta raiz e execute os scripts de automação:

```bash
# Criação da estrutura de tabelas
php scripts/migrate.php

# População com as 980+ figurinhas oficiais (Qatar/2026 base)
php scripts/seed.php
```

### 3. Gerenciamento de Imagens
- As fotos dos jogadores Legends devem ser colocadas na pasta `public/img/`.
- O sistema utiliza `default.png` como fallback automático para fotos não encontradas.

### 4. Acesso
Navegue para: `http://localhost/Figurinhas/public/`

## 📁 Estrutura do Projeto

*   `src/Controllers`: Lógica de rotas e processamento de dados.
*   `src/Models`: Camada de abstração e consultas SQL.
*   `src/Views`: Templates PHP com as interfaces responsivas.
*   `public/`: Ponto de entrada, estilos CSS globais e assets.
*   `scripts/`: Utilitários para CLI (migration, seed, backups).

---
**Desenvolvido para colecionadores apaixonados.** ⚽🏆