Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-P16b.md
T

301 lines
22 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-<tenant>-*`-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.