reverseproxy

README.md

@@ -10,9 +10,20 @@ Admin-Passwort für dich, und pro Freund ein frei wählbares Freigabe-Passwort z
 - Jeder Freund hat ein **Profilbild** und einen **Steckbrief** (klassische Freundebuch-Felder).
 - Beliebig viele **Blöcke** pro Freund: 🖼️ Bild, 📝 Text, 🎙️ Audio (MP3 o. ä.) – alles wird
   im jeweiligen Freundes-Ordner gespeichert.
+- **Audio-Cover**: Beim Hochladen eines Liedes/einer Sprachnachricht kann optional ein eigenes
+  Cover-Bild mitgegeben werden. Wird keins hochgeladen, versucht die App automatisch ein in der
+  MP3 eingebettetes Cover (ID3-Tag) zu extrahieren und zu verwenden.
 - **Freigabe-Link**: Für jeden Freund kannst du einen Link mit eigenem Passwort erzeugen.
   Damit kann sich der Freund **nur** in seine eigene Seite einloggen und dort Inhalte
   hinzufügen/bearbeiten. Die Freigabe kannst du jederzeit als Admin beenden.
+- **Öffentliche URL für Freigabe-Links**: Läuft der Server hinter einem Reverse-Proxy, kannst
+  du im Admin-Bereich unter "Einstellungen" (oder per `PUBLIC_BASE_URL`-Env) eine öffentliche
+  Basis-URL hinterlegen. Freigabe-Links werden dann darauf basierend erzeugt statt auf der
+  lokalen Server-Adresse/IP.
+- **Export & Import**: Einzelne Freunde oder das gesamte Freundesbuch lassen sich als ZIP
+  exportieren und wieder importieren (z. B. zum Umziehen auf einen anderen Server oder als
+  Backup). Der Import eines Freundes/Buchs legt dabei immer neue Einträge an; beim
+  Buch-Import kann optional vorher alles Bestehende gelöscht werden.
 - **Freundesbuch-Ansicht**: verspieltes Scrapbook-Layout mit schräg angeordneten
   Polaroid-Fotos, Washi-Tape-Optik usw. – seitenweise durchblätterbar.
 - **PDF-Export** des gesamten Freundesbuchs (serverseitig über Puppeteer/Chromium gerendert).
@@ -40,8 +51,14 @@ Admin-Passwort für dich, und pro Freund ein frei wählbares Freigabe-Passwort z
    ```
    Die Anwendung läuft danach auf `http://<server>:3000`.
 
-4. Alle Daten (Freunde-Ordner, Fotos, Texte, Audios) landen im lokalen Ordner `./data`,
-   der als Volume eingebunden ist – so bleiben sie auch bei Container-Updates erhalten.
+4. **Reverse-Proxy / öffentliche URL (optional)**: Läuft der Server hinter einem Reverse-Proxy
+   (z. B. Nginx, Traefik, Caddy), trage entweder `PUBLIC_BASE_URL` in der `docker-compose.yml`
+   ein, oder setze die URL direkt im Admin-Bereich unter "Einstellungen" (`https://deine-domain.tld`,
+   ohne abschließenden Slash). Danach zeigen alle neu erzeugten Freigabe-Links auf diese Adresse
+   statt auf die lokale Server-IP.
+
+5. Alle Daten (Freunde-Ordner, Fotos, Texte, Audios, Einstellungen) landen im lokalen Ordner
+   `./data`, der als Volume eingebunden ist – so bleiben sie auch bei Container-Updates erhalten.
 
 ## Nutzung
 
@@ -52,6 +69,9 @@ Admin-Passwort für dich, und pro Freund ein frei wählbares Freigabe-Passwort z
   vergebenen Freigabe-Passwort an und kann **nur** dort etwas eintragen.
 - **/book** – die verspielte Freundesbuch-Ansicht mit Blätterfunktion und PDF-Export
   (Button oben rechts).
+- Im Admin-Bereich (`/admin`) findest du außerdem die Bereiche **Einstellungen**
+  (öffentliche URL) und **Sichern & Wiederherstellen** (Export/Import für einzelne Freunde
+  und für das gesamte Buch als ZIP-Datei) sowie einen Export-Button auf jeder Freundeskarte.
 
 ## Hinweise