Engagement Platform - Cross-area Current Mechanism Inventory

SharedShared Capabilities1.302 words7 min read

active

Purpose

Tổng hợp trạng thái hiện tại của tất cả cơ chế Engagement nằm ngoài area Engagement Platform.
Tạo baseline để các bước nâng cấp sau này không bị bỏ sót cơ chế đã tồn tại.

Audit Scope

Audit các area chính có cơ chế engagement:
- Home & Discovery
- Practice Flow
- Learning Management
- Course Management
- Social
- Vocabulary Management
- Register/Account
- Payment (các điểm giao thoa entitlement/reward)
- Product Discovery (decision records liên quan)
Loại trừ:
- file concept/prototype auto-generated không phải nguồn logic chuẩn.

Evidence Sources (Core)

Mechanism Inventory (Current State)

Mechanism family	Cơ chế hiện có	Area đang sở hữu logic	Maturity
Habit loop	Core Streak + one-day freeze; Vocabulary Streak; Super Streak	LM + Vocabulary	High
Decline recovery	Decline detection OR-logic; rescue-pack 3 bài; 7-day immediate prompt cooldown; non-blocking prompt	LM + Practice + Product Discovery decisions	High
Recommendation engine	Habit-first, dynamic size `3..7`, primary reason deterministic, confidence levels, freshness/diversification guardrails, reactivation seed handoff	Practice Flow	High
Home engagement surface	Community teaser (streak-first, 7-day window, cold-start empty-state, CTA sang Practice challenge context) + goal/profile nudge + activation card	Home + Register + Product Discovery decisions	High
Competitive loop	Course leaderboard theo category + điều kiện tham gia + H+7 lock; Social leaderboard theo subject/overall/season; Vocab leaderboard theo Garden contexts (Set/Course/Global)	Course + Social + Vocabulary	Medium
Achievement loop	Social achievements (one-off/tiered/seasonal, versioned); Course achievements (cross-course profile aggregation); profile milestone badges (track/display)	Social + Course + Register	Medium
Reward economy	Points UI thống nhất; dual-ledger (`Lifetime` + `Spendable`); reward catalog + redemption + expiration; `account level` deferred (not current rollout)	Social + Payment integration	Medium
Engagement notifications	Reactivation stages + governor cap + quiet hours; AI score-ready one-shot; Vocab urgency/social/system notifications	Social + Vocabulary + Practice	Medium
Safety/fairness	Anti-cheat leaderboard, anti-farm points, moderation/reporting, idempotency cho redemption/achievement unlock	Social + Practice + Course	Medium

Product Completion Decisions (Minimal UX First)

Action	Scope	Decision
Keep	Habit loop	Giữ `streak + freeze + rescue` vì đã rõ rule, dễ hiểu và tác động retention tốt.
Keep	Result loop	Giữ result unified + recommendation explainable (1 primary reason/item).
Simplify	Home engagement	Chỉ giữ teaser nhẹ + 1 CTA chính; không mở social depth tại Home.
Simplify	Achievement surfacing	Tập trung archive tại Profile; Home/Course chỉ summary/pulse.
Simplify	Reward surfacing	UI 1 chỉ số Points, không lộ complexity dual-ledger cho user.
Defer	Social depth	Feed/chat/forum mở rộng để phase sau; không tăng tải nhận thức trong phase hiện tại.
Defer	Gamification metaphor nâng cao	Các mechanics giàu metaphor ở Vocabulary giữ ở mức optional layer, không ép vào flow chính.
Retire/cleanup	Docs drift	Thu hồi mô tả mâu thuẫn privacy/cap; tránh định nghĩa trùng rule giữa nhiều area.

Detailed Findings By Family

1) Habit and Recovery

Streak/freeze đã rõ rule và có quyết định cấp discovery (DEC-0002), gồm timezone local + submit timestamp attribution.
Rescue-pack đã có đủ policy từ detection -> touchpoint -> cooldown -> re-prompt theo signal (DEC-0016, DEC-0017), không ép học.
High-attention + AI Tutor 7-day plan đã xuất hiện trong LM/PRA/AIT với behavior non-blocking.

2) Leaderboard and Competition

Home đã chốt rõ role teaser-only, không thay leaderboard chi tiết.
Course leaderboard đã có công thức theo từng category, lock window H+7, và badge publish sang Profile.
Social leaderboard có eligibility/normalization/tie-break/opt-out/anti-cheat.
Vocabulary có leaderboard đậm game metaphor (Garden/Archipelago), nhưng nhiều phần vẫn thiên về concept-level.

3) Achievement and Recognition

Social achievement engine có rule model tốt: type/group/criteria/version/season/backfill.
Course achievements đã có metadata khá đầy (rank, participants, defeated, ruleVersion, revoked/pending).
Register profile completion badge hiện là lớp track + display; social sharing còn deferred.
Hall of Fame có verify/retraction flow riêng.

4) Reward and Economy

Social đã có khung dual-ledger rõ và redemption lifecycle.
Levels đọc từ lifetime points, không bị giảm khi spend.
Payment đã có fairness policy quan trọng cho AI credit:
- charge-once theo job,
- auto-refund khi lỗi hệ thống,
- downgrade giữ credit nhưng lock usage ngoài entitlement.

5) Notification and Nudge

Social notification đã có governor khá chặt (cap theo kênh, quiet hours, retry policy, reactivation chain).
Vocab notifications có trigger phong phú (urgency/social/system) nhưng policy cap hiện đang tách riêng.
Goal/profile nudge có anti-fatigue (3 dismiss/14d -> soft snooze 14d) và global cap 1/day.

Cross-area Inconsistencies (Current)

Taxonomy điểm chưa hoàn toàn đồng bộ tên gọi:
- Social dùng PointsLedger/LifetimePoints.
- Một số tài liệu concept cũ (đặc biệt ở Vocabulary) vẫn còn ký pháp XP/points ở narrative layer.
- Logic vận hành Social đã chuẩn hóa về PointsEvent + dual-ledger.
Leaderboard tie-break/closure khác nhau giữa module:
- Course có rule tie-break và H+7 lock riêng.
- Social có tie-break khác; chưa thấy map versioning chuẩn chung theo ENG_03 ở mọi nơi.
Notification semantics còn cần chuẩn hóa sâu ở các docs domain phụ:
- Social đã chốt platform governor.
- Vocabulary đã thêm precedence rule.
- Cần đồng bộ dần các tài liệu liên quan khác để tránh drift về sau.

Maturity Summary (Current)

Strongest today:
- Practice recommendation + result contracts.
- LM streak/recovery + progress metric baseline.
- Home engagement touchpoint policy.
Needs consolidation next:
- Cross-module leaderboard semantics.
- Unified metric taxonomy (points/xp) across docs.
- Full propagation của notification precedence rule ở mọi docs domain.
- Mapping rõ giữa local gamification (Vocabulary) và global reward economy.

Quality Rubric for This Audit

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

Self-check Scores (Audit Pass)

Correctness: 96
Requirement coverage: 94
Risk and safety: 95
Verification evidence: 91
Maintainability: 90
Delivery efficiency: 89

Change log

2026-03-04: Hoàn tất audit cross-area engagement mechanisms và tổng hợp baseline hiện trạng trước giai đoạn nâng cấp từ Engagement Platform.
2026-03-04: Bổ sung quyết định hoàn thiện theo hướng tối giản (Keep/Simplify/Defer/Retire) và cập nhật inconsistency list sau cleanup đợt 1.
2026-03-05: Cập nhật trạng thái inconsistency taxonomy sau cleanup đợt 2 (Social integration docs + naming alignment với Engagement Platform).