Phase 13: Gamification + XP System

phase-mcd-tracker-13-gamification Phase

phase

Project

Goal: Celebrate usage. XP system with levels, lifetime code tally, mascot character with context-aware Lottie animations.

Owner: Lucas (mascot design) + Dev agent (implementation)

Repo: mcd-tracker-api, mcd-tracker-app

Depends on: Phase 7 (frontend must exist)

API: GET /stats endpoint — lifetime codes redeemed, current level, XP progress, streak days
Level system: Level 1 (0-5 redeemed) → Level 2 (6-15) → etc. Titles: "BOGO Beginner" → "Free Food Fanatic" → "Coupon Legend"
Home page XP banner above location list ("Level 3 BOGO Hunter · 12 codes redeemed")
Mascot character — Lottie animations, ~8 states: idle, happy, excited, worried (code expiring), sleeping (no activity), celebrating (just redeemed), nudging (slot opened), waving (first visit)
Mascot appears on: home banner, redemption overlay, empty states
Design mascot as separate creative task — Lucas drives, AI tools (motchi.art, Lottie Tools) assist