Leaderboard & Counting Service  ·  View 05 of 21  ·  People and journeys

Journey — Ship a New Leaderboard

The adoption loop: declare, try, cost, promote, launch.

Editable source SVG draw.io All views
Product engineer one of 25 tenant teams Goal — Put a new weekly leaderboard on a screen this week Trigger — A product decision to add a competitive surface to an existing feature Done when — A declared counter, a leaderboard reading it, and a cost per million events they can defend 1 · Declare counter + windows 2 · Try it sandbox tenant 3 · Choose cost ◆ moment of truth 4 · Promote to production 5 · Launch ◆ moment of truth What they do Writes the definition Replays sample events Picks exact or approx Opens a config change Turns the surface on What the platform does Schema + bounds check Disposable tenant state Shows unit cost per type Compatibility validation Quota ceiling applied How it feels In control Fine Blocked Where it hurts Tie-break rule not obvious Cost of exact unknown Error bound hard to judge Window change breaks history What answers it Declared default tie-break Cost shown in the diff New counter version, not a mutation Config live ≤ 60 s Journey — A Product Engineer Ships a New Leaderboard The trough is a cost and accuracy decision the engineer is not equipped to make blind. Showing the unit cost of each counter type in the definition is what turns it from a guess into a choice. v 1.0 · owner Platform Architecture · date 2026-10

The finding

  • The trough is a cost-and-accuracy decision the engineer is not equipped to make blind: exact or approximate, and what error is acceptable. Showing the unit cost of each counter type inside the definition turns a guess into a choice.
  • A window-set change is the other hazard. It silently reinterprets events already counted, so the platform refuses it and creates a new counter version instead.
  • A disposable sandbox tenant is what makes "try it" a real step rather than a staging ritual.

What the platform owes here

  • A new counter or leaderboard live by configuration within one working day, with no platform code change.
  • Configuration effective at ingestion within 60 s (assumption).
  • A stated unit cost per million events for each counter type, visible in the change.

Risks

  • Self-service plus per-tenant quotas means a team can declare a leaderboard whose read pattern is affordable in test and not in production. The ceiling has to bite before the bill does.
  • Versioned counters accumulate. Without a retirement path the definition store becomes an archaeology site.