chineseclass/docs/Chinese-Learning-System.md

Chinese Learning System - Application du ULLF

Basé sur : Universal Language Learning Framework v1.1

---

1. Configuration Langue

language:
  name: "Chinois (Mandarin)"
  code: "zh-CN"
  level: "Intermediate (Zhongyi)"
  target: "Parler avec ma femme en chinois"

---

2. Les 5 Books Zhongyi

2.0 Types de Segments

Les 5 books se divisent en 2 catégories :

Skill Segments (4 books)

Développent une compétence linguistique spécifique :

• Kouyu (口语) → Speaking
• LEDU (乐读) → Reading
• Tingli (听力) → Listening
• Xiezuo (写作) → Writing

Foundation Segment (1 book)

Construit les fondations (grammaire + vocabulaire) qui supportent toutes les skills :

• Hanyu Jiaocheng (汉语教程) → Grammar/Vocabulary Foundation

Important : Hanyu n'est PAS une skill en soi, c'est un enabler. Les exams pour ce book testent la compréhension grammaticale et la maîtrise du vocabulaire, pas la production libre.

2.1 Inventaire complet

Book	Segment Type	Chapitres	Pages/chap	Total pages	Densité	Status actuel
LEDU (乐读)	Reading (Skill)	12	15	180	Dense	Ch 1-4 en JSON
Kouyu (口语)	Speaking (Skill)	12	16	192	Dense	À digitaliser
Hanyu Jiaocheng (汉语教程)	Foundation	13	17	221	Très dense	Ch 1-5 en MD
Tingli (听力)	Listening (Skill)	30	4	120	Léger	Ch 4-8 en MD
Xiezuo (写作)	Writing (Skill)	6	6	36	Léger	Ch 1-6 en MD

Total : 73 chapters, ~749 pages

2.2 Répartition par densité

Dense (nécessite plus de temps) :

• Kouyu : 12 ch × 16 pages = 192 pages
• Hanyu : 13 ch × 17 pages = 221 pages
• LEDU : 12 ch × 15 pages = 180 pages

Léger (plus rapide) :

• Tingli : 30 ch × 4 pages = 120 pages
• Xiezuo : 6 ch × 6 pages = 36 pages

---

3. Schedule Hebdomadaire

3.1 Assignation fixe par jour

Jour	Segment	Book	Type de contenu
Lundi	Speaking	Kouyu	Dense (16 pages)
Mardi	Foundation	Hanyu Jiaocheng	Très dense (17 pages)
Mercredi	Reading	LEDU	Dense (15 pages)
Jeudi	Listening	Tingli	Léger (4 pages)
Vendredi	Writing	Xiezuo	Léger (6 pages)
Samedi	Custom/Support	Variable	Review, catch-up, weak points
Dimanche	FREE	-	Repos, absence, ou rattrapage

3.2 Rythme NEW vs REVIEW

Objectif hebdomadaire (semaines 1-3) :

• 2-3 nouveaux chapters/semaine
• 3-4 reviews/semaine
• Total : 6 chapters/semaine

Pattern suggéré sur 3 semaines :

Semaine	Lun (Kouyu)	Mar (Hanyu)	Mer (LEDU)	Jeu (Tingli)	Ven (Xiezuo)	Sam (Support)
S1	NEW	NEW	REVIEW	NEW	REVIEW	REVIEW
S2	REVIEW	REVIEW	NEW	NEW	REVIEW	REVIEW
S3	REVIEW	NEW	REVIEW	NEW	REVIEW	REVIEW

Résultat : ~9 NEW / ~9 REVIEW sur 3 semaines

---

4. Cycle Mensuel

4.1 Semaines 1-3 : Learning + Review

Chaque jour (1-2h) :

• 60-70% : Nouveau contenu OU Review SRS principal
• 20-30% : Multiple reviews (L1, L2, L3, L4)
• 10% : 3 jeux par chapter complété

Speaking practice :

• Lundi (Kouyu day) : Focus speaking avec le chapter
• Autres jours : Intégré dans les games quand applicable
• Solution technique pour speaking quotidien : À développer plus tard

4.2 Semaine 4 : EXAM WEEK

Structure :

Jour	Exam	Book testé	Durée
Lundi	Speaking	Kouyu (chapters du mois)	45min
Mardi	Foundation	Hanyu (chapters du mois)	60min
Mercredi	Reading	LEDU (chapters du mois)	45min
Jeudi	Listening	Tingli (chapters du mois)	45min
Vendredi	Writing	Xiezuo (chapters du mois)	45min
Samedi	Correction	Tous les exams	2-3h
Dimanche	Sit Rep	Génération rapport mensuel	1h

Exams coverage :

• Contenu des 3 dernières semaines (~9 nouveaux chapters)
• Tous les reviews effectués
• Grammar/vocab de tous les chapters touchés

---

5. Spaced Repetition System

5.1 Schedule de review par chapter

Quand tu complètes un chapter (jour 0), il entre dans le cycle :

Level	Timing	Durée	Activités
NEW	Day 0	1-2h	Study complet + 3 games
L1	Day 1	10min	Flash vocab + grammar recall
L2	Day 3	20min	Redo exercises + flashcards
L3	Day 7	30min	Production (speak/write with content)
L4	Day 14	30min	Advanced production + integration
L5	Day 30	Exam	Testé dans exam mensuel
MASTERED	After exam >80%	-	Chapter maîtrisé

5.2 Tracking SRS

Chaque chapter a un status dans le système :

NEW → L1 → L2 → L3 → L4 → L5 (exam) → MASTERED

Le samedi (jour Support) est idéal pour faire les reviews L3/L4 qui prennent plus de temps.

---

6. Game System (3 per chapter)

6.1 Structure des jeux

Game 1 : Vocabulary Challenge

• Matching game chinois-français
• Flashcards interactives avec pinyin
• Quiz rapide de reconnaissance
• Data : vocab du chapter avec pronunciation, meaning, examples

Game 2 : Grammar Pattern Practice

• Sentence building puzzles
• Transformation exercises (ex: transformer en 把 sentence)
• Fill-in-the-blank avec structures
• Data : grammar patterns du chapter avec exemples

Game 3 : Production Game

• Speaking prompts avec vocab imposé
• Writing challenges avec contraintes
• Listening comprehension puzzles
• Role-play scenarios
• Data : contextes réels utilisant le contenu du chapter

6.2 Integration classGen

Format JSON pour chaque game :

{
  "chapter_id": "ledu-chapter1",
  "games": [
    {
      "id": "game1-vocab",
      "type": "vocabulary-matching",
      "title": "食为天 - Vocabulary Challenge",
      "description": "Match Chinese food vocabulary with meanings",
      "data": {
        "pairs": [
          {"chinese": "重视", "pinyin": "zhòngshì", "meaning": "to attach importance to"},
          // ... more pairs
        ]
      },
      "completion_criteria": {"min_score": 80}
    },
    {
      "id": "game2-grammar",
      "type": "sentence-builder",
      "title": "因此 Pattern Practice",
      "data": {
        "pattern": "...，因此...",
        "examples": [...],
        "exercises": [...]
      }
    },
    {
      "id": "game3-production",
      "type": "speaking-challenge",
      "title": "Restaurant Conversation",
      "data": {
        "scenario": "Order food at a Chinese restaurant",
        "required_vocab": ["味道", "麻辣", "火锅", "口味"],
        "prompts": [...]
      }
    }
  ]
}

---

7. Exam System

7.1 Passing Criteria (Rappel)

• >80% : PASS ✓ - Excellent, continue
• 50-80% : DIFFICULTY ⚠ - Révision nécessaire, identifie les weak points
• <50% : CRITICAL ✗ - Arrête la progression, révision intensive

7.2 Exams par compétence

Lundi - Speaking Exam (Kouyu)

• Monologue 3-5min sur topics du mois
• Q&A spontané (5 questions)
• Production libre avec vocab imposé
• Score : /100 (fluency + vocab usage + grammar + pronunciation)

Mardi - Foundation Exam (Hanyu)

• Grammar patterns (10 phrases à compléter)
• Transformation sentences (6 phrases)
• Production originale (5 phrases)
• Vocabulary mastery (15 mots clés)
• Score : /100 (grammar accuracy + vocab retention + application)

Mercredi - Reading Exam (LEDU)

• Vocabulary test (15 mots)
• Nouveau texte + 10 questions
• Character inference (5 caractères)
• Score : /100 (vocab + comprehension + inference)

Jeudi - Listening Exam (Tingli)

• 2 audios nouveaux + questions
• 1 audio des chapters + questions détaillées
• Dictée (5 phrases)
• Score : /100 (global + detailed + dictation)

Vendredi - Writing Exam (Xiezuo)

• Écriture guidée 150-200 caractères (10 vocab imposés)
• Écriture libre 150-200 caractères
• Correction d'erreurs (10 phrases)
• Score : /100 (guided + free + correction)

Frameworks détaillés dans document séparé : Exam-Frameworks.md

---

8. Daily Tracking

8.1 Daily Log Format

# Daily Log - [YYYY-MM-DD]

## Session Info
- **Day of Week**: [Lundi-Dimanche]
- **Skill Focus**: [Speaking|Foundation|Reading|Listening|Writing|Support]
- **Time Spent**: Xh Ymin
- **Streak**: X days

## Chapter Work
- **Chapter**: [book-name] Chapter X
- **Type**: [NEW|REVIEW-L1|REVIEW-L2|REVIEW-L3|REVIEW-L4]
- **Progress**: X%
- **Games Completed**: X/3

## Additional Reviews
- Chapter Y (L1) - 10min
- Chapter Z (L2) - 20min

## Notes & Observations
- **What went well**: ...
- **Difficulties encountered**: ...
- **Tomorrow's focus**: ...

## Vocabulary Learned
- 词语 (cíyǔ) - word, vocabulary
- [other new vocab]

8.2 Weekly Summary (auto-generated)

À la fin de chaque semaine, generate un summary :

• Chapters completed this week (NEW + REVIEW)
• Total time spent
• Games completed
• SRS reviews completed
• Notes for next week

---

9. Monthly Sit Rep

9.1 Structure (.md + .html)

# CHINESE LEARNING - Monthly Sit Rep
**Month**: [Month YYYY]
**Generated**: [Date]

---

## 📊 Chapters Progress

### New Chapters Completed This Month
- **Kouyu (Speaking)**: Chapters X, Y (Total: Z/12)
- **Hanyu (Foundation)**: Chapters X, Y (Total: Z/13)
- **LEDU (Reading)**: Chapters X, Y (Total: Z/12)
- **Tingli (Listening)**: Chapters X, Y, Z (Total: W/30)
- **Xiezuo (Writing)**: Chapter X (Total: Z/6)

**Total NEW**: X chapters (Target: 9)
**Total REVIEW**: Y chapters (Target: 9)

### Overall Progress
- **Total Chapters Completed**: X/73 (Y%)
- **Estimated Time Remaining**: Z months at current pace

---

## 🎯 Exam Results (Week 4)

| Segment | Score | Status | Notes |
|---------|-------|--------|-------|
| Speaking (Kouyu) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |
| Foundation (Hanyu) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |
| Reading (LEDU) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |
| Listening (Tingli) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |
| Writing (Xiezuo) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |

**Average Score**: X/100

### Exam Analysis
- **Passed (>80%)**: X exams
- **Difficulty (50-80%)**: X exams
- **Critical (<50%)**: X exams

---

## 📈 Performance Metrics

- **Streak**: X days (Longest: Y days)
- **Consistency**: X% (Z/30 days with practice)
- **Average Daily Time**: Xh Ymin
- **Games Completed**: X/Y (Z%)

### Balance Between Segments
- Speaking: X% of time
- Foundation: X% of time
- Reading: X% of time
- Listening: X% of time
- Writing: X% of time

---

## 💪 Strengths This Month

1. [Compétence qui s'améliore le plus]
2. [Vocab/grammar bien maîtrisé]
3. [Habitudes positives établies]

**Example vocabulary mastered**: [liste de mots clés]
**Grammar patterns mastered**: [liste de structures]

---

## ⚠️ Weaknesses Identified

1. [Compétence nécessitant plus de travail]
2. [Erreurs récurrentes]
3. [Obstacles rencontrés]

**Specific difficulties**: [détails]
**Missed days**: [raisons si applicable]

---

## 🎮 Games Performance

- **Total Games Played**: X
- **Average Score**: Y%
- **Favorite Game Type**: [vocabulary|grammar|production]

---

## 🎯 Goals for Next Month

### Primary Focus
- [Skill prioritaire basé sur exam results]
- [Specific improvement goal]

### Targets
- ✓ Study X new chapters
- ✓ Maintain >80% consistency
- ✓ Improve [weak skill] by X%
- ✓ Complete all 3 games per chapter

### Specific Actions
1. [Action concrète pour améliorer point faible]
2. [Nouvelle stratégie à tester]
3. [Resource additionnelle à utiliser]

---

## 💬 Communication with Tingting

**Progress to share**: [résumé pour Tingting]
**Challenges to discuss**: [points à discuter]
**Wins to celebrate**: [succès du mois]

---

*Generated by Chinese Learning System v1.0*
*Next Sit Rep: [Date]*

9.2 HTML Version

Le HTML version aura :

• Graphiques de progression (bar charts)
• Color coding (vert >80%, orange 50-80%, rouge <50%)
• Interactive timeline de streak
• Visual balance wheel pour les 5 compétences
• Prettier formatting pour sharing

---

10. Timeline Estimée

10.1 Calculs

Rythme actuel : ~9 nouveaux chapters/mois

Par book :

• Kouyu (12 ch) : ~1.3 mois
• Hanyu (13 ch) : ~1.4 mois
• LEDU (12 ch) : ~1.3 mois
• Tingli (30 ch) : ~3.3 mois
• Xiezuo (6 ch) : ~0.7 mois

Total : 73 chapters ÷ 9 per month = ~8-9 mois pour tout couvrir

Avec reviews, exams, et flexibilité : ~10-12 mois réaliste

10.2 Milestones

• Mois 3 : ~25 chapters (33%)
• Mois 6 : ~50 chapters (68%)
• Mois 9 : ~73 chapters (100%)
• Mois 12 : Full mastery avec reviews

---

11. Success Criteria

11.1 Monthly (Court terme)

• ✓ >80% consistency (24/30 days minimum)
• ✓ 5 compétences touchées chaque semaine
• ✓ Exam average >80%
• ✓ Streak >20 days
• ✓ 3 games per chapter completed

11.2 6-Month (Moyen terme)

• ✓ 50+ chapters completed
• ✓ Exam average maintained >80%
• ✓ Speaking confidence notable
• ✓ Can have basic conversations with wife in Chinese
• ✓ No CRITICAL exams (<50%)

11.3 12-Month (Long terme)

• ✓ All 73 chapters completed
• ✓ Exam average >85%
• ✓ Fluent conversations with wife
• ✓ Can read/write/listen without major difficulty
• ✓ All chapters at MASTERED status

---

12. Next Steps

12.1 Setup Immédiat

1. ✓ Framework défini
2. ⏳ Créer les Exam Frameworks détaillés
3. ⏳ Setup le daily log template
4. ⏳ Setup le sit rep templates (.md + .html)
5. ⏳ Digitaliser les chapters manquants (Kouyu surtout)
6. ⏳ Générer les 3 games pour chapters existants

12.2 Première Semaine

1. Choisir le starting point (quels chapters commencer)
2. Faire Day 1 (Lundi) avec Kouyu Chapter X
3. Logger dans daily log
4. Compléter les 3 games
5. Speaking practice quotidienne
6. Continuer le pattern

12.3 Premier Mois

• Semaines 1-3 : Pattern NEW/REVIEW
• Semaine 4 : Premier exam + premier sit rep
• Ajuster selon résultats
• Share avec Tingting

---

Version

• v1.0 (2025-10-29) : Chinese-specific application of ULLF v1.1