# 📦 ReservaMesa — Pacote de Documentação

**Versão:** 1.0.0 | **Data:** Maio 2026

---

## Conteúdo deste pacote

### 📁 /docs — Documentação Técnica

| Ficheiro | Conteúdo |
|---|---|
| `01_PROJECT_OVERVIEW.md` | Visão geral, objetivos, fases, stakeholders |
| `02_TECH_STACK.md` | Stack tecnológica, Firebase schema, dependências, segurança |
| `03_PROJECT_STRUCTURE.md` | Estrutura de pastas e ficheiros do projeto Next.js |
| `04_DESIGN_SYSTEM.md` | Cores, tipografia, componentes, animações, layout |
| `05_AGENT_HANDOFF.md` | **Lê este primeiro** — contexto entre sessões, checklist por fase, padrões de código |
| `06_PROGRESS_TRACKER.md` | Status de cada tarefa por fase |

### 📁 /mockups — Protótipos Visuais (abrir no browser)

| Ficheiro | Página |
|---|---|
| `01_dashboard.html` | Dashboard principal com métricas, timeline e mapa de mesas |
| `02_reservas.html` | Gestão de reservas com filtros, tabela e ações inline |
| `03_mesas.html` | Mapa visual do restaurante com painel de detalhe |

---

## Como usar esta documentação

### Para a próxima sessão de desenvolvimento:
1. Abre `docs/05_AGENT_HANDOFF.md` — lê tudo
2. Confirma o status atual em `docs/06_PROGRESS_TRACKER.md`
3. Inicia a fase seguinte conforme o checklist

### Para ver os mockups:
Abre os ficheiros `.html` directamente no browser — não precisam de servidor.

### Para o designer:
Toda a identidade visual está em `docs/04_DESIGN_SYSTEM.md` — cores, fontes, componentes.

---

## Stack Resumida
- **Framework:** Next.js 14 (App Router) + TypeScript
- **Base de dados:** Firebase Firestore (existente)
- **Auth:** Firebase Auth (existente)
- **UI:** Tailwind CSS + Shadcn/UI
- **Deploy:** Vercel

---

## Próximo Passo
→ Iniciar **Fase 2: Setup & Estrutura Base** conforme `05_AGENT_HANDOFF.md`