Thematische Lernwege im A1-Kurs standardmäßig empfehlen

Die bisherige Auswahl verbindet Lernbereiche nicht thematisch und kann freies
Sprechen ohne passende Vorbereitung anbieten. Der Bankbetrieb empfiehlt nun
60 redaktionell verknüpfte Themen in sechs Lernmodulen: Hören, Wortschatz,
Lesen, Nachsprechen, Grammatik, angeleitetes und freies Schreiben, freies Sprechen.

Speichert die Lernwegposition getrennt von Leistungsnachweisen. Unbeantwortete
Schritte bleiben empfohlen und sind explizit überspringbar; nach einer tatsächlich
bewerteten schwachen Antwort gibt es höchstens eine Wiederholung ohne Notensperre.
Bereichswahl, Muttersprache, historische Aufgaben und A1-Tests bleiben unabhängig.
Deutsch und Russisch zeigen Thema und Schritt; vorhandene Aufgabeninhalte und
Bewertungen werden nicht umgeschrieben. Keine zusätzlichen Modellaufrufe.

Validierung: Go-Race-Suite mit eigener lokaler PostgreSQL-Testdatenbank, go vet,
Web-Build, Bank-/Varianten-/Sequenzaudits und lokale Kurs-/Sprachen-/Admin-Smokes.
Regressionsfall: passendes Schreiben vor freiem Sprechen über zwei Freunde.
Keine Live-Anbieterprüfung oder Produktionsänderung.
This commit is contained in:
Eugenius Naumenko
2026-11-11 17:51:32 +00:00
parent 16cceae28a
commit 7499491ae8
28 changed files with 5489 additions and 43 deletions
+28
View File
@@ -58,3 +58,31 @@ and request replays keep it. Both native languages provide 840 task presentation
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.
## Thematic learning paths
`course_v2_sequence_progress` is additive state scoped by user, target language,
course version, module and editorial sequence revision. It stores a cursor,
current assignment, presentation timestamp, skipped count and bounded review flag.
It is navigation/participation state, never mastery evidence or an exam result.
Only a new non-demo saved answer for the current presentation or an explicit skip
advances the cursor. A known graded error may offer one repeat; grades never gate
progress. Native changes share the cursor, while task snapshots remain frozen.
Selections and cursor changes commit together under the existing per-user/course
advisory lock. Job results retain recommendation metadata across finalization and
idempotent replay. Direct skill selection and exams do not move this cursor.
`GET /course/catalog` adds `sequence_recommendations` by module. Recommendations
include localized topic title, current phase and step, topic count, active task,
review/answer-needed flags and explicit skipped count. Completed paths indicate
only that steps were worked through or skipped. `POST /course/modules/{id}/tasks/next`
with empty `skill` uses the path; optional `skip_task_id` explicitly skips the
current owned assignment. Stale/foreign skips fail without changing progress.
The field is rejected alongside an explicit skill or in AI mode. Request replay
must preserve the original skip subject. Existing clients may omit the new field.
Immutable thematic links are embedded separately from the task/variant banks.
Their source and compiler are pinned by a separate editorial review and manifest;
changing the path requires a new revision. The 840 base entries and Russian
presentations are unchanged. Initial activation begins at the first topic without
reinterpreting historical grades or rewriting existing assignments.