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:
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user