Files
Speech/apps/api/internal/domain/adaptive.go
T
Eugenius Naumenko 7499491ae8 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.
2026-11-11 17:51:32 +00:00

190 lines
8.3 KiB
Go

package domain
import "time"
const CourseVersion = "a1-v2"
var CourseSkills = []string{"grammar", "vocabulary", "listening", "reading", "speaking", "writing"}
type AdaptiveModule struct {
ID string `json:"id"`
Key string `json:"key"`
Title string `json:"title"`
Description string `json:"description"`
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
Goals []string `json:"goals"`
Order int `json:"order"`
}
type CoursePack struct {
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
Modules []AdaptiveModule `json:"modules"`
Reserves []AdaptiveTask `json:"reserves"`
}
type TaskOption struct {
ID string `json:"id"`
Label string `json:"label"`
Language string `json:"language,omitempty"`
Role string `json:"role,omitempty"`
}
type TaskKey struct {
CorrectOptionID string `json:"correct_option_id,omitempty"`
ReferenceAnswer string `json:"reference_answer,omitempty"`
ReferenceAnswerLanguage string `json:"reference_answer_language,omitempty"`
Rubric []string `json:"rubric"`
Explanation string `json:"explanation"`
}
// TaskStimulus is public exercise material, separate from the instruction.
// Private listening text remains AudioText and is excluded by Public(false).
type TaskStimulus struct {
Role string `json:"role"`
Language string `json:"language"`
Text string `json:"text"`
}
type AdaptiveTask struct {
SchemaVersion int `json:"schema_version"`
ID string `json:"id,omitempty"`
ModuleID string `json:"module_id"`
OriginModuleKey string `json:"origin_module_key,omitempty"`
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
CEFRLevel string `json:"cefr_level"`
Skill string `json:"skill"`
Kind string `json:"kind"`
Prompt string `json:"prompt"`
Passage string `json:"passage,omitempty"`
Options []TaskOption `json:"options,omitempty"`
ReferenceText string `json:"reference_text,omitempty"`
AudioText string `json:"audio_text,omitempty"`
AnswerKey *TaskKey `json:"answer_key,omitempty"`
Source string `json:"source,omitempty"`
BriefID string `json:"brief_id,omitempty"`
ExamID string `json:"exam_id,omitempty"`
Review bool `json:"review,omitempty"`
CreatedAt time.Time `json:"created_at,omitempty"`
InstructionLanguage string `json:"instruction_language,omitempty"`
Instruction string `json:"instruction,omitempty"`
Stimulus *TaskStimulus `json:"stimulus,omitempty"`
VariantID string `json:"variant_id,omitempty"`
ContentRevision string `json:"content_revision,omitempty"`
CanonicalTaskID string `json:"canonical_task_id,omitempty"`
EvidenceTaskID string `json:"evidence_task_id,omitempty"`
}
func (t AdaptiveTask) Public(reveal bool) AdaptiveTask {
t.EvidenceTaskID = ""
if !reveal {
t.AnswerKey = nil
t.AudioText = ""
}
return t
}
type CourseEvaluation struct {
Score float64 `json:"score"`
Verdict string `json:"verdict"`
Feedback string `json:"feedback"`
Issues []string `json:"issues"`
}
type AdaptiveAttempt struct {
ID string `json:"id"`
TaskID string `json:"task_id"`
ModuleID string `json:"module_id"`
TargetLanguage string `json:"target_language"`
Skill string `json:"skill"`
Answer string `json:"answer"`
Status string `json:"status"`
Evaluation *CourseEvaluation `json:"evaluation,omitempty"`
Speech *PronunciationResult `json:"speech,omitempty"`
ExamID string `json:"exam_id,omitempty"`
Demo bool `json:"demo"`
CreatedAt time.Time `json:"created_at"`
}
type SkillProgress struct {
ModuleID string `json:"module_id"`
Skill string `json:"skill"`
Attempts int `json:"attempts"`
DistinctTasks int `json:"distinct_tasks"`
AverageScore float64 `json:"average_score"`
EvidenceID string `json:"evidence_id"`
}
type ModuleAnalysis struct {
ModuleID string `json:"module_id"`
Strengths []string `json:"strengths"`
Weaknesses []string `json:"weaknesses"`
Recommendation string `json:"recommendation"`
Reason string `json:"reason"`
EvidenceIDs []string `json:"evidence_ids"`
ReadyForCompletion bool `json:"ready_for_completion"`
}
type CourseAnalysis struct {
SchemaVersion int `json:"schema_version"`
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
FactsVersion int64 `json:"facts_version"`
Summary string `json:"summary"`
RecommendedModuleID string `json:"recommended_module_id"`
Modules []ModuleAnalysis `json:"modules"`
CreatedAt time.Time `json:"created_at"`
}
type CourseSnapshot struct {
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
CEFRLevel string `json:"cefr_level"`
UILanguage string `json:"ui_language"`
FactsVersion int64 `json:"facts_version"`
Modules []AdaptiveModule `json:"curriculum"`
Progress []SkillProgress `json:"progress"`
RecentTasks []AdaptiveTask `json:"recent_tasks"`
RecentAttempts []AdaptiveAttempt `json:"recent_attempts"`
PreviousAnalysis *CourseAnalysis `json:"previous_analysis,omitempty"`
RecentPrompts []string `json:"recent_prompts"`
}
type CourseBrief struct {
SchemaVersion int `json:"schema_version"`
ID string `json:"id,omitempty"`
ModuleID string `json:"module_id"`
TargetLanguage string `json:"target_language"`
CourseVersion string `json:"course_version"`
Skill string `json:"skill"`
Kind string `json:"kind"`
Objective string `json:"objective"`
Difficulty string `json:"difficulty"`
Reason string `json:"reason"`
}
type CourseJob struct {
Recommendation *SequenceRecommendation `json:"recommendation,omitempty"`
InstructionLanguage string `json:"instruction_language"`
AIRevision int `json:"-"`
ID string `json:"id"`
UserID string `json:"-"`
Language string `json:"target_language"`
Kind string `json:"kind"`
ModuleID string `json:"module_id"`
Skill string `json:"skill,omitempty"`
SubjectID string `json:"subject_id,omitempty"`
Status string `json:"status"`
Stage string `json:"stage"`
TaskID string `json:"task_id,omitempty"`
Source string `json:"source,omitempty"`
Review bool `json:"review,omitempty"`
Error string `json:"error,omitempty"`
Lease string `json:"-"`
}
type AdaptiveExam struct {
PreparationJobID string `json:"preparation_job_id,omitempty"`
SummaryStatus string `json:"summary_status,omitempty"`
SummaryJobID string `json:"summary_job_id,omitempty"`
ID string `json:"id"`
TargetLanguage string `json:"target_language"`
Status string `json:"status"`
Tasks []AdaptiveTask `json:"tasks"`
Attempts []AdaptiveAttempt `json:"attempts"`
Scores map[string]float64 `json:"scores,omitempty"`
Score *float64 `json:"score,omitempty"`
Summary string `json:"summary,omitempty"`
}