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
+15 -15
View File
@@ -16,19 +16,18 @@ The MVP seeds `en-US` A1 lessons and exercises. Additional languages should be a
## Language roles
- `learner_profiles.target_language`: language being learned; progress remains
scoped by learner, target language and course version.
- `users.ui_language`: interface preference; newly selected values are `de-DE`
or `en-US` during the first rollout.
- `users.instruction_language`: preferred explanation language. The additive
startup migration copies the old `ui_language` only for rows without this
field. New accounts default to `de-DE`; changing the interface never updates
this field. Existing stored tasks and feedback keep their original language.
- `learner_profiles.target_language`: language being learned; evidence is scoped
by authenticated learner, target language and course version.
- `users.native_language`: shared GUI and explanation language (`de-DE`/`ru-RU`).
- `users.ui_language` and `users.instruction_language`: compatibility aliases,
constrained to equal `native_language`. No independent preferences remain.
`PATCH /me/preferences` preserves omitted target language, level and daily goal.
The profile update and interface preference are committed in one transaction.
`GET /me` and auth responses expose both user language fields. The course also
offers `PUT /course/instruction-language` for reviewed bank presentations; this changes no interface, target-language or learning-goal fields.
`PATCH /me/preferences` accepts the canonical native field and preserves omitted
profile values atomically. Conflicting aliases fail before writes. Registration,
auth responses and `/me` expose the canonical field. The deprecated
`PUT /course/instruction-language` updates all aliases together. Initial migration
keeps supported old GUI values, otherwise selects German; task and attempt data
remain untouched. Repeated startup preserves the canonical preference.
## Reviewed task presentations
@@ -55,6 +54,7 @@ all old exam copies. Adaptations have new canonical/evidence identities.
`course_v2_jobs.instruction_language` freezes the effective preference when the
job is inserted. Startup fills this additive field once for older jobs; retries
and request replays keep it. The pilot adds twelve English presentations, nine
translations and three adaptations. Catalog inventory uses the selected
explanation language, so the German total remains 840 and the pilot total is 12.
and request replays keep it. Both native languages provide 840 task presentations,
seven modules and the internal A1 exam. All Russian entries are translations with
shared base canonical IDs. Retired English pilot variants remain in existing
databases for frozen history but are no longer offered.