Vermeide kürzlich angezeigte Sätze bei neuen Übungen und frage Flowise bei Wiederholungen einmal erneut. Validiere strukturierte Antworten, protokolliere die Übungsquelle und schütze nutzerspezifische Übungs-IDs. Berechne schwierige Wörter anhand der neuesten Aussprache pro Wort. Passe das Lehrerfeedback an gute Bewertungen an und verbessere das Laden neuer Übungen im Web. Ergänze gezielte Go-Tests.
Speech Learning App
Docker-basierter MVP fuer eine A1-Englisch-Lern-Web-App. Der Kern ist eine Go API, das Frontend ist React/TypeScript, FlowiseAI laeuft als eigener Container auf demselben VPS, und Azure Speech wird serverseitig gekapselt.
Start auf dem VPS
docker compose up --build
Danach:
- Web-App: https://speech.v2202510301049387828.goodsrv.de
- API Healthcheck: https://speech.v2202510301049387828.goodsrv.de/api/health
- Flowise: vorhandene Instanz ueber
FLOWISE_BASE_URL
Der Default-Compose ist fuer den VPS portlos und haengt speech-web/speech-api an das bestehende Docker-Netzwerk web.
Lokale Entwicklung
cp .env.example .env
docker compose -f docker-compose.dev.yml up --build
Danach:
- Web-App: http://localhost:5173
- API Healthcheck: http://localhost:8080/health
- Flowise: http://localhost:3000
Mit AZURE_ENABLE_MOCK=true laeuft die Aussprachebewertung ohne Azure Credentials. Fuer echte Azure Speech Calls AZURE_SPEECH_KEY, AZURE_SPEECH_REGION setzen und AZURE_ENABLE_MOCK=false verwenden.
Debug
Debug ist ueber .env aktivierbar:
DEBUG_ENABLED=true
LOG_LEVEL=debug
Danach:
docker compose up -d --force-recreate speech-api
Eingeloggte Nutzer sehen dann in der Web-App den Navigationspunkt Debug. Die Ausgaben sind maskiert und zeigen keine Secrets.
MVP-Funktionen
- Registrierung und Login
- A1-Lernerprofil mit
en-US - Dashboard mit Tagesziel und naechster Uebung
- Browser-Audioaufnahme
- Pronunciation Assessment API mit Azure/Mock-Fallback
- Visuelles Wort-Feedback
- Flowise-Adapter mit Mock-Fallback
- Datenmodell vorbereitet fuer weitere Zielsprachen
Architektur
web -> api -> postgres
-> redis
-> flowise
-> azure speech
Der Browser spricht nur mit der Go API. Azure- und Flowise-Secrets bleiben im Backend.