Integration: Gamification Module + Fair Points System (#212)

[Charank18]

Objective:
Merge the existing Fair Efforts, Fair Points, Fair Penalties system (Discussion #212) with the new Gamification Module (badges, leaderboards, XP) to create a unified, automated rewards/penalties framework.

Key Integration Points:

1. Aligning Metrics
   The Fair Points system already tracks:

Quiz performance (accuracy, time, confidence, streaks)

Contribution quality (question/review genuineness)

Understanding submissions (LLM-evaluated reflections)

Proposed Gamification Additions:

Badges: Award for milestones (e.g., "Confident Thinker" for high confidence + accuracy, "Helper" for peer reviews)

XP System: Convert Fair Points to XP (1:1 ratio) for leaderboards

Leaderboards: Split by tiers (Bronze/Silver/Gold) based on percentiles from #212

Question:
Should penalties (e.g., -30% for low-quality submissions) reduce XP and badge eligibility?

2. Gamifying Existing Mechanisms
   Bonus Jump (75th percentile) | Unlock "Underdog" badge + XP multiplier
   High genuineness score (G≥T) | "Quality Contributor" badge + XP bonus
   Revalidation success | "Fair Play" badge + refund as XP boost

Do we add a "PvP Quiz" mode (suggested by @lasya2007) using the ELO system and Fair Points metrics?

3. Database & API Changes
   New Tables Needed:

badges: Links to Fair Points criteria (e.g., badge_condition = "confidence > 4 AND accuracy > 80%")

leaderboards: Aggregates XP from user_xp (derived from Fair Points)

API Endpoints:

GET /api/gamification/stats → Returns Fair Points + XP + badges in one payload

POST /api/gamification/contest → Triggers revalidation (stakes XP instead of points)

Question:
Should we deprecate standalone Fair Points endpoints or keep both systems separate?

4. Event Triggers
   Automate gamification rewards using Fair Points events:

Question:
How to handle conflicts? (e.g., a penalized user loses XP and badge eligibility?)