# Melhores do Ano Valença — Sistema de Gestão do Evento

Sistema completo para gerenciamento e cerimônia de premiação.

## Stack
- **PHP 8.2+** · Tailwind CSS (CDN) · Persistência em JSON (sem banco de dados)
- **Fontes:** Playfair Display · Cinzel · Outfit
- **Identidade:** Dourado · Escuro · Elegante

## Estrutura

```
melhores/
├── index.php              # Roteador principal
├── config.php             # Configurações globais
├── .htaccess              # Rewrite + proteção /data
│
├── app/                   # Core
│   ├── router.php         # Mapa de rotas
│   ├── helpers.php        # Funções auxiliares
│   ├── json-handler.php   # CRUD JSON (arquivo por empresa)
│   └── auth.php           # Autenticação sessão
│
├── admin/                 # Painel administrativo (login obrigatório)
│   ├── login.php          # Login
│   ├── dashboard.php      # Dashboard com stats
│   ├── empresas.php       # Listagem de empresas
│   ├── empresa-form.php   # Cadastro/edição de empresa
│   ├── categorias.php     # Listagem de categorias
│   ├── categoria-form.php # Cadastro/edição de categoria
│   ├── importar.php       # Importação via JSON
│   ├── relatorio.php      # Relatório com export PDF (print)
│   └── configuracoes.php  # Alterar senha + info sistema
│
├── pages/                 # Páginas do evento
│   ├── apresentadores.php # 🎤 Tela dos apresentadores (polling 4s)
│   └── recepcao.php       # 🎟  Tela da recepção (busca + confirmação)
│
├── api/                   # Endpoints JSON
│   ├── empresas.php       # GET — lista todas as empresas
│   ├── presenca.php       # POST — confirmar/cancelar presença
│   └── chamado.php        # POST — marcar/desmarcar empresa como chamada
│
├── includes/              # Componentes reutilizáveis
│   ├── head.php           # DOCTYPE + estilos globais
│   ├── sidebar-admin.php  # Sidebar do painel
│   ├── admin-layout-start.php
│   └── admin-layout-end.php
│
└── data/                  # Dados JSON (protegidos via .htaccess)
    ├── admin-user.json    # Credenciais do admin
    ├── categorias.json    # Todas as categorias
    └── empresas/          # Um JSON por empresa (EMP*.json)
```

## Instalação

1. Copie para o servidor com PHP 8.2+ e Apache/Nginx
2. Habilite `mod_rewrite` no Apache
3. Certifique-se que `data/` tem permissão de escrita: `chmod -R 755 data/`
4. Acesse `/admin` — login padrão: **senha: melhores2025**
5. **Importe as categorias** via `/admin/importar` usando o `ganhadores_2025.json`

## URLs Principais

| URL | Descrição |
|---|---|
| `/admin` | Painel administrativo |
| `/admin/empresas` | CRUD de empresas |
| `/admin/categorias` | CRUD de categorias |
| `/admin/importar` | Importar JSON |
| `/admin/relatorio` | Relatório PDF |
| `/apresentadores` | 🎤 Tela dos apresentadores |
| `/recepcao` | 🎟 Tela da recepção |

## Fluxo do Evento

1. **Antes:** Cadastre empresas e importe categorias
2. **Na entrada:** Recepcionistas usam `/recepcao` para confirmar chegadas
3. **No palco:** Apresentadores usam `/apresentadores` para ver ordem e marcar chamados
4. **Relatório:** Exporte PDF via `/admin/relatorio` antes do evento

## Senha Padrão
`melhores2025` — troque em `/admin/configuracoes` antes do evento!

---
Desenvolvido por **Reale Tech Soluções em TI**
