docs(quick-260922-hk4): Changelog, Betriebsanleitung und Todo zur data-Spalte

- Changelog unter Unveroeffentlicht -> Geaendert: Bilder liegen im
  Dateibereich, vorhandene ziehen beim ersten Start automatisch um
- Betriebsanleitung Kap. 6: user-files nennt die Bilderrahmen-Bilder und
  haelt fest, dass pg_dump allein sie nicht mehr enthaelt
- Todo fuer Stufe 2 (DROP data, storagePath NOT NULL) mit Vorbedingung,
  Migrationsname und den Nacharbeiten an Spec und Klassifikation

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-22 15:25:31 +02:00
parent 9039cea686
commit 8cbfb8b69d
3 changed files with 96 additions and 3 deletions
+10 -3
View File
@@ -283,8 +283,11 @@ Restores stattfinden.
- **Verschlüsselungsschlüssel** `TESSERA_ENCRYPTION_KEY`: liegt nur in `.env` auf
dem Host, **nicht** im Datenbank-Dump. Getrennt sichern (siehe Kapitel 2/3) – ohne
ihn sind alle per `pg_dump` gesicherten verschlüsselten Zugangsdaten wertlos.
- **Hochgeladene Dateien** (Avatare unter `user-files/avatars/`, generierte
DKV-Exporte unter `user-files/`, siehe `apps/api/src/user/user.controller.ts` und
- **Hochgeladene Dateien** (Avatare unter `user-files/avatars/`, Bilder des
Bilderrahmen-Widgets unter `user-files/dashboard-images/<Benutzerkennung>/`,
generierte DKV-Exporte unter `user-files/`, siehe
`apps/api/src/user/user.controller.ts`,
`apps/api/src/dashboard/dashboard-images.service.ts` und
`apps/api/src/dkv/dkv-export.service.ts`): Diese Dateien liegen im benannten
Docker-Volume `user-files`, gemountet auf `/app/user-files` im Dienst `api`. Der
Mount ist in `docker-compose.yml` und `docker-compose.prod.yml` eingetragen:
@@ -296,7 +299,11 @@ Restores stattfinden.
user-files:
```
Damit überstehen Avatare und DKV-Exporte ein `--force-recreate` von `api`. Wie bei
Damit überstehen Avatare, Bilderrahmen-Bilder und DKV-Exporte ein
`--force-recreate` von `api`. Seit den Bilderrahmen-Bildern (Version nach 1.3.0)
gehört dieses Volume zwingend zur Sicherung: `pg_dump` allein enthält diese
Bilder nicht mehr — genau das ist der Zweck der Umstellung, der
Datenbank-Abzug bleibt dadurch klein. Wie bei
`pgdata` zeigt `docker volume ls` das Volume mit vorangestelltem Projektnamen an
(`<projekt>_user-files`). Gesichert werden die Dateien weiterhin mit
`docker compose cp api:/app/user-files ./user-files-backup`, alternativ über eine