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
+3
View File
@@ -49,3 +49,6 @@ print('PASS: 144 reviewed grammar keys, 144 contextual vocabulary items, 144 fac
from variants import audit as audit_variants
audit_variants()
from sequences import audit as audit_sequences
audit_sequences()
+3
View File
@@ -79,3 +79,6 @@ if __name__=='__main__':
build()
from variants import build as build_variants
build_variants()
from sequences import build as build_sequences
build_sequences()
+2 -2
View File
@@ -18,8 +18,8 @@
"Open speaking content/language criteria are separated from Azure pronunciation scores."
],
"sources": {
"audit.py": "ec8ad1842390b03ef366726e81baa3f6d24d03165e83aff757de876918e036cf",
"build.py": "e9c047217c6b850e98d88c1ea86995e74fd398915089f51f9552a52c7eb3e077",
"audit.py": "fd41c4c6fcd06b5ce764435393c262e1d0f6c510a598a60b5c0c5bef393b38a3",
"build.py": "9d44b6ecfb3412d520e8e33197b82a09ce9d7b0e6af8ccf463f386082e3f291a",
"daily_life.grammar.txt": "0b84ee5b65e2fdf63add826c372c1438215a48c9731c266601ba9160e0e25192",
"daily_life.stories.txt": "62bd24776fd4bbbdf7bf5e926f1452f7720e8b061394dced91ff7cc46aed2e03",
"daily_life.vocabulary.txt": "4db8b0cf43b1f154e315cefe82970e32e410e61edb047d517ad7310e5aff23aa",
+30
View File
@@ -0,0 +1,30 @@
{
"revision": "thematic-A1-v1",
"reviewed": true,
"sequence_count": 60,
"reviewer": "Codex editorial pass",
"method": "Explicit topical linking of existing listening/reading scenes to related word meanings, spoken models, grammar patterns, short translation and matching open writing/speech. Related models deliberately use different names/details. Participation is not mastery. No independent teacher certification.",
"sources": {
"sequence_sources.json": "f09b3b845fcaee948b0dca211f2c644e649597151563e4c7b8d89bb1aad1ad2a",
"sequences.py": "a20f985ccf180b66b537692eb38fc81061c63e8e32aa9c2ff7ace61b6e43f72a",
"daily_life.grammar.txt": "0b84ee5b65e2fdf63add826c372c1438215a48c9731c266601ba9160e0e25192",
"daily_life.stories.txt": "62bd24776fd4bbbdf7bf5e926f1452f7720e8b061394dced91ff7cc46aed2e03",
"daily_life.vocabulary.txt": "4db8b0cf43b1f154e315cefe82970e32e410e61edb047d517ad7310e5aff23aa",
"family.grammar.txt": "2f30205b3f17a45f6f2272a4cf616cb6a7abc73f2af808be16a3b14983121c3e",
"family.stories.txt": "caf8363c09831106c592a6323d65f28c46b4a71dab5263bd8e71346c4c1fc89e",
"family.vocabulary.txt": "226ca654d0cb00ce64da9e9f2b5885f3a0b086833dddf6e95a8149cdf071cee3",
"food_shopping.grammar.txt": "da585dbb71ee6855010272433a1c4d589b49b8137bfa2f4504292f34a4f12481",
"food_shopping.stories.txt": "7bab84c03180d8760c618804e530a93ec042c57b4ffd504f4269edeb94f7ffd9",
"food_shopping.vocabulary.txt": "cdb19da92e611f439d435c79a2f7c70544a8deeedb4774726d80edd01a1bccd6",
"home_city.grammar.txt": "7622f06c27441cb7a8e9874c40ab3b8b4ce8bd225e461be6cadc1867849d1f1d",
"home_city.stories.txt": "df55a7d643ae76eb6edc3956da15ff91daa66620a07f7af3072ad3ec675bc462",
"home_city.vocabulary.txt": "28701a513c4119f110a6dbcd8cc32b704db018a674e58fc41f9975cf5b5a5fd5",
"introductions.grammar.txt": "63908be080f56268d3cf0ea03f827177d332d4a23f1e01c5a3fbb513e8b2eccf",
"introductions.stories.txt": "d187cc61ad8873c5a8c53d956f7b723689218364cce5e196c59ebbadda48405c",
"introductions.vocabulary.txt": "c120cdb9ccf7d70c1f61c8fcbee0bcffc8e474ceae420edcb9c59eee8b2356f1",
"numbers_time.grammar.txt": "33b50bd88db2b78af7de93bd81be1442912ce4519bccd10d5da2b78f6f4c33b9",
"numbers_time.stories.txt": "1127477a8f80c613f94c838c0c80d5c9176e1a6eef7bcc8a72b4e95d5cb1245f",
"numbers_time.vocabulary.txt": "fa2d4b1284f3d89789d3b25310739f62356361d090489f995d8734a306fbeef0",
"open_instructions.json": "dc6e2239a146080c8eb2f6d54f3877c5e01afaa9d4b196104184bb6623f24728"
}
}
File diff suppressed because it is too large Load Diff
+56
View File
@@ -0,0 +1,56 @@
"""Reviewed thematic links between immutable tasks; never changes task content."""
import hashlib
import json
import pathlib
BASE = pathlib.Path(__file__).resolve().parent
DEST = BASE.parents[1] / 'apps/api/internal/store/coursebank'
def compile_sequences():
review_bytes = (BASE / 'sequence_review.json').read_bytes()
review = json.loads(review_bytes)
assert review['reviewed']
for name, digest in review['sources'].items():
assert hashlib.sha256((BASE / name).read_bytes()).hexdigest() == digest, f'Sequence review is stale: {name}'
source = json.loads((BASE / 'sequence_sources.json').read_text())
entries = {}
for path in (DEST / 'en-US/a1-v2').glob('*.json'):
if path.name != 'manifest.json':
entries[path.name] = json.loads(path.read_text())
sequences = []
for module, rows in source['modules'].items():
for scene, vocab, repeats, grammar, writing, de, ru in rows:
steps = []
for phase, skill, numbers in [('listen', 'listening', [scene]), ('vocabulary', 'vocabulary', vocab), ('read', 'reading', [scene]), ('repeat', 'speaking', repeats), ('grammar', 'grammar', grammar), ('write', 'writing', writing), ('compose', 'writing', [scene]), ('speak', 'speaking', [scene])]:
for number in numbers:
entry = entries[f'{module}.{skill}.json'][number - 1]
expected = {'listen':'choice','vocabulary':'choice','read':'choice','repeat':'repeat_sentence','grammar':'choice','write':'short_text','compose':'free_text','speak':'free_speech'}[phase]
assert entry['task']['kind'] == expected
steps.append(dict(phase=phase, bank_entry_id=entry['id']))
sequences.append(dict(id=f'{module}_scene_{scene:02d}', module_id=f'a1_{module}_v1', titles={'de-DE':de,'ru-RU':ru}, steps=steps))
assert len(sequences) == review['sequence_count'] == 60
return dict(revision=source['revision'], editorial_review_sha256=hashlib.sha256(review_bytes).hexdigest(), sequences=sequences)
def build():
data = (json.dumps(compile_sequences(),ensure_ascii=False,indent=2)+'\n').encode()
(DEST/'sequences.json').write_bytes(data)
(DEST/'sequence_manifest.json').write_text(json.dumps({'sha256':hashlib.sha256(data).hexdigest()},indent=2)+'\n')
print('Wrote 60 thematic learning sequences in six modules; no task content changed.')
def audit():
data = (DEST/'sequences.json').read_bytes()
assert hashlib.sha256(data).hexdigest() == json.loads((DEST/'sequence_manifest.json').read_text())['sha256']
assert json.loads(data) == compile_sequences()
for seq in json.loads(data)['sequences']:
assert seq['steps'][0]['phase']=='listen' and seq['steps'][-1]['phase']=='speak'
assert all(seq['titles'][lang] for lang in ('de-DE','ru-RU'))
assert seq['steps'][-2]['phase']=='compose'
assert seq['steps'][-2]['bank_entry_id'].replace('_writing_','_speaking_') == seq['steps'][-1]['bank_entry_id']
print('PASS: 60 reviewed thematic sequences, listening first and free speaking after related recognition, repeat, grammar and writing; immutable task links.')
if __name__ == '__main__':
build()
audit()