# 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** | Done (2026-07-11, PR #75; Interim-UI AD-28 inkl. /availability + Picker; finale Optik = design-nachzug) · Audit 2026-07-17: Doppelbuchungs-Constraint als Migration nachgeliefert (war nie deployt + defekt), Public-e2e ergänzt, RLS seit Cutover live → 8/8 DoD | **🎨 design-nachzug: offen** (seit 2026-07-11) — Interim-UI aus `~/ui` steht; finale Subframe-Optik aus `D-P16`/`D-BOOK` ausstehend. ## 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 - [x] Öffentliche **Booking-Seiten** berechnen Slots **timezone-aware** (Regeln, Ausnahmen, Kalender-Sync, Puffer, Vorlauf) - [x] Nach Buchung: **Lead oder Activity** (Email-Match), **FormSubmission**, **Bestätigungs-Email** (.ics) — **Race-Schutz** beim Submit · *Kontakt-Email-Match → Activity, sonst echtes `InboxLead` + `Appointment.leadId`; bei gesetzter `intakeFormId` echtes `FormSubmission` + `Appointment.formSubmissionId`, sonst `intakeAnswers` Json-Fallback; Intake-Form-**Auswahl** im Page-Editor seit 2026-07-11 (Interim-UI) — offen nur noch Staging-DB-Ausführung (Race-Integrationstest, env-blockiert)* - [x] **iFrame-Embed** + Public-URL mit Copy - [x] Nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2) - [x] **Storno/Verschiebung/Re-Assign/No-Show** (M129 VOLL) inkl. Auto-Mail bei Cancel · *Service + Route-Action-Contract vollständig; Reschedule-Slot-Picker + Re-Assign-Provider-Dialog seit 2026-07-11 als Interim-UI (AD-28); finale Optik = design-nachzug* - [x] Permission-Bundle `bookings.*` (read_own/read_all/write/admin) serverseitig Owner-gefiltert - [x] Konnektor `tenantHasModule('booking')`; RLS auf allen Tenant-Tabellen *(RLS seit `20260713190000_appwide_rls_cutover` LIVE — „deferred" erledigt)* - [x] **e2e-Smoke Public-Booking (fehlender DoD-Punkt, Audit 2026-07-17):** `tests/e2e/booking-public.spec.ts` (env-gated via `E2E_PUBLIC_BOOKING_PATH`, Marker `ui.booking.public` + Form/Empty) — `booking.spec.ts` deckte nur `ui.booking.list` (AGENTS.md D.19) ## 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 · Milestones: (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) ## Dev-Nachzug (nach Davids `D-BOOK`/`D-P16`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/ROADMAP nachgezogen - [ ] Plane-Ticket `AK-P16b` aktualisiert **Interim-UI (Vorschau, Stand 2026-07-11):** Screens aus `~/ui` gebaut — `apps/web/app/components/screens/booking/BookingListPage.tsx` (A2: Tabs Anstehend/Vergangen/Storniert/Alle + Suche + Status-Badges), `BookingDetailPage.tsx` (A3: M129-Lifecycle komplett — Cancel-Dialog mit Grund, **Reschedule-Slot-Picker** (Datum → Loader berechnet Engine-Slots via `?slotsDate=`, nur eigener Provider) und **Re-Assign-Provider-Dialog** (admin), alles echte S-560-Dialoge auf die bestehenden Intents), `BookingPagesPage.tsx` (A2: Publish-Badges, absolute Public-URL mit Copy), `BookingPageEditorPage.tsx` (A6+A4: Provider-Checkboxen, **Intake-Form-Auswahl** — `BookingPage.intakeFormId` wird jetzt gepflegt, schließt den DoD-2-Rest „Form-Auswahl"), `AvailabilityPage.tsx` (**neue Route `/availability`**: Wochen-Regeln mit mehreren Fenstern/Tag, Datums-Ausnahmen, Timezone; atomarer Replace, own-user-Scope; Sidebar/`UI_NAV_IDS`/`surfaces.json` verdrahtet). Öffentliche Booking-Page im S04-Look des `PublicFormRenderer` (`tcbook-*`-CSS, bewusst ohne `~/ui` wegen iFrame-Embed — dokumentierte Ausnahme mit PublicFormRenderer-Präzedenz). Bulk-Cancel/CSV (nur Brief, nicht DoD) bewusst deferred. Proof: Guard-Tests (`subframe-layout-boundary`, `booking-auth-boundary` inkl. neuem Availability-Action-Test), Booking-Modultests grün, e2e-Marker (`ui.booking.list`, `ui.booking.public.*`) erhalten. Visual-Baseline/Hot-Swap-Infra fehlt repo-weit für diese Bereiche — beim D-P16-Nachzug mit Re-Baseline aufsetzen. Refactor-Nachzug offen: finale Subframe-Optik aus `D-P16`/`D-BOOK` (Plane-Label `design-nachzug`). > ℹ️ **Auswirkung aus AK-P16c (2026-07-10, PR #71):** Der gemeinsam genutzte `PublicFormRenderer` wurde im WF-P16-Subframe-Nachzug optisch auf den S04-Soll-Stand gehoben (zentrierte Card, Akzentbalken, neue Erfolgs-/Fehler-/Nicht-verfügbar-Zustände). Verhalten/Props unverändert (nur neuer optionaler `layout`-Prop); Booking-Intake-Formulare rendern automatisch im neuen Look. Beim D-BOOK-Nachzug gegenprüfen. ## Umsetzungs-Notiz (2026-06-30, Akeshan) — ~85 % DoD Branch `feat/AK-P16b` (von `feat/AK-P16a` abgezweigt, AD-21), **8 Commits** (`fecf6f19f` → `b262dabe8`), nicht gepusht, Plane-Status unverändert. Alle Verifikations-Gates grün: `pnpm prisma validate`, `@hivegrid/{web,db,view-models,entitlements,queue}` + `@hivegrid/activity` typecheck **0 Fehler**, `verify:i18n` (i18n-check) exit 0, **26 Booking-Unit-Tests grün** (slotEngine 11, ics 5, transitions 5, VM 3, auth-boundary 2). lefthook pre-commit je Commit grün. **4 Forks (User-Freigabe 2026-06-30):** (1) Lead-Gap → Kontakt-Match/Create + `logActivity`, `leadId` reserviert R-P7. (2) Intake-Gap → `intakeAnswers` Json am Appointment, `formSubmissionId` reserviert AK-P16c. (3) Modul-Gate → eigener `booking` Feature-Key (`tenantHasModule('booking')`). (4) Scope → Backend + funktionale Routen inkl. minimal-funktionaler öffentlicher Strecke. **DoD-Stand:** - [x] **Slot-Engine timezone-aware (DoD 1)** — `slotEngine.ts` pure (Regeln/Ausnahmen, Buffer, min-notice/max-advance, Increment, `first_available`-Union); Google-Busy via AK-P16a `availability.ts` (leak-safe). 11 Tests inkl. DST. `/b/{tenant}/{slug}`. - [~] **Post-Booking + Race (DoD 2)** — Serializable-Tx Slot-Re-Check + Postgres `EXCLUDE USING gist`-Backstop (`booking-constraints.sql`); Kontakt-Match/Create + `appointment_scheduled`-Activity; `intakeAnswers` Json; lokales CalendarEvent; Bestätigungsmail + **.ics-Attachment** (`buildIcs` pure). **Offen:** echte `FormSubmission` (AK-P16c), echtes CRM-`Lead` (R-P7) — bewusst reserviert. - [x] **iFrame-Embed + Public-URL (DoD 3)** — `/b/.../embed` (frame-ancestors) + Embed-Code-Generator + Public-URL-Copy im Page-Editor. - [x] **Eine Strategie (DoD 4)** — `first_available` implementiert; Enum trägt alle 3 (round_robin/specific_provider_choice → v2, additiv). - [~] **Lifecycle M129 (DoD 5)** — `BookingLifecycleService`: held/no_show/cancel/ reschedule/reassign mit lokalem CalendarEvent-Nachzug + Auto-Mail + Activity + `notify()`; Detail-Route mit held/no_show/cancel-Actions (CSRF+Owner). **Offen:** Reschedule-/Re-Assign-**Picker-UI** (Slot-/Provider-Auswahl) → David D-P16. - [x] **bookings.* owner-gefiltert (DoD 6)** — 4 Registries, `bookingAccess.server.ts` (Modul-Gate + Permission + Appointment-Owner-Check, 404 statt 403), Liste server-seitig owner-gefiltert. Auth-Boundary-Test. - [x] **Konnektor + RLS (DoD 7)** — `booking` Feature-Key + Gate; `booking-isolation.sql` (deferred Cutover wie Kalender), `booking-constraints.sql` (gist + btree_gist). **Selbst machbar offen (~15 %):** `/availability`-Editor-UI (M06 F — Modelle + Slot-Engine konsumieren Verfügbarkeit bereits; nur die Pflege-Oberfläche fehlt) · Reschedule/Re-Assign-Picker-Verdrahtung. **Staging-DB-blockiert:** `prisma db push` + `psql -f booking-constraints.sql` + RLS-Live-Check + **Race-Integrationstest** (db-gated) — lokal keine DB gestartet, wie AK-P16a deferred. **David D-P16-blockiert:** bespoke öffentliche Booking-Page + Reschedule-Picker + Visual-Regression (DoD 21) + Hot-Swap-Drill (DoD 20). **Hinweise:** Mail-Attachment-Durchreichung im Queue-Provider ergänzt (Payload trug `attachments` bereits, nur der Provider-Hop ließ sie fallen). 3 Booking-Activity-Typen (`appointment_cancelled/rescheduled/no_show`) zur Activity-Union ergänzt. Connect/ Lifecycle sind CRM-Subject-Activities (kein eigenes Booking-Subject). ## Umsetzungs-Notiz (2026-07-01, Raffael) — ~90 % gewichtet, 5/7 DoD vollständig Direkt auf `main` serverseitig nachgezogen, um den ohne Screens selbst machbaren P16b-Rest zu maximieren. **Nachzug:** - Public Booking erzeugt bei fehlendem Kontakt jetzt ein echtes `InboxLead` über `createLead(...)`, verknüpft es über `Appointment.leadId` und schreibt die Activity auf Kontakt oder Lead. Der alte automatische Kontakt-Create ist raus. - Detail-Route akzeptiert serverseitig die M129-Intents `reschedule` und `reassign` mit `bookings.write` bzw. `bookings.admin`; die Picker-UI bleibt D-P16-blockiert. - `AvailabilityService.server.ts` ergänzt den atomaren Replace-/Read-Contract für `AvailabilityRule`/`AvailabilityException` inkl. Zeitfenster-, Datum- und Timezone-Validierung. Die `/availability`-Oberfläche bleibt screen-blockiert. - Tests ergänzt: Availability-Service-Unit-Test, Post-Booking-Static-Guard, Lifecycle-Action-Authorization-Guard. **DoD-Stand nach Nachzug:** - Vollständig abgehakt: DoD 1, 3, 4, 6, 7 = **5/7 vollständig**. - Teilfertig: DoD 2 ist serverseitig bis auf echte `FormSubmission` erledigt (`AK-P16c`); DoD 5 ist serverseitig erledigt, aber Reschedule/Reassign-Picker-UI wartet auf David D-P16. - Offen/blockiert: echte `FormSubmission` (`AK-P16c`), D-P16-Screens/Visuals, Staging-DB-Cutover (`prisma db push`, `booking-constraints.sql`, RLS-Live-Check, Race-Integrationstest). **Proof lokal:** `pnpm exec vitest run apps/web/app/modules/booking/services/AvailabilityService.server.test.ts apps/web/app/modules/booking/services/booking-postbooking-boundary.test.ts apps/web/app/modules/booking/routes/booking-auth-boundary.test.ts` → 8/8 grün; `pnpm typecheck` → grün. ## Umsetzungs-Notiz (2026-07-01, Raffael) — ~92 % gewichtet, selbst machbarer Server-Rest erledigt Noch ohne Screens nachgezogen: - `BookingPage.intakeFormId` wird im Public-Booking-Resolve mitgeladen. - Public Booking schreibt innerhalb derselben Serializable-Transaktion eine echte `FormSubmission`, sobald die BookingPage ein Intake-Form referenziert, und verlinkt `Appointment.formSubmissionId`. Ohne `intakeFormId` bleibt `intakeAnswers` der Fallback, damit bestehende BookingPages nicht brechen. - Statische DB-Artefakt-Guards ergänzt: `booking-constraints.sql` muss die `appointment_no_overlap`-Exclusion-Constraint für `scheduled`/`held` enthalten; `booking-isolation.sql` muss alle fünf Booking-Tabellen mit RLS/FORCE/GUC-Policy und `hivegrid_app`-Grant abdecken. **DoD-Stand nach Nachzug:** - DoD 2 ist serverseitig maximal: Lead/Activity, FormSubmission bei konfiguriertem Intake-Form, .ics-Mail, Serializable Slot-Re-Check und SQL-Backstop sind vorhanden. Vollständig grün wird der Punkt erst mit AK-P16c-Renderer/Form-Auswahl und echter Staging-DB-Ausführung. - DoD 5 bleibt screen-blockiert für den Reschedule-/Reassign-Picker; Service und Action-Contract sind bereits erledigt. **Proof lokal:** `pnpm exec vitest run apps/web/app/modules/booking/services/booking-postbooking-boundary.test.ts apps/web/app/modules/booking/services/booking-db-artifacts.test.ts apps/web/app/modules/booking/services/AvailabilityService.server.test.ts apps/web/app/modules/booking/routes/booking-auth-boundary.test.ts` → 11/11 grün; `pnpm typecheck`, `pnpm lint`, `pnpm verify:i18n`, `pnpm test` und `pnpm build` → grün. ## Umsetzungs-Notiz (2026-07-11, Akeshan) — Interim-UI (AD-28), 7/7 DoD selbst machbar Branch `akeshan/ak-p16ab-interim-ui` (von `origin/main`), gemeinsamer Interim-UI-PR mit AK-P16a. Alle Booking-Oberflächen auf `~/ui`-Interim-Standard gehoben (Details im Interim-UI-Vermerk der Dev-Nachzug-Sektion): Buchungsliste mit Tabs, Detail mit Reschedule-Slot-Picker + Re-Assign-Dialog (schließt den DoD-5-UI-Rest), Pages-Liste, Page-Editor mit Provider-Checkboxen + Intake-Form-Auswahl (schließt den DoD-2-Rest „Form-Auswahl"; `intakeFormId` wird jetzt in Create/Update persistiert), neue Route `/availability` gegen den fertigen AvailabilityService-Contract (Wochen-Regeln, Ausnahmen, Timezone, atomarer Replace, own-user-Scope) inkl. Reachability-Wiring (Sidebar, `UI_NAV_IDS.appAvailability`, `surfaces.json`), öffentliche Booking-Page im S04-Look. Neue VMs (`booking-detail`, `booking-pages`, `availability` inkl. Payload-Codecs, `bookingListTab`) pure in `@hivegrid/view-models` mit Unit-Tests. **DoD-Stand: 7/7 selbst machbar erledigt.** DoD 2 und 5 sind jetzt bis auf die env-blockierte Staging-DB-Ausführung (db push, booking-constraints.sql, RLS-Live, Race-Integrationstest) vollständig; finale Subframe-Optik = getrackter design-nachzug (Tag oben). Keine Schema-Änderung auf dem Branch (AD-21, keine Migration nötig — `intakeFormId` existierte bereits). **Proof:** `@hivegrid/{view-models,web}` typecheck 0 Fehler; `verify:i18n` + `verify:sidebar-routes` Exit 0; Vitest gezielt grün: view-models 26 (davon Booking/Availability 14), Booking-Modul 34 inkl. neuem Availability-Guard-Test, Sidebar-/uiInventory-Kontrakte 66 gesamt im Lauf; e2e-Marker (`ui.booking.list`, `ui.booking.public.*`) unverändert. lefthook pre-commit je Commit grün. **Nachtrag Demo-Seed (2026-07-11):** `scripts/seed-hivegrid-demo.ts` um Staging-/Demo-Daten für die Interim-Screens ergänzt: 4 `AvailabilityException`-Rows (Urlaubstag + Custom-Window für owner/vertrieb, `/availability`-Editor), Booking-Page `Beratung vor Ort` mit `intakeFormId` → `demo-form-angebotsanfrage` (Editor-Formularauswahl + echter FormSubmission-Pfad), 2 zusätzliche externe Kalender-Events (Privat-Termin busy + zweitägige ganztägige Messe) für Quell-Marker/Multi-Day im Kalender-Grid. Idempotenz verifiziert: 2 Läufe gegen frische pgvector-DB (db push), identische Counts (BookingPages 2, Appointments 3, CalendarEvents 6, Exceptions 4, Rules 15). `docs/ops/local-demo-seed.md` nachgezogen. ## Nachtrag (2026-07-11, Akeshan) — Reachability `/bookings/pages` + Staging-Demo-Daten Zwei Nachbesserungen nach User-Review auf Staging (eigener PR, Branch `akeshan/booking-reachability-staging-seed`): 1. **`/bookings/pages` erreichbar gemacht (DoD B.6/E.23-Lücke):** Die Booking-Seiten-Verwaltung hatte weder Sidebar-Eintrag noch Inline-Link und war nur per URL erreichbar. Jetzt verlinkt die Buchungsliste inline: Header-Button „Booking-Seiten verwalten" (`ui.booking.list.managePages`) + Aktions-Button im Empty-State. Permission-gated über `bookings.read_all` (gleiches Gate wie der Pages-Loader selbst); der Loader liefert `pagesHref` (null ohne Permission). 2. **SeedService um Booking-/Kalender-Demo-Daten erweitert:** Der reichhaltige lokale Demo-Seed verweigert `NODE_ENV=production` und lief daher nie auf Staging — die Staging-Demo-Tenants (demo-starter/pro/business-crm, SeedService mit `SEED_ON_BOOT`) hatten 0 Booking-Daten. `seedDemoTenantBookingData` seedet jetzt je Demo-Tenant: 2 Booking-Pages (1 published + 1 unpublished, Provider john.doe+luna.davis), Mo–Fr-AvailabilityRules je Provider, 2 Exceptions (Urlaubstag + Custom-Window), 4 Appointments über alle Listen-Tabs (scheduled ×2, held, cancelled inkl. Storno-Feldern) mit lokalem CalendarEvent-Spiegel plus 1 externem Busy-Event für die Quell-Marker. Idempotent über deterministische `seed--*`-IDs bzw. Unique-Upserts; Day-Offsets werden je Lauf neu aufgelöst, „anstehende" Termine bleiben also anstehend. `isDemoData` gesetzt, wo das Schema es trägt. ## Umsetzungs-Notiz (2026-07-17, Akeshan) — Stand-Audit + Restarbeiten Audit-Befund (Code auf `main` pro DoD-Punkt geprüft): DoD 1/3/4/5/6/7 real erfüllt. **Zwei echte Lücken geschlossen** (Branch `fix/ak-p16-audit-restwork`): 1. **DoD 2 Race-Backstop war nie deployt UND nie lauffähig:** `booking-constraints.sql` lag in keiner Migration (nur manueller `psql -f`-Pfad, der nie ausgeführt wurde) — und das Artefakt selbst war defekt: `tstzrange(...)` über `TIMESTAMP(3)`-Spalten wird von Postgres im Index-Ausdruck abgelehnt (impliziter Cast nur STABLE, Fehler 42P17). **Fix:** `tsrange` (semantisch identisch, Werte sind UTC) + getrackte, idempotente Migration `20260717090000_ak_p16b_booking_overlap_constraint` mit Pre-Flight-Overlap-Check und Klartext-Operator-Hinweis; `booking-db-artifacts.test.ts` prüft jetzt beide Kopien. Proof: `verify:migrations-parity` grün (voller Replay gegen leere DB). 2. **e2e Public-Smoke** (nachgetragener DoD-Punkt oben) ergänzt. **Drift korrigiert:** RLS auf allen 5 Booking-Tabellen ist seit `20260713190000_appwide_rls_cutover` live; die „Staging-DB-Ausführung env-blockiert"-Vermerke (db push, booking-constraints, RLS-Live) sind mit der Migration bzw. dem Cutover erledigt. Offen bleibt nur der Race-Integrationstest gegen eine echte DB als optionaler Nachweis (Constraint greift jetzt physisch). ## Umsetzungs-Notiz (2026-07-17, Akeshan) — Staging-Incident: Constraint-Migration tenant-scoped nachgezogen Der erste Rollout der Constraint-Migration brach den Staging-Deploy (P3018, 23P01 „Key conflicts exist"). Zwei Ursachen, beide behoben: 1. **Constraint war tenant-agnostisch:** Die Demo-Tenants teilen sich globale Provider-User (john.doe/luna.davis), und `seedDemoTenantBookingData` legt in jedem Demo-Tenant identische Termin-Zeiten an → garantierte Cross-Tenant- „Überlappungen". Fachlich ist der Constraint tenant-scoped korrekt (die Slot-Engine ist tenant-scoped; tenant-übergreifend wäre zudem ein Isolation-Leak: Tenant B erführe über Buchungsfehler Belegtzeiten aus Tenant A). **Fix:** `"tenantId" WITH =` als erste Constraint-Spalte. 2. **Pre-Flight-Check war RLS-blind:** Der Migrator läuft unter FORCE RLS ohne Tenant-GUC — der Vorab-SELECT sah 0 Zeilen, während `ADD CONSTRAINT` als DDL alle Zeilen indexierte. **Fix:** Pre-Flight entfernt; stattdessen fängt die Migration die `exclusion_violation` und wirft eine Klartext-Meldung mit Diagnose-Query (als `postgres` auszuführen, da RLS die Zeilen vor dem Migrator versteckt). Lokal gegen Postgres 16 verifiziert: Cross-Tenant-Overlaps (Staging-Szenario) bauen durch; Within-Tenant-Doppelbuchung wird zur Laufzeit abgelehnt (23P01 → Klartext im Submit-Pfad); Bestandskonflikt beim Anlegen liefert die lesbare Operator-Meldung. `verify:migrations-parity` (voller Replay) grün. Die Migration war nirgends erfolgreich angewandt (nur failed auf Staging) und durfte daher in place korrigiert werden; Staging-Recovery gemäß `docs/operations/database-rollback.md`: `prisma migrate resolve --rolled-back 20260717090000_ak_p16b_booking_overlap_constraint`, dann Deploy neu anstoßen. **Proof:** `pnpm typecheck` (Root) 0 Fehler; `verify:i18n`, `verify:production-seed-artifact` Exit 0; SeedService-Tests um Booking-Mocks + Count-/Shape-Assertions erweitert (grün; 1 vorbestehender Timeout-Flake „rejects default admin credentials" tritt identisch auf unverändertem main auf, environmental). `verify:sidebar-routes`-Failures kamen ausschließlich aus einem alten `.codex/worktrees`-Checkout, Repo-Dateien grün.