# AK-P16b · P16 Booking (Slots + Verfügbarkeit + Storno) | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P16 — Kalender, Booking, Forms & Signatur | | **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-05 · Gate W4 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-P16a` (Kalender-Sync — Slot-Verfügbarkeit braucht Busy-Slots aus Google) - **Blocks:** — (Intake-Form-Wahl referenziert AK-P16c, läuft aber im selben Fenster) - **Läuft parallel zu:** Raffaels Kern-Kette + den anderen P16-Slices (c/d). Eigene `prisma/schema/booking.prisma` (AD-21); Buchung erzeugt Lead/Activity im CRM-Kern (R-P6/P7). - **Konflikt-Risiko:** gering — additive Tabellen; `crm.prisma`/`calendar.prisma`/`forms.prisma` nur über Relationen berührt. ## Was wir bauen Öffentliche **Buchungsseiten im Calendly-Stil**: timezone-aware **Slot-Berechnung** aus Verfügbarkeitsregeln, Ausnahmen, Kalender-Sync (AK-P16a) und Puffer/Vorlauf, mit **iFrame-Embed**. Nach der Buchung entsteht ein **Lead** (oder Activity bei Email-Match), eine **FormSubmission** (Intake-Form aus AK-P16c) und eine **Bestätigungs-Email** (.ics/Add-to-Calendar). Nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2). Der volle Lifecycle ist v1: **Storno/Verschiebung/Re-Assign/No-Show** (M129 explizit VOLL) inkl. Auto-Mail bei Cancel + Race-Schutz beim Submit. ## Benötigte Screens (Backend bedient — Design liefert `D-BOOK` + `D-P16`) | Screen [Route] | Kern-Inhalt | |---|---| | 🌐 Booking-Page [`/b/{tenant}/{slug}`] | Multi-Step: Slot-Picker (timezone-aware + Wechsler) → Intake-Form → Bestätigung + Add-to-Calendar (.ics), Tenant-Logo, iFrame-Variante — **BESPOKE-Public** | | Buchungen-Liste [`/bookings`] | Termin/Endkunde/Page/Provider/Status, Tabs Anstehend/Vergangen/Storniert/Alle, Filter, Bulk-Cancel, CSV | | Buchung-Detail [`/bookings/:id`] | Termin-Daten, verknüpfter Kontakt/Lead, Form-Antworten, Sync-Status-Badge; Aktionen held/no-show, Cancel (Grund + Auto-Mail), Reschedule (Slot-Picker), Provider-Re-Assign | | Booking-Page-Editor [`/bookings/pages/:id`, `/new`] · Pages-Liste [`/bookings/pages`] | Dauer/Puffer/Vorlauf, Provider-Auswahl, Intake-Form-Wahl, Bestätigungsmail-Template, Publish + Embed-Code-Generator | | Verfügbarkeit [`/availability`] | Wöchentliche Standard-Regeln (mehrere Zeitfenster/Tag), Datums-Ausnahmen (frei/Custom-Window), Timezone | ## Definition of Done - [ ] Öffentliche **Booking-Seiten** berechnen Slots **timezone-aware** (Regeln, Ausnahmen, Kalender-Sync, Puffer, Vorlauf) - [ ] Nach Buchung: **Lead oder Activity** (Email-Match), **FormSubmission**, **Bestätigungs-Email** (.ics) — **Race-Schutz** beim Submit - [ ] **iFrame-Embed** + Public-URL mit Copy - [ ] Nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2) - [ ] **Storno/Verschiebung/Re-Assign/No-Show** (M129 VOLL) inkl. Auto-Mail bei Cancel - [ ] Permission-Bundle `bookings.*` (read_own/read_all/write/admin) serverseitig Owner-gefiltert - [ ] Konnektor `tenantHasModule('booking')`; RLS auf allen Tenant-Tabellen ## Technische Bausteine - **Entities** (eigene `prisma/schema/booking.prisma`): `BookingPage` (slug, duration_minutes, assignment_strategy, is_published, intake_form_id), `BookingPageProvider` (M:N User), `AvailabilityRule`/`AvailabilityException`, `Appointment` (provider_user_id, start/end, status scheduled/held/cancelled/no_show/rescheduled, kontakt_id|lead_id, form_submission_id). `calendar.prisma`/`crm.prisma`/`forms.prisma` nur über Relationen (AD-21). - **Slot-Engine**: kombiniert Regeln/Ausnahmen + Google-Busy-Slots (AK-P16a) + Puffer/Vorlauf, timezone-aware; **Race-Schutz** (Transaction/Lock beim Submit gegen Doppelbuchung). - **Post-Booking**: Lead/Activity (R-P6/P7) + FormSubmission (AK-P16c) + Bestätigungs-Mail (.ics) via Email (AK-P14a-Versand). - **Lifecycle**: Cancel/Reschedule/Re-Assign/No-Show mit Status-Übergängen + Auto-Mail. - **RLS** überall; `bookings.*`-Bundle; `is_demo_data` auf Demo-Pages/-Buchungen. ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 9** (BookingPage/Provider, AvailabilityRule/Exception, Appointment) - `REQUIREMENTS.md` → `REQ-booking-datenmodell`, `REQ-booking-slot-kalkulierung`, `REQ-booking-integrationen` - `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M126-time-slot, M127-verfuegbarkeit, M128-bestaetigung, M129-stornierung — M129 explizit VOLL) - `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 2 Booking; eine Zuteilungs-Strategie v1) - `_bmad-output/specs/M06-booking.md` ## Dev-Nachzug (nach Davids `D-BOOK`/`D-P16`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `AK-P16b` aktualisiert