53 lines
4.4 KiB
Markdown
53 lines
4.4 KiB
Markdown
# AK-P16a · P16 Kalender-Sync (Google)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Dev (Code) |
|
|
| **Owner** | Akeshan |
|
|
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
|
|
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-04 · Gate W4 |
|
|
| **Status** | geplant |
|
|
|
|
## 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`)
|
|
- **Blocks:** `AK-P16b` (Booking braucht Slot-Verfügbarkeit aus dem Sync)
|
|
- **Läuft parallel zu:** Raffaels Kern-Kette. **Sync-Punkt R-P5**: Connection-Lifecycle/OAuth-Verschlüsselung kommen aus der Apps-Engine. Eigene `prisma/schema/calendar.prisma` (AD-21); Termine docken an Projekt-Termine + Plantafel (P9) an.
|
|
- **Konflikt-Risiko:** gering — additive Tabellen; `apps.prisma` nur lesend.
|
|
|
|
## Was wir bauen
|
|
Den **bidirektionalen Kalender-Sync mit Google** (Outlook-Adapter → v2, Interface bleibt provider-agnostisch): **CalendarAdapter** mit Auto-Token-Refresh und Webhook-Subscriptions, **pro User** verbunden (nicht pro Tenant). HiveGrid-Termine (Booking/Projekt/Plantafel) gehen extern, externe Events kommen **read-only** für die Verfügbarkeitsberechnung — externe Event-Inhalte leaken **nie** an andere User (Booking sieht nur „belegt von X bis Y"). Konflikte werden per **Last-Write-Wins** aufgelöst und in Klartext ins Konflikt-Log + Notification geschrieben. Eine Kalender-Ansicht zeigt Termine aus allen Quellen mit Quell-Marker.
|
|
|
|
## Benötigte Screens (Backend bedient — Design liefert `D-BOOK` + `D-P16`)
|
|
| Screen [Route] | Kern-Inhalt |
|
|
|---|---|
|
|
| Kalender [`/calendar`] | Monats-/Wochen-Grid mit Terminen aus Google-Sync + HiveGrid-Quellen (Booking, Plantafel, Projekt-Termine), Quell-Marker, Konflikt-Log |
|
|
| Kalender-Verbindungen [`/settings/integrations/calendar`] | Google-Connect-Card (Status-Ampel, Konto-Email, letzte Sync), Kalender-Auswahl, Sync-Richtung, Disconnect mit „auch extern entfernen?", Re-Connect-Banner bei Fehler |
|
|
| Kalender-Verbindungs-Detail [`/settings/integrations/calendar/:id`] | gewählte Kalender, Sync-Status, Konflikt-Liste (letzte 50, Klartext + Resolution) |
|
|
|
|
## Definition of Done
|
|
- [ ] **Bidirektionaler Google-Sync** (CalendarAdapter, Auto-Token-Refresh, Webhook-Subscriptions); Outlook → v2 (Interface provider-agnostisch)
|
|
- [ ] HiveGrid-Termine (Booking/Projekt/Plantafel) gehen **extern**, externe Events kommen **read-only** für Verfügbarkeit
|
|
- [ ] **Connection pro User**; externe Event-Inhalte nie an andere User leaken (nur „belegt von X bis Y")
|
|
- [ ] **Last-Write-Wins-Konflikt** mit Klartext-Notification + Konflikt-Log (letzte 50)
|
|
- [ ] Kalender-Ansicht mit Quell-Markern (HiveGrid + extern)
|
|
- [ ] Konnektor `tenantHasModule('calendar')`; RLS auf allen Tenant-Tabellen; OAuth verschlüsselt (AD-8, via Apps-Engine)
|
|
|
|
## 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).
|
|
- **Kalender = Apps-Engine-Adapter** (R-P5): OAuth/Health vom Framework; hier der provider-agnostische `CalendarAdapter` mit Google als erstem Provider.
|
|
- **Sync-Infra**: Webhook-Subscription-Renewal-Cron, Cursor-basiertes Delta, Last-Write-Wins-Resolver mit Konflikt-Log + `notify()`.
|
|
- **Leak-Schutz**: externe Event-Details nur für den Owner-User; für Verfügbarkeit nur Busy-Slots exponiert.
|
|
- **RLS** überall; `is_demo_data` auf Demo-Terminen.
|
|
|
|
## 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)
|
|
- `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
|
|
- [ ] Plane-Ticket `AK-P16a` aktualisiert
|