Reapply "Adminbereich mit Rollen und Nutzerauswertung ergänzen"
This reverts commit 2447537652.
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user