---
title: "Datenschutz und Beispieldaten"
description: "PrivacyAware: Datenexport, Kontolöschung und Löschung von Communities; Absatz für die Datenschutz-Vorlage; Aufbewahrungspflichten; DemoAware für app:demo:seed"
---

## Personenbezogene Daten

Speichert ein Plugin Daten über Personen, setzt es im Manifest `"privacy": { "personalData": true }` und implementiert in der Einstiegsklasse `App\Plugin\Api\PrivacyAware`. Fehlt die Schnittstelle, ist das Plugin fehlerhaft und wird nicht geladen.

Liest ein Plugin volle Geburtsdaten (`members()->birthDates()`, ab Plugin-API 1.2), gibt es zusätzlich `"birthDates": true` an. Die Datenschutz-Vorlage der Community sagt dann im Absatz „Geburtstag“, dass Owner, Admins und Plattform-Administratoren mit Mitgliedschaft das vollständige Datum in der Mitgliederverwaltung sehen; der eigene Absatz des Plugins (`privacyNotice`) darf dem nicht widersprechen. Nach einem Update, das die Angabe neu einführt, sollte das Plugin Owner und Admins bitten, die Datenschutzerklärung aus der Vorlage zu aktualisieren.

Behält ein Plugin nach der Löschung eines Kontos eigene Unterlagen zur Person (etwa eine Mitgliedsakte, ab Plugin-API 1.5), gibt es `"accountSnapshot": true` an. Der Kern hält dann vor dem Anonymisieren Name, Anschrift, Geburtsdatum und Handynummer fest – je Community nur, was sie abfragt – und gibt sie dem Plugin genau einmal während `deleteUserData()` über `members()->accountSnapshot($communityId, $userId)`. Die Momentaufnahme liegt verschlüsselt an der Löschaufgabe des Plugins und verschwindet mit ihr; scheitert `deleteUserData()`, bekommt die Wiederholung sie erneut. Das Plugin übernimmt nur, was es braucht, nennt es in seinem Absatz und darf daraus nichts an Dritte weitergeben. Die Datenschutz-Vorlage der Community nennt das Plugin dann im Absatz zur Speicherdauer.

Gleicht ein Plugin E-Mail-Adressen mit den Konten ab (`members()->verifiedEmail()`, `matchEmails()`, ab Plugin-API 1.3 – etwa um Akten aus einer Vereinsliste beim Beitritt zuzuordnen), gibt es `"memberEmails": true` an. Jeder Abgleich steht im Protokoll der Community; die Adressen selbst stehen dort nicht. Der eigene Absatz des Plugins sagt, wofür es die Adresse nutzt. Dieselbe Angabe braucht ein Plugin, das Adressen ohne Konto anschreibt (`mailer()->sendToAddress()`, ab 1.8); meldet sich jemand über den Link in einer solchen Mail ab, speichert die Plattform nur einen Prüfwert der Adresse (nicht die Adresse) und löscht ihn mit der Community.

```php
final class CarpoolPlugin implements Plugin, PrivacyAware
{
    // …

    public function exportUserData(string $userId, ExportBundle $bundle): array
    {
        $db = $this->ctx->db();

        return [
            'offers' => $db->fetchAll('SELECT community_id, event_id, seats, created_at FROM '.$db->table('offers').' WHERE user_id = ?', [$userId]),
        ];
    }

    public function deleteUserData(string $userId): void
    {
        $db = $this->ctx->db();
        $db->execute('DELETE FROM '.$db->table('requests').' WHERE user_id = ?', [$userId]);
        $db->execute('DELETE FROM '.$db->table('offers').' WHERE user_id = ?', [$userId]);
    }

    public function deleteCommunityData(string $communityId): void
    {
        $this->ctx->db()->execute('DELETE FROM '.$this->ctx->db()->table('offers').' WHERE community_id = ?', [$communityId]);
    }
}
```

