Vocabulary v2 (SRS)

Purpose

• Chuẩn hóa trải nghiệm Vocab dựa trên SRS (fluency/decay, success/fail) với một CTA “Bắt đầu học” trộn bài mới + ôn.
• Garden Ecosystem: Sử dụng ẩn dụ “Vườn Cây” để Game hóa việc học (Hạt mầm -> Cổ thụ).
• Giữ đơn giản cho người học (timed/untimed, nhóm item gọn) nhưng linh hoạt mở rộng đa môn (Languages/Sciences).
• Tách rõ preview miễn phí vs full practice cho học viên đã mua khóa.

Scope & Components

• SRS Engine: Fluency/decay per item/học viên.
  • Withering Logic: Cây lớn không bao giờ nhỏ lại, chỉ bị “Héo” (Withering) nếu bỏ bê. Cơ chế “Revive” (Cứu cây) thay vì học lại từ đầu.
• Garden Ecosystem:
  • Visual Progression: 6 Stages (Seed, Sprout, Seedling, Sapling, Mature, Flowering).
  • States: Healthy vs Withered vs Dead.
• Social & Gamification:
  • Multi-context Leaderboards: Set (The Pot), Course (The Greenhouse), Global (The Garden).
  • Ranking Baseline: nếu Vocab đóng góp vào cross-area rank thì đi qua points conversion vào Learning Points; current rollout không dùng user/account level.
  • Fun Mechanics: “Sleeping Beauties” (Cà khịa người lười), “Resurrection Squad” (Anh hùng cứu cây).
• Session Flow: Timed/untimed, micro-batch 5 (web preload 10, mobile 5), debt-aware mixing và recap đóng vòng sửa sai.
• Learn Question Display Controller: Chọn exercise theo contract tỷ lệ với 2 nhánh độc lập: Difficulty (level-based theo max_stage, có repair override) và Skill (profile-based), có ratio window, fail-streak override, và fallback chain khi thiếu content.
• Access Model: Preview free 1–2 bài/roadmap; full practice + lưu tiến độ chỉ cho học viên đã mua (không bán practice lẻ).
• Analytics: Sự kiện session/item/access/reminder (xem VOCV2_Analytics.md).
• Notification: Quy tắc nhắc nhở “Emergency Water” (Cứu cây sắp héo) và “Social Nudge” (Rớt hạng).

Monetization & Access

• Hai option lock: (A) free full ở vài list, khoá học/ôn ở list còn lại; (B) free view toàn bộ list, khoá học/ôn.
• Preview free cho guest; unlock full khi là học viên (hoặc gói Pro tương ứng).

Dependencies

• LM / Tracking: đồng bộ chỉ số tiến độ và sự kiện luyện tập.
• Payment: khóa/mở tính năng học/ôn theo gói Pro/khoá học; stage non-exam giá thấp nếu áp dụng.
• Teaching Tool / Parent: học viên thiếu nhi (Starters/Movers/Flyers) tuân thủ rule “full practice cho học viên”.

Notes

• Leaderboard hiển thị theo Context (Lớp học/Toàn cầu) để đảm bảo tính công bằng và liên quan.
• Garden stages là progression của item/bộ nhớ, không phải learner account level.