Bỏ qua để đến nội dung
DOL Wiki

Social - Points & Rewards (Integration Logic)

DomainsDOL AcademyUX343 words2 min read
active

Purpose

Phần tiêu đề “Purpose”
  • Định nghĩa lớp hiển thị và redemption của Social cho points/rewards.
  • Giữ UI đơn giản (Points) nhưng không định nghĩa lại công thức nền tảng ở đây.

Canonical Source of Truth

Phần tiêu đề “Canonical Source of Truth”

Ledger Model (Read/Render in Social)

Phần tiêu đề “Ledger Model (Read/Render in Social)”
  • RankingPointsLedger:
    • non-spendable, dùng cho ranking/season (learning_points).
  • RewardPointsLedger:
    • spendable_points + lifetime_points, dùng cho đổi quà và level.
  • UI hiển thị:
    • một nhãn Points,
    • breakdown chỉ ở màn chi tiết/tài khoản.

Reward Catalog Scope

Phần tiêu đề “Reward Catalog Scope”
  • RewardItem: digital | voucher | physical | upgrade.
  • Achievement/badge không phải item đổi quà trực tiếp:
    • badge được cấp qua achievement pipeline.
  • reward_type = badge (nếu có ở governance layer) chỉ dùng cho grant hệ thống, không hiển thị trong redemption catalog.

Core Flows

Phần tiêu đề “Core Flows”
  • Earn:
    • ingest grant events đã qua idempotency/cap từ layer Engagement.
  • Redeem:
    • pre-check điều kiện + tồn kho -> inventory lock -> deliver -> finalize/refund.
  • Expiration:
    • apply theo policy reward ledger, gửi cảnh báo trước hạn.

Guardrails

Phần tiêu đề “Guardrails”
  • Idempotency theo grant_key (grant) và redemption_key (redeem).
  • Không settle nếu chưa qua inventory lock.
  • High-value redemption có thể yêu cầu xác minh bổ sung.
  • Chargeback/vi phạm:
    • reversal theo policy có audit trail.

Integration Notes

Phần tiêu đề “Integration Notes”
  • Dòng điểm học tuần vào reward ledger:
    • đọc từ learning_points_reward_granted_event.
  • Bonus từ achievements:
    • đọc từ achievement_reward_granted_event và vocab_achievement_reward_granted_event.

References

Phần tiêu đề “References”

Change log

Phần tiêu đề “Change log”
  • 2026-03-05: Refactor thành integration doc; bỏ định nghĩa trùng và loại bỏ mapping reward type badge để nhất quán kiến trúc achievement-first.