Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,590 @@
|
||||
---
|
||||
module: 35
|
||||
title: DSGVO-Export / Account-Löschung / Tenant-Daten-Portabilität
|
||||
phase: 1
|
||||
status: detail-spec-draft
|
||||
last_updated: 2026-05-08
|
||||
session_source: brainstorming-session-2026-05-07-2206.md
|
||||
related_lps: [LP-8, LP-9, LP-10, LP-13]
|
||||
spec_style: requirements-pur
|
||||
---
|
||||
|
||||
# Modul 35 — DSGVO-Export / Account-Löschung
|
||||
|
||||
> **Detail-Spec gemäß LP-9.** Konsolidiert User-Account-Löschung (Apple-Pflicht seit 2022, bereits in Modul 27 Block D.3 spec'd), Tenant-Daten-Export (DSGVO-Auskunftsrecht + Vendor-Lock-in-Vermeidung), Tenant-Lösch-Workflow bei Kündigung, AVV-Vertrag im Onboarding, Subprozessoren-Liste und Privacy-Manifest. **LP-13 (EU-Stack komplett) ist hier Querschnitt.**
|
||||
|
||||
## Themenblöcke
|
||||
|
||||
```
|
||||
A. Datenmodell (GdprExportJob, TenantDeletionRequest, AvvAcceptance, Subprocessor)
|
||||
B. Routes (Tenant-Admin-Scope und User-Scope)
|
||||
C. User-Daten-Export (jeder User für sich)
|
||||
D. Tenant-Daten-Export (Tenant-Admin)
|
||||
E. User-Account-Löschung (Apple-Pflicht, Verweis auf Modul 27 D.3)
|
||||
F. Tenant-Kündigung und Lösch-Workflow (30-Tage-Grace, Hard-Delete)
|
||||
G. AVV-Vertrag im Onboarding
|
||||
H. Subprozessoren-Liste
|
||||
I. Privacy-Manifest (Capacitor-App)
|
||||
J. Permissions
|
||||
K. Klartext-Hinweise
|
||||
L. Phase 2 Erweiterungen
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Block A — Datenmodell
|
||||
|
||||
### GdprExportJob
|
||||
|
||||
Tenant-scoped (RLS aktiv).
|
||||
|
||||
- `id`, `tenant_id`, `created_at`, `updated_at`
|
||||
- `requested_by_user_id` (welcher User hat den Export angefordert)
|
||||
- `scope` (Enum: `user_self | tenant_full`)
|
||||
- `target_user_id` (bei `scope=user_self`: der User dessen Daten gemeint sind; gleich `requested_by_user_id`)
|
||||
- `status` (Enum: `queued | processing | ready | failed | expired`)
|
||||
- `progress_percent` (Integer 0-100)
|
||||
- `result_file_id` (FK auf `File` aus Modul 23, ZIP-Output)
|
||||
- `result_size_bytes`
|
||||
- `result_expires_at` (Default 7 Tage nach `ready` — danach automatischer Hard-Delete der ZIP-Datei)
|
||||
- `download_count` (für Audit)
|
||||
- `last_downloaded_at`
|
||||
- `error_message` (Klartext bei `failed`)
|
||||
- `processing_started_at`, `processing_finished_at`
|
||||
|
||||
**Indizes:** `(tenant_id, status)`, `(result_expires_at)` für Cleanup-Cron, `(requested_by_user_id, scope)`.
|
||||
|
||||
**Constraint:** max. 1 aktiver `tenant_full`-Job pro Tenant gleichzeitig. Max. 3 aktive `user_self`-Jobs pro User pro 24h (Rate-Limit gegen Missbrauch).
|
||||
|
||||
### TenantDeletionRequest
|
||||
|
||||
Tenant-scoped (RLS aktiv).
|
||||
|
||||
- `id`, `tenant_id`, `created_at`
|
||||
- `requested_by_user_id` (Tenant-Admin)
|
||||
- `reason` (Enum: `voluntary | non_payment | suspended_violation | admin_initiated`) — `voluntary` ist Self-Service, Rest kommt aus Plattform-Admin
|
||||
- `reason_text` (optionaler Freitext-Kommentar)
|
||||
- `grace_period_ends_at` (Default `created_at + 30 Tage`)
|
||||
- `status` (Enum: `pending | cancelled | executing | completed | failed`)
|
||||
- `cancelled_by_user_id`, `cancelled_at` (bei Rücknahme innerhalb Grace-Period)
|
||||
- `execution_started_at`, `execution_finished_at`
|
||||
- `failure_reason` (bei `failed`)
|
||||
|
||||
**Indizes:** `(tenant_id)` (unique über `status IN ('pending', 'executing')` — max 1 aktive Lösch-Anforderung), `(grace_period_ends_at, status)` für Cron.
|
||||
|
||||
### AvvAcceptance
|
||||
|
||||
Tenant-scoped, einmalig pro Tenant beim Onboarding angelegt.
|
||||
|
||||
- `id`, `tenant_id`, `created_at`
|
||||
- `accepted_by_user_id` (User der die Checkbox geklickt hat — typischerweise GF beim Signup)
|
||||
- `accepted_ip`, `accepted_user_agent` (für Beweisbarkeit)
|
||||
- `avv_version` (z.B. `2026-05`) — bei AVV-Updates wird neuer Eintrag verlangt
|
||||
- `pdf_file_id` (FK auf `File`, signiertes PDF mit Tenant-Daten + Datum)
|
||||
- `signer_full_name`, `signer_company_role` (z.B. *„Geschäftsführer"*) — für PDF-Branding
|
||||
|
||||
**Indizes:** `(tenant_id, avv_version)` unique.
|
||||
|
||||
### Subprocessor
|
||||
|
||||
Plattform-globale Tabelle (kein RLS, App-Code-gegated).
|
||||
|
||||
- `id`, `created_at`, `updated_at`
|
||||
- `name` (z.B. *„Scaleway S.A.S."*)
|
||||
- `purpose_text` (Klartext: *„Hosting + Object-Storage + DB"*)
|
||||
- `country` (ISO, z.B. `FR`)
|
||||
- `is_eu_eea` (Boolean)
|
||||
- `data_categories[]` (z.B. *„Stamm-/Vertragsdaten, User-Content, Logs"*)
|
||||
- `dpa_url` (Link auf öffentliches Auftragsverarbeitungs-Vertragstemplate des Subprozessors)
|
||||
- `active_since` (Datum)
|
||||
- `archived_at` (wenn aufgegeben)
|
||||
|
||||
**Beim Onboarding:** Tenant sieht aktuelle Liste als Teil der AVV-Akzeptanz.
|
||||
|
||||
### Klartext-Sichtbarkeit von Drittland-Transfers
|
||||
|
||||
- `country` außerhalb EU/EEA → in Tenant-UI **Klartext-Warnung** sichtbar (*„Daten werden außerhalb der EU verarbeitet — Rechtsgrundlage: ..."*)
|
||||
- In Phase 1 ist das EU-Stack-Pflicht (LP-13), daher Liste sollte ausschließlich EU/EEA-Anbieter enthalten — Schema unterstützt aber Drittland für Sichtbarkeit/Korrektheit
|
||||
|
||||
---
|
||||
|
||||
## Block B — Routes
|
||||
|
||||
### Tenant-Admin-Scope (Workspace-Verwaltung)
|
||||
|
||||
```
|
||||
/{tenant}/admin/privacy/ → Privacy-Hub (Übersicht)
|
||||
/{tenant}/admin/privacy/export/ → Tenant-Daten-Export-Liste
|
||||
/{tenant}/admin/privacy/export/new → Neuen Export anstoßen
|
||||
/{tenant}/admin/privacy/export/:jobId → Export-Job-Status
|
||||
/{tenant}/admin/privacy/deletion/ → Tenant-Lösch-Workflow starten
|
||||
/{tenant}/admin/privacy/deletion/:requestId → Lösch-Anforderungs-Status (mit Cancel-Funktion)
|
||||
/{tenant}/admin/privacy/subprocessors/ → Subprozessoren-Liste
|
||||
/{tenant}/admin/privacy/avv/ → AVV-PDF-Download und Akzeptanz-History
|
||||
```
|
||||
|
||||
**Permission:** `tenant.admin` für alle.
|
||||
|
||||
### User-Scope (persönliche Settings)
|
||||
|
||||
```
|
||||
/{tenant}/settings/account/ → Account-Settings (siehe Modul 27 D.3)
|
||||
/{tenant}/settings/account/data-export → Eigener User-Daten-Export
|
||||
/{tenant}/settings/account/data-export/:jobId → Export-Job-Status
|
||||
/{tenant}/settings/account/delete → Account-Löschung (Multi-Step, siehe Modul 27 D.3)
|
||||
```
|
||||
|
||||
**Permission:** Login + Tenant-Membership (jeder User darf seine eigenen Daten exportieren und seinen Account löschen).
|
||||
|
||||
---
|
||||
|
||||
## Block C — User-Daten-Export (User-Scope)
|
||||
|
||||
### Anwendungsfall
|
||||
|
||||
Jeder User darf jederzeit alle Daten, die mit seiner Person verknüpft sind, in maschinenlesbarem Format anfordern (DSGVO Art. 15 Auskunftsrecht + Art. 20 Datenportabilität).
|
||||
|
||||
### Was wird exportiert
|
||||
|
||||
**Stammdaten:**
|
||||
- User-Account-Stammdaten (Email, Name, Sprache, 2FA-Status, OAuth-Verknüpfungen, Notification-Preferences)
|
||||
- Aktive Sessions (gekürzt: nur Geräte-Liste, keine Tokens)
|
||||
- API-Keys (gekürzt: keine Secret-Werte)
|
||||
|
||||
**Tenant-Membership-Daten:**
|
||||
- TenantUser-Beziehung (Rollen, Groups, Beitritts-Datum)
|
||||
- Permission-Snapshot
|
||||
|
||||
**User-erzeugte Inhalte:**
|
||||
- Activities, in denen User als Actor auftritt (`actor_user_id = self`)
|
||||
- Notes, die User erstellt hat
|
||||
- Chat-Nachrichten, die User geschrieben hat
|
||||
- Tasks, die User erstellt oder zugewiesen wurden
|
||||
- Termine (Booking + Calendar) mit User-Beteiligung
|
||||
- Hochgeladene Files (Metadaten + Binary)
|
||||
- Form-Submissions (falls von User stammend)
|
||||
- HR-Datenbestand zu sich selbst (eigene Krankmeldungen, Urlaubsanträge, Payslips, Personaldokumente — nicht die der Kollegen)
|
||||
|
||||
**Kommunikations-Daten:**
|
||||
- Outbound-Emails, die User gesendet hat (mit Body)
|
||||
- Eingehende Emails, die in Mailbox des Users waren
|
||||
|
||||
**KI/Audit:**
|
||||
- Eigene KI-Konversations-Historie (HiveMind, AI-Assistent)
|
||||
- Audit-Spuren mit User als `actor_user_id`
|
||||
|
||||
### Format
|
||||
|
||||
**ZIP-Archiv mit Struktur:**
|
||||
|
||||
```
|
||||
user-export-{userId}-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
├── README.md ← Klartext-Erklärung was im ZIP ist
|
||||
├── manifest.json ← Schema-Version, Generations-Datum, Tenant, User
|
||||
├── account/
|
||||
│ ├── profile.json
|
||||
│ ├── sessions.json
|
||||
│ ├── notification-preferences.json
|
||||
│ └── oauth-connections.json
|
||||
├── memberships/
|
||||
│ └── tenant-{tenantId}.json
|
||||
├── activities/
|
||||
│ └── activities.jsonl ← JSONL für große Mengen
|
||||
├── chat/
|
||||
│ └── messages.jsonl
|
||||
├── notes/
|
||||
│ └── notes.jsonl
|
||||
├── tasks/
|
||||
│ └── tasks.jsonl
|
||||
├── appointments/
|
||||
│ └── appointments.jsonl
|
||||
├── files/
|
||||
│ ├── files-metadata.jsonl
|
||||
│ └── binaries/ ← Original-Files in Subordnern pro Modul
|
||||
│ ├── projects/
|
||||
│ ├── chat/
|
||||
│ └── ...
|
||||
├── emails/
|
||||
│ ├── outbound.jsonl
|
||||
│ ├── inbound.jsonl
|
||||
│ └── attachments/ ← Original-Attachments
|
||||
├── hr/
|
||||
│ ├── leave-requests.jsonl
|
||||
│ ├── sick-reports.jsonl
|
||||
│ ├── payslips/ ← Original-PDFs
|
||||
│ └── personal-docs/
|
||||
├── ai-conversations/
|
||||
│ └── conversations.jsonl
|
||||
└── audit/
|
||||
└── audit-trail.jsonl
|
||||
```
|
||||
|
||||
**JSON-Schema-Version** im `manifest.json` für künftige Kompatibilität.
|
||||
|
||||
### Workflow
|
||||
|
||||
1. User klickt *„Daten exportieren"* in `/{tenant}/settings/account/data-export`
|
||||
2. Klartext-Erklärung: was wird exportiert, ungefähre Dauer, Aufbewahrungs-Frist
|
||||
3. Bestätigungs-Klick → `GdprExportJob` mit `scope=user_self` wird angelegt, Status `queued`
|
||||
4. Worker (BullMQ) verarbeitet: zieht Daten aus allen Modulen, packt ZIP, lädt in Storage hoch
|
||||
5. Status `ready` → User bekommt Email mit Download-Link (Magic-Link gegen Auth-Bypass) + In-App-Notification
|
||||
6. Download via signed-URL (max. Lebenszeit 7 Tage, dann ZIP gelöscht)
|
||||
|
||||
### Edge-Cases
|
||||
|
||||
- User hat sehr große Datenmenge (z.B. 50.000+ Activities): Worker arbeitet in Chunks, Progress-Update alle 5%
|
||||
- Job läuft länger als 24h: Status auf `failed` setzen, Klartext: *„Export hat länger als erwartet gedauert. Bitte erneut anstoßen oder Support kontaktieren."*
|
||||
- Concurrent: max. 3 aktive `user_self`-Jobs pro User pro 24h (Block mit Klartext)
|
||||
- Permission-Check: User darf nur seinen eigenen Export anfordern. Tenant-Admin darf **nicht** für andere User-Daten exportieren (das wäre `tenant_full`-Scope)
|
||||
|
||||
---
|
||||
|
||||
## Block D — Tenant-Daten-Export (Tenant-Admin-Scope)
|
||||
|
||||
### Anwendungsfall
|
||||
|
||||
Tenant-Admin (`tenant.admin`) darf alle Daten des kompletten Tenants in maschinenlesbarem Format anfordern. Zwei Hauptzwecke:
|
||||
- DSGVO-Auskunftsrecht für die Firma als Verantwortlicher
|
||||
- Vendor-Lock-in-Vermeidung (Wechsel weg von HiveGrid)
|
||||
|
||||
### Was wird exportiert
|
||||
|
||||
**Alle tenant-scoped Entitäten** als JSON. Für jede Entität ein eigenes JSONL-File:
|
||||
|
||||
- `crm/contacts.jsonl`, `crm/companies.jsonl`, `crm/leads.jsonl`, `crm/contact-company-relations.jsonl`
|
||||
- `crm/custom-field-definitions.jsonl`, `crm/custom-field-values.jsonl`
|
||||
- `deals/deals.jsonl`, `deals/pipelines.jsonl`, `deals/pipeline-stages.jsonl`
|
||||
- `projects/projects.jsonl`, `projects/project-pipelines.jsonl`, `projects/project-members.jsonl`, `projects/acceptance-protocols.jsonl`, `projects/schedule-entries.jsonl`
|
||||
- `tasks/tasks.jsonl`
|
||||
- `forms/forms.jsonl`, `forms/form-submissions.jsonl`, `forms/form-actions.jsonl`
|
||||
- `bookings/booking-pages.jsonl`, `bookings/appointments.jsonl`, `bookings/availability-rules.jsonl`
|
||||
- `email/inbound.jsonl`, `email/outbound.jsonl`, `email/campaigns.jsonl`, `email/sending-domains.jsonl`
|
||||
- `chat/messages.jsonl`, `chat/threads.jsonl`, `chat/reactions.jsonl`
|
||||
- `whatsapp/...` (falls aktiv)
|
||||
- `telephony/call-sessions.jsonl`
|
||||
- `signatures/...`
|
||||
- `hr/...` (alle HR-Hub-Daten)
|
||||
- `portal/...` (Customer-Portal)
|
||||
- `automations/rules.jsonl`, `automations/executions.jsonl`
|
||||
- `ai/conversations.jsonl`, `ai/embeddings-metadata.jsonl` (Embeddings selbst nicht exportiert — nicht-portabel)
|
||||
- `kwp/...` (KWP-Sync-Daten falls aktiv)
|
||||
- `audit/audit-trail.jsonl`
|
||||
- `users/tenant-users.jsonl` (mit gekürzten PII anderer User — Email, Name; nicht Passwort, nicht 2FA-Secrets)
|
||||
- `roles-permissions/roles.jsonl`, `roles-permissions/permissions.jsonl`, `roles-permissions/groups.jsonl`
|
||||
- `tags/tags.jsonl`, `tags/entity-tags.jsonl`
|
||||
- `feature-flags/effective-values.jsonl` (welche Flags waren wann aktiv)
|
||||
- `subscriptions/subscription-history.jsonl`
|
||||
|
||||
**Plus alle Files** im Original-Format unter `files/` (gleiche Verzeichnis-Struktur wie im Storage: `files/{module}/{entityId}/{fileName}`).
|
||||
|
||||
### Format
|
||||
|
||||
**ZIP-Archiv** (potenziell sehr groß — kann mehrere GB sein):
|
||||
|
||||
```
|
||||
tenant-export-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
├── README.md
|
||||
├── manifest.json
|
||||
├── schema/
|
||||
│ └── *.json ← JSON-Schema-Definitionen je Entität
|
||||
├── crm/
|
||||
├── deals/
|
||||
├── projects/
|
||||
├── ... (siehe oben)
|
||||
└── files/
|
||||
```
|
||||
|
||||
**Bei extrem großen Tenants:** Multi-Part-ZIP mit Index-File (`tenant-export-...part01.zip`, `part02.zip`, ...). Implementierungs-Detail.
|
||||
|
||||
### Workflow
|
||||
|
||||
1. Tenant-Admin klickt *„Tenant-Daten exportieren"* in `/{tenant}/admin/privacy/export/new`
|
||||
2. Klartext-Erklärung: was wird exportiert, geschätzte Größe (basierend auf DB-/Storage-Statistik), erwartete Dauer, Aufbewahrungs-Frist (7 Tage Download-Window)
|
||||
3. Optional: Scope-Filter (z.B. *„nur CRM"*, *„nur HR"*) — **Phase 2**, in Phase 1 immer Vollexport
|
||||
4. Bestätigungs-Klick → `GdprExportJob` mit `scope=tenant_full`
|
||||
5. Worker arbeitet asynchron — kann Stunden dauern bei großen Tenants
|
||||
6. Progress sichtbar in Real-Time (Websocket oder Polling)
|
||||
7. Status `ready` → Tenant-Admin bekommt Email + In-App-Notification
|
||||
8. Download via signed-URL, Multi-Part-Download wenn nötig
|
||||
9. Audit-Eintrag mit `download_count` pro Zugriff
|
||||
|
||||
### Edge-Cases
|
||||
|
||||
- Tenant ist im Status `frozen` oder `past_due`: Export trotzdem erlaubt (Lese-Recht hat Vorrang)
|
||||
- Tenant ist `deletion_pending`: Export erlaubt während Grace-Period — Klartext-Hinweis *„Letzte Möglichkeit, Daten zu sichern bevor Tenant gelöscht wird."*
|
||||
- Job-Fehler mitten im Export: Resume-Mode (Worker speichert Checkpoint, kann ab letzter erfolgreicher Entität fortsetzen)
|
||||
- Storage-Limit überschritten beim Schreiben des ZIPs: Klartext-Fehler *„Export-ZIP zu groß für Storage. Bitte Support kontaktieren — wir splitten es in Teilexporte."*
|
||||
- Concurrent: max. 1 aktiver `tenant_full`-Job pro Tenant
|
||||
- Klartext bei extrem großem Tenant beim Anstoßen: *„Geschätzte Dauer: ca. 4-6 Stunden. Geschätzte Größe: ca. 12 GB. [Trotzdem starten]"*
|
||||
|
||||
---
|
||||
|
||||
## Block E — User-Account-Löschung
|
||||
|
||||
**Spec ist in Modul 27 Block D.3 vollständig.** Hier nur Konsolidierungs-Hinweise:
|
||||
|
||||
- Multi-Step-Bestätigung in `/{tenant}/settings/account/delete`
|
||||
- Apple-Pflicht seit 2022 — App-Store-Compliance gegeben durch Sichtbarkeit auf gleicher Ebene wie Profil-Settings
|
||||
- Was passiert technisch: TenantUser-Beziehungen gelöscht, PII mit `[deleted-{userId}]` überschrieben, Audit-Spuren behalten User-ID, 2FA/Sessions/Push-Tokens/OAuth-Konten weg, Avatar gelöscht
|
||||
- 24h-Reverse-Window mit Bestätigungs-Email an Lösch-Adresse
|
||||
|
||||
**Erweiterung in Modul 35:**
|
||||
- Bei User-Löschung wird **automatisch** ein User-Daten-Export angeboten (Multi-Step Step 1.5: *„Möchtest du vorher deine Daten exportieren? [Ja, Export starten] [Nein, direkt löschen]"*)
|
||||
- User klickt „Ja" → Export-Job läuft, User bekommt Email mit Download → erst nach Download (oder nach Ablauf 7 Tage) wird Lösch-Workflow fortgesetzt
|
||||
- User klickt „Nein" → direkter Übergang zu Step 2 (Identitäts-Bestätigung)
|
||||
|
||||
---
|
||||
|
||||
## Block F — Tenant-Kündigung und Lösch-Workflow
|
||||
|
||||
### Voluntary Deletion (Self-Service durch Tenant-Admin)
|
||||
|
||||
**Workflow:**
|
||||
|
||||
1. Tenant-Admin in `/{tenant}/admin/privacy/deletion/` klickt *„Workspace kündigen"*
|
||||
2. **Step 1 — Erklärung:** Klartext was passiert
|
||||
- Status wechselt sofort auf `deletion_pending`
|
||||
- Workspace bleibt 30 Tage sichtbar (Read-Only-Modus, Login möglich, Daten lesbar, Schreib-Aktionen blockiert)
|
||||
- Nach 30 Tagen Hard-Delete aller Tenant-Daten inkl. Files
|
||||
- Ab Hard-Delete: nicht wiederherstellbar
|
||||
3. **Step 2 — Datensicherung-Hinweis:** *„Vor Lösch-Bestätigung empfehlen wir: Tenant-Daten-Export starten. [Export jetzt starten] [Habe ich bereits] [Daten brauche ich nicht]"*
|
||||
4. **Step 3 — Stripe-Hinweis:** Klartext über Restbetrag, Pro-rata-Erstattung, letzte Rechnung
|
||||
5. **Step 4 — Identitäts-Bestätigung:** Pwd + 2FA falls aktiv
|
||||
6. **Step 5 — Final-Klick** mit Tenant-Slug-Eingabe als Confirm-Phrase (User muss `geerkens-gmbh` eintippen, nicht nur einen Knopf drücken)
|
||||
7. `TenantDeletionRequest` mit `reason=voluntary`, `grace_period_ends_at = now + 30 Tage` wird angelegt
|
||||
8. Tenant-Status → `deletion_pending`
|
||||
9. Bestätigungs-Email an alle Tenant-Admins
|
||||
10. Banner im Workspace: *„Konto wird in X Tagen gelöscht — [Kündigung zurückziehen]"*
|
||||
|
||||
### Cancel innerhalb Grace-Period
|
||||
|
||||
- Jeder Tenant-Admin kann mit einem Klick rückgängig machen → Status zurück auf `active` (oder vorherigen Status)
|
||||
- Audit-Eintrag: wer hat gekündigt, wer hat zurückgezogen
|
||||
- Stripe-Subscription wird bei Cancel reaktiviert (siehe Modul 28)
|
||||
|
||||
### Hard-Delete-Cron (nach 30 Tagen)
|
||||
|
||||
**Cron-Job läuft täglich**, prüft `TenantDeletionRequest` mit `grace_period_ends_at < now AND status='pending'`.
|
||||
|
||||
**Für jeden Hit:**
|
||||
|
||||
1. Status auf `executing`, `execution_started_at` gesetzt
|
||||
2. **Reihenfolge der Löschung** (FK-Abhängigkeit beachten):
|
||||
- Files in Scaleway-Storage: `tenants/{tenantId}/...` rekursiv löschen
|
||||
- Embeddings (pgvector): alle `TenantEmbedding`-Einträge löschen
|
||||
- Worker-Queues: alle ausstehenden Jobs für diesen Tenant verwerfen
|
||||
- Webhook-Subscriptions: deaktivieren und löschen
|
||||
- DB-Daten: Reihenfolge per FK — Activity-Daten → Verknüpfungs-Tabellen → Haupt-Entitäten → User-Memberships → Tenant selbst
|
||||
- Audit-Daten: behalten in Plattform-Audit-Log (Modul 37) ohne Tenant-Daten — nur Metadata (Lösch-Datum, User-ID des Auslösers, Reason)
|
||||
- Cache-Keys: Redis `tenant:{tenantId}:*` purgen
|
||||
3. Status auf `completed`
|
||||
4. Tenant-Status → `deleted` (siehe Modul 27 A.5)
|
||||
5. Bestätigungs-Email an `accepted_by_user_id` aus AVV: *„Tenant ‚X' wurde am [Datum] vollständig gelöscht. DSGVO-Auftrag erfüllt."*
|
||||
6. Plattform-Audit-Log-Eintrag
|
||||
|
||||
### Was bleibt nach Hard-Delete
|
||||
|
||||
- Audit-Metadata in `AdminAuditLog` (Modul 37): Tenant-ID, Slug, Lösch-Datum, Reason, Akteur
|
||||
- Stripe-Records (von Stripe-Seite, gemäß deren Aufbewahrungs-Pflichten)
|
||||
- Email-Logs vom Email-Provider (gemäß deren Retention)
|
||||
- **Keine** PII, **keine** User-Inhalte
|
||||
|
||||
### Reasons außer `voluntary`
|
||||
|
||||
- `non_payment` — automatisch nach 30 Tagen `past_due` (Trigger: Stripe-Webhook-Logik in Modul 28); `TenantDeletionRequest` wird automatisch angelegt
|
||||
- `suspended_violation` — Plattform-Admin kündigt manuell wegen AGB-Verstoß; ggf. verkürzte Grace-Period
|
||||
- `admin_initiated` — Plattform-Admin kündigt im Auftrag des Tenant-Admins (z.B. Email-Anfrage); Tenant-Admin bekommt Bestätigungs-Email mit Cancel-Link
|
||||
|
||||
### Edge-Cases
|
||||
|
||||
- Hard-Delete-Cron schlägt mittendrin fehl: Status `failed`, Resume-fähig (idempotente Lösch-Aktionen)
|
||||
- Tenant-Daten-Export läuft noch beim Hard-Delete: Export-Job wird abgebrochen, ZIP gelöscht, Klartext im Audit
|
||||
- Tenant-Admin kündigt während aktiver Subscription: Stripe-Cancel wird beim Hard-Delete-Cron getriggert (nicht beim Anlegen der `TenantDeletionRequest` — User soll noch zurückziehen können ohne Stripe-Doppel-Abbuchung)
|
||||
- Last-Tenant-Admin kündigt Tenant: erlaubt (anders als bei User-Löschung — Tenant-Kündigung ist explizit das Ende)
|
||||
|
||||
---
|
||||
|
||||
## Block G — AVV-Vertrag im Onboarding
|
||||
|
||||
### Akzeptanz beim Signup
|
||||
|
||||
**In Modul 27 A.1 Self-Service-Signup-Formular:** Checkbox „AVV-Akzeptanz" als Pflicht-Feld.
|
||||
|
||||
**Erweiterung hier:**
|
||||
|
||||
- Beim Klick: PDF-Vorschau des AVV mit aktueller Version (`avv_version`)
|
||||
- PDF wird **dynamisch generiert** mit Tenant-spezifischen Daten:
|
||||
- Firma (Tenant-Name)
|
||||
- Anschrift (aus Signup)
|
||||
- GF-Name + Rolle (Signer)
|
||||
- Datum
|
||||
- Aktuelle Subprozessoren-Liste (Snapshot der Tabelle)
|
||||
- Aktuelle Version-ID
|
||||
- User klickt *„Elektronisch unterschreiben"* → System speichert:
|
||||
- `AvvAcceptance`-Eintrag mit IP, User-Agent, Datum, Signer-Name, Version
|
||||
- Generiertes PDF in Storage (`tenants/{tenantId}/legal/avv-{version}-{date}.pdf`)
|
||||
- Audit-Eintrag
|
||||
|
||||
### Re-Akzeptanz bei Updates
|
||||
|
||||
- Bei AVV-Update (neue `avv_version`): Plattform-Admin triggert Re-Akzeptanz für alle Tenants
|
||||
- Beim nächsten Login: Modal mit Klartext *„Unsere AVV wurde aktualisiert (Änderungen: [Klartext]). Bitte erneut akzeptieren."*
|
||||
- Nutzungs-Sperre nach 14 Tagen ohne Re-Akzeptanz → Read-Only-Modus mit Klartext-Banner
|
||||
- Tenant-Admin sieht Liste aller akzeptierten Versionen im `/admin/privacy/avv/`
|
||||
|
||||
### Download
|
||||
|
||||
- Tenant-Admin sieht in `/{tenant}/admin/privacy/avv/`:
|
||||
- Aktuelle Version (PDF-Download)
|
||||
- History aller akzeptierten Versionen mit Datum + Signer
|
||||
- Download als PDF jederzeit möglich
|
||||
|
||||
### Edge-Cases
|
||||
|
||||
- AVV-Update während aktiver Trial-Phase: Tenant muss akzeptieren bevor Trial in `active` übergeht
|
||||
- Tenant lehnt Re-Akzeptanz ab: Klartext mit Folgen (*„Ohne Akzeptanz können wir den Service nicht weiter erbringen — bitte Support kontaktieren oder Workspace kündigen"*) und Link zu Lösch-Workflow
|
||||
|
||||
---
|
||||
|
||||
## Block H — Subprozessoren-Liste
|
||||
|
||||
### Sichtbarkeit für Tenant
|
||||
|
||||
`/{tenant}/admin/privacy/subprocessors/` zeigt:
|
||||
|
||||
- Liste aller aktiven `Subprocessor`-Einträge
|
||||
- Pro Eintrag: Name, Land, EU/EEA-Indikator, Zweck-Klartext, Datenkategorien, DPA-Link, „Aktiv seit"
|
||||
|
||||
**Benötigte UI-Elemente:**
|
||||
- Tabellarische Anzeige
|
||||
- Filter: nur EU vs. alle, nach Datenkategorie
|
||||
- Such-Funktion über Name + Zweck
|
||||
- Export als CSV/PDF (für Tenant-eigene Compliance-Doku)
|
||||
|
||||
### Änderungs-Benachrichtigung
|
||||
|
||||
- Bei Hinzufügen eines neuen Subprozessors: Plattform-Admin triggert Benachrichtigung
|
||||
- Email an alle Tenant-Admins mit Klartext-Beschreibung des neuen Subprozessors
|
||||
- 14-Tage-Widerspruchs-Frist (gesetzliche AVV-Pflicht): Tenant kann widersprechen → Klartext mit Folgen (*„Ohne neuen Subprozessor können wir Feature X nicht anbieten — bitte Support kontaktieren"*)
|
||||
- Audit-Eintrag pro Notification-Versand
|
||||
|
||||
### Plattform-Admin-Verwaltung
|
||||
|
||||
In Modul 37: Subprocessoren-Anlegen / Editieren / Archivieren mit Cross-Tenant-Auswirkung. Detail dort.
|
||||
|
||||
---
|
||||
|
||||
## Block I — Privacy-Manifest (Capacitor-App)
|
||||
|
||||
**Apple-Pflicht seit 2024.** Modul-übergreifender Querschnitt — wird in Modul 36 (Mobile-App) konkret implementiert, aber Inhalt-Quelle liegt hier:
|
||||
|
||||
### Pflicht-Inhalte
|
||||
|
||||
- **Daten-Sammelarten:** welche Datentypen sammelt die App (Kontakt-Info, User-Content, Identifiers, Diagnostics, Usage-Data)
|
||||
- **Tracking-Domains:** Liste aller Drittanbieter-Domains, an die Daten gehen
|
||||
- **Required-Reason-APIs:** für jeden genutzten Apple-API mit Reason-Pflicht (z.B. `UserDefaults`, `FileTimestamp`) der dokumentierte Grund
|
||||
|
||||
### Dynamisch vs. statisch
|
||||
|
||||
- **Statisch:** generelle App-Funktion (Kamera, Push, Location-bei-Nutzung)
|
||||
- **Dynamisch:** je nach aktivierten Modulen pro Tenant — z.B. Aircall-Telefonie aktiv → Telefon-Permissions; HR-Hub aktiv → Personal-Daten; etc.
|
||||
- In Phase 1 wird ein **maximales Privacy-Manifest** verwendet (alle möglichen Datenarten deklariert), unabhängig davon ob Tenant das Feature aktiv hat. Spätere Optimierung Phase 2.
|
||||
|
||||
### Lebenszyklus
|
||||
|
||||
- Bei jedem App-Store-Submit muss Privacy-Manifest aktuell sein
|
||||
- Plattform-Admin pflegt Master-Liste in Modul 37
|
||||
- Build-Pipeline für Capacitor-App generiert `PrivacyInfo.xcprivacy` aus Master-Liste
|
||||
|
||||
### Klartext-Sichtbarkeit für Tenant
|
||||
|
||||
- `/{tenant}/admin/privacy/` zeigt Link auf öffentliche Privacy-Manifest-Seite (Marketing-Site `hivegrid.de/privacy-manifest`)
|
||||
- Quick-Verlinkung auf Drittland-Übersicht (siehe Block H)
|
||||
|
||||
---
|
||||
|
||||
## Block J — Permissions
|
||||
|
||||
### Permission-IDs
|
||||
|
||||
| Permission | Erlaubt |
|
||||
|---|---|
|
||||
| `privacy.user_export.self` | Eigenen User-Daten-Export anstoßen (jeder eingeloggte Tenant-User implizit) |
|
||||
| `privacy.tenant_export` | Tenant-Daten-Export anstoßen |
|
||||
| `privacy.tenant_deletion` | Tenant-Lösch-Workflow starten oder zurückziehen |
|
||||
| `privacy.subprocessors.read` | Subprozessoren-Liste einsehen |
|
||||
| `privacy.avv.read` | AVV-PDF und Akzeptanz-History einsehen |
|
||||
| `privacy.avv.accept` | AVV (re-)akzeptieren |
|
||||
|
||||
### Bundle-Mapping
|
||||
|
||||
| Bundle | Atomare Permissions |
|
||||
|---|---|
|
||||
| `privacy.user` (jeder eingeloggte User implizit) | `privacy.user_export.self` |
|
||||
| `privacy.tenant_admin` (kommt mit `tenant.admin`) | alle obigen außer `user_export.self`-Beschränkung |
|
||||
|
||||
### Anwendung in Routes
|
||||
|
||||
- `/{tenant}/settings/account/data-export` → eingeloggter User
|
||||
- `/{tenant}/settings/account/delete` → eingeloggter User
|
||||
- `/{tenant}/admin/privacy/export/*` → `privacy.tenant_export`
|
||||
- `/{tenant}/admin/privacy/deletion/*` → `privacy.tenant_deletion`
|
||||
- `/{tenant}/admin/privacy/subprocessors/` → `privacy.subprocessors.read`
|
||||
- `/{tenant}/admin/privacy/avv/` → `privacy.avv.read`
|
||||
|
||||
### Sonderfall: User-Daten-Export für andere User
|
||||
|
||||
- **Phase 1:** nicht möglich. Jeder User exportiert nur seine eigenen Daten.
|
||||
- **Phase 2:** Tenant-Admin kann auf Anfrage des Users (z.B. Mitarbeiter ist krank, braucht Daten) im Vertretungsfall anstoßen — mit zusätzlicher Bestätigungs-Email an betroffenen User und Audit-Eintrag.
|
||||
|
||||
---
|
||||
|
||||
## Block K — Klartext-Hinweise / -Fehler
|
||||
|
||||
- Export-Job läuft länger als 24h: *„Dein Export dauert länger als erwartet. Wir versuchen es weiter — du bekommst eine Email sobald fertig. Bei Problemen: [Support kontaktieren]"*
|
||||
- Export-ZIP abgelaufen (>7 Tage): *„Dieser Export ist abgelaufen und wurde gelöscht. [Neuen Export starten]"*
|
||||
- Concurrent-Limit: *„Du hast bereits 3 aktive Export-Anforderungen in den letzten 24 Stunden. Bitte warte bis einer fertig ist."*
|
||||
- Tenant-Lösch-Workflow ohne aktive Subscription: *„Dein Tenant ist im Trial — Kündigung beendet sofort den Zugang ohne Grace-Period. [Trotzdem fortfahren]"*
|
||||
- Hard-Delete-Cron läuft: Banner *„Tenant-Daten werden gerade endgültig gelöscht. Bitte nicht schließen. Geschätzte Dauer: X Min."* (für Plattform-Admin sichtbar)
|
||||
- AVV-Re-Akzeptanz blockiert: *„Bitte unsere aktualisierte AVV akzeptieren, um den Workspace weiter zu nutzen. [Anschauen + Akzeptieren] [Workspace kündigen]"*
|
||||
- Subprozessor-Widerspruchs-Frist abgelaufen: *„Du hast nicht widersprochen. Der neue Subprozessor wird ab [Datum] wirksam."*
|
||||
- Privacy-Manifest-Update bei App-Update: *„Diese App-Version verarbeitet zusätzliche Datenarten: [Liste]. Mehr erfahren: [Link]"* (Apple-Required-Disclosure)
|
||||
|
||||
---
|
||||
|
||||
## Block L — Phase 2 / spätere Features
|
||||
|
||||
- **Pseudonymisierungs-Toggle** — Tenant kann pro Modul wählen, dass exportierte Daten pseudonymisiert werden (z.B. Email-Adressen gehasht)
|
||||
- **Drittland-Audit-Log** — wenn Subprozessor außerhalb EU/EEA, separater Log mit Begründung pro Datentransfer
|
||||
- **DSFA-Generator** (Datenschutz-Folgeabschätzung) — automatisch generiertes PDF basierend auf aktivierten Modulen + Subprozessoren + Datenkategorien für Tenant-Compliance
|
||||
- **Scope-gefilterter Export** — nur CRM, nur HR, etc. (statt immer Vollexport)
|
||||
- **Inkrementelle Exports** — *„nur Daten seit letztem Export"* für regelmäßige Sicherungen
|
||||
- **Auto-Delete-Schedules** — DSGVO-Speicherbegrenzung: z.B. *„lösche Leads im Status `lost` automatisch nach 90 Tagen"* — pro Entity-Typ konfigurierbar
|
||||
- **User-Daten-Export für andere User durch Tenant-Admin** (siehe Block J)
|
||||
- **Verschlüsselter Export** — User legt Passwort fest, ZIP wird AES-verschlüsselt
|
||||
- **Export-API** — programmatischer Zugriff via API-Key (für regelmäßige automatische Backups durch Tenant)
|
||||
- **Konsolidierte Privacy-Center-Page** — Tenant sieht alle DSGVO-relevanten Aspekte in einer Übersicht (Aufbewahrungs-Fristen, aktive Datenflüsse, offene Lösch-Anforderungen)
|
||||
|
||||
---
|
||||
|
||||
## Block M — Architektur-Vorschriften (Querschnitt)
|
||||
|
||||
- **LP-13 — EU-Stack komplett:** alle Subprozessoren EU/EEA in Phase 1
|
||||
- **LP-10 — Klartext-Diagnostik:** alle Lösch-/Export-Hinweise menschenlesbar (Block K)
|
||||
- **AV #6 — Audit-Trail-Default:** alle Privacy-Aktionen geloggt (Export-Anstoß, Download, Lösch-Anforderung, AVV-Akzeptanz, Subprozessor-Notification)
|
||||
- **LP-8 — App-Store-Strategie:** User-Account-Löschung in App (Apple-Pflicht 2022), Privacy-Manifest (Apple-Pflicht 2024)
|
||||
- **LP-9 — Spec-Tiefe:** keine UI-Layouts
|
||||
|
||||
---
|
||||
|
||||
## Detail-Spec-Status: DRAFT
|
||||
|
||||
Erste vollständige Detail-Spec für Modul 35. Konsolidiert User-Account-Löschung aus Modul 27 D.3 und ergänzt Tenant-Daten-Export, Tenant-Lösch-Workflow, AVV-Vertrag, Subprozessoren-Liste und Privacy-Manifest.
|
||||
|
||||
**Offene Detail-Punkte (nicht-blockierend):**
|
||||
- AVV-PDF-Template (rechtlicher Inhalt) finalisieren mit Anwalt — Schema steht
|
||||
- Multi-Part-ZIP-Strategie für sehr große Tenants (Implementierungs-Detail)
|
||||
- Privacy-Manifest-Master-Liste konkrete Apple-API-Reasons (Implementierungs-Detail in Modul 36)
|
||||
- Konkrete Subprozessoren-Liste zum Launch (Plattform-Admin-Pflege)
|
||||
- Storage-Pfad-Konvention für Lösch-Audit-Daten in Plattform-Audit-Log final mit Modul 37 abstimmen
|
||||
- Subframe-UI-Designs separat
|
||||
Reference in new issue
Block a user