USER SCENARIO 4 (REWARDING SYSTEM IN THE CONTEXT OF RUNNING) - bounswe/bounswe2025group2 GitHub Wiki

ℹ️ Introduction

Encouraging kids and young athletes to stay active is a key goal of the platform. This feature allows users to log their running miles, compete for the top spot, and earn a "Running Champion on Quahog" badge if they achieve the highest distance in a given week. By recognizing top performers, the platform motivates participants to set and reach their fitness goals.

πŸ‘€ Runner Persona: Lois

Lois is a 21-year-old university student passionate about running. She actively participates in virtual fitness challenges and logs her miles in the app. Her goal is to become the "Week's Best Runner" by consistently tracking and improving her performance.

🎭 Actors

  • Lois (Runner): A university student who logs her runs and competes on the leaderboard.
  • System: Tracks running distances, updates leaderboards, and awards the "Week's Best Runner" badge.

πŸ”— Preconditions

  • Lois must have an active user account on the platform. πŸ”
  • The app must support logging of running distances. πŸ“²
  • Weekly tracking must be enabled, with rankings resetting every Monday. ⏳

πŸ“ Main Scenario

  1. Login: Lois logs into her account on the platform. πŸ”‘
  2. Run Logging: She records her daily running sessions, entering distance and time. πŸƒβ€β™€οΈπŸ“Š
  3. Leaderboard Update: The system updates the leaderboard based on logged miles. πŸ“ˆ
  4. Weekly Evaluation: At the end of the week, the system determines the top runner based on total miles logged. πŸ†
  5. Badge Award: If Lois logs the most miles, she receives the "Week's Best Runner" badge. πŸŽ–οΈ
  6. Notification: Lois is notified via an in-app pop-up. πŸ“©
  7. Profile Update: The badge appears on Lois’s profile, showcasing her accomplishment to the community. πŸ‘€πŸ…

πŸ”„ Alternative Flows

  • Tie in Miles: If multiple users log the same top distance, the badge is awarded based on the earliest submission. ⏳🏁
  • Data Entry Error: If Lois enters incorrect miles, she can edit or delete the log within a limited timeframe. βœοΈπŸ”„
  • Late Submission: Runs logged after the weekly deadline do not count toward rankings. 🚫⏰

🎯 Postconditions

  • If Lois Wins: She gets the "Week's Best Runner" badge and recognition on the leaderboard. πŸ…πŸŽ‰
  • If Lois Does Not Win: She can try again next week and track her improvement. πŸ”„

πŸ”” Notifications

  • Lois receives updates on her weekly ranking and progress. πŸ“’
  • A congratulatory message is sent upon winning. 🎊
  • Other users in the community are encouraged to participate in the challenge. 🏁

πŸ”’ Privacy and Data Security

  • Lois's running data is stored securely and only visible to authorized users. πŸ”
  • The leaderboard displays rankings but protects sensitive user information. πŸ›‘οΈ

Requirements for Running Challenge & Leaderboard

1. Functional Requirements

  • Users can log their running distance by entering the mileage and duration.
  • The system updates the weekly leaderboard based on total distance logged.
  • Users can edit or delete incorrect run entries within a limited timeframe.
  • The leaderboard resets every Monday at 00:00 UTC.
  • The system awards the "Running Champion on Quahog" badge to the user with the highest weekly mileage.
  • If multiple users tie for the top distance, the badge is awarded to the earliest submission.
  • Users receive in-app notifications for ranking updates, badge awards, and challenge encouragement.
  • The badge is displayed on the winner’s profile, with a count of total wins.

2. Non-Functional Requirements

  • The leaderboard updates within 5 seconds of a new run entry.
  • The system must be accessible on both web and mobile platforms.
  • System uptime is 99.9%, with weekly data backups.
  • Running data is stored securely, with user privacy protections in place.

##Mock Up Click