Files
yourpart3/docs/BISAYA_COURSE_EXPANSION_IMPLEMENTATION_SPEC.md
Torsten Schulz (local) 9a78bc7c4b
All checks were successful
Deploy to production / deploy (push) Successful in 2m47s
feat(admin): add potential fathers retrieval for character management
- Implemented a new method in AdminService to fetch potential fathers for a given character based on existing relationships.
- Updated AdminController to expose this functionality via a new API endpoint.
- Enhanced adminRouter to include the route for retrieving potential fathers.
- Modified frontend components to allow selection of potential fathers during pregnancy and birth management.
- Updated internationalization files to include new translation keys related to father selection.
2026-03-31 08:50:56 +02:00

1039 lines
24 KiB
Markdown

# Bisaya-Kursausbau: Umsetzungsdokument
## 1. Ziel
Der bestehende Bisaya-Kurs soll von einem kompakten Schnellstart zu einem belastbaren Sprachlernangebot ausgebaut werden.
Das Ziel ist nicht nur:
- Wörter schnell einprägen
- einzelne Sätze wiedererkennen
Sondern:
- häufige Muster aktiv abrufen
- Alltagssituationen sicher bewältigen
- alte Inhalte vertiefen statt nur wiederholen
- neue Inhalte dosiert und adaptiv einführen
Der Kurs soll damit zwischen zwei schlechten Extremen vermeiden:
- zu viel neuer Stoff ohne Konsolidierung
- zu viel stumpfe Wiederholung ohne Fortschritt
## 2. Aktueller Stand
Der aktuelle Bisaya-Kurs ist im System klar als kompakter Einstieg angelegt.
Quelle:
- [create-bisaya-course.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/create-bisaya-course.js)
Der Kurs umfasst nach Phase 5:
- `15 Wochen`
- `150 Lektionen`
- Fokus auf:
- Begrüßung
- Familie
- Fürsorge
- Alltag
- Preise
- einfache Zeitformen
- erste freie Gespräche
Die aktuelle Bezeichnung ist:
- `Bisaya für Familien - Alltag & Stabilisierung`
Das ist als Startkurs sinnvoll, aber nicht ausreichend für stabile Sprachbeherrschung.
## 3. Produktentscheidung
Der bisherige Kurs bleibt fachlich erhalten, wird aber neu eingeordnet:
- nicht mehr als „der Bisaya-Kurs“
- sondern als `Phase 1: Schnellstart / Grundkommunikation`
Darauf bauen weitere Phasen auf.
## 4. Zielbild des neuen Kursmodells
Der neue Bisaya-Lernpfad besteht aus drei Ebenen.
### 4.1 Phase A: Schnellstart
Ziel:
- erste Gespräche führen
- Fürsorge, Familie und Höflichkeit verstehen
- typische Alltagssätze direkt benutzen
Dauer:
- `6 Wochen`
Lernfokus:
- hochfrequente Phrasen
- feste Muster
- erste freie Antworten
### 4.2 Phase B: Alltag
Ziel:
- Alltagskommunikation verbreitern
- mehr Variabilität im Ausdruck
- längere Gespräche verstehen und mittragen
Dauer:
- `8 bis 12 Wochen`
Lernfokus:
- Wohnen
- Kinder
- Gesundheit
- Wege
- Zeit
- Organisation
- soziale Situationen
### 4.3 Phase C: Stabilisierung
Ziel:
- Inhalte langfristig verfügbar machen
- alte Muster flexibel in neuen Situationen verwenden
- freie Produktion deutlich stärken
Dauer:
- `3 bis 6 Monate`
Lernfokus:
- Mischtraining
- Wiederaufnahme alter Inhalte
- aktives Formulieren
- Fehlerreduktion bei ähnlichen Mustern
## 4.4 Konkrete Phasenlabels im System
Für die technische Umsetzung werden drei feste Phasenlabels verwendet:
- `quickstart`
- `daily_life`
- `stabilization`
Diese Phasen sind nicht nur Beschreibung, sondern sollen in Lektionen gespeichert und in der UI sichtbar gemacht werden.
### `quickstart`
Zeitfenster:
- ungefähr Woche `1 bis 6`
Ziel:
- schnell sprechfähige Kernmuster aufbauen
Didaktischer Schwerpunkt:
- häufige Phrasen
- gebrauchsfertige Satzmuster
- einfache Dialoge
- wenig Grammatikballast
Typische Modi:
- `core_input`
- `guided_dialogue`
- erste `pattern_drill`
### `daily_life`
Zeitfenster:
- ungefähr Woche `7 bis 18`
Ziel:
- Alltagssituationen verbreitern und kombinieren
Didaktischer Schwerpunkt:
- Familie
- Besuch
- Kinder
- Gesundheit
- Termine
- Wege
- soziale Reaktionen
Typische Modi:
- `guided_dialogue`
- `pattern_drill`
- `real_life_scenario`
### `stabilization`
Zeitfenster:
- ab ungefähr Woche `19`
Ziel:
- Langzeitverfügbarkeit und Transfer
Didaktischer Schwerpunkt:
- Mischtraining
- Abruf
- Kontrastierung ähnlicher Muster
- freie Produktion
- blockübergreifende Wiederholung
Typische Modi:
- `intensive_review`
- `checkpoint`
- `real_life_scenario`
## 4.5 Konkrete Blocklogik
Die Inhalte werden in Blöcken organisiert.
Empfohlene Größe je Block:
- `6 bis 10` Inhaltslektionen
- danach `1 bis 3` Konsolidierungslektionen
- danach `1` Checkpoint
Blockeinteilung für Bisaya:
1. `Block 1`
- Begrüßung, Höflichkeit, Familie
2. `Block 2`
- Zuhause, Essen, Fürsorge, Wege
3. `Block 3`
- Alltag, Zeit, Preise, Organisation
4. `Block 4`
- Gefühle, Gesundheit, Beziehungen
5. `Block 5`
- Alltagsvertiefung und freie Situationen
6. `Block 6+`
- Stabilisierung und Transfer
## 5. Grundprinzipien für den Ausbau
### 5.1 Nicht nach starrer Vokabelzahl planen
Die Lernmenge pro Lektion wird nicht mehr pauschal über „x Vokabeln“ definiert.
Stattdessen wird pro Lektion die `Lernlast` geschätzt.
Einflussfaktoren:
- Anzahl neuer Einheiten
- Abstraktionsgrad
- Nähe zu bereits Bekanntem
- Grammatikkomplexität
- Produktionsanforderung
Empfehlung:
- leichte Lektion: `6 bis 10` neue Einheiten
- mittlere Lektion: `4 bis 7` neue Einheiten
- schwere Lektion: `2 bis 5` neue Einheiten
Eine Einheit kann sein:
- Wort
- Phrase
- Satzmuster
- Mini-Dialogformel
### 5.2 Muster vor Einzelwörtern
Bisaya soll stärker über gebrauchsfertige Muster gelernt werden.
Beispiel:
- nicht nur `kaon`
- sondern `Nikaon na ka?`
- `Kaon ta.`
- `Gusto ka mokaon?`
### 5.3 Jede Einheit durchläuft vier Stufen
Jede wichtige Spracheinheit soll im Kurs mehrfach auftauchen:
1. `Erkennen`
2. `Abrufen`
3. `Anwenden`
4. `Variieren`
Beispiel:
- erkennen: richtige Übersetzung auswählen
- abrufen: Phrase selbst tippen
- anwenden: passende Dialogantwort wählen
- variieren: ähnliche Situation frei beantworten
## 6. Wiederholungsmodell
## 6.1 Ziel
Wiederholung soll intensiv genug sein, um Vergessen zu verhindern, aber nicht so dominant, dass Lernende stehenbleiben.
## 6.2 Vier Ebenen der Wiederholung
### A. Mikro-Wiederholung innerhalb derselben Lektion
Neuer Stoff taucht in derselben Lektion mehrfach wieder auf, aber in anderer Form.
Beispiel:
- Einführung
- Multiple Choice
- Lückentext
- Dialog
- Sprechimpuls
### B. Kurzintervall-Wiederholung
Neue Inhalte werden nach kurzen Abständen erneut aufgegriffen:
- nach `1 Tag`
- nach `3 Tagen`
- nach `7 Tagen`
Allerdings nur, wenn sie noch nicht stabil wirken.
### C. Intensiv-Wiederholungsphasen
Nach jedem inhaltlichen Block folgt eine gezielte Konsolidierungsphase.
Empfehlung:
- `2 Wochen Aufbau`
- danach `3 bis 5 Tage Intensiv-Wiederholung`
Merkmale:
- kaum neuer Stoff
- hoher Abrufanteil
- viele Mischaufgaben
- mehr aktive Produktion
### D. Spiral-Wiederholung
Frühere Inhalte kommen in späteren Modulen wieder, aber in neuen Kontexten.
Nicht:
- dieselbe Karte nochmal
Sondern:
- neues Umfeld
- neue Satzkombination
- neue Gesprächssituation
Beispiel:
- `Nanay = Mutter`
- später:
- `Asa si Nanay?`
- `Nikaon na si Nanay?`
- `Si Nanay naa sa balay.`
## 6.3 Zielverhältnis neu vs. alt
Die App soll neue und alte Inhalte dynamisch mischen.
Empfohlene Verteilung:
- Start einer neuen Lektionsphase:
- `70 % neu`
- `30 % alt`
- Mitte eines Blocks:
- `50 % neu`
- `50 % alt`
- kurz vor Blockabschluss:
- `30 % neu`
- `70 % alt`
- Intensiv-Wiederholungsphase:
- `10 % neu`
- `90 % alt`
Wichtig:
Nicht alles Alte wiederholen, sondern vor allem:
- fällige Inhalte
- oft falsch beantwortete Inhalte
- ähnliche/verwechselbare Inhalte
- Kernmuster mit hoher Alltagshäufigkeit
## 7. Neue Kursstruktur für Bisaya
Der Ausbau soll den Kurs in inhaltliche Module statt nur in lineare Wochen gliedern.
## 7.1 Phase A: Schnellstart
### Modul 1: Begrüßen, reagieren, höflich sein
- Begrüßungen
- Verabschiedungen
- Danke / Bitte
- nach dem Befinden fragen
- einfache Reaktionen
### Modul 2: Familie und Nähe
- Familienbezeichnungen
- Anredeformen
- Fürsorge
- Nähe und Zuneigung
### Modul 3: Zuhause und Alltag
- Haus
- Räume
- Gegenstände
- Routinen
- Essen und Trinken
### Modul 4: Unterwegs und organisieren
- Richtungen
- Orte
- Fragen nach Wegen
- Zeit und Tagesablauf
- Zahlen, Preise, Einkauf
### Modul 5: Schnellstart-Konsolidierung
- große Wiederholungsblöcke
- Mischdialoge
- erste freie Aufgaben
- blockübergreifender Checkpoint
## 7.2 Phase B: Alltag
### Modul 6: Familie, Kinder, Besuch
- mit Verwandten sprechen
- Kinder und Betreuung
- Besuche und gemeinsamer Alltag
### Modul 7: Gefühle, Bedürfnisse, soziale Reaktionen
- Sorgen
- Freude
- Müdigkeit
- Hunger
- Unsicherheit
- Trost und Reaktion
### Modul 8: Gesundheit und Hilfe
- Beschwerden
- Medikamente
- Arzt / Hilfe holen
- erklären, was los ist
### Modul 9: Termine, Vergangenheit, Zukunft
- gestern / heute / morgen
- Vorhaben
- einfache Erzählung
- Vergangenes und Zukünftiges im Alltag
### Modul 10: Alltag stabilisieren
- längere Szenarien
- Rollenspiele
- Fehlerspots
- Wortschatzfestigung
## 7.3 Phase C: Stabilisierung
### Modul 11: Freies Alltagsgespräch
- längere Reaktionsketten
- Folgefragen
- Umschreiben
- Rückfragen
### Modul 12: Tiefenwiederholung
- Kernmuster aus Phase A und B
- Kontrasttraining
- häufige Fehler
- aktive Produktionsphasen
### Modul 13: Praxis- und Transferphase
- offene Situationen
- variierte Antworten
- Mini-Gespräche
- Abschlussdiagnosen
## 8. Lektionstypen
Die bisherigen Typen `vocab`, `conversation`, `grammar`, `review`, `culture` reichen technisch als Basis, sind didaktisch aber zu grob.
Empfohlen ist eine Erweiterung um fachliche Typen.
### Neue didaktische Typen
- `core_input`
- `pattern_drill`
- `guided_dialogue`
- `recall_session`
- `contrast_session`
- `real_life_scenario`
- `intensive_review`
- `checkpoint`
Diese können technisch entweder:
- als neue `lessonType`-Werte eingeführt werden
oder:
- als neues Feld `didactic_mode`
Erste Empfehlung:
- bestehendes `lessonType` beibehalten
- zusätzlich `didacticMode` ergänzen
So bleiben bestehende Inhalte kompatibel.
## 9. Vorschlag für Datenmodell-Erweiterung
Aktuell vorhanden in [vocab_course_lesson.js](/mnt/share/torsten/Programs/YourPart3/backend/models/community/vocab_course_lesson.js):
- `weekNumber`
- `dayNumber`
- `lessonType`
- `learningGoals`
- `corePatterns`
- `grammarFocus`
- `speakingPrompts`
- `practicalTasks`
- `targetMinutes`
- `targetScorePercent`
- `requiresReview`
Für den Ausbau werden zusätzliche Felder empfohlen.
## 9.1 Neue Felder auf Lektionsebene
- `difficulty_weight`
- numerischer Schwierigkeitswert
- Grundlage für adaptive Freigabe
- `new_unit_target`
- wie viele neue Einheiten diese Lektion ungefähr einführt
- `review_weight`
- wie stark Wiederholung hier dominieren soll
- `didactic_mode`
- z. B. `core_input`, `intensive_review`, `checkpoint`
- `block_number`
- ordnet Lektionen einem Konsolidierungsblock zu
- `phase_label`
- z. B. `quickstart`, `daily_life`, `stabilization`
## 9.2 Neue Felder auf Kurs- oder Fortschrittsebene
Empfehlung für `course progress` bzw. neue itembasierte Progress-Tabelle:
- `item_strength`
- `error_rate`
- `last_seen_at`
- `next_due_at`
- `confusion_group`
- `production_level_reached`
Wichtig:
Langfristig reicht reiner Lektionsfortschritt nicht aus. Sprachlernen muss itembasiert werden.
## 10. Fortschrittslogik
Die Kursseite in [VocabCourseView.vue](/mnt/share/torsten/Programs/YourPart3/frontend/src/views/social/VocabCourseView.vue) ist aktuell stark linear aufgebaut:
- Lektion 1
- Lektion 2
- Lektion 3
Für den Ausbau gilt:
- lineare Struktur darf bleiben
- aber die eigentliche Tageslogik darf nicht nur „nächste Lektion“ sein
## 10.1 Neuer Tagesablauf
Der empfohlene Tagesablauf:
1. `fällige Wiederholungen`
2. `Intensivphase`, falls aktiv
3. `neuer Stoff`, wenn Kapazität frei
4. `kurze Abschlussaktivierung`
## 10.2 Freigabe neuer Inhalte
Neue Lektionen werden nicht mehr nur über die vorige Lektion freigeschaltet.
Stattdessen soll die Freigabe berücksichtigen:
- ob kritische Wiederholungen offen sind
- ob Kernmuster des letzten Blocks grob sitzen
- ob der Nutzer gerade in einer Intensivphase ist
Aber:
- keine totale Blockade
- Fortschritt muss motivierend bleiben
Empfehlung:
- `soft gate` statt `hard gate`
## 11. Trainerlogik
Die Traineransicht soll drei Zustände unterscheiden:
- `neu`
- `wiederholen`
- `vertiefen`
## 11.1 Vertiefen ist kein normales Wiederholen
`Vertiefen` bedeutet:
- alte Inhalte in neuer Form
- mehr Produktion
- mehr Kontrast
- mehr Dialognähe
Beispiele:
- aus MC wird freie Antwort
- aus Wortpaar wird Dialogergänzung
- aus kurzer Phrase wird Mini-Szenario
## 11.2 Intensiv-Wiederholungsphase
Während einer Intensivphase sollen Nutzer nicht das Gefühl haben, festzustecken.
Darum braucht die Oberfläche:
- klare Kennzeichnung
- sichtbaren Sinn
- sichtbares Ende
Beispiel:
- `Intensivphase 2/4`
- `Heute festigst du Woche 1 und 2`
- `Danach öffnet sich Modul 3`
## 12. UI-Anpassungen
## 12.1 Kursübersicht
In [VocabCourseView.vue](/mnt/share/torsten/Programs/YourPart3/frontend/src/views/social/VocabCourseView.vue):
- statt nur `x Lektionen`
- auch sichtbar machen:
- Phase
- Modul
- Intensivblöcke
- Checkpoints
## 12.2 Lektion
In [VocabLessonView.vue](/mnt/share/torsten/Programs/YourPart3/frontend/src/views/social/VocabLessonView.vue):
- stärker unterscheiden zwischen:
- neuer Stoff
- vertiefender Stoff
- Wiederholung
- Intensivphase
- sichtbare Lernabsicht pro Lektion:
- `Heute neu`
- `Heute festigen`
- `Heute abrufen`
## 12.3 Startseite für Sprachkurse
Empfohlen:
- `Heute fällig`
- `Heute neu möglich`
- `kritische Muster`
- `nächster Intensivblock`
## 13. Inhalte für Bisaya konkret
Für Bisaya sollen zunächst diese Ausbaupakete entstehen.
## Paket A: Schnellstart vertiefen
Ziel:
- bestehenden 4-Wochen-Kurs auf `6 Wochen` erweitern
- mehr Muster
- mehr freie Antworten
- erste echte Intensivphasen
Umfang:
- vorhandene Lektionen überarbeiten
- zusätzliche Lektionen für:
- Hör-/Sprechmuster
- Kontrasttraining
- Alltagsszenarien
## Paket B: Alltagsmodule ergänzen
Neue Module:
- Besuche und Gastgeber-Situationen
- Kinder und Familie
- Gesundheit
- Erledigungen und Termine
- soziale Fragen und Hilfen
## Paket C: Stabilisierung
Neue Blöcke:
- Dialogtage
- Mischtraining
- Fehlerschwerpunkte
- große Wiederholungsphasen
## 14. Empfohlene Umsetzung in Phasen
## Phase 1: Didaktische Infrastruktur
Ziel:
- System auf adaptive Kurslogik vorbereiten
Umfang:
- neue didaktische Felder ergänzen
- Intensivphasen im Progress-Modell vorbereiten
- UI-Kennzeichnung für `neu`, `wiederholen`, `vertiefen`
Konkreter Lieferumfang:
- Phase- und Fokusfelder auf Lektionsebene
- Datenbankmigration
- SQL-Skript für manuelle Einspielung
- Service-Fallbacks für bestehende Lektionen ohne gepflegte Felder
- Kursübersicht zeigt Phase, Fokus, Block und Intensivwiederholung
- Lektionsansicht zeigt Phase, Fokus, neue Einheiten und Wiederholungsgewicht
Bewusst noch nicht enthalten:
- adaptive itembasierte Terminierung
- neue große Bisaya-Contentpakete
- kompletter Umbau der Progress-Logik
## Phase 2: Bestehenden Bisaya-Kurs überarbeiten
Ziel:
- vorhandenen Kurs nicht wegwerfen, sondern fachlich umbauen
Umfang:
- 40 Lektionen neu clustern
- Intensivblöcke einziehen
- leichte und schwere Lektionen neu gewichten
- mehr Produktionsaufgaben ergänzen
Konkrete Zuordnung für den bestehenden 4-Wochen-Kurs:
1. `Block 1 / quickstart / Lektion 1-10`
- Begrüßung, Überlebenssätze, Familie, Fürsorge
- Abschluss mit `Woche 1 - Wiederholung` als `intensive_review`
- Abschluss mit `Woche 1 - Vokabeltest` als `checkpoint`
2. `Block 2 / quickstart / Lektion 11-20`
- Alltag, Wege, Zeit, Einkauf
- Abschluss mit `Woche 2 - Wiederholung` als `intensive_review`
- Abschluss mit `Woche 2 - Vokabeltest` als `checkpoint`
3. `Block 3 / daily_life / Lektion 21-30`
- Gefühle, Gesundheit, Höflichkeit, Kinder
- Abschluss mit `Woche 3 - Wiederholung` als `intensive_review`
- Abschluss mit `Woche 3 - Vokabeltest` als `checkpoint`
4. `Block 4 / stabilization / Lektion 31-40`
- freie Gespräche, Transfer, große Wiederholungswellen
- `32`, `34` und `36` als intensive Wiederholungsphasen
- `38` und `39` als abschließende Checkpoints
Technische Umsetzung von Phase 2:
- neues Mapping für alle 40 Bisaya-Lektionen in
- [bisaya-course-phase2-pedagogy.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase2-pedagogy.js)
- Erzeugung neuer Kurse schreibt diese Felder direkt mit
- [create-bisaya-course.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/create-bisaya-course.js)
- Refresh bestehender Kurse pflegt dieselben Werte nach
- [apply-bisaya-course-refresh.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/apply-bisaya-course-refresh.js)
- [update-bisaya-didactics.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/update-bisaya-didactics.js)
- manuelles SQL-Backfill für bestehende Datenbanken
- [backfill_bisaya_phase2_pedagogy.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/backfill_bisaya_phase2_pedagogy.sql)
## Phase 3: Kurs in 6-Wochen-Schnellstart ausbauen
Ziel:
- aktuelles Niveau sinnvoll vertiefen
Umfang:
- zusätzliche Lektionen
- mehr Dialoge
- mehr Abruftraining
- mehr Spiralwiederholung
Konkrete Umsetzung:
1. `Woche 5`
- Besuch & Gastfreundschaft
- Besuch & Haushalt
- Fragen im Alltag vertiefen
- Termine & Verabredungen
- zwei intensive Wiederholungswellen plus Checkpoint
2. `Woche 6`
- Unterwegs & Transport
- Arbeit & Aufgaben
- freies Gespräch zu Familie und Alltag
- Konflikte & Missverständnisse
- große Spiralwiederholung
- Schnellstart-Abschlusstest und Abschlussprüfung
Technische Umsetzung:
- neue Lektionen `41` bis `60` in
- [bisaya-course-phase3-extension.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase3-extension.js)
- bestehender Kursgenerator erweitert
- [create-bisaya-course.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/create-bisaya-course.js)
- Nachrüstskript für bestehende Kurse
- [extend-bisaya-course-phase3.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/extend-bisaya-course-phase3.js)
- SQL für Titel-/Beschreibungsumstellung
- [extend_bisaya_course_phase3_to_6_weeks.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/extend_bisaya_course_phase3_to_6_weeks.sql)
## Phase 4: Alltagsphase ergänzen
Ziel:
- aus Einstieg einen echten Alltagskurs machen
Umfang:
- neue Module 6 bis 10
- Ausbau auf 3-Monats-Pfad
Konkrete Umsetzung:
1. `Woche 7`
- Kinder im Alltag
- Schule & Betreuung
- Hausaufgaben, Routine und Spiel
2. `Woche 8`
- Arzt, Apotheke und Pflege
- Beschwerden, Hilfe und Genesung
3. `Woche 9`
- Einkaufen vertiefen
- Markt, Bank, Dokumente und Behördengänge
4. `Woche 10`
- Nachbarschaft, Hilfe, Einladungen und soziale Reaktionen
- Konflikte und Gefühle im Gespräch
5. `Woche 11`
- Zuhause organisieren
- Haushalt, Reparaturen, Planung und Alltagslogistik
6. `Woche 12`
- freie Alltagsgespräche
- Mischtraining
- Fehlerschwerpunkte
- Abschlussprüfung der Alltagsphase
Technische Umsetzung:
- neue Lektionen `61` bis `120` in
- [bisaya-course-phase4-extension.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase4-extension.js)
- Pädagogik-Mapping erweitert bis Lektion `120`
- [bisaya-course-phase2-pedagogy.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase2-pedagogy.js)
- bestehender Kursgenerator erweitert
- [create-bisaya-course.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/create-bisaya-course.js)
- Nachrüstskript für bestehende Kurse
- [extend-bisaya-course-phase4.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/extend-bisaya-course-phase4.js)
- SQL für Titel-/Beschreibungsumstellung
- [extend_bisaya_course_phase4_to_3_months.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/extend_bisaya_course_phase4_to_3_months.sql)
## Phase 5: Stabilisierungsphase ergänzen
Ziel:
- langfristige Verfügbarkeit
Umfang:
- Tiefenwiederholung
- freie Produktion
- große Misch- und Checkpointformate
Konkrete Umsetzung:
1. `Woche 13`
- erster Stabilisierungsblock
- große Dialogtage
- Fehlerschwerpunkte
- freie Produktion
2. `Woche 14`
- zweiter Stabilisierungsblock
- erneutes Fehlertraining
- mehr Rollenspiele und Transfer
3. `Woche 15`
- großes Mischreview
- Langzeitreview
- Gesamtabschluss des Pfads
Technische Umsetzung:
- neue Lektionen `121` bis `150` in
- [bisaya-course-phase5-extension.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase5-extension.js)
- Pädagogik-Mapping erweitert bis Lektion `150`
- [bisaya-course-phase2-pedagogy.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/bisaya-course-phase2-pedagogy.js)
- bestehender Kursgenerator erweitert
- [create-bisaya-course.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/create-bisaya-course.js)
- Nachrüstskript für bestehende Kurse
- [extend-bisaya-course-phase5.js](/mnt/share/torsten/Programs/YourPart3/backend/scripts/extend-bisaya-course-phase5.js)
- SQL für Titel-/Beschreibungsumstellung
- [extend_bisaya_course_phase5_to_stabilization.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/extend_bisaya_course_phase5_to_stabilization.sql)
## 15. Konkrete nächste technische Schritte
### 15.1 Backend
- Migration für zusätzliche Lektionsfelder
- Anpassung der Course-/Lesson-APIs
- Vorbereitung itembasierten Fortschritts
### 15.1.1 Echte SQLs für Phase 1
Die SQL-Datei liegt in:
- [add_vocab_lesson_phase1_fields.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/add_vocab_lesson_phase1_fields.sql)
Verwendeter SQL-Block:
```sql
ALTER TABLE community.vocab_course_lesson
ADD COLUMN IF NOT EXISTS didactic_mode TEXT,
ADD COLUMN IF NOT EXISTS phase_label TEXT,
ADD COLUMN IF NOT EXISTS block_number INTEGER,
ADD COLUMN IF NOT EXISTS difficulty_weight INTEGER,
ADD COLUMN IF NOT EXISTS new_unit_target INTEGER,
ADD COLUMN IF NOT EXISTS review_weight INTEGER,
ADD COLUMN IF NOT EXISTS is_intensive_review BOOLEAN NOT NULL DEFAULT FALSE;
```
Kommentare:
```sql
COMMENT ON COLUMN community.vocab_course_lesson.didactic_mode IS
'Didaktischer Modus der Lektion, z.B. core_input, guided_dialogue, intensive_review oder checkpoint.';
COMMENT ON COLUMN community.vocab_course_lesson.phase_label IS
'Übergeordnete Lernphase, z.B. quickstart, daily_life oder stabilization.';
COMMENT ON COLUMN community.vocab_course_lesson.block_number IS
'Inhaltlicher Block für Konsolidierungs- und Wiederholungswellen.';
COMMENT ON COLUMN community.vocab_course_lesson.difficulty_weight IS
'Grobe relative Schwierigkeit der Lektion von leicht bis schwer.';
COMMENT ON COLUMN community.vocab_course_lesson.new_unit_target IS
'Empfohlene Zahl neuer Spracheinheiten in dieser Lektion.';
COMMENT ON COLUMN community.vocab_course_lesson.review_weight IS
'Wie stark Wiederholung in dieser Lektion dominieren soll, typischerweise 0 bis 100.';
COMMENT ON COLUMN community.vocab_course_lesson.is_intensive_review IS
'Markiert Lektionen, die als intensive Wiederholungsphase gedacht sind.';
```
### 15.1.2 Echte SQLs für Phase 2
Die SQL-Datei liegt in:
- [backfill_bisaya_phase2_pedagogy.sql](/mnt/share/torsten/Programs/YourPart3/backend/sql/backfill_bisaya_phase2_pedagogy.sql)
Sie pflegt für bestehende Bisaya-Kurse die Felder
- `phase_label`
- `block_number`
- `didactic_mode`
- `difficulty_weight`
- `new_unit_target`
- `review_weight`
- `is_intensive_review`
für die Lektionen `1` bis `40` explizit nach.
### 15.2 Frontend
- Kursübersicht mit Phasen- und Blockdarstellung
- Traineransicht mit Zustand `neu / vertiefen / wiederholen`
- Kennzeichnung von Intensivphasen
### 15.3 Content
- Bestandsaudit des Bisaya-Kurses
- Definition der Kernmuster pro Modul
- Ausbau der Lektionen um Kontrast- und Produktionsaufgaben
## 16. Entscheidungsempfehlung
Empfohlen ist:
1. den bisherigen Kurs offiziell als `Schnellstart` einordnen
2. die Wiederholungslogik zuerst verbessern
3. erst danach große Mengen neuer Inhalte hinzufügen
Begründung:
Ein größerer Kurs ohne bessere Konsolidierung verschärft nur das bestehende Problem.
Die richtige Reihenfolge ist:
- erst didaktische Struktur
- dann Ausbau
- dann Langzeitstabilisierung
## 17. Priorisierte erste Lieferung
Wenn nur ein begrenzter erster Schritt umgesetzt werden soll, dann dieser:
1. Bisaya-Kurs auf `6 Wochen` erweitern
2. nach je 2 Wochen eine `Intensiv-Wiederholungsphase` einbauen
3. Trainer technisch auf `neu / vertiefen / wiederholen` umstellen
4. die aktuellen 40 Lektionen nach Lernlast neu gewichten
Das ist der kleinste sinnvolle Ausbau, der didaktisch bereits einen echten Unterschied macht.