# 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