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:

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:

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.

S
Description
No description provided
Readme
2.3 MiB
Languages
Go 72.1%
TypeScript 16.7%
JavaScript 6.2%
Python 3.3%
CSS 1.6%