From 91b12ad859ef8b511ad57a33371951fccbe2b9f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=B6rdle=20Bot?= Date: Wed, 3 Dec 2025 23:30:31 +0100 Subject: [PATCH] Erweitere README.md um Kuratoren-System und Analytics-Funktionen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Einführung eines Kuratoren-Managements mit separaten Accounts, Genre- und Special-Zuweisungen. - Kuratoren können Songs verwalten und Spieler-Kommentare einsehen. - Integration von Plausible Analytics für anonyme Nutzungsstatistiken und automatisches Domain-Tracking. - Aktualisierung der Anweisungen für Kurator-Zugang und -Funktionen. --- README.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1b41e6e..b07b815 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ Eine Web-App inspiriert von Heardle, bei der Nutzer täglich einen Song anhand k - Bearbeitung von Metadaten. - Sortierbare Song-Bibliothek (Titel, Interpret, Hinzugefügt am, Erscheinungsjahr, Aktivierungen, Rating). - Play/Pause-Funktion zum Vorhören in der Bibliothek. + - **Kuratoren-Verwaltung:** Erstellen und Verwalten von Kurator-Accounts mit Zuweisung zu Genres und Specials. - **Cover Art:** - Automatische Extraktion von Cover-Bildern aus MP3-Dateien. - Anzeige des Covers nach Spielende (Sieg/Niederlage). @@ -42,7 +43,6 @@ Eine Web-App inspiriert von Heardle, bei der Nutzer täglich einen Song anhand k - Live-Vorschau beim Hovern über die Waveform. - Playback-Cursor zeigt aktuelle Abspielposition. - Einzelne Segmente zum Testen abspielen. - - Einzelne Segmente zum Testen abspielen. - Manuelle Speicherung mit visueller Bestätigung. - **News & Announcements:** - Integriertes News-System für Ankündigungen (z.B. neue Specials, Features). @@ -51,6 +51,24 @@ Eine Web-App inspiriert von Heardle, bei der Nutzer täglich einen Song anhand k - **Featured News:** Hervorhebung wichtiger Ankündigungen. - Special-Verknüpfung: Direkte Links zu Specials in News-Beiträgen. - Verwaltung über das Admin-Dashboard. +- **Kurator-System:** + - **Kurator-Accounts:** Separate Login-Accounts für Kuratoren (nicht Admins). + - **Genre- & Special-Zuweisung:** Kuratoren können einzelnen Genres oder Specials zugewiesen werden. + - **Global-Kuratoren:** Optionale globale Kuratoren, die für alle Rätsel zuständig sind. + - **Kurator-Dashboard:** Eigene Dashboard-Seite (`/curator` oder `/de/curator`, `/en/curator`) für Kuratoren. + - **Song-Verwaltung:** Kuratoren können Songs hochladen, bearbeiten und Genres/Specials zuweisen. + - **Kommentar-Verwaltung:** Kuratoren können Spieler-Kommentare zu ihren Rätseln einsehen, als gelesen markieren und archivieren. +- **Spieler-Kommentare:** + - **Feedback an Kuratoren:** Spieler können nach Abschluss eines Rätsels optional eine Nachricht an die Kuratoren senden. + - **Automatische Zuordnung:** Kommentare werden automatisch an relevante Kuratoren verteilt (Genre-Kuratoren, Special-Kuratoren, Global-Kuratoren). + - **Rate-Limiting:** Pro Spieler nur ein Kommentar pro Puzzle möglich. + - **Kontext-Informationen:** Kommentare enthalten vollständigen Rätsel-Kontext (Hördle #, Genre/Special, Titel/Artist). + - **Kommentar-Verwaltung:** Kuratoren sehen Kommentare in ihrem Dashboard mit Badge für neue/ungelesene Nachrichten. +- **Analytics:** + - **Plausible Analytics:** Integration mit Plausible Analytics für anonyme Nutzungsstatistiken. + - **Automatisches Domain-Tracking:** Unterstützt mehrere Domains mit automatischer Erkennung. + - **Privacy-First:** Keine Cookies, kein Cross-Site-Tracking. + - 👉 **[Plausible Setup-Dokumentation](docs/PLAUSIBLE_SETUP.md)** ## Internationalisierung (i18n) @@ -139,6 +157,7 @@ Das Projekt ist für den Betrieb mit Docker optimiert. - `GOTIFY_URL`: URL deines Gotify Servers (z.B. `https://gotify.example.com`) - `GOTIFY_APP_TOKEN`: App Token für Gotify (z.B. `A...`) - `OPENROUTER_API_KEY`: API-Key für OpenRouter (für KI-Kategorisierung, optional) + - `NEXT_PUBLIC_PLAUSIBLE_SCRIPT_SRC`: URL zum Plausible Analytics Script (z.B. `https://plausible.example.com/js/script.js`, optional) 2. **Starten:** ```bash @@ -156,7 +175,12 @@ Das Projekt ist für den Betrieb mit Docker optimiert. - URL: `/de/admin` oder `/en/admin` - Standard-Passwort: `admin123` (Bitte in `docker-compose.yml` ändern! Muss als Hash hinterlegt werden.) -5. **Special Curation & Scheduling verwenden:** +5. **Kurator-Zugang:** + - URL: `/de/curator` oder `/en/curator` + - Kurator-Accounts werden vom Admin erstellt und verwaltet. + - Kuratoren können Songs hochladen und verwalten, sowie Kommentare von Spielern einsehen. + +6. **Special Curation & Scheduling verwenden:** - Erstelle ein Special im Admin-Dashboard: - Gib Name, Max Attempts und Unlock Steps ein. - **Optional:** Setze ein Startdatum (Launch Date) und Enddatum.