Der Kern ruft diese Methoden für **jedes installierte, gültige Plugin** auf, das schon einmal aktiviert war oder Tabellen angelegt hat – auch wenn es gerade deaktiviert oder in der Community ausgeschaltet ist. Solange eine Migration eines aktivierten Plugins offen ist, warten Löschungen, bis sie gelaufen ist.

### Datenexport

`exportUserData(string $userId, ExportBundle $bundle): array` liefert die Daten der Person für den Datenexport unter Konto → Datenschutz. Das Ergebnis landet in `export.json` unter `plugins.<id>`.

- Nur Daten **über diese Person**; andere Personen erscheinen höchstens als „anderes Mitglied“.
- Dateien kommen mit `$bundle->addFile(string $path, int $size, \Closure $producer)` ins ZIP unter `plugins/<id>/<path>`; der Producer bekommt einen Schreiber `fn(string $chunk)` (z. B. für `storage()->…->streamEncrypted()`). Dateien über 20 MB stehen nur in der Liste großer Dateien.
- Muss das Plugin Daten aus rechtlichen Gründen aufbewahren, nennt es das mit `$bundle->noteRetention('{count} Einträge im Schießbuch werden bis {until} aufbewahrt.', [...])` – der Text erscheint in `plugins/LIESMICH.txt` des Exports.
- Scheitert das Plugin, läuft der Export trotzdem weiter; unter `plugins.<id>` steht dann ein Fehler.
- **Zusatzfelder exportiert der Kern selbst:** Mitgliedsfelder unter `memberships[].pluginFields`, ab 1.2 die Felder, die der Autor an eigenen Beiträgen setzt (`Editor::Author`), unter `posts[].pluginFields` – nur von Plugins, die in der Community eingeschaltet sind. Felder, die das Team setzt, gehören nicht zur Person und fehlen dort.

### Kontolöschung

`deleteUserData(string $userId): void` löscht oder anonymisiert **alle** Daten der Person.

- **Reihenfolge:** Erst gehen die Hooks `member.left` (Grund `account_deleted`) je Mitgliedschaft und `account.deleted` hinaus, danach ruft der Kern `deleteUserData()`. Wer andere benachrichtigen will (etwa Mitfahrer einer abgesagten Fahrt), tut das im Hook; `deleteUserData()` selbst verschickt nichts.
- **Idempotent:** Der Kern merkt sich jede offene Löschung und wiederholt sie stündlich, bis sie gelingt; nach drei Fehlschlägen erscheint ein Hinweis unter Plattform-Admin → Plugins. Die Kontolöschung selbst wartet nie auf ein Plugin.
- **Zusatzfelder** an Mitgliedern (`ExtraField` mit `Target::Member`) exportiert und löscht der Kern selbst.

### Gelöschte Communities

`deleteCommunityData(string $communityId): void` löscht alle Daten einer gelöschten Community – ebenfalls mit Wiederholung. Innerhalb dieses Aufrufs sind Zustand, Cache, Speicher und Einstellungen der gelöschten Community noch erreichbar; danach entfernt der Kern den Speicherbereich des Plugins für diese Community sowie Zustand und Einstellungen.

### Aufbewahrungspflichten

Muss ein Plugin Daten gesetzlich aufbewahren (z. B. Schießbücher), löscht es sie in `deleteUserData()` nicht, sondern sperrt oder anonymisiert, was möglich ist, und weist darauf hin – mit `noteRetention()` im Export und im Absatz für die Datenschutzerklärung.

## Absatz für die Datenschutzerklärung

```php
$registry->privacyNotice(fn (?CommunityInfo $community): ?string =>
    'Für Fahrgemeinschaften speichern wir Angebote und Anfragen zu Events samt Abfahrtsort und – falls angegeben – Mobilnummer, bis 30 Tage nach der Fahrt.');
```

Der Rückruf liefert einen Übersetzungsschlüssel (reiner Text) oder `null`. Nennt der Absatz eine Frist, hält ein täglicher Job sie ein – in allen Communities mit Daten, auch dort, wo das Plugin gerade ausgeschaltet ist (siehe [Abgleich und Löschfristen](/plugins/erweiterungspunkte#abgleich-und-löschfristen)). Die Vorlage der Datenschutzerklärung unter Einstellungen → Rechtstexte (**Vorlage einfügen**) enthält für jedes Plugin, das in der Community wirkt, einen Absatz mit dessen Namen als Überschrift. Schalten Owner ein Plugin mit `personalData` ein, erinnert sie die Oberfläche daran, ihre Datenschutzerklärung zu prüfen.

## Beispieldaten (DemoAware)

Der Befehl `app:demo:seed` legt eine Beispiel-Community mit erfundenen Inhalten an (siehe [Konsole → Beispiel-Community](/handbuch/plattform-admin/konsole#beispiel-community-anlegen)). Plugins können dort eigene Beispieldaten ergänzen, indem die Einstiegsklasse `App\Plugin\Api\DemoAware` implementiert:

```php
public function seedDemo(DemoSeed $seed): void
{
    $random = new \Random\Randomizer(new \Random\Engine\Mt19937($seed->randomSeed));
    $from = $seed->now;
    foreach ($this->ctx->events()->occurrences($seed->community->id, $from, $from->modify('+6 weeks')) as $occurrence) {
        if ($this->hasOffer($seed->community->id, $occurrence) || $random->getInt(0, 2) > 0) {
            continue;   // idempotent: vorhandene Angebote nicht doppelt anlegen
        }
        $this->createOffer($seed->community->id, $occurrence, seats: $random->getInt(1, 4));
    }
}
```

- `DemoSeed` liefert `community` (`CommunityInfo`), `refresh` (Ergänzungslauf), `now` (UTC – „Zukunft“ heißt nach `now`), `randomSeed` für eine wiederholbare Auswahl und `profile`: das Inhaltsprofil der Beispiel-Community (`standard` oder `schuetzenverein`, Konstanten `DemoSeed::PROFILE_*`; `--refresh` liefert das Profil der Anlage). Unbekannte Profile – auch weitere mitgelieferte wie `reitverein` – behandelst du wie `standard`.
- Im Profil `schuetzenverein` gibt es die eigenen Rollen „Vorstand“, „Schießleiter“, „Standaufsicht“, „Jugendleiter“, „Kasse“, „Theke“ und „Waffenwart“ (über `members()->customRoles()` und `withCustomRole()`), Trainings-Serien („Training Luftdruck 10 m“, „KK/GK-Training“, „Jugendtraining“ – nur unter 18) und Auswärtstermine mit dem Tag `Auswärts`. Daran kann ein Plugin seine Beispieldaten ausrichten, z. B. Aufsichten aus der Rolle „Standaufsicht“ oder Fahrgemeinschaften zu Auswärtsterminen:

```php
if ($seed->profile === DemoSeed::PROFILE_SCHUETZENVEREIN) {
    $this->seedShootingClub($seed);   // eigene Beispieldaten für den Schützenverein
    return;
}
```
- Nur `app:demo:seed` ruft die Methode auf – nie die Demo-Daten der Entwicklungsumgebung und nie ohne diesen Befehl. Der Befehl schaltet Plugins, die je Community gelten, in **seiner eigenen** Beispiel-Community vorher ein; bei `--refresh` nur neu hinzugekommene, ein dort ausgeschaltetes Plugin bleibt aus.
- Daten über die Kern-Dienste anlegen, **ohne** E-Mails, Glocken oder Push.
- Bei `refresh` nur ergänzen (z. B. kommende Termine), nie löschen; jeder Lauf ist idempotent.
- Fehler fängt der Kern je Plugin ab; die Ausgabe des Befehls nennt je Plugin `ok`, `skipped` oder `failed`, das Protokoll erhält `community.demo_plugins_seeded`.
