4.4 KiB
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 alsDataConnection) - 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.prismanur 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.prismanur lesend (DataConnection-Bezug, AD-21). - Kalender = Apps-Engine-Adapter (R-P5): OAuth/Health vom Framework; hier der provider-agnostische
CalendarAdaptermit 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_dataauf 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-P16aaktualisiert