Social - Achievements (Integration Logic)

Purpose

• Định nghĩa vai trò của Social trong achievement loop:
  • hiển thị,
  • chia sẻ,
  • privacy/moderation.
• Không định nghĩa lại rule unlock ở đây để tránh drift.

Canonical Source of Truth

• Rule unlock, batch, idempotency:
  • ../Engagement Platform/ENG_12_Achievement_Badge_Reward_and_Batch_System.md
• Vocabulary-specific achievements/badges:
  • ../Engagement Platform/ENG_14_Vocabulary_Achievement_Badge_and_Reward_System.md
• Event contract:
  • ../Engagement Platform/ENG_06_Event_Contracts.md

Social-owned Scope

• Render badge board trên profile.
• Render recent unlock trên feed (theo visibility).
• Cho phép pin badge để khoe thành tích.
• Không evaluate criteria tại client/UI layer.

Canonical Events Consumed

• achievement_unlocked_event
• badge_awarded_event
• vocab_achievement_unlocked_event
• vocab_badge_awarded_event

Display and UX Rules (Minimal)

• Result/Home: tối đa 1 badge toast nổi bật mỗi phiên.
• Profile: archive đầy đủ theo program | group | rarity.
• Feed: chỉ hiển thị badge/event user đã cho phép chia sẻ.

Privacy and Moderation

• User opt_out khỏi public leaderboard vẫn giữ achievement nội bộ.
• Achievement gắn nội dung private:
  • chỉ hiển thị public khi user bật chia sẻ.
• Badge/reward bị moderation hold:
  • không render public cho đến khi clearance.

Anti-drift Rules

• Mọi thay đổi criteria/tier/version phải sửa ở ENG_12 hoặc ENG_14, không sửa trực tiếp ở file này.
• Nếu Social cần custom display grouping mới:
  • chỉ thêm mapping hiển thị, không tạo rule unlock mới.

Change log

• 2026-03-05: Refactor thành integration doc; loại bỏ định nghĩa rule trùng với Engagement Platform để giảm drift dài hạn.