check point

README.md

@@ -0,0 +1,100 @@
+# GAME GENERATOR
+
+## 🚀 TỐI ƯU API CALLS
+
+| Trước | Sau |
+|-------|-----|
+| Analyzer: 1 call | Analyzer: 1 call |
+| Generate: N calls (1 per game) | Generate: **1 call** (tất cả games) |
+| Validator: N calls | Validator: **0 call** (Python) |
+| **Tổng: N+1 calls** | **Tổng: 1-2 calls** |
+
+---
+
+## 📁 Cấu trúc
+
+```
+gen_using_graph/
+├── api.py                # FastAPI server
+├── requirements.txt
+│
+└── src/
+    ├── core.py           # Core engine (tối ưu API calls)
+    ├── game_registry.py  # Auto-load games
+    ├── validator.py      # Hallucination check (không dùng API)
+    │
+    └── games/            # Game definitions
+        ├── _template.py  # Template
+        ├── quiz.py       # Quiz game
+        └── fill_blank.py # Fill-blank game
+```
+
+---
+
+## 🔌 API ENDPOINTS
+
+### Generate games
+```bash
+POST /generate
+{
+    "text": "Văn bản...",
+    "enabled_games": ["quiz", "fill_blank"],
+    "run_analyzer": true,
+    "run_validator": true,
+    "max_items": 3
+}
+
+# Response includes:
+# "api_calls": 2  <-- Số lần gọi LLM
+```
+
+### Xem games
+```bash
+GET /games
+```
+
+### Bật/Tắt game
+```bash
+POST /games/quiz/activate
+POST /games/quiz/deactivate
+```
+
+### Reload
+```bash
+POST /reload
+```
+
+---
+
+## 🎮 THÊM GAME MỚI
+
+1. Copy `src/games/_template.py` → `src/games/new_game.py`
+2. Sửa nội dung
+3. Gọi `POST /reload`
+
+---
+
+## ✅ BẬT/TẮT GAME
+
+```python
+# Trong file game
+GAME_CONFIG = {
+    "active": True,   # Bật
+    "active": False,  # Tắt
+}
+```
+
+Hoặc qua API:
+```bash
+curl -X POST http://localhost:8000/games/quiz/deactivate
+```
+
+---
+
+## 🚀 Chạy
+
+```bash
+pip install -r requirements.txt
+export GOOGLE_API_KEY=your_key
+uvicorn api:app --port 8000
+```