Points-only engagement ranking and account level deferral

DEC-0093 - Points-only engagement ranking and account level deferral

Context

DOL English đã có nhiều lớp động lực như streak, badge, certificate, course achievements, và vocabulary progression. Tuy nhiên policy về cross-area ranking chưa được phát biểu đủ rõ ngay trong domain, khiến người đọc có thể suy ngược từ docs shared hoặc từ SOC_Levels_Logic.md của domain khác.

Decision

• Current rollout của DOL English dùng points-only cho engagement ranking.
• Canonical cross-area ranking axis là LearningPointsWeek.
• Các điểm context như PracticePointsWeek và VocabCarePointsWeek được phép hiển thị trong module tương ứng như breakdown, nhưng không thay thế trục rank chung.
• Không triển khai user/account level trong current rollout.
• badge, streak, certificate, và course achievement là lớp ghi nhận/động lực riêng; mặc định không đi vào công thức rank.
• Vocabulary stages/levels chỉ áp cho item/progression cục bộ, không được repurpose thành learner level.
• Guardrail viết tài liệu:
  • docs active không ghép Rank + Level cho cùng một learner-facing status line,
  • mọi point bucket mới phải khai báo rõ là primary rank, context breakdown, hoặc non-ranking.

Decision Value

• Giữ leaderboard công bằng, dễ hiểu, và dễ vận hành.
• Loại bỏ nhu cầu build level curve, anti-inflation, và lifecycle phức tạp khi chưa cần.
• Tạo một baseline gọn để AI/doc writers có thể áp dụng nhất quán về sau.

Rationale

Ranking là bài toán period comparison; level là bài toán progression dài hạn. Ở current scope, DOL English đã có đủ lớp recognition để giữ động lực mà không cần thêm account level. Vì vậy, dùng một trục điểm chung cho rank là đơn giản hơn, ít drift hơn, và đúng với shared engagement model hiện tại.

Implications

• Product/UX impact:
  • learner-facing rank nên ưu tiên points + rank delta, không thêm account level.
  • recognition vẫn đến từ streak/badge/certificate/achievement surfaces.
• Data/logic impact:
  • cross-area ranking đọc từ LearningPointsWeek.
  • module-specific points phải định nghĩa quan hệ với LearningPointsWeek nếu muốn góp vào rank chung.
• Documentation impact:
  • DOL English docs cần có policy source riêng, không yêu cầu người đọc tra sang domain khác để hiểu ranking baseline.

Alternatives considered

• Option A: thêm account level song song với points ngay trong current rollout.
• Option B: chỉ dùng points cho ranking, defer level cho future progression needs (selected).

Open follow-ups

• Nếu sau này cần progression dài hạn, mở decision riêng cho account level với use cases cụ thể như unlocks, identity, hoặc retention track.

Decision quality check

Decision quality check: DEC-0093

• Score: 12/12
• Weak dimensions: none
• Action: promote as canonical DOL English engagement-ranking baseline.