4.8 KiB
4.8 KiB
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.prismanur ü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.prismanur ü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_dataauf 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-integrationenROADMAP.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-P16baktualisiert