Adminbereich mit Rollen und Nutzerauswertung ergänzen

Admin-API serverseitig absichern, Kennzahlen und paginierte Nutzersuche bereitstellen, Weboberfläche ergänzen und Einrichtung sowie spätere Kauf-Funktionen dokumentieren.
This commit is contained in:
Eugenius Naumenko
2026-10-10 18:45:52 +00:00
parent 82d8768a99
commit e432943ea7
14 changed files with 634 additions and 18 deletions
+37 -1
View File
@@ -13,6 +13,42 @@ Sprachlern-App für Ausspracheübungen auf A1-Niveau. Die Web-App nimmt Sprache
Weitere Übungstypen, ein `evaluate_attempt`-Flowise-Task und ein langfristiges Fähigkeitsmodell pro Wort sind noch nicht implementiert.
## Adminbereich
Die App besitzt einen geschützten Adminbereich unter dem Menüpunkt **Adminbereich**. Er zeigt die Zahl aller Konten, aktive Nutzer der letzten sieben Tage (mindestens ein Sprechversuch), alle Sprechversuche, die Zahl gespeicherter Flowise-Übungen und die durchschnittliche Gesamtbewertung. Die Nutzerliste kann nach E-Mail durchsucht werden, zeigt Registrierungsdatum, Rolle und aggregierte Lernaktivität und lädt höchstens 25 Konten pro Seite. Audio und vollständige Versuchstexte werden dort nicht angezeigt.
Adminrechte werden **bei jedem Admin-API-Aufruf** aus PostgreSQL gelesen. Ein Lernender bekommt für `GET /admin/overview` und `GET /admin/users` HTTP 403; ohne Anmeldung ist es HTTP 401. Eine versteckte Web-Seite allein wäre kein Zugriffsschutz. Öffentliche Registrierung erstellt ausschließlich Konten mit der Rolle `learner`. Die Rolle wird beim Start der API auch für bestehende Datenbanken als neue Spalte angelegt. Wenn Debug aktiviert ist, sind die Debug-Endpunkte ebenfalls nur für Admins zugänglich.
### Erstes Admin-Konto einrichten
1. Ein eigenes Konto über die normale Registrierung erstellen. Ein bereits vorhandenes eigenes Konto kann ebenfalls verwendet werden.
2. Auf dem VPS mit PostgreSQL verbinden (Datenbankname und Nutzer aus der `.env` verwenden):
```bash
docker compose exec speech-postgres psql -U speech -d speech
```
3. **Nur das eigene Konto** anhand der E-Mail-Adresse zum Admin machen:
```sql
UPDATE users SET role = 'admin' WHERE email = 'eigene-adresse@beispiel.de';
```
4. Die Web-App neu laden. Die API liefert die aktuelle Rolle über `GET /me`; danach erscheint der Adminbereich in der Navigation.
Es gibt bewusst keinen öffentlichen Endpunkt, über den Nutzer sich selbst Adminrechte geben können. Für spätere Teamverwaltung braucht es einen gesonderten Ablauf mit Änderungsprotokoll und stärkeren Anmeldeschutzmaßnahmen.
### Vorbereitung für ein Kaufprodukt
Der Adminbereich ist derzeit eine **Betriebs- und Nutzerübersicht**. Er zeigt keine Umsätze oder Abonnements, weil die App noch keinen Produktkatalog, Zahlungsanbieter oder Kaufberechtigungen besitzt. Für den Verkauf sind als nächste Ausbaustufen sinnvoll:
1. Produkte und Tarife mit Preis, Laufzeit und enthaltenen Lernfunktionen definieren.
2. Einen Zahlungsanbieter anbinden und signierte Webhooks verarbeiten. Zahlungen und Rückerstattungen müssen nachvollziehbar gespeichert werden.
3. Den Zugang zu bezahlten Funktionen über serverseitig geprüfte Berechtigungen steuern.
4. Im Adminbereich Bestellungen, Zahlungsstatus, Supportfälle und einen Änderungsverlauf für Adminaktionen anzeigen.
Solange diese Teile fehlen, bleibt die Lern-App für registrierte Nutzer unabhängig von einem Kauf zugänglich.
## Architektur und Datenfluss
```text
@@ -165,7 +201,7 @@ cd ../web && npm run build
## Debug
Debug-Endpunkte und der Navigationspunkt **Debug** lassen sich über `.env` aktivieren:
Debug-Endpunkte und der Navigationspunkt **Debug** lassen sich über `.env` aktivieren. Sie sind nur für Admins zugänglich:
```env
DEBUG_ENABLED=true