Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,55 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user