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.

​
Sections

Architecture overview

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

Quests

Quest lifecycle, step completion rules, and progress checks.

Points

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

Leaderboards

Team/global scoring and season-scoped aggregation.

Rewards

Reward availability, claim, and redeem behavior.

Achievements

Current achievement surface and constraints.

​
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.