Muttersprache koppeln und russischen A1-Kurs ergänzen

GUI und neue Erklärungen verwenden gemeinsam native_language. Deutsch und
Russisch sind die beiden Muttersprachen; Englisch bleibt die Lernsprache.
Kompatibilitätsfelder werden atomar gekoppelt, widersprüchliche Eingaben
abgewiesen und bestehende Profile sowie eingefrorene Inhalte erhalten.

Ergänzt vollständige russische GUI-Kataloge und 840 geprüfte Aufgabenansichten
in sieben Modulen einschließlich A1-Test, mit getrennten Sprachrollen für
Ausgangs- und Lernmaterial. Äquivalente Ansichten teilen ihre Nachweisidentität.
Stabile API-Fehlercodes, neue deterministische Hilfen und Trainingsbegründungen
berücksichtigen die Muttersprache. Dokumentiert das Sprachmodell in AGENTS.md.

Validierung: Go-Race-Suite mit eigener lokaler PostgreSQL-Testdatenbank, go vet,
Web-Build, Offline-Bank-/Variantenaudit, Diff-Prüfung sowie lokale Browser-Smokes
für Sprachen, Kurs, Administration, Aussprache und Aufnahme. Keine Live-Anbieter,
Produktionsprofile, Deployment-Schritte oder historischen Neubewertungen.
This commit is contained in:
Eugenius Naumenko
2026-11-07 17:02:17 +00:00
parent f3d42ee2b6
commit 16cceae28a
77 changed files with 46646 additions and 1969 deletions
+69 -80
View File
@@ -4,99 +4,88 @@ Hinweise für Coding-Agenten und Beitragsarbeit: [AGENTS.md](AGENTS.md).
## Mehrsprachigkeit
Oberflächensprache und Erklärungssprache sind getrennt. Vor dem Login lässt sich
Deutsch oder Englisch wählen; die Auswahl bleibt in diesem Browser gespeichert.
Nach dem Login gilt die Kontoeinstellung. Ein Wechsel im angemeldeten Bereich
speichert ausschließlich die Oberflächensprache, ohne Lernsprache, Niveau,
Tagesziel oder Erklärungssprache zurückzusetzen.
Es gibt genau zwei Sprachrollen: **Muttersprache** und **Lernsprache**.
Die Muttersprache steuert gemeinsam Oberfläche, neue Aufgabenanweisungen,
Erklärungen und Rückmeldungen. Zur Auswahl stehen Deutsch (`de-DE`) und Russisch
(`ru-RU`). Die Lernsprache des vorhandenen A1-Kurses bleibt Englisch (`en-US`).
Eine separate Einstellung für GUI- oder Erklärungssprache gibt es nicht.
Übersetzt sind Navigation, Anmeldung, Registrierung, Dashboard, Fortschritt mit
Ausspracheprofil, die Bedienung beider Kursansichten, Aussprache- und
Aufnahmebedienung, Dialog, Administration, KI-Verwaltung und Debug. Datums-,
Zahlen- und Kostenanzeigen verwenden in den übersetzten Ansichten die gewählte
Oberflächensprache. Lokale Hinweise speichern Übersetzungsschlüssel, damit auch
bereits sichtbare Meldungen beim Sprachwechsel aktualisiert werden. Ungespeicherte
Antworten, Admin-Eingaben und eine laufende Aufnahme bleiben beim Wechsel erhalten.
Vor dem Login wird die Muttersprache im Browser gespeichert; nach dem Login gilt
die Kontoeinstellung. Ein Wechsel erhält Lernsprache, Niveau, Tagesziel,
Lernfortschritt, eingegebene Antworten und laufende Aufnahmen. Historische Aufgaben,
Bewertungen und Rückmeldungen behalten ihren eingefrorenen Inhalt und ihre Sprache.
Technische Rohdaten, Prompts, Schemas und Anbieterdiagnosen werden nicht automatisch
übersetzt. Die normale Fehleranzeige verwendet übersetzte stabile API-Fehlercodes.
Die vorhandenen 840 Englischaufgaben behalten ihre bisherigen Anweisungen,
Antwortoptionen und Lösungserklärungen; die Anweisungen und Erklärungen sind Deutsch.
Weitere Modulnamen, Modulbeschreibungen, Lehrerfeedback und technische API-/
Anbieterfehlermeldungen bleiben gespeicherte beziehungsweise ursprüngliche Inhalte.
Eine englische Oberfläche bedeutet keinen englischsprachigen Erklärungskurs und
schaltet keine neue Lernsprache frei. Technische Rohdaten, Prompts und Schemas in
Administration/Debug werden nicht automatisch übersetzt.
Navigation, Anmeldung, Dashboard, Fortschritt und Ausspracheprofil, Kursbedienung,
Aufnahme, Dialog, Administration und Debug verwenden deutsche und russische
Textkataloge. Datums-, Zahlen-, Kosten- und Pluralanzeigen folgen der Muttersprache.
Neue deterministische Aussprache- und Dialoghilfen berücksichtigen diese ebenfalls.
`users.instruction_language` speichert die bevorzugte Erklärungssprache unabhängig
von `users.ui_language`. Beim ersten Start mit dem neuen API-Binary übernimmt eine
additive Migration für bestehende Konten deren bisherige `ui_language`; wiederholte
Starts überschreiben diese Erklärungssprache nicht. Neue Konten beginnen mit
`instruction_language=de-DE`, passend zum vorhandenen Aufgabenbestand. Die
Erklärungssprache neuer Aufgaben lässt sich im A1-Kurs unabhängig von der
Oberfläche wählen. Bestehende Aufgaben, Antworten und Bewertungen behalten ihre
Sprache und ihren eingefrorenen Inhalt.
### Aufgabenvarianten
Die KI-Eingaben behalten für die Erklärungssprache vorerst den bisherigen
Wire-Namen `ui_language`, damit bestehende Prompt-/Schema-Verträge kompatibel
bleiben. Der Wert stammt jetzt aus `instruction_language`. Ein Wechsel der
Oberfläche verändert damit auch bei laufenden Kursaufträgen keine Modellsprache.
Feste Banktexte und historische Rückmeldungen werden dadurch nicht übersetzt.
Die 840 deutschen Basisaufgaben bleiben unverändert. Zusätzlich gibt es **840
russische Aufgabenansichten**, verteilt auf sieben Module und sechs Lernbereiche
mit jeweils 20 Aufgaben. Auch der interne A1-Test mit zwölf Aufgaben steht mit
russischen Anweisungen zur Verfügung. Russischsprachige Bedeutungsoptionen und
Ausgangssätze sind redaktionelle Quelldaten; englische Lücken, Lesetexte,
Hörtexte und Nachsprechsätze bleiben Lernmaterial auf Englisch. Räumliche und
zeitliche Bedeutungen werden kontextabhängig übersetzt.
### Aufgabenvarianten: erster Pilot
Alle russischen Ansichten sind äquivalente Übersetzungen und teilen die fachliche
Kennung ihrer Basisaufgabe. Sprachansichten werden getrennt eingefroren, erhöhen
aber nicht die Zahl unterschiedlicher Aufgaben oder die Aussprache-Nachweisdichte.
Versuche bleiben einzeln erhalten. Lösungen und Hörtranskripte bleiben bis zur
vorgesehenen Freigabe geschützt; offene Antworten ohne Bewertungsprofil bleiben
unbenotet. Der interne Test ist kein Zertifikat.
Im Bankbetrieb stehen neben den 840 deutschen Aufgabenansichten **zwölf Varianten
mit englischen Erklärungen** für „Begrüßung & Vorstellung“ bereit: zwei pro
Lernbereich, mit allen fünf Aufgabenformen. Das Pilotmodul erhält auch eine
englische Bezeichnung. Die übrigen Module und neue A1-Tests benötigen weiterhin
den deutschen Bestand. Fehlende englische Varianten werden ausdrücklich angezeigt;
es erfolgt kein stiller Rückfall auf deutsche Ersatzaufgaben. Historische Tests
bleiben zugänglich, auch über eine Wiederholung ihrer ursprünglichen Anfrage.
`instruction`, `stimulus` mit Sprachrolle, Optionssprache, Variantenkennung und
Revision trennen Anweisung, Ausgangsmaterial und Lerninhalt. Das kombinierte
`prompt` bleibt für kompatible Clients erhalten. Hintergrundaufträge frieren die
Muttersprache beim Einreihen ein; wiederholte Anfragen behalten den ursprünglichen
Auftrag. Alte englische Pilotansichten in vorhandenen Datenbanken werden deaktiviert,
aber weder gelöscht noch an bereits zugewiesenen Aufgaben verändert.
Bei Englisch als Lern- und Erklärungssprache sind zwei Wortschatzaufgaben auf
englische Bedeutungsbeschreibungen umgestellt. Eine kurze Übersetzungsaufgabe wird
zu angeleitetem Schreiben mit ausdrücklich vorgegebenem Namen. Diese drei
Abwandlungen haben neue fachliche Kennungen. Die neun äquivalenten Übersetzungen
teilen ihre fachliche Kennung mit dem Original. Beide Sprachansichten dürfen
getrennte eingefrorene Zuweisungen haben; äquivalente Übersetzungen erhöhen jedoch
nicht die Zahl unterschiedlicher Aufgaben oder die Aussprache-Nachweisdichte.
Versuche bleiben einzeln gespeichert. Alte Antworten und Messungen werden nicht
umgeschrieben oder neu bewertet.
Die Varianten trennen Anweisung, Lern-/Ausgangsmaterial, Sprachrollen der Optionen
und private Bewertungskriterien. Sprache, Variantenkennung und Revision werden mit
der Aufgabe gespeichert. Hintergrundaufträge speichern ihre Erklärungssprache
bereits beim Einreihen; spätere Präferenzänderungen verändern den Auftrag nicht.
Das alte gemischte `prompt` bleibt als kompatible Darstellung enthalten.
Redaktionelle Quellen und eigener prüfsummengebundener Prüfvermerk liegen unter
`tools/course_bank/variant_sources.json` und `variant_review.json`; generierte
Varianten unter `apps/api/internal/store/coursebank/variants/`. Der Prüfvermerk
beschreibt eine Codex-Redaktion, keine externe Lehrkräfte-Zertifizierung.
Redaktionelle Quellen liegen in `tools/course_bank/russian/*.tsv` und
`variant_sources.json`; `variant_review.json` bindet die Durchsicht an Prüfsummen.
Generierte Ansichten liegen unter `apps/api/internal/store/coursebank/variants/`.
Die dokumentierte Codex-Durchsicht ist keine unabhängige Lehrkräfte-Zertifizierung.
```bash
python tools/course_bank/build.py
python tools/course_bank/audit.py
```
Beide Befehle berücksichtigen Basisbank und Varianten. Die 840 bisherigen
Aufgabendateien bleiben inhaltlich unverändert; der zusätzliche Prüfvermerk ist an
ein eigenes Variantenmanifest gebunden. Gespeicherte Aufgabenansichten bleiben unveränderlich:
spätere Inhaltsänderungen benötigen neue Kennungen/Revisionen.
Beide Befehle prüfen Basisbank und Varianten offline. Geänderte fachliche Inhalte
benötigen neue IDs beziehungsweise Revisionen; historische Daten werden nicht
umgeschrieben oder neu bewertet.
`GET /course/catalog` liefert Erklärungssprache, verfügbare Erklärungssprachen,
sprachbezogenen Bestand und `exam_available`. `PUT /course/instruction-language`
mit `{"instruction_language":"en-US"}` ändert nur die Präferenz des angemeldeten
Nutzers. Nicht verfügbare Sprachpakete/neue Tests liefern HTTP 409 mit
`code=course_variant_unavailable`; die Oberfläche übersetzt diesen Fehlercode.
Andere technische API-/Anbietermeldungen bleiben vorerst im Original.
### Kontoeinstellung und Kompatibilität
Der Pilot gilt für den geprüften Bankbetrieb. Der alternative KI-Modus behält
seine bestehenden Verträge; dessen offene Antworten und Aussprachegenerierung
können die bevorzugte Erklärungssprache verwenden, feste Ersatztexte und altes
Feedback sind damit nicht automatisch übersetzt. Lokale Fixtureprüfungen bestätigen
keine allgemeine Live-Modell- oder Audioqualität. Weitere Module, Erklärungssprachen
und ein vollständiger englischer A1-Test sind nach eigener fachlicher Prüfung
auszubauen; weitere Lernsprachen benötigen zusätzlich eigene Kursinhalte und
geprüfte Speech-Fähigkeiten.
`users.native_language` ist die maßgebliche Einstellung. `PATCH /me/preferences`
akzeptiert `{"native_language":"ru-RU"}`. Die bisherigen Felder `ui_language` und
`instruction_language` bleiben als gekoppelte Kompatibilitätsfelder erhalten.
Alle drei Werte müssen gleich sein; widersprüchliche Angaben liefern HTTP 400
mit `native_language_conflict`, nicht unterstützte Werte `native_language_unsupported`.
Eine Datenbankbedingung schützt die Kopplung auch bei direkten Schreibzugriffen.
`PUT /course/instruction-language` bleibt ein veralteter Kompatibilitätsendpunkt
und ändert ebenfalls die gesamte Muttersprache.
Die additive Migration übernimmt eine vorhandene deutsche/russische GUI-Einstellung;
andere alte GUI-Werte werden auf Deutsch gesetzt. Vorhandene Aufgaben, Aufträge,
Bewertungen und Messungen werden dabei nicht übersetzt. Wiederholte Starts erhalten
die bereits gesetzte Muttersprache. Profil und Sprache werden atomar aktualisiert.
KI-Verträge behalten vorerst den Wire-Namen `ui_language`; dessen Wert stammt aus
der eingefrorenen Muttersprache. `GET /course/catalog` liefert Muttersprache,
verfügbare Muttersprachen, Bestand und Testverfügbarkeit. Fehlende Sprachpakete
führen zu `course_variant_unavailable`, ohne stillen Rückfall auf Deutsch.
Die historische feste Kursansicht und gespeicherte Rückmeldungen bleiben historische
Inhalte. Die festen Recorder-Anweisungen sind übersetzte Oberflächenvorlagen; neue
statistische Trainingsbegründungen werden mit der Muttersprache gespeichert. Neue Lernsprachen benötigen eigene Kursinhalte und geprüfte
Speech-Unterstützung. Lokale Fixturetests bestätigen keine Live-Modellqualität
oder echte Audioqualität. Preise, Produktionsprofile und Budgets werden durch die
Spracherweiterung nicht geändert.
## Klare offene Aufgaben (01.11.2026)
@@ -118,7 +107,7 @@ Betriebsanleitung: [docs/AI_OPERATIONS.md](docs/AI_OPERATIONS.md). Die echte `.e
## Aktueller Funktionsumfang
- Registrierung, Login und Lernerprofil mit Zielsprache, Oberflächensprache und Tagesziel
- Registrierung, Login und Lernerprofil mit Lernsprache, Muttersprache und Tagesziel
- Kurze englische `repeat_sentence`-Übungen aus direkten Modellaufrufen; Seed-Übungen als Fallback
- Audioaufnahme im Browser und Aussprachebewertung über Azure Speech
- Audio-Monitoring ist für eine spätere Erprobung im Code erhalten, derzeit aber in allen Aufnahmebereichen ausgeblendet und deaktiviert. Bei einem manuellen Test mit USB-Headset unter Debian/Firefox wurden etwa 900 ms Verzögerung berichtet; die Ursache ist nicht geklärt. Eine spätere Freigabe erfolgt ausdrücklich über die Komponenten-Option `enableMonitoring`; Schalter und Mithörlautstärke (0–100 %) bleiben vorbereitet.
@@ -134,7 +123,7 @@ Auswahlantworten bewertet die Go-API anhand des gespeicherten Lösungsschlüssel
Der Menüpunkt **A1-Kurs** öffnet sieben frei wählbare Module mit Grammatik, Wortschatz, Hören, Lesen, Sprechen und Schreiben. **Nächste Aufgabe** wählt aus dem geprüften Bestand: noch nicht gezeigte Aufgaben zuerst, bei belegtem Lernbedarf passende Lernziele, nach Ausschöpfen des Bereichs Wiederholungen. Schwierigkeit und Wiederholung beruhen auf tatsächlich bewerteten Antworten. Auch bereits gezeigte, noch unbeantwortete Aufgaben zählen als gesehen, nicht als Leistungsnachweis. Im Browser stehen Herkunft und verbleibender Bestand.
Die 840 Aufgaben liegen in 42 versionierten JSON-Dateien unter `apps/api/internal/store/coursebank/en-US/a1-v2/`. Ihre redaktionellen Quellen und der an Dateiprüfsummen gebundene Prüfvermerk liegen unter `tools/course_bank/`. Es gibt 560 Auswahlaufgaben, je 70 kurze und freie Schreibaufgaben sowie je 70 Nachsprech- und freie Sprechaufgaben. Hörtexte bleiben bis zur zulässigen Freigabe privat. Alte Reserven bleiben für den deutschen Bestand und den alternativen KI-Modus erhalten; fehlende englische Bankvarianten werden nicht dadurch ersetzt.
Die 840 Aufgaben liegen in 42 versionierten JSON-Dateien unter `apps/api/internal/store/coursebank/en-US/a1-v2/`. Ihre redaktionellen Quellen und der an Dateiprüfsummen gebundene Prüfvermerk liegen unter `tools/course_bank/`. Es gibt 560 Auswahlaufgaben, je 70 kurze und freie Schreibaufgaben sowie je 70 Nachsprech- und freie Sprechaufgaben. Hörtexte bleiben bis zur zulässigen Freigabe privat. Alte Reserven bleiben für den deutschen Bestand und den alternativen KI-Modus erhalten; fehlende muttersprachliche Bankvarianten werden nicht dadurch ersetzt.
Der A1-Test besteht aus zwölf vor der ersten Antwort eingefrorenen Aufgaben, zwei je Lernbereich, mit Abdeckung der sechs Lernmodule. Nach zwölf Abgaben ohne vollständige Bewertung erscheint **Abgegeben – Bewertung ausstehend**. Erst nach vollständiger Bewertung werden Lösungen und Gesamtnote gezeigt. Gespeicherte unbenotete Antworten begründen keinen Modulabschluss. Das Testergebnis ist eine interne Lerneinschätzung, kein Zertifikat.