Engagement Platform - Overview
SharedShared Capabilities845 words4 min read
Engagement Platform - Overview (UX Design)
Phần tiêu đề “Engagement Platform - Overview (UX Design)”Purpose
Phần tiêu đề “Purpose”- Vấn đề: Cơ chế động lực học tập hiện nằm rải rác ở
Home,Practice,Learning,Course,Vocabulary,Social, dẫn tới rủi ro lệch nghĩa và trùng logic. - Đối tượng chính: Product/UX/Data/Engineering cần một chuẩn chung để thiết kế và vận hành hệ cơ chế
Mission + Leaderboard + Gamification + Achievement + Reward. - Tín hiệu thành công: Mọi module dùng cùng chuẩn governance và event contract, nhưng vẫn giữ được ngữ cảnh địa phương của từng lane học tập.
Scope
Phần tiêu đề “Scope”- In scope:
- Cơ chế nền tảng cho
Mission system,Leaderboard,Gamification loop,Achievement/Badge,Reward economy. - Quy tắc đồng bộ giữa các module:
Home,Practice Flow,Learning Management,Course Management,Vocabulary Management,Social. - Chuẩn dữ liệu/event, anti-abuse, privacy, quality gates, roadmap triển khai.
- Cơ chế nền tảng cho
- Out of scope:
- Pixel/UI chi tiết của từng màn hình module.
- Thay thế business logic sâu của từng module học tập.
Strategic Decision
Phần tiêu đề “Strategic Decision”- Quyết định kiến trúc: Hybrid model.
- Lý do:
- Không chọn
single monolithic specvì sẽ làm mất ngữ cảnh theo module. - Không chọn
fully splitvì khó giữ chuẩn toàn nền tảng.
- Không chọn
- Nguyên tắc vận hành:
- Governance chung ở area này.
- Implementation cụ thể giữ ở docs module nguồn.
Core Principles
Phần tiêu đề “Core Principles”Learning-first: cơ chế động lực phải hỗ trợ học tập thật, không khuyến khích hành vi spam.Motivation over pressure: ưu tiên nudge tích cực, tránh phạt cứng trên bề mặt chính.Simple-by-default: mỗi bề mặt chỉ giữ hành động chính rõ ràng, tránh dồn nhiều mechanics cùng lúc.Global contract, local semantics: chuẩn event/metric chung, ngôn ngữ trải nghiệm được phép khác theo module.Transparency: mọi rule xếp hạng và điều kiện nhận thành tích phải giải thích được.Safety and fairness: có anti-cheat, privacy và moderation mặc định.
Document Map
Phần tiêu đề “Document Map”ENG_01_Current_State_Analysis.mdENG_02_Module_Responsibility_Matrix.mdENG_03_Leaderboard_Governance.mdENG_04_Achievement_Badge_Governance.mdENG_05_Reward_Economy_Governance.mdENG_06_Event_Contracts.mdENG_07_Roadmap_and_Quality_Gates.mdENG_08_Metrics_and_Experimentation_Framework.mdENG_09_Operating_Model_and_Change_Control.mdENG_10_Cross_Area_Current_Mechanism_Inventory.mdENG_11_Practice_Leaderboard_and_Global_Score_Model.mdENG_12_Achievement_Badge_Reward_and_Batch_System.mdENG_13_Practice_and_Vocabulary_Point_Conversion_System.mdENG_14_Vocabulary_Achievement_Badge_and_Reward_System.mdENG_15_Mission_System_Hybrid_Model.mdENG_16_Mission_Documentation_Guidelines_for_AI.md
How To Use This Area
Phần tiêu đề “How To Use This Area”- Product/UX dùng area này để ra quyết định rule và rollout liên module.
- Module docs chỉ triển khai chi tiết trong phạm vi lane, không định nghĩa lại global contract.
- Với nhóm
Achievement + Badge + Reward + Batch:ENG_12là nguồn chuẩn duy nhất để tránh drift.
- Với nhóm
Point conversion Practice + Vocabulary:ENG_13là nguồn chuẩn cho quy đổi điểm global.
- Với nhóm
Vocabulary badge/achievement/reward:ENG_14là nguồn chuẩn cho mốc và reward mapping của Vocabulary.
- Với nhóm
Mission system:ENG_15là nguồn chuẩn cho taxonomy, reward mapping và surface boundary.
- Với nhóm
AI-authored mission docs:ENG_16là guideline chuẩn để tránh drift.
- Mọi thay đổi có ảnh hưởng rank/reward phải update:
- governance doc tương ứng,
- event contract liên quan,
- roadmap hoặc change-control log.
References
Phần tiêu đề “References”docs/Shared/Shared Capabilities/Ecosystem Experience/SHR_ECOSYSTEM_UX_00_Overview.md../Home & Discovery/HOME_ENG_Home_Post_Login.md(archived, DEC-0096)../Practice Flow/PRA_Result_Flow.md../Practice Flow/PRA_Result_Impact_Contracts.md../Learning Management/LM_Metrics.md../Course Management/CM_Course_Detail_Leaderboard.md../Course Management/CM_Course_Achievements.md../Social/SOC_Leaderboards_Logic.md../Social/SOC_Points_Rewards_Logic.md../Vocabulary Management/Vocab v2/Business Logic/VOCV2_Gamification_Strategy.md
Change log
Phần tiêu đề “Change log”- 2026-03-04: Tạo area
Engagement Platformtrongdocs/UX Designvà chốt quyết định Hybrid (governance chung + implementation theo module). - 2026-03-04: Bổ sung hướng dẫn áp dụng area và mở rộng map cho metrics/experimentation + operating model.
- 2026-03-04: Bổ sung inventory cross-area hiện trạng engagement để làm baseline trước giai đoạn nâng cấp.
- 2026-03-04: Bổ sung nguyên tắc
Simple-by-defaultđể giữ trải nghiệm tối giản khi mở rộng cơ chế engagement. - 2026-03-04: Bổ sung model leaderboard luyện tập đa trục + global points để chuẩn hóa xếp hạng toàn nền tảng.
- 2026-03-04: Bổ sung kiến trúc toàn diện cho achievement/badge/reward + batch processing system.
- 2026-03-04: Bổ sung cơ chế quy đổi điểm hợp nhất Practice + Vocabulary thành Learning Points cho global ranking/reward.
- 2026-03-04: Bổ sung cơ chế badge/achievement/reward chuyên biệt cho Vocabulary (save/create list, word milestones, list completion).
- 2026-03-06: Bổ sung
Mission Systemhybrid model và guideline cho AI-authored mission docs.