Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P16a.md
T

4.4 KiB

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