Gamification

The gamification engine is registry-driven. Every awardable event — first competition, 100th match, top-10 ranking, weekly streak, fantasy points scored — is declared in a central registry with thresholds, payloads and replay rules. The API emits events from the domain layer and a gamification worker evaluates rules, awards badges, increments XP and updates leaderboards atomically. XP grows from activity (playing, attending, predicting, posting) not just wins, so casual fans level up alongside competitors.

Fantasy petanque lets users build a dream squad from licensed players within a budget cap, then earns points based on real-world performance across selected competitions. Prediction games and pick'em brackets cover entire tournaments — fill in your bracket before round one, score points as the field plays out, climb the leaderboard. Live fan predictions let spectators predict the next end's score for cheap points and instant feedback during a televised final.

Challenges layer onto the same engine. Daily and weekly community challenges ("play 3 matches", "visit a new club") reward XP and badges. Club-vs-club mini-competitions aggregate member activity into team scores. Seasonal quests run for months ("play 30 matches, visit 5 venues, enter 3 tournaments"). Direct player challenges send a one-tap match invitation. Streaks track consecutive wins, weeks active, daily check-ins and prediction accuracy. Personal bests record best ELO, best tournament finish, longest streak and best fantasy week.

The celebration UX motor renders proportional confetti, banners and badge primitives — major moments get full celebration once per session (rate-limited), minor moments get subtle flourishes. It respects web `prefers-reduced-motion` and native `AppState` so animations never fire when minimised or when the user wants quiet. A personal-best comparison primitive uses staggered animations to reveal the new record next to the old one. An audit gate logs every awarded badge for support and dispute resolution.