Vocab V2 – Leaderboard Mechanics (Context & Logic)

Tài liệu này quy định chi tiết các cơ chế tính điểm, xếp hạng và luật chơi cho hệ thống Leaderboard đa ngữ cảnh của Vocab V2.

---

Scope Clarification (Anti-drift)

• Global View trong file này là global ở phạm vi Vocabulary (Garden/Archipelago), không phải global ranking toàn nền tảng.
• Global ranking toàn nền tảng dùng LearningPointsWeek theo:
  • ../../../Engagement Platform/ENG_13_Practice_and_Vocabulary_Point_Conversion_System.md
• Current rollout của global ranking toàn nền tảng là points-only, không dùng user/account level.
• Rule governance leaderboard toàn nền tảng:
  • ../../../Engagement Platform/ENG_03_Leaderboard_Governance.md
• Nếu màn Vocab surfacing vị trí ở tầng toàn nền tảng:
  • hiển thị current-period points/rank hoặc rank delta,
  • không hiển thị learner level.

---

1. Set View: “The Islet” (Hòn Đảo Nhỏ)

Context: User viewing a specific Set Detail (e.g., “Unit 1”). 👉 View Prototype (concept prototype archived - not migrated to current corpus)

Tab 1: Top Cultivators (Primary)

• Metric: Mastery Percentage (%) per Set.
  • Formula: (Count of Items with F >= 90 AND Success >= 5) / Total Items in Set.
• Tie-breaker (The Race Element):
  1. Harvest Timestamp (Ai cán mốc điểm hiện tại sớm hơn sẽ xếp trên).
  2. Average Accuracy (Nếu cùng điểm và cùng thời gian, ai sai ít hơn xếp trên).
• Target User: Achievers, Completionists.
• Psychology: Tạo cảm giác “Đua” (Race) xem ai hoàn thành khu vườn sớm nhất, nhưng vẫn bị giới hạn bởi thời gian chờ SRS (chống học vẹt).

Tab 2: Sharpshooters (Secondary)

• Metric: Average Accuracy (%).
  • Formula: Current Set Correct Answers / (Correct + Wrong) * 100.
  • Constraint: Minimum 20 attempts required to appear on leaderboard (chống user làm 1 câu đúng 100% rồi nghỉ).
• Target User: Perfectionists.

---

2. Course View: “The Island” (Hòn Đảo Lớn)

Context: User viewing Course Overview (e.g., “IELTS 6.0”). Scope restricted to Classmates (if applicable) or Global Course Learners. 👉 View Prototype (concept prototype archived - not migrated to current corpus)

Tab 1: Class Sprinters (Primary)

• Metric: Progress Count.
  • Formula: Count of items in Course with status ≥ Mature (F ≥ Threshold, Success ≥ 3).
• Filter - “Rising Stars” (Tăng trưởng tuần - Default):
  • Hiển thị Top user có số lượng Mature Items tăng thêm nhiều nhất trong tuần này.
  • Mục tiêu: Giúp người mới (Newbies) có cơ hội đua Top với người cũ (Oldbies).
• Filter - “All-time”: Tổng số Mature Items từ đầu đến giờ (dành cho Oldbies).
• Target User: Racers, Competitive Learners.

Tab 2: Sun-chasers (Secondary)

• Metric: Active Streak (Days).
  • Formula: Consecutive days with at least 1 lesson completed within this course.
• Target User: Routine Builders.

---

3. Global View: “The Archipelago” (Quần Đảo)

Context: Home Screen / Global Leaderboard. 👉 View Prototype (concept prototype archived - not migrated to current corpus)

Tab 1: Greenest Garden (Maintenance)

• Metric: Average Fluency ($F_{avg}$).
  • Formula: $\frac{\sum F_{current}}{N_{total}}$
  • Condition: $N_{total} \ge 50$ items.
• Update Frequency: Batch update every 6 hours (to reduce server load).

Tab 2: Resurrection Squad (Heroism)

• Metric: “Saves” Count (Weekly Reset).
  • Trigger: Item transitions from Withering/Dead ($F < Threshold$) → Healthy ($F > Threshold$).
• Anti-Gaming:
  • Cooldown: 1 save per item per week (không thể cố tình làm sai để cứu lại liên tục).

Tab 3: Harvest Season (Legacy)

• Metric: Mastered Count (Weekly Reset / All-time).
  • Trigger: Item transitions to Mastery.

Tab 4: The Sleeping Beauties (Góc “Cà Khịa” - Fun)

• Metric: Withered Wealth (Gia tài bị lãng quên).
  • Formula: Count of items with max_stage >= Mature BUT F < Threshold (Withering).
• Target User: “Lazy Geniuses” (Người giỏi nhưng lười).
• Psychology:
  • Friendly Shame: “Nhà lầu (Cây to) mà để mốc meo thế kia à?”
  • Motivation: Kích thích lòng tự trọng (Ego) để user quay lại chăm sóc vườn.

---

4. Edge Cases & Anti-Gaming Rules

1. Reset Set:
   • If user resets a Set: “Top Cultivators” score resets to 0%. “Sharpshooters” accuracy history for that set is cleared.
2. Time Travel:
   • Server time is authoritative. Client-side time changes do not affect Streak or “Time to Completion” timestamps.
3. Spamming:
   • “Sharpshooters” tab penalizes random clicking naturally.
   • Minimum engagement time per question (e.g., > 1s) may be enforced for valid attempts.

Change log

• 2026-03-09: Bổ sung anti-drift boundary: global ở file này chỉ là global của Vocabulary; cross-area global ranking dùng current-period points và không dùng user/account level.