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

90 lines
2.4 KiB
Markdown

# 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:
```json
"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