Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -6,7 +6,9 @@
|
||||
| **Owner** | Akeshan |
|
||||
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
|
||||
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-05 · Gate W4 |
|
||||
| **Status** | in Arbeit (~92 % gewichtet; 5/7 DoD vollständig, 2/7 teilfertig; selbst machbarer Server-Rest erledigt, Rest David D-P16/AK-P16c + Staging-DB-Ausführung) |
|
||||
| **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)
|
||||
@@ -28,12 +30,13 @@
|
||||
|
||||
## Definition of Done
|
||||
- [x] Ö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 gesetzter `intakeFormId` echtes `FormSubmission` + `Appointment.formSubmissionId`, sonst `intakeAnswers` Json-Fallback*
|
||||
- [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)
|
||||
- [~] **Storno/Verschiebung/Re-Assign/No-Show** (M129 VOLL) inkl. Auto-Mail bei Cancel · *Service + Route-Action-Contract vollständig; Reschedule/Re-Assign-Picker-UI → David D-P16*
|
||||
- [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-SQL als deferred Cutover wie Kalender)*
|
||||
- [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).
|
||||
@@ -45,15 +48,36 @@
|
||||
## 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)
|
||||
- `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)
|
||||
- `_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
|
||||
- [ ] 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`
|
||||
@@ -155,3 +179,122 @@ Noch ohne Screens nachgezogen:
|
||||
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.
|
||||
Reference in new issue
Block a user