Skip to main content

​
Scope

This section documents gamification behavior in d-sports-api with two lenses:
  • Architecture: how data flows through backend services and routes.
  • Behavior: how users earn points, progress quests, and appear on leaderboards.
This excludes admin and superadmin-only controls.

​
Quest revamp highlights

  • Quest progression now supports per-team quests in addition to global progression surfaces.
  • Eligibility and progression are pass-aware for both global pass and event pass models.
  • Reward surfaces include clarified handling for free rewards and unpaid rewards paths.

​
Sections

Architecture overview

System boundaries, data model, and cross-feature flow.

Quests

Per-team quests, pass-aware eligibility, lifecycle, and completion behavior.

Points

Point write paths, history, and user-visible totals.

Leaderboards

Team/global scoring and season-scoped aggregation.

Rewards

Reward taxonomy with free/unpaid handling plus claim/redeem behavior.

Achievements

Current achievement surface and constraints.

Fan Rep

Separate ledger for Fan, Club, and Player Rep.

​
Completeness tracking

Use the coverage page to see what is already documented vs what still needs documentation:

Coverage status

Documented areas, intentionally excluded paths, and remaining gaps.