Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
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-04 · Gate W4 |
| **Status** | in Arbeit (~83 % DoD, Backend+Routen+Sync+Worker+Write-Pfad fertig; Rest David D-P16/D-BOOK + Staging-DB) |
| **Status** | Done (2026-07-11, PR #75; Interim-UI AD-28; finale Optik = design-nachzug) · Audit 2026-07-17: Reachability-Lücke B.6 gefixt, RLS seit Cutover 14.07. live → 7/7 DoD; offen nur Live-OAuth-Smoke (EXT-15) |
**🎨 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:** `EXT-10` (Google-Cloud-Projekt + OAuth-Consent für Calendar-API), `R-P5` (Apps-Engine — Kalender läuft als `DataConnection`)
@@ -29,8 +31,9 @@ Den **bidirektionalen Kalender-Sync mit Google** (Outlook-Adapter → v2, Interf
- [x] HiveGrid-Termine (Booking/Projekt/Plantafel) gehen **extern**, externe Events kommen **read-only** für Verfügbarkeit
- [x] **Connection pro User**; externe Event-Inhalte nie an andere User leaken (nur „belegt von X bis Y")
- [x] **Last-Write-Wins-Konflikt** mit Klartext-Notification + Konflikt-Log (letzte 50)
- [ ] Kalender-Ansicht mit Quell-Markern (HiveGrid + extern)
- [x] Konnektor `tenantHasModule('calendar')`; RLS auf allen Tenant-Tabellen; OAuth verschlüsselt (AD-8, via Apps-Engine)
- [x] Kalender-Ansicht mit Quell-Markern (HiveGrid + extern) — *Interim-Monats-/Wochen-Grid aus `~/ui` (AD-28); finale Subframe-Optik = design-nachzug*
- [x] Konnektor `tenantHasModule('calendar')`; RLS auf allen Tenant-Tabellen; OAuth verschlüsselt (AD-8, via Apps-Engine) · *RLS ist seit `20260713190000_appwide_rls_cutover` (14.07.) LIVE — der frühere „deferred cutover"-Vermerk ist damit erledigt*
- [x] **Reachability Verbindungsseite (fehlender DoD-Punkt, Audit 2026-07-17):** `/settings/integrations/calendar` ist aus dem Integrations-Katalog erreichbar — die „Kalender"-Karte und die generische `google-calendar`-Detailseite leiten auf die Kalender-Verbindungen um (Aircall-Muster; vorher nur per Direkt-URL/OAuth-Redirect erreichbar, DoD B.6)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/calendar.prisma`): `CalendarConnection` (provider google, oauth_refresh_token **verschlüsselt**, status — **pro User**), `CalendarEvent` (source internal/external_synced, starts/ends_at, is_busy, internal_entity_link polymorph), `CalendarEventMapping` (internal↔external_id), `CalendarSyncCursor` (cursor_token), `CalendarWebhookEvent` (payload). `apps.prisma` nur lesend (DataConnection-Bezug, AD-21).
@@ -42,15 +45,26 @@ Den **bidirektionalen Kalender-Sync mit Google** (Outlook-Adapter → v2, Interf
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 9: Kalender/Booking/Forms/Signatur** (CalendarConnection v1 Google, CalendarEvent/Mapping/SyncCursor/WebhookEvent)
- `REQUIREMENTS.md` → `REQ-kalender-datenmodell`, `REQ-kalender-sync-adapter` (Outlook-Teil → v2)
- `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M118-google-adapter, M119-termin-sync, M120-display-modul-verknuepfung; Outlook v2)
- `ROADMAP.md` → Phase 16 · Milestones: (M118-google-adapter, M119-termin-sync, M120-display-modul-verknuepfung; Outlook v2)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 1 Kalender-Sync; nur Google v1)
- `_bmad-output/specs/M25-calendar-sync.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-P16a` aktualisiert
**Interim-UI (Vorschau, Stand 2026-07-11):** Screens aus `~/ui` gebaut —
`apps/web/app/components/screens/calendar/CalendarViewPage.tsx` (Monats-/Wochen-Grid mit
Quell-Marker-Legende, GET-Navigation `?view=&anchor=`),
`CalendarConnectionsPage.tsx` (A6: Connect-CTA, Not-Configured-/Re-Connect-Banner, Status-Tabelle),
`CalendarConnectionDetailPage.tsx` (A6+A2: Kalender-Liste, Konfliktprotokoll-Tabelle, Disconnect
als XS-420-Dialog). Routen unverändert (Loader/Action), injizieren nur VM+csrf. Proof:
`subframe-layout-boundary.test.ts` (Guard, alle 3 Screens registriert), Calendar-Modultests 24 grün,
`tests/e2e/calendar.spec.ts`-Marker (`ui.calendar.list`) erhalten. Visual-Baseline/Hot-Swap: für
diese Bereiche existiert (wie bei den Automations-/Forms-Nachzügen) noch keine Infra — beim
D-P16-Nachzug mit Re-Baseline aufsetzen. Refactor-Nachzug offen: finale Subframe-Optik aus
`D-P16`/`D-BOOK` (Plane-Label `design-nachzug`).
## Umsetzungs-Notiz (2026-06-30, Akeshan) — ~70 % DoD
Branch `feat/AK-P16a`, 6 lokale Commits (`ca0a410` → `4ac8cb07`), nichts gepusht,
@@ -120,3 +134,50 @@ typecheck; `pnpm run verify:i18n`; gezielte Vitest-Suite **40 Tests grün**
Calendar/Booking VMs 8). Zusätzlich wurde ein AK-P16b-VM-Testimport auf
NodeNext-konformes `.js` korrigiert, damit `@hivegrid/view-models` wieder
typecheck-grün ist.
## Umsetzungs-Notiz (2026-07-11, Akeshan) — Interim-UI (AD-28), 6/6 DoD selbst machbar
Branch `akeshan/ak-p16ab-interim-ui` (von `origin/main`), gemeinsamer Interim-UI-PR
mit AK-P16b. Neu: `CalendarViewPage` (bespoke Monats-/Wochen-Grid aus `~/ui`,
Quell-Marker-Legende + farbige Event-Chips, Heute/Prev/Next/Toggle als
GET-Navigation, Loader lädt das Event-Fenster passend zum Grid, Tage werden
Berlin-lokal gebucketed — pure `calendar-grid.ts` in `@hivegrid/view-models`
mit 7 Unit-Tests), `CalendarConnectionsPage` und `CalendarConnectionDetailPage`
ersetzen die Baseline-Routen-JSX; Disconnect läuft als echter Dialog.
**DoD-Stand: 6/6 = 100 % selbst machbar** — DoD 5 (Kalender-Ansicht Quell-Marker)
per Interim-UI erfüllt; finale Subframe-Optik = getrackter design-nachzug
(Tag oben). Weiter env-blockiert (unverändert): Staging-`db push`, RLS-Live-Check,
Live-OAuth (EXT-15); Visual-Baseline/Hot-Swap-Infra für Calendar fehlt repo-weit
und wird beim D-P16-Nachzug mit aufgesetzt.
**Proof:** `@hivegrid/{view-models,web}` typecheck 0 Fehler; `verify:i18n` +
`verify:sidebar-routes` Exit 0; Vitest gezielt grün: view-models 26,
Calendar-Modul 24, `subframe-layout-boundary.test.ts` (3 neue Calendar-Screens
registriert); e2e-Marker `ui.calendar.list` unverändert.
**Nachtrag Demo-Seed (2026-07-11):** Für das Interim-Kalender-Grid liefert der Demo-Seed
jetzt 6 Kalender-Events mit Quell-Vielfalt (3 interne Booking-Spiegelungen, externer
Material-/Privat-Termin, zweitägige ganztägige Messe) — Details/Proof im
AK-P16b-Seed-Nachtrag; `docs/ops/local-demo-seed.md` aktualisiert.
## Umsetzungs-Notiz (2026-07-17, Akeshan) — Stand-Audit + Restarbeiten
Audit-Befund (Code auf `main` pro DoD-Punkt geprüft): DoD 1–6 real erfüllt, aber
eine **Reachability-Lücke** (DoD B.6, oben als nachgetragener DoD-Punkt): die
„Kalender"-Katalog-Karte führte auf die generische `DataConnection`-Detailseite
(zeigt für Kalender immer 0 Verbindungen, Connect-Wizard hätte den OAuth-Flow
umgangen); `/settings/integrations/calendar` war nur per Direkt-URL erreichbar.
**Fix** (Branch `fix/ak-p16-audit-restwork`): Katalog-Karte + Loader/Action der
generischen Detailseite leiten nach Aircall-Muster auf `calendarConnectionsPath`
um; Routing-Kontrakt-Test `integrations.calendar-routing.test.ts` (6 Tests grün).
**Drift korrigiert:** Die RLS ist seit dem appwide Cutover
(`20260713190000_appwide_rls_cutover`, ENABLE+FORCE auf allen 6 Calendar-Tabellen)
live — die als „env-blockiert offen" geführten Staging-RLS-Vermerke sind damit
gegenstandslos; `calendar.prisma`-Header-Kommentar entsprechend nachgezogen.
Offen extern bleibt nur der Live-OAuth-Smoke (EXT-15, Google-App-Verifizierung).
Kleinbefund (kein DoD-Bruch, notiert): der Worker-Write-Pfad mappt Provider-412
hart auf `external_won` statt den pure `resolveConflict`-Resolver zu nutzen —
funktional Last-Write-Wins-konform; Umbau nur als Vorschlag außerhalb Scope.