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.
61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
# Data Model
|
|
|
|
Core tables are created automatically by the Go API at startup:
|
|
|
|
- `users`
|
|
- `learner_profiles`
|
|
- `language_profiles`
|
|
- `lessons`
|
|
- `exercises`
|
|
- `attempts`
|
|
- `progress_events`
|
|
- `conversation_sessions`
|
|
- `conversation_turns`
|
|
|
|
The MVP seeds `en-US` A1 lessons and exercises. Additional languages should be added by inserting a new `language_profiles` row and matching lessons/exercises.
|
|
|
|
## Language roles
|
|
|
|
- `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` 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
|
|
|
|
`course_v2_bank_variants` stores immutable IDs, base-entry references, canonical
|
|
identity, explanation language, revision, reviewed data and checksum. A partial
|
|
unique index allows one active presentation per base entry/explanation language;
|
|
retired rows remain for frozen assignments. `course_v2_tasks.variant_id` links new
|
|
variant snapshots. Its assignment uniqueness includes the variant, allowing
|
|
separate frozen language presentations. Original German bank entries and old
|
|
assigned JSON remain unchanged.
|
|
|
|
New task JSON may include `instruction_language`, `instruction`, `stimulus`,
|
|
`variant_id`, `content_revision`, `canonical_task_id`, option language/role and
|
|
private reference-answer language. The compatible combined `prompt` remains.
|
|
`Public(false)` still removes solutions and listening transcripts and always
|
|
removes the internal `evidence_task_id`.
|
|
|
|
New equivalent presentations reuse the earliest matching owned assignment's
|
|
`evidence_task_id` (or its ID for legacy snapshots). Graded attempts remain
|
|
separate; distinct-task aggregation uses that identity. New scripted speech
|
|
observations also use it for repetition grouping. Previously stored observations
|
|
and historical attempt JSON are unchanged; this does not retrospectively dedupe
|
|
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. 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.
|