22 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 | 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.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 · Kontakt-Email-Match → Activity, sonst echtes
InboxLead+Appointment.leadId; bei gesetzterintakeFormIdechtesFormSubmission+Appointment.formSubmissionId, sonstintakeAnswersJson-Fallback; Intake-Form-Auswahl im Page-Editor seit 2026-07-11 (Interim-UI) — offen nur noch Staging-DB-Ausführung (Race-Integrationstest, env-blockiert) - 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 · 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
- Permission-Bundle
bookings.*(read_own/read_all/write/admin) serverseitig Owner-gefiltert - Konnektor
tenantHasModule('booking'); RLS auf allen Tenant-Tabellen (RLS seit20260713190000_appwide_rls_cutoverLIVE — „deferred" erledigt) - e2e-Smoke Public-Booking (fehlender DoD-Punkt, Audit 2026-07-17):
tests/e2e/booking-public.spec.ts(env-gated viaE2E_PUBLIC_BOOKING_PATH, Markerui.booking.public+ Form/Empty) —booking.spec.tsdeckte nurui.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.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 · 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-P16baktualisiert
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
PublicFormRendererwurde 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 optionalerlayout-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:
- Slot-Engine timezone-aware (DoD 1) —
slotEngine.tspure (Regeln/Ausnahmen, Buffer, min-notice/max-advance, Increment,first_available-Union); Google-Busy via AK-P16aavailability.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;intakeAnswersJson; lokales CalendarEvent; Bestätigungsmail + .ics-Attachment (buildIcspure). Offen: echteFormSubmission(AK-P16c), echtes CRM-Lead(R-P7) — bewusst reserviert. - iFrame-Embed + Public-URL (DoD 3) —
/b/.../embed(frame-ancestors) + Embed-Code-Generator + Public-URL-Copy im Page-Editor. - Eine Strategie (DoD 4) —
first_availableimplementiert; 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. - 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. - Konnektor + RLS (DoD 7) —
bookingFeature-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übercreateLead(...), verknüpft es überAppointment.leadIdund schreibt die Activity auf Kontakt oder Lead. Der alte automatische Kontakt-Create ist raus. - Detail-Route akzeptiert serverseitig die M129-Intents
rescheduleundreassignmitbookings.writebzw.bookings.admin; die Picker-UI bleibt D-P16-blockiert. AvailabilityService.server.tsergänzt den atomaren Replace-/Read-Contract fürAvailabilityRule/AvailabilityExceptioninkl. 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
FormSubmissionerledigt (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.intakeFormIdwird im Public-Booking-Resolve mitgeladen.- Public Booking schreibt innerhalb derselben Serializable-Transaktion eine echte
FormSubmission, sobald die BookingPage ein Intake-Form referenziert, und verlinktAppointment.formSubmissionId. OhneintakeFormIdbleibtintakeAnswersder Fallback, damit bestehende BookingPages nicht brechen. - Statische DB-Artefakt-Guards ergänzt:
booking-constraints.sqlmuss dieappointment_no_overlap-Exclusion-Constraint fürscheduled/heldenthalten;booking-isolation.sqlmuss alle fünf Booking-Tabellen mit RLS/FORCE/GUC-Policy undhivegrid_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):
/bookings/pageserreichbar 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 überbookings.read_all(gleiches Gate wie der Pages-Loader selbst); der Loader liefertpagesHref(null ohne Permission).- SeedService um Booking-/Kalender-Demo-Daten erweitert: Der reichhaltige
lokale Demo-Seed verweigert
NODE_ENV=productionund lief daher nie auf Staging — die Staging-Demo-Tenants (demo-starter/pro/business-crm, SeedService mitSEED_ON_BOOT) hatten 0 Booking-Daten.seedDemoTenantBookingDataseedet 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 deterministischeseed-<tenant>-*-IDs bzw. Unique-Upserts; Day-Offsets werden je Lauf neu aufgelöst, „anstehende" Termine bleiben also anstehend.isDemoDatagesetzt, 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):
- DoD 2 Race-Backstop war nie deployt UND nie lauffähig:
booking-constraints.sqllag in keiner Migration (nur manuellerpsql -f-Pfad, der nie ausgeführt wurde) — und das Artefakt selbst war defekt:tstzrange(...)überTIMESTAMP(3)-Spalten wird von Postgres im Index-Ausdruck abgelehnt (impliziter Cast nur STABLE, Fehler 42P17). Fix:tsrange(semantisch identisch, Werte sind UTC) + getrackte, idempotente Migration20260717090000_ak_p16b_booking_overlap_constraintmit Pre-Flight-Overlap-Check und Klartext-Operator-Hinweis;booking-db-artifacts.test.tsprüft jetzt beide Kopien. Proof:verify:migrations-paritygrün (voller Replay gegen leere DB). - 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:
- Constraint war tenant-agnostisch: Die Demo-Tenants teilen sich globale
Provider-User (john.doe/luna.davis), und
seedDemoTenantBookingDatalegt 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. - 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 CONSTRAINTals DDL alle Zeilen indexierte. Fix: Pre-Flight entfernt; stattdessen fängt die Migration dieexclusion_violationund wirft eine Klartext-Meldung mit Diagnose-Query (alspostgresauszufü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.