# 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.