28 KiB
module, title, phase, status, last_updated, session_source, related_lps, spec_style
| module | title | phase | status | last_updated | session_source | related_lps | spec_style | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 35 | DSGVO-Export / Account-Löschung / Tenant-Daten-Portabilität | 1 | detail-spec-draft | 2026-05-08 | brainstorming-session-2026-05-07-2206.md |
|
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_atrequested_by_user_id(welcher User hat den Export angefordert)scope(Enum:user_self | tenant_full)target_user_id(beiscope=user_self: der User dessen Daten gemeint sind; gleichrequested_by_user_id)status(Enum:queued | processing | ready | failed | expired)progress_percent(Integer 0-100)result_file_id(FK aufFileaus Modul 23, ZIP-Output)result_size_bytesresult_expires_at(Default 7 Tage nachready— danach automatischer Hard-Delete der ZIP-Datei)download_count(für Audit)last_downloaded_aterror_message(Klartext beifailed)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_atrequested_by_user_id(Tenant-Admin)reason(Enum:voluntary | non_payment | suspended_violation | admin_initiated) —voluntaryist Self-Service, Rest kommt aus Plattform-Adminreason_text(optionaler Freitext-Kommentar)grace_period_ends_at(Defaultcreated_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_atfailure_reason(beifailed)
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_ataccepted_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 verlangtpdf_file_id(FK aufFile, 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_atname(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
countryauß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
- User klickt „Daten exportieren" in
/{tenant}/settings/account/data-export - Klartext-Erklärung: was wird exportiert, ungefähre Dauer, Aufbewahrungs-Frist
- Bestätigungs-Klick →
GdprExportJobmitscope=user_selfwird angelegt, Statusqueued - Worker (BullMQ) verarbeitet: zieht Daten aus allen Modulen, packt ZIP, lädt in Storage hoch
- Status
ready→ User bekommt Email mit Download-Link (Magic-Link gegen Auth-Bypass) + In-App-Notification - 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
failedsetzen, 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.jsonlcrm/custom-field-definitions.jsonl,crm/custom-field-values.jsonldeals/deals.jsonl,deals/pipelines.jsonl,deals/pipeline-stages.jsonlprojects/projects.jsonl,projects/project-pipelines.jsonl,projects/project-members.jsonl,projects/acceptance-protocols.jsonl,projects/schedule-entries.jsonltasks/tasks.jsonlforms/forms.jsonl,forms/form-submissions.jsonl,forms/form-actions.jsonlbookings/booking-pages.jsonl,bookings/appointments.jsonl,bookings/availability-rules.jsonlemail/inbound.jsonl,email/outbound.jsonl,email/campaigns.jsonl,email/sending-domains.jsonlchat/messages.jsonl,chat/threads.jsonl,chat/reactions.jsonlwhatsapp/...(falls aktiv)telephony/call-sessions.jsonlsignatures/...hr/...(alle HR-Hub-Daten)portal/...(Customer-Portal)automations/rules.jsonl,automations/executions.jsonlai/conversations.jsonl,ai/embeddings-metadata.jsonl(Embeddings selbst nicht exportiert — nicht-portabel)kwp/...(KWP-Sync-Daten falls aktiv)audit/audit-trail.jsonlusers/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.jsonltags/tags.jsonl,tags/entity-tags.jsonlfeature-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
- Tenant-Admin klickt „Tenant-Daten exportieren" in
/{tenant}/admin/privacy/export/new - Klartext-Erklärung: was wird exportiert, geschätzte Größe (basierend auf DB-/Storage-Statistik), erwartete Dauer, Aufbewahrungs-Frist (7 Tage Download-Window)
- Optional: Scope-Filter (z.B. „nur CRM", „nur HR") — Phase 2, in Phase 1 immer Vollexport
- Bestätigungs-Klick →
GdprExportJobmitscope=tenant_full - Worker arbeitet asynchron — kann Stunden dauern bei großen Tenants
- Progress sichtbar in Real-Time (Websocket oder Polling)
- Status
ready→ Tenant-Admin bekommt Email + In-App-Notification - Download via signed-URL, Multi-Part-Download wenn nötig
- Audit-Eintrag mit
download_countpro Zugriff
Edge-Cases
- Tenant ist im Status
frozenoderpast_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:
- Tenant-Admin in
/{tenant}/admin/privacy/deletion/klickt „Workspace kündigen" - 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
- Status wechselt sofort auf
- 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]"
- Step 3 — Stripe-Hinweis: Klartext über Restbetrag, Pro-rata-Erstattung, letzte Rechnung
- Step 4 — Identitäts-Bestätigung: Pwd + 2FA falls aktiv
- Step 5 — Final-Klick mit Tenant-Slug-Eingabe als Confirm-Phrase (User muss
geerkens-gmbheintippen, nicht nur einen Knopf drücken) TenantDeletionRequestmitreason=voluntary,grace_period_ends_at = now + 30 Tagewird angelegt- Tenant-Status →
deletion_pending - Bestätigungs-Email an alle Tenant-Admins
- 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:
- Status auf
executing,execution_started_atgesetzt - 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
- Files in Scaleway-Storage:
- Status auf
completed - Tenant-Status →
deleted(siehe Modul 27 A.5) - Bestätigungs-Email an
accepted_by_user_idaus AVV: „Tenant ‚X' wurde am [Datum] vollständig gelöscht. DSGVO-Auftrag erfüllt." - 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 Tagenpast_due(Trigger: Stripe-Webhook-Logik in Modul 28);TenantDeletionRequestwird automatisch angelegtsuspended_violation— Plattform-Admin kündigt manuell wegen AGB-Verstoß; ggf. verkürzte Grace-Periodadmin_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.xcprivacyaus Master-Liste
Klartext-Sichtbarkeit für Tenant
/{tenant}/admin/privacy/zeigt Link auf öffentliche Privacy-Manifest-Seite (Marketing-Sitehivegrid.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
lostautomatisch 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