Adaptiven A1-Kurs und statistisches Aussprachetraining integrieren

Direkte DeepSeek- und Mistral-Anbindung mit versionierten Aktionsprofilen,
Budgetreservierung, Tokenabrechnung und administrativen Qualitätsprüfungen
ersetzen die Flowise-Abhängigkeit im regulären Betrieb.

840 geprüfte A1-Aufgaben mit geschützter Testauswertung und konkreten offenen
Arbeitsaufträgen ergänzen den Kurs. Inhalts- und Sprachbewertung bleiben von
Azure-Aussprachewerten getrennt; historische Aufgaben und Antworten bleiben erhalten.

Echte Wort- und Phonemmessungen werden mit Herkunft, Aktualität und Nachweisdichte
gebündelt. Go bestimmt Trainingsziele und Wiederholungen, das Modell formuliert
dazu passende Nachsprechübungen. Profilansicht und Auswahlgründe werden angezeigt.

Validierung: Go-Race-Tests mit lokaler PostgreSQL-Integration, go vet,
Web-Build, Audit aller 840 Aufgaben und drei Browser-Smokes mit lokalen
Modell-/Speech-Fixtures bestanden. Keine Produktionsänderungen oder Live-Aufrufe.
This commit is contained in:
Eugenius Naumenko
2026-11-01 23:23:20 +00:00
parent 83944f791e
commit e274eaab2b
186 changed files with 46676 additions and 257 deletions
@@ -0,0 +1,62 @@
import { useEffect, useRef, useState } from 'react';
import { answerCourseAudio, answerCourseTask, courseRequestID, courseSkillNames, getAdaptiveAudio, type AdaptiveAttempt, type AdaptiveTask } from '../api/adaptive';
import { AudioRecorder } from './AudioRecorder';
type Props = { task: AdaptiveTask; attempt: AdaptiveAttempt | null; locked: boolean; onAttempt: (attempt: AdaptiveAttempt) => void; onBusy: (value: boolean) => void; onRecording: (value: boolean) => void };
export function AdaptiveExercise({ task, attempt, locked, onAttempt, onRecording, onBusy }: Props) {
const [answer, setAnswer] = useState('');
const [recording, setRecording] = useState(false);
const [audio, setAudio] = useState<Blob | null>(null);
const [audioURL, setAudioURL] = useState('');
const [busy, setBusy] = useState(false);
const [error, setError] = useState('');
useEffect(() => { onBusy(busy); return () => onBusy(false); }, [busy, onBusy]);
const requestID = useRef<string | null>(null);
const playback = useRef<{ audio: HTMLAudioElement; url: string } | null>(null);
function stopPlayback() { if (playback.current) { playback.current.audio.pause(); URL.revokeObjectURL(playback.current.url); playback.current = null; } }
useEffect(() => () => stopPlayback(), []);
useEffect(() => { if (!audio) { setAudioURL(''); return; } const url = URL.createObjectURL(audio); setAudioURL(url); return () => URL.revokeObjectURL(url); }, [audio]);
const isSpeech = task.kind === 'repeat_sentence' || task.kind === 'free_speech';
const examAnswered = Boolean(task.exam_id && attempt);
const disabled = locked || busy || examAnswered || attempt?.status === 'pending';
async function play() {
setError(''); setBusy(true);
try { stopPlayback(); const blob = await getAdaptiveAudio(task.id); const url = URL.createObjectURL(blob); const player = new Audio(url); playback.current = { audio: player, url }; player.onended = stopPlayback; player.onerror = () => { stopPlayback(); setError('Audio konnte nicht abgespielt werden.'); }; await player.play(); }
catch (err) { stopPlayback(); setError(err instanceof Error ? err.message : 'Audio nicht verfügbar.'); }
finally { setBusy(false); }
}
async function submit() {
if (disabled || recording || (isSpeech ? !audio : !answer.trim())) return;
setBusy(true); setError('');
try {
requestID.current ??= courseRequestID();
const result = isSpeech ? await answerCourseAudio(task.id, audio!, requestID.current) : await answerCourseTask(task.id, answer, requestID.current);
requestID.current = null; onAttempt(result.attempt); setAudio(null);
} catch (err) { setError(err instanceof Error ? err.message : 'Antwort konnte nicht gespeichert werden.'); }
finally { setBusy(false); }
}
return <div className="view-stack">
<p className="eyebrow">{courseSkillNames[task.skill]} · {task.source === 'curated' ? 'Aus geprüftem Aufgabenbestand' : task.source === 'ai' ? 'Mit KI erstellt' : task.source === 'flowise' ? 'Mit Flowise erstellt' : 'Geprüfte Ersatzaufgabe'}{task.review ? ' · Wiederholung' : ''}</p>
<h2>{task.prompt}</h2>
{task.kind==='free_speech'&&<p className="muted">Inhalt und Sprache werden von der KI bewertet. Der Azure-Aussprachewert wird getrennt angezeigt.</p>}
{task.passage && <p className="course-passage" lang={task.target_language} dir="auto">{task.passage}</p>}
{task.reference_text && <p className="target-text" lang={task.target_language} dir="auto">{task.reference_text}</p>}
{(task.skill === 'listening' || task.kind === 'repeat_sentence') && <button type="button" className="ghost-button" disabled={busy || recording} onClick={() => void play()}>Anhören</button>}
{task.kind === 'choice' && <div className="course-options" role="group" aria-label="Antwortmöglichkeiten">{task.options?.map((option) => <label key={option.id} className="course-option" dir="auto"><input type="radio" name={task.id} checked={answer === option.id} value={option.id} disabled={disabled} onChange={() => { setAnswer(option.id); requestID.current = null; }} />{option.label}</label>)}</div>}
{(task.kind === 'free_text' || task.kind === 'short_text') && <label>Deine Antwort<textarea rows={task.kind === 'free_text' ? 5 : 2} maxLength={10000} lang={task.target_language} dir="auto" disabled={disabled} value={answer} onChange={(event) => { setAnswer(event.target.value); requestID.current = null; }} /></label>}
{isSpeech && <>
<p className="muted">Bis zu 30 Sekunden. Du kannst die Aufnahme vor dem Absenden anhören.</p>
<AudioRecorder maxSeconds={30} disabled={disabled} onRecorded={setAudio} onRecordingStart={() => { setAudio(null); requestID.current = null; stopPlayback(); }} onRecordingChange={(value) => { setRecording(value); onRecording(value); }} />
{audioURL && <audio controls src={audioURL} />}
</>}
<button type="button" className="primary-button" onClick={() => void submit()} disabled={disabled || recording || (isSpeech ? !audio : !answer.trim())}>{busy ? 'Antwort wird verarbeitet…' : task.exam_id ? 'Testantwort speichern' : 'Antwort prüfen'}</button>
{error && <p className="form-error" role="alert">{error}</p>}
{attempt && <div className="course-feedback" role="status">
{attempt.demo && <p>Demo-Messung: zählt nicht als Lernnachweis.</p>}
{task.exam_id && !attempt.evaluation ? <p>Testantwort gespeichert. Das Feedback erscheint, sobald alle zwölf Antworten bewertet sind.</p> : attempt.status === 'pending' ? <p>Antwort gespeichert. Der Lehrer-Agent bewertet sie.</p> : attempt.status === 'ungraded' ? <p>Antwort gespeichert – ohne verbindliche Note. Eine KI-Bewertung kann später angefordert werden.</p> : attempt.status === 'failed' ? <p>Die Bewertung steht noch aus. Du kannst sie erneut anfordern.</p> : attempt.evaluation && <><strong>{task.kind==='free_speech'?'Inhalt und Sprache: ':''}{Math.round(attempt.evaluation.score)} / 100 · {attempt.evaluation.verdict === 'correct' ? 'Richtig' : attempt.evaluation.verdict === 'partial' ? 'Teilweise richtig' : 'Noch üben'}</strong><p>{attempt.evaluation.feedback}</p>{attempt.evaluation.issues?.map((issue, i) => <p key={i}>{issue}</p>)}</>}
{task.kind==='free_speech'&&<p>Erkannter Text: {attempt.answer}</p>}
{attempt.speech && <p>Aussprache: {Math.round(attempt.speech.overall_score)} / 100</p>}
{task.answer_key && <><p>{task.answer_key.explanation}</p>{attempt?.status === 'ungraded' && <><p>Zum Selbstvergleich, ohne Benotung:</p><ul>{task.answer_key.rubric?.map((rule,i)=><li key={i}>{rule}</li>)}</ul></>}{task.answer_key.reference_answer && <p lang={task.target_language} dir="auto">Beispiel: {task.answer_key.reference_answer}</p>}{task.audio_text && <p lang={task.target_language} dir="auto">Hörtext: {task.audio_text}</p>}</>}
</div>}
</div>;
}