--- 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