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
+4 -2
View File
@@ -25,7 +25,9 @@ export type CourseAnalysis = {
summary: string; facts_version: number; recommended_module_id: string;
modules: { module_id: string; strengths: string[]; weaknesses: string[]; recommendation: string; reason: string; ready_for_completion: boolean }[];
};
export type SequenceRecommendation = { review: boolean; revision: string; sequence_id?: string; title?: string; phase?: string; step: number; steps: number; topic: number; topics: number; task_id?: string; complete: boolean; skipped_steps: number; needs_answer: boolean };
export type CourseCatalog = {
sequence_recommendations?: Record<string, SequenceRecommendation>;
native_language?: string; native_languages?: string[]; exam_available?: boolean;
task_mode?: string; grading_available?: boolean; bank?: {module_id:string;skill:CourseSkill;total:number;unseen:number}[];
profile: LearnerProfile; modules: AdaptiveModule[];
@@ -33,13 +35,13 @@ export type CourseCatalog = {
analysis_job?: CourseJob; analysis: CourseAnalysis | null; facts_version: number; enabled_languages: string[]; languages: LanguageProfile[];
exams: { id: string; target_language: string; status: string }[];
};
export type CourseJob = { instruction_language?: string; id: string; kind: string; status: string; stage: string; task_id?: string; subject_id?: string; error?: string; source?: string; review?: boolean };
export type CourseJob = { recommendation?: SequenceRecommendation; instruction_language?: string; id: string; kind: string; status: string; stage: string; task_id?: string; subject_id?: string; error?: string; source?: string; review?: boolean };
export type AdaptiveExam = { id: string; status: string; target_language: string; tasks: AdaptiveTask[]; attempts: AdaptiveAttempt[]; scores?: Record<CourseSkill, number>; score?: number; summary?: string; summary_status?: string; summary_job_id?: string; preparation_job_id?: string };
export function courseRequestID() { return Array.from(crypto.getRandomValues(new Uint8Array(16)), (b) => b.toString(16).padStart(2, '0')).join(''); }
export const getCourseCatalog = () => request<CourseCatalog>('/course/catalog');
export const getCourseHistory = (module: string, offset = 0) => request<{ tasks: AdaptiveTask[]; has_more: boolean }>(`/course/modules/${encodeURIComponent(module)}/tasks?offset=${offset}`);
export const getAdaptiveTask = (id: string) => request<{ task: AdaptiveTask; attempt: AdaptiveAttempt | null }>(`/course/tasks/${encodeURIComponent(id)}`);
export const createCourseTask = (module: string, skill: string, requestId: string) => request<CourseJob>(`/course/modules/${encodeURIComponent(module)}/tasks/next`, { method: 'POST', body: JSON.stringify({ skill, request_id: requestId }) });
export const createCourseTask = (module: string, skill: string, requestId: string, skipTaskID?: string) => request<CourseJob>(`/course/modules/${encodeURIComponent(module)}/tasks/next`, { method: 'POST', body: JSON.stringify({ skill, request_id: requestId, skip_task_id: skipTaskID }) });
export const getCourseJob = (id: string) => request<CourseJob>(`/course/jobs/${encodeURIComponent(id)}`);
export const retryCourseJob = (id: string) => request<CourseJob>(`/course/jobs/${encodeURIComponent(id)}/retry`, { method: 'POST' });
export const getCourseAttempt = (id: string) => request<AdaptiveAttempt>(`/course/attempts/${encodeURIComponent(id)}`);
+17 -2
View File
@@ -98,7 +98,7 @@
"ui.course_not_yet_available": " – Kurs noch nicht verfügbar",
"ui.a_reviewed_a1_course_pack_is_not_yet_available_for": "Für diese Zielsprache ist noch kein geprüftes A1-Sprachpaket freigeschaltet. Dein bisheriger Lernstand bleibt gespeichert.",
"ui.your_learning_progress": "Dein Lernstand",
"ui.exercises_are_selected_using_your_saved_evaluations_new_exercises_come": "Die Auswahl nutzt deine gespeicherten Bewertungen. Noch neue Aufgaben haben Vorrang; bei Lernbedarf folgen passende Übungen und Wiederholungen. Unbenotete Antworten zählen nicht als bewerteter Lernnachweis.",
"ui.exercises_are_selected_using_your_saved_evaluations_new_exercises_come": "Der empfohlene Lernweg verbindet Hören, Wortschatz, Lesen, Nachsprechen, Grammatik und Schreiben bis zum freien Sprechen. Einzelne Lernbereiche bleiben direkt wählbar.",
"ui.no_ai_learning_analysis_yet_the_teacher_agent_creates_it": "Noch keine KI-Lernanalyse vorhanden. Der Lehrer-Agent erstellt sie aus deinen gespeicherten Antworten.",
"ui.the_learning_analysis_is_being_updated_after_your_latest_answer": "Die Lernanalyse wird nach deiner letzten Antwort aktualisiert.",
"ui.request_learning_analysis_again": "Lernanalyse erneut anfordern",
@@ -443,5 +443,20 @@
"seed.cafe.title": "Im Café",
"seed.numbers.title": "Zahlen",
"seed.generated.title": "Ausspracheübung",
"seed.historical": "Historischer fester Kurs: Die gespeicherten Aufgaben und Erklärungen bleiben in ihrer ursprünglichen Sprache. Für neue Aufgaben in deiner Muttersprache nutze den aktuellen A1-Kurs."
"seed.historical": "Historischer fester Kurs: Die gespeicherten Aufgaben und Erklärungen bleiben in ihrer ursprünglichen Sprache. Für neue Aufgaben in deiner Muttersprache nutze den aktuellen A1-Kurs.",
"sequence.default": "Empfohlener Lernweg",
"sequence.title": "Dein thematischer Lernweg",
"sequence.intro": "Die Übungen bauen zum selben Thema aufeinander auf. Antworte und wähle dann „Nächste Aufgabe“. Du kannst einen Schritt überspringen oder einen Lernbereich direkt wählen. Bearbeitet bedeutet noch nicht beherrscht.",
"sequence.position": "Thema {topic} von {topics} · Schritt {step} von {steps}",
"sequence.skip": "Diesen Schritt überspringen",
"sequence.complete": "Du hast diesen Lernweg durchgearbeitet oder Schritte übersprungen. Weitere Aufgaben richten sich nach deinen gespeicherten Bewertungen. Das ist noch kein Nachweis, dass du alles beherrschst.",
"sequence.phase.listen": "Zuerst hören",
"sequence.phase.vocabulary": "Wörter im Zusammenhang verstehen",
"sequence.phase.read": "Ein passendes Beispiel lesen",
"sequence.phase.repeat": "Mit Vorlage nachsprechen",
"sequence.phase.grammar": "Das Satzmuster üben",
"sequence.phase.write": "Mit Vorgabe schreiben",
"sequence.phase.compose": "Selbstständig formulieren",
"sequence.phase.speak": "Das Thema frei sprechen",
"sequence.review": "Bei der letzten Antwort gab es einen Fehler. Übe diesen Schritt noch einmal oder überspringe ihn. Danach geht der Lernweg weiter, unabhängig von der Punktzahl."
}
+17 -2
View File
@@ -98,7 +98,7 @@
"ui.course_not_yet_available": " — Курс пока недоступен",
"ui.a_reviewed_a1_course_pack_is_not_yet_available_for": "Для этого изучаемого языка пока нет проверенного курса A1. Ваш прежний прогресс сохранён.",
"ui.your_learning_progress": "Ваш прогресс в обучении",
"ui.exercises_are_selected_using_your_saved_evaluations_new_exercises_come": "Задания подбираются по сохранённым оценкам. Сначала предлагаются новые задания, затем подходящие упражнения и повторения. Ответы без оценки не считаются оценёнными результатами обучения.",
"ui.exercises_are_selected_using_your_saved_evaluations_new_exercises_come": "Рекомендуемый учебный путь связывает аудирование, лексику, чтение, повторение вслух, грамматику и письмо, подготавливая к самостоятельной речи. Любое направление можно выбрать напрямую.",
"ui.no_ai_learning_analysis_yet_the_teacher_agent_creates_it": "Анализа ИИ пока нет. Учитель создаёт его на основе ваших сохранённых ответов.",
"ui.the_learning_analysis_is_being_updated_after_your_latest_answer": "Анализ прогресса обновляется после последнего ответа.",
"ui.request_learning_analysis_again": "Запросить анализ прогресса повторно",
@@ -443,5 +443,20 @@
"seed.cafe.title": "В кафе",
"seed.numbers.title": "Числа",
"seed.generated.title": "Упражнение на произношение",
"seed.historical": "Исторический фиксированный курс: сохранённые задания и объяснения остаются на исходном языке. Новые задания на вашем родном языке доступны в текущем курсе A1."
"seed.historical": "Исторический фиксированный курс: сохранённые задания и объяснения остаются на исходном языке. Новые задания на вашем родном языке доступны в текущем курсе A1.",
"sequence.default": "Рекомендуемый учебный путь",
"sequence.title": "Ваш тематический учебный путь",
"sequence.intro": "Упражнения последовательно раскрывают одну тему. Ответьте и нажмите «Следующее задание». Можно пропустить шаг или выбрать направление обучения напрямую. Выполненное задание ещё не означает освоение материала.",
"sequence.position": "Тема {topic} из {topics} · Шаг {step} из {steps}",
"sequence.skip": "Пропустить этот шаг",
"sequence.complete": "Вы прошли этот учебный путь или пропустили отдельные шаги. Дальнейшие задания подбираются по сохранённым оценкам. Это ещё не подтверждает освоение всего материала.",
"sequence.phase.listen": "Сначала послушать",
"sequence.phase.vocabulary": "Понять слова в контексте",
"sequence.phase.read": "Прочитать пример по теме",
"sequence.phase.repeat": "Повторить вслух по образцу",
"sequence.phase.grammar": "Потренировать структуру предложения",
"sequence.phase.write": "Написать по заданию",
"sequence.phase.compose": "Самостоятельно составить текст",
"sequence.phase.speak": "Самостоятельно рассказать по теме",
"sequence.review": "В последнем ответе была ошибка. Повторите этот шаг ещё раз или пропустите его. После этого учебный путь продолжится независимо от балла."
}
+20 -4
View File
@@ -1,6 +1,6 @@
import { errorMessage, useLocalizedMessage } from '../i18n/useLocalizedMessage';
import { useCourseSkillNames } from '../i18n/labels';
import { useI18n } from '../i18n/I18n';
import { useI18n, type MessageKey } from '../i18n/I18n';
import { useEffect, useRef, useState } from 'react';
import { request } from '../api/client';
import {
@@ -33,6 +33,7 @@ export function CoursePage() {
const [restored, setRestored] = useState(false);
const [revision, setRevision] = useState(0);
const generationID = useRef<string | null>(null);
const generationSkipID = useRef<string | undefined>(undefined);
const examRequestID = useRef<string | null>(null);
const exerciseRef = useRef<HTMLElement | null>(null);
const active = useRef(true);
@@ -137,9 +138,12 @@ export function CoursePage() {
const timer = window.setTimeout(() => { void refreshCatalog().catch(showError); }, 3000);
return () => window.clearTimeout(timer);
}, [catalog]);
async function generate() {
async function generate(skip = false) {
if (locked || !moduleID) return; setBusy(true); setError('');
try { generationID.current ??= courseRequestID(); const next = await createCourseTask(moduleID, skill, generationID.current); generationID.current = null; setExam(null); setJob(next); }
try { const skipID = skip ? task?.id : undefined;
if (generationSkipID.current !== skipID) generationID.current = null;
generationSkipID.current = skipID;
generationID.current ??= courseRequestID(); const next = await createCourseTask(moduleID, skill, generationID.current, skipID); generationID.current = null; setExam(null); setJob(next); }
catch (err) { showError(err); } finally { setBusy(false); }
}
async function changeLanguage(language: string) {
@@ -166,6 +170,8 @@ export function CoursePage() {
if (legacy) return <><button type="button" className="ghost-button" onClick={() => setLegacy(false)}>{t('ui.back_to_the_adaptive_course')}</button><LegacyCoursePage /></>;
if (!catalog) return <section className="panel"><p>{error || t('ui.loading_a1_course')}</p>{error && <button type="button" onClick={() => setRevision((n) => n + 1)}>{t('ui.reload')}</button>}</section>;
const selected = catalog.modules.find((m) => m.id === moduleID);
const recommendation = catalog.sequence_recommendations?.[moduleID];
const phases: Record<string, MessageKey> = { listen: 'sequence.phase.listen', vocabulary: 'sequence.phase.vocabulary', read: 'sequence.phase.read', repeat: 'sequence.phase.repeat', grammar: 'sequence.phase.grammar', write: 'sequence.phase.write', compose: 'sequence.phase.compose', speak: 'sequence.phase.speak' };
const analysis = catalog.analysis?.modules.find((m) => m.module_id === moduleID);
const progress = catalog.progress.filter((p) => p.module_id === moduleID);
const inventory=(catalog.bank??[]).filter(p=>p.module_id===moduleID && (!skill||p.skill===skill));
@@ -187,7 +193,17 @@ export function CoursePage() {
</button>)}</nav>
{selected && <section className="panel view-stack"><div><p className="eyebrow">{t('ui.module')} {selected.order}</p><h2>{selected.title}</h2><p className="muted">{selected.description}</p></div>
{analysis && <div><p>{analysis.recommendation}</p><p className="muted">{analysis.reason}</p>{analysis.weaknesses?.map((weakness, i) => <p key={i}>{t('ui.more_practice')} {weakness}</p>)}</div>}
<div className="course-area-grid" role="group" aria-label={t('ui.learning_area')}><button type="button" disabled={locked} className={skill === '' ? 'course-task active' : 'course-task'} onClick={() => setSkill('')}>{t('ui.ai_recommendation')}</button>{courseSkills.map((area) => <button type="button" disabled={locked} key={area} className={skill === area ? 'course-task active' : 'course-task'} onClick={() => { setSkill(area); generationID.current = null; }}>{courseSkillNames[area]}</button>)}</div>
<div className="course-area-grid" role="group" aria-label={t('ui.learning_area')}><button type="button" disabled={locked} className={skill === '' ? 'course-task active' : 'course-task'} onClick={() => { setSkill(''); generationID.current = null; }}>{t(catalog.task_mode === 'bank' ? 'sequence.default' : 'ui.ai_recommendation')}</button>{courseSkills.map((area) => <button type="button" disabled={locked} key={area} className={skill === area ? 'course-task active' : 'course-task'} onClick={() => { setSkill(area); generationID.current = null; }}>{courseSkillNames[area]}</button>)}</div>
{skill === '' && recommendation && !exam && <div className="view-stack" role="region" aria-label={t('sequence.title')}>
<h3>{t('sequence.title')}</h3>
{recommendation.complete ? <p>{t('sequence.complete')}</p> : <>
<strong>{recommendation.title}</strong>
<p>{t('sequence.position', { topic: recommendation.topic, topics: recommendation.topics, step: recommendation.step, steps: recommendation.steps })} · {recommendation.phase && phases[recommendation.phase] ? t(phases[recommendation.phase]) : ''}</p>
<p className="muted">{t('sequence.intro')}</p>
{recommendation.review && <p role="status">{t('sequence.review')}</p>}
{recommendation.task_id === task?.id && recommendation.needs_answer && <button type="button" className="ghost-button" disabled={locked} onClick={() => void generate(true)}>{t('sequence.skip')}</button>}
</>}
</div>}
<div className="action-row"><button type="button" className="primary-button" disabled={locked || noVariant} onClick={() => void generate()}>{jobRunning ? t('ui.preparing_exercise') : t('ui.next_exercise')}</button>{selected.key === 'review_test' && <button type="button" className="ghost-button" disabled={locked || catalog.exam_available === false} onClick={() => void startExam()}>{t('ui.start_a_new_a1_test_12_questions')}</button>}</div>
{noVariant && <p role="status">{t('course.noVariant')}</p>}
{selected.key === 'review_test' && catalog.exam_available === false && <p>{t('course.examUnavailable')}</p>}
+10
View File
@@ -49,6 +49,16 @@ Sprachrollen, private Hörtexte/Lösungen, unbenotete Antworten sowie eingefrore
Aufgaben nach Sprachwechsel und Reload. Ein russischer Test mit zwölf Aufgaben
bleibt nach einem Wechsel über dieselbe Request-ID unverändert abrufbar.
`course-sequences.e2e.cjs` prüft auf Deutsch und Russisch den empfohlenen
Lernweg mit Höreinstieg, Wiederaufnahme nach Reload, unveränderten Schritt bei
bloßem Weiterklicken, explizites Überspringen, freie Bereichswahl, Fortsetzung
nach einer Antwort und Erhalt beim Wechsel der Muttersprache. Die Kursbank-Fixture
startet ihn sequenziell nach dem Varianten-Smoke. Keine Modellaufrufe.
Die Go-Datenbanktests prüfen zusätzlich den Weg bis zur gemeldeten Aufgabe über
zwei Freunde: passendes Schreiben vor freiem Sprechen, unbenotete Antworten ohne
falschen Leistungsnachweis, einmaliges Wiederholungsangebot, Request-Replay,
abgewiesene fremde/veraltete Skip-IDs und unveränderte historische Aufgaben.
`course-bank.e2e.cjs` läuft vollständig mit deutscher und russischer Muttersprache:
Aufgabenzuweisung, Bedienung aller fünf Darstellungen, Antwort/Reload, Eingabeerhalt
beim Sprachwechsel und vollständig abgegebener Test ohne vorzeitige Note oder
+48
View File
@@ -0,0 +1,48 @@
// Real local API and disposable database; no paid models or actual microphone.
const {chromium}=require(process.env.PLAYWRIGHT_MODULE||'playwright');
const assert=require('node:assert/strict'),crypto=require('node:crypto'),fs=require('node:fs');
(async()=>{
const api=process.env.AI_E2E_API,url=process.env.AI_E2E_URL;
const browser=await chromium.launch({headless:true,args:['--no-sandbox']});
try {
const page=await browser.newPage();page.setDefaultTimeout(15000);const errors=[];page.on('pageerror',e=>errors.push(e.message));
for(const native of ['de-DE','ru-RU']) {
const labels=JSON.parse(fs.readFileSync(`src/i18n/${native}.json`));
const response=await page.request.post(api+'/auth/register',{data:{email:`sequence-${native}-${Date.now()}@example.test`,password:'local-sequence-test-password',native_language:native,target_language:'en-US'}});assert.equal(response.status(),201);
const account=await response.json(),headers={Authorization:`Bearer ${account.token}`};
const get=async path=>{const r=await page.request.get(api+path,{headers});assert.equal(r.status(),200,await r.text());return r.json()};
await page.goto(url);await page.evaluate(t=>localStorage.setItem('speech_token',t),account.token);await page.reload();await page.getByRole('button',{name:labels['nav.course'],exact:true}).click();
const path=page.getByRole('region',{name:labels['sequence.title'],exact:true});await path.waitFor();await path.getByText(labels['sequence.phase.listen'],{exact:false}).waitFor();
await page.getByRole('button',{name:labels['sequence.default'],exact:true}).waitFor();
async function next(skip=false) {
const ready=page.waitForResponse(r=>r.url().endsWith('/tasks/next')&&r.request().method()==='POST');
await page.getByRole('button',{name:labels[skip?'sequence.skip':'ui.next_exercise'],exact:true}).click();
let job=await(await ready).json();for(let n=0;n<100&&['queued','running'].includes(job.status);n++){await page.waitForTimeout(100);job=await get('/course/jobs/'+job.id)}
assert.equal(job.status,'succeeded',job.error);
await path.getByText(labels['sequence.phase.'+job.recommendation.phase],{exact:false}).waitFor();
const current=await get('/course/tasks/'+job.task_id);
const exercise=page.getByRole('region',{name:labels['ui.current_course_exercise']});await exercise.getByRole('heading',{name:current.task.instruction||current.task.prompt,exact:true}).waitFor();
return {job,...current};
}
const first=await next();assert.equal(first.task.skill,'listening');assert.equal(first.job.recommendation.step,1);assert.equal(first.task.audio_text,undefined);assert.equal(first.task.answer_key,undefined);
const same=await next();assert.equal(same.task.id,first.task.id,'Clicking Next alone must not count as practice');
await page.reload();await page.getByRole('button',{name:labels['nav.course'],exact:true}).click();await path.getByRole('button',{name:labels['sequence.skip'],exact:true}).waitFor();
const skipped=await next(true);assert.equal(skipped.job.recommendation.step,2);assert.equal(skipped.job.recommendation.skipped_steps,1);assert.equal(skipped.task.skill,'vocabulary');
const areas=page.getByRole('group',{name:labels['ui.learning_area']});await areas.getByRole('button',{name:labels['ui.speaking'],exact:true}).click();assert.equal(await path.count(),0);
await areas.getByRole('button',{name:labels['sequence.default'],exact:true}).click();await path.getByText(labels['sequence.phase.vocabulary'],{exact:false}).waitFor();
// Submit a correct choice through the API, then let the browser continue the path.
const baseline=JSON.parse(fs.readFileSync('../api/internal/store/coursebank/en-US/a1-v2/introductions.vocabulary.json'));
const key=baseline.find(e=>e.id===skipped.task.canonical_task_id).task.answer_key.correct_option_id;
const attempt=await page.request.post(api+'/course/tasks/'+skipped.task.id+'/attempts',{headers,data:{request_id:crypto.randomUUID().replaceAll('-',''),answer:key}});assert.equal(attempt.status(),201);
const continued=await next();assert.equal(continued.job.recommendation.step,3);
const me=await get('/me');assert.deepEqual(me.profile,account.profile);
const other=native==='de-DE'?'ru-RU':'de-DE';await page.locator('.language-picker select').selectOption(other);
const translated=JSON.parse(fs.readFileSync(`src/i18n/${other}.json`));await page.getByRole('region',{name:translated['sequence.title']}).getByText(translated['sequence.phase.vocabulary'],{exact:false}).waitFor();
const catalog=await get('/course/catalog');assert.equal(catalog.sequence_recommendations.a1_introductions_v1.step,3);assert.equal(catalog.sequence_recommendations.a1_introductions_v1.skipped_steps,1);
assert.equal((await get('/course/tasks/'+continued.task.id)).task.instruction_language,native);
await page.getByRole('button',{name:translated['auth.logout'],exact:true}).click();
}
const usage=await page.request.get(api+'/admin/ai/usage',{headers:{Authorization:`Bearer ${process.env.AI_E2E_TOKEN}`}});assert.equal((await usage.json()).total,0);assert.deepEqual(errors,[]);
console.log('PASS: German/Russian default thematic paths; listening entry; no silent skip; explicit skip and reload; manual areas remain available; submitted answers advance; native change retains path and frozen task; no model calls.');
}finally{await browser.close()}
})().catch(e=>{console.error(e);process.exitCode=1});