Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,41 @@
# VR-P16 · Google Workspace Kalender für ganze Firma (Domain-wide Delegation)
| | |
|---|---|
| **Typ** | Feature / External (v2) |
| **Owner** | Raffael |
| **Cycle/Fenster** | v2 — Backlog (nach v1-Launch) |
| **Status** | Backlog |
## Was zu tun ist
Org-weite Google-Kalender-Anbindung für Kunden mit **Google Workspace**, sodass nicht jeder
Mitarbeiter einzeln per OAuth zustimmen muss, sondern ein **Workspace-Admin die HiveGrid-App
einmal org-weit freigibt** und HiveGrid auf alle Mitarbeiter-Kalender der Domain zugreifen kann.
- **Service-Account** in der bestehenden Google-Cloud-App (EXT-10) anlegen + **Domain-wide
Delegation** aktivieren (eigener technischer Pfad neben dem User-OAuth aus v1).
- Admin-seitiger Freigabe-Flow: Workspace-Admin trägt die Client-ID + Scope(s) in der
Google-Admin-Console unter „API-Steuerung → Domänenweite Delegierung" ein.
- HiveGrid-seitig: Impersonation pro Nutzer (`subject`-Param), Tenant-Konfiguration „Workspace-Domain
+ Service-Account-Modus" statt Einzel-Connect.
- Doku/Onboarding für Workspace-Admins (welche Client-ID, welche Scopes, wie freigeben).
- Sicherheits-Guard: Vollzugriff auf alle Firmenkalender ist heikel → klare Tenant-Opt-in,
Audit, Scope minimal halten.
## Warum / Kontext
v1 (EXT-10 + P16) macht die Kalender-Anbindung **pro Person** (jeder Nutzer verbindet sein eigenes
Konto, funktioniert auch mit privatem @gmail). Größere Kunden mit eigener Google-Workspace-Domain
wollen das **org-weit** ohne Einzel-Consent. Das ist ein anderes technisches Modell (Service-Account
+ Domain-wide Delegation), nur für Workspace-Kunden sinnvoll und für die v1-SHK-Zielgruppe (meist
kein Workspace) überdimensioniert → bewusst nach v2 verschoben.
## Abhängigkeiten
- **blocked-by:** EXT-10 (Google-Cloud-App + Calendar-Scope müssen existieren), P16 (Kalender-Basis pro Person)
- **blocks:** —
## Definition of Done
- [ ] Service-Account + Domain-wide Delegation in der Google-Cloud-App eingerichtet
- [ ] Admin-Freigabe-Flow dokumentiert (Workspace-Admin-Console)
- [ ] HiveGrid Tenant-Konfiguration „Workspace-Domain / Service-Account-Modus" + Nutzer-Impersonation
- [ ] Org-weiter Kalender-Zugriff ohne Einzel-Consent nachgewiesen (Test gegen eine Workspace-Domain)
- [ ] Sicherheits-/Datenschutz-Guard (Tenant-Opt-in, Audit, Subprozessor-Eintrag → VR-P31)