Engagement Platform - Roadmap and Quality Gates

Purpose

• Định nghĩa lộ trình triển khai và cơ chế kiểm soát chất lượng dài hạn cho area Hybrid, gồm cả Mission + Leaderboard + Achievement + Reward.

Phased Roadmap

• Phase 1 (Foundation Alignment):
  • Chốt taxonomy + ownership matrix + event contract chung.
  • Chốt mapping giữa local metrics và global governance.
• Phase 2 (Consolidation):
  • Chuẩn hóa mission lifecycle, leaderboard lifecycle và achievement publication.
  • Áp contract reward economy cho các bề mặt có quy đổi quyền lợi.
• Phase 3 (Optimization Loop):
  • A/B test động lực học tập theo cohort và mission usefulness.
  • Tối ưu fairness, retention quality và anti-abuse theo dữ liệu thực.

Execution Backlog (Current)

• P0:
  • Chốt quy tắc tối giản UX: mỗi surface chỉ 1 primary CTA cho engagement action.
  • Dọn conflict docs privacy/cap để tránh drift logic trước rollout.
  • Chốt ENG_12 là canonical source cho achievement + badge + reward + batch.
  • Chốt ENG_15 là canonical source cho daily mission + weekly community mission + event challenge.
  • Gắn tag deprecated cho các đoạn rule cũ còn lặp ở module docs (không xóa lịch sử).
  • Chốt baseline Practice Points (score 50% + volume 30% + duration 20%) và qualified-activity gate.
  • Chốt taxonomy achievement/badge/reward và idempotency keys (award_key, grant_key).
  • Chốt công thức learning_points quy đổi từ practice + vocabulary và eligibility gates.
  • Chốt XP là user-facing term; backend không mở ledger mới ngoài learning_points/lifetime/spendable.
  • Chốt baseline Warm-up + Focus cho daily mission và ngưỡng minimum qualified participation cho weekly community mission.
  • Chốt taxonomy badge vocab cho các hành động list/save/create/learn/completion.
  • Publish canonical event dictionary vào data pipeline validator.
  • Chốt policy opt-out/masking cho minors ở mọi leaderboard public.
  • Thêm inventory lock + refund fallback vào reward redemption flow.
• P1:
  • Chuẩn hóa taxonomy điểm (points/xp) về một chuẩn canonical.
  • Mở Practice leaderboard đa trục (duration | volume | score) ở bề mặt chi tiết.
  • Mở teaser global_points ở Home.
  • Mở batch evaluator cho achievement tier cao + badge awarding + reward grant.
  • Mở pipeline tính vocab_care_points và learning_points ở shadow mode.
  • Mở evaluation pipeline cho vocab achievements (starter + tier thấp).
  • Mở mission generator baseline với anti-repeat + difficulty ladder guardrails.
  • Mở weekly community mission baseline ở 1 scope chính.
  • Chuẩn hóa rule-versioning cho achievement và leaderboard ở mọi module.
  • Mở dashboard theo dõi fairness gap và anti-cheat false-positive.
• P2:
  • Dọn legacy docs: chuyển các rule cũ sang trạng thái deprecated hoặc reference-only.
  • Mở season ranking/reward dựa trên global_points.
  • Mở reconciliation batch đa nguồn (late event, retry fail, drift repair).
  • Mở cohort experiment cho nudge strategy theo points band và learning stage.
  • Mở đầy đủ tier cao cho vocab badges + reward cap governance.
  • Mở operator tooling tối giản cho event challenge.
  • Chuẩn hóa mission campaign templates và policy retire/refresh template family.
  • Chuẩn hóa cross-module copy để giảm semantic drift.

Long-term Optimization Objectives

• Tăng tỷ lệ học đều bền vững, không chỉ tăng số action bề mặt.
• Giữ bề mặt UX tối giản, tránh user phải học quá nhiều cơ chế cùng lúc.
• Giảm chênh lệch semantics giữa module khi user chuyển lane.
• Tăng tốc rollout nhờ chuẩn contract thay vì patch cục bộ.

Quality Rubric (Weighted)

• Correctness: 30%
• Requirement coverage: 25%
• Risk and safety: 20%
• Verification evidence: 15%
• Maintainability: 5%
• Delivery efficiency: 5%

Hard Gates

• Correctness >= 95 (critical)
• Risk and safety >= 95 (critical)
• Requirement coverage >= 90
• Verification evidence >= 85
• Maintainability >= 85
• Delivery efficiency >= 80

Self-check Loop (Operational)

• Outer loop tối đa 3 vòng.
• Vòng 1: triển khai baseline theo contract.
• Vòng 2: sửa các tiêu chí yếu nhất theo score.
• Vòng 3: chốt residual risk, đề xuất next-best actions.
• Tổng điểm cao không được override critical gate fail.

Verification Checklist

• Có owner matrix rõ và không trùng quyền.
• Có canonical event fields + idempotency policy.
• Có lifecycle cho leaderboard/achievement/reward.
• Có lifecycle cho daily mission/community mission/event challenge.
• Có roadmap theo phase và guardrails anti-abuse/privacy.
• Có mapping nguồn chuẩn (source of truth) và policy chống drift tài liệu.

Iterative Self-check (Documentation Package)

• Loop 1:
  • Điểm yếu: thiếu operating cadence và KPI tree.
  • Hành động: thêm metrics/experiment framework + change-control model.
• Loop 2:
  • Điểm yếu: thiếu backlog ưu tiên theo mức ảnh hưởng.
  • Hành động: thêm execution backlog P0/P1/P2 trong roadmap.
• Loop 3:
  • Điểm yếu còn lại: cần evidence thực thi từ telemetry production.
  • Hành động kế tiếp: chạy adoption checklist theo module và audit sau 2-4 tuần.

Change log

• 2026-03-04: Tạo roadmap 3 phase và rubric/hard-gate để vận hành cải tiến dài hạn cho Engagement Platform.
• 2026-03-04: Bổ sung execution backlog và self-check loop để điều phối triển khai dài hạn.
• 2026-03-04: Bổ sung backlog triển khai Practice Points và leaderboard đa trục theo hướng tối giản bề mặt Home.
• 2026-03-04: Bổ sung backlog toàn diện cho achievement/badge/reward + batch evaluation và reconciliation.
• 2026-03-04: Bổ sung backlog triển khai quy đổi điểm hợp nhất Practice + Vocabulary (learning_points).
• 2026-03-04: Bổ sung backlog triển khai hệ thống Vocabulary achievements/badges/rewards.
• 2026-03-07: Bổ sung mission-system rollout backlog và quality gates để mission trở thành phần chính thức của area Hybrid.