From ea29a2f3f325c05a7eefa17b23991fa1f96dbca0 Mon Sep 17 00:00:00 2001
From: 230409 <230409@epvc.pt>
Date: Fri, 8 May 2026 10:22:03 +0100
Subject: [PATCH] first commit

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..10ea858
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# 📦 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`