chineseclass/docs/Chinese-Learning-System.md

# Chinese Learning System - Application du ULLF

**Basé sur** : Universal Language Learning Framework v1.1

---

## 1. Configuration Langue

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

---

## 2. Les 5 Books Zhongyi

### 2.1 Inventaire complet

| Book | Skill | Chapitres | Pages/chap | Total pages | Densité | Status actuel |
|------|-------|-----------|------------|-------------|---------|---------------|
| **LEDU (乐读)** | Reading | 12 | 15 | 180 | Dense | Ch 1-4 en JSON |
| **Kouyu (口语)** | Speaking | 12 | 16 | 192 | Dense | À digitaliser |
| **Hanyu Jiaocheng (汉语教程)** | Composition | 13 | 17 | 221 | Très dense | Ch 1-5 en MD |
| **Tingli (听力)** | Listening | 30 | 4 | 120 | Léger | Ch 4-8 en MD |
| **Xiezuo (写作)** | Writing | 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 | Compétence | Book | Type de contenu |
|------|------------|------|-----------------|
| **Lundi** | Speaking | Kouyu | Dense (16 pages) |
| **Mardi** | Composition | 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** | Composition | 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 :
```json
{
  "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 - Composition Exam (Hanyu)**
- Grammar patterns (10 phrases à compléter)
- Transformation sentences (6 phrases)
- Production originale (5 phrases)
- **Score** : /100 (grammar accuracy + creativity)

**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

```markdown
# Daily Log - [YYYY-MM-DD]

## Session Info
- **Day of Week**: [Lundi-Dimanche]
- **Skill Focus**: [Speaking|Composition|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)

```markdown
# 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 (Composition)**: 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)

| Skill | Score | Status | Notes |
|-------|-------|--------|-------|
| Speaking (Kouyu) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... |
| Composition (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 Skills
- Speaking: X% of time
- Composition: 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