🎯 GRAND TASK: Gastro Table Reservation SaaS (caspos Ecosystem)

1. Projektübersicht & Vision

Entwicklung einer modernen, mandantenfähigen Tischreservierungs-SaaS-Plattform für die Gastronomie.

Zielgruppe: Gastronomiebetriebe (Einzelrestaurants bis Ketten).
Fokus Phase 1: Perfekte UI/UX, Dual-Auth-System (Admin vs. Kellner-PIN), grafischer 2D-Tischplan, Timeline und Schnellbuchung.
Fokus Phase 2 (Später): Kassenanbindung / POS-Integration an caspos via REST/Webhooks.

Infrastruktur & Container: Docker Compose (docker-compose.yml) für lokales Setup und Cloud-Parität.
Datenbank: PostgreSQL 16 (Open Source, ACID, RLS, Flyway Migrationen).
Architekturmodell: Hybrid Multi-Tenancy (Shared App + Database/Schema-per-Tenant).
- Master-Schema: Mandanten, Lizenzen, Slugs, API-Keys.
- Tenant-Schema: Tische, Bereiche, Reservierungen, Gäste, Staff.
Backend: Java 21 / Spring Boot 3.x (Spring Data JPA, Spring Security, Flyway, STOMP WebSockets).
Frontend: TypeScript, React (Next.js / Vite), Tailwind CSS, Zustand, Konva.js (2D-Canvas), Lucide Icons.

DiningArea: Gastrobereiche (z. B. "Innenbereich", "Terrasse").
RestaurantTable: Tische mit 2D-Koordinaten (x, y, width, height, shape), Min/Max-Kapazität und Kombinierbarkeit.
Guest: Gästedatei mit Kontaktdaten, Präferenzen/Notizen und No-Show-Counter.
Reservation: Reservierungsstatus (PENDING, CONFIRMED, ARRIVED, FINISHED, NO_SHOW, CANCELLED), Timeslots, Gästeanzahl.
StaffUser: Kellner/Manager mit Rollen und schneller PIN-Authentifizierung.

Dual-Mode Auth:
- Inhaber/Manager: Langlebiger Login via E-Mail/Passwort (Portal).
- Kellner/Terminal: 4-6 stelliger PIN-Schnellzugriff (am iPad/Terminal).
- Gäste: Kein Account-Zwang für Online-Reservierungen.
2D-Tischplan: Farbcodierte Tische (Frei = Grün, Bald reserviert = Gelb, Belegt = Rot, Rechnung offen = Blau), Touch-Interaktionen.
Timeline / Gantt: Zeitstrahl nach Tischen im 15-Minuten-Raster.
Quick-Booking / Walk-In: Buchungserfassung für Kellner in unter 5 Sekunden.

Milestone 1: Docker Compose & PostgreSQL 16 Setup mit Flyway & Sicherheitskonfiguration.
Milestone 2: Spring Boot 3 Multi-Tenant Backend (TenantContext, Hibernate Resolver, Auth-Modul mit PIN-Login).
Milestone 3: TypeScript Frontend-Basis (Typen, API-Client, Zustand-Stores).
Milestone 4: UI-Komponenten (2D Tischplan via Konva.js, Timeline, Quick-Booking-Modal).
Milestone 5: caspos POS REST-API & Webhook-Integration.