VOCV2 Exercise Types Catalog

Hardening Note (SoT precedence): Logic chọn câu hỏi thuộc SoT tại VOCV2_LEARN_Question_Rules.md. File này chỉ mô tả danh mục dạng bài và cách gắn tag.

1) Mục tiêu

• Chuẩn hóa danh sách dạng bài cho flow LEARN.
• Mỗi dạng bài có tag rõ ràng để engine chọn đúng theo contract.
• Tránh lặp lại logic controller đã có trong file contract.

2) Cách gắn tag cho mỗi dạng bài

Mỗi exercise type cần 3 nhóm tag:

• difficulty_tag: EASY / MEDIUM / HARD
• skill_fit: PRIMARY / ADJACENT / CROSS (theo item.skill)
• purpose: recognition / guided production / full production

3) Catalog dạng bài

3.1 General (Nhận biết & nghĩa)

Exercise	Difficulty	Purpose	Phù hợp skill
MCQ nghĩa (VN/EN)	EASY	Recognition	PRIMARY/ADJACENT
Reverse nghĩa (term -> meaning)	EASY-MEDIUM	Recognition	PRIMARY/ADJACENT
Context chọn từ đúng	MEDIUM	Guided production	PRIMARY

3.2 Listening (Luyện tai)

Exercise	Difficulty	Purpose	Phù hợp skill
Audio -> chọn term	EASY-MEDIUM	Recognition	PRIMARY (Listening), ADJACENT
Meaning -> chọn audio đúng	EASY	Recognition	PRIMARY (Listening), ADJACENT
Nghe câu -> điền/chọn từ	MEDIUM	Guided production	PRIMARY

3.3 Speaking (Luyện nói)

Exercise	Difficulty	Purpose	Phù hợp skill
Shadowing (nghe + lặp lại)	EASY	Recognition/Production nhẹ	PRIMARY (Speaking), ADJACENT
Recall speaking (xem nghĩa -> tự nói)	MEDIUM	Guided production	PRIMARY
Speaking challenge (không hint)	HARD	Full production	PRIMARY

3.4 Writing (Spelling/Typing)

Exercise	Difficulty	Purpose	Phù hợp skill
Dictation (visual/audio) / type full term	HARD	Full production	PRIMARY (Writing)

3.5 Card Practice Actions (trên từng thẻ từ)

Action	Map exercise	Difficulty	Ghi chú
Practice Speaking	Speaking practice	EASY	Dùng chung cơ chế điểm hiện có
Practice Writing	Writing dictation/type full	HARD	Dùng chung cơ chế điểm hiện có
Practice Matching (ghép thẻ)	Matching success = Reading practice	EASY	Mỗi ghép đúng 1 thẻ/pair = tương đương hoàn thành Reading EASY

4) Rule dùng catalog trong LEARN

1. Engine chọn bucket theo contract (difficulty + skill).
2. Từ bucket đó, chọn exercise type cụ thể từ catalog này.
3. Ưu tiên variety để tránh lặp kiểu câu hỏi liên tục.
4. Nếu bucket không có bài, engine fallback theo ladder: PRIMARY -> ADJACENT -> CROSS -> difficulty gần nhất an toàn -> Learning Card.
5. Nếu thiếu content cho dạng bài mong muốn, fallback sang dạng an toàn hơn.

Rule cho Card Practice:

• Card Practice dùng mapping cố định theo action (Practice Speaking/Practice Writing/Practice Matching) thay vì đi đầy đủ pipeline chọn bucket của LEARN.
• Practice Speaking/Practice Writing áp dụng gate chống cày 2 + 3 theo SoT.
• Practice Matching không áp dụng gate 2 + 3 (vì bài ghép được làm mới liên tục).

5) Rule riêng cho Writing

• Catalog hiện tại: Writing chỉ có bài HARD.
• Với item skill=Writing ở level thấp hoặc repair mode, engine dùng Reading/Speaking/Listening EASY-MEDIUM làm lớp đệm.
• Khi level tăng (3+), tăng dần tần suất Writing HARD để đảm bảo vẫn luyện đúng mục tiêu viết.

6) Tài liệu liên quan

• VOCV2_LEARN_Question_Rules.md (SoT logic chọn hiển thị)
• VOCV2_Session_Flow.md (flow trong phiên)
• VOCV2_Content_Generation_Strategy.md (yêu cầu dữ liệu nội dung)

Change log

• 2026-03-02: Tách vai trò rõ với file Contract; giữ catalog + tag, bỏ phần logic engine bị trùng.
• 2026-03-03: Thêm mapping chính thức cho Practice Speaking và Practice Writing trên thẻ từ.
• 2026-03-04: Thêm Practice Matching và rule credit tương đương Reading EASY.