chineseclass/ClassGenSystem/README.md
StillHammer 18fb87ae3f Complete Chinese learning system setup
- Created Universal Language Learning Framework (ULLF v1.1)
- Built complete learning system for 73 chapters across 5 books
- Setup folder structure with 18 README.md files
- Created learning plans (EN + CN for Tingting)
- Defined monthly cycle, SRS system, exams, and tracking
- Setup daily logs, weekly summaries, monthly sit reps
- Ready to start learning

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-29 11:31:40 +08:00

2.4 KiB

ClassGenSystem - Game-Ready JSON Content

This folder contains all textbook content structured as JSON files ready to be loaded into the classGen game system.

Structure

Each book has its own subfolder with JSON files:

ClassGenSystem/
├── Kouyu/          # Speaking chapters as JSON
├── Hanyu/          # Composition chapters as JSON
├── LEDU/           # Reading chapters as JSON
├── Tingli/         # Listening chapters as JSON
└── Xiezuo/         # Writing chapters as JSON

JSON Format

Each chapter JSON includes:

  • Metadata: id, name, difficulty, estimated hours, prerequisites
  • Vocabulary: Words with pronunciation, type, meaning, examples
  • Grammar: Patterns with explanations and examples
  • Texts: Main reading/listening content with questions
  • Exercises: Various exercise types (character inference, comprehension, etc.)
  • Games: 3 games per chapter
    • Game 1: Vocabulary challenge
    • Game 2: Grammar/pattern practice
    • Game 3: Production game

Game Structure

Each chapter must have 3 games:

"games": [
  {
    "id": "game1-vocab",
    "type": "vocabulary-matching",
    "title": "Vocabulary Challenge",
    "data": { /* game-specific data */ }
  },
  {
    "id": "game2-grammar",
    "type": "sentence-builder",
    "title": "Grammar Practice",
    "data": { /* game-specific data */ }
  },
  {
    "id": "game3-production",
    "type": "speaking-challenge",
    "title": "Production Game",
    "data": { /* game-specific data */ }
  }
]

Workflow

Markdown content (Content/)
  → Structure as JSON with metadata
  → Add 3 games per chapter
  → Save here (ClassGenSystem/)
  → Load into classGen app

Current Status

Book JSON Files Status
LEDU Chapters 1-4 ✓ Exists with full structure
Hanyu 0/13 Need to create
Kouyu 0/12 Need to create
Tingli 0/30 Need to create
Xiezuo 0/6 Need to create

Reference

See ledu-chapter1.json for a complete example of proper JSON structure.

Book metadata file: ledu-book.json shows how to structure a book overview.

Notes

  • Follow the LEDU format for consistency
  • Each game should be playable and engaging
  • Vocabulary should include pronunciation (pinyin) and examples
  • Grammar patterns need clear explanations and multiple examples