Skip to content

feat: implement hierarchical achievement engine and global leaderboard #206

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
SatyamPandey-07 wants to merge 8 commits into
base: master
Choose a base branch
from
Open

feat: implement hierarchical achievement engine and global leaderboard #206

SatyamPandey-07 wants to merge 8 commits into from

Conversation

@SatyamPandey-07
Copy link
Contributor

@SatyamPandey-07 SatyamPandey-07 commented Jan 22, 2026 •
edited
Loading

Summary

Introduces a dynamic achievement system and a weighted global leaderboard to gamify user engagement.

Changes

  • Models: Achievement (definitions) and UserAchievement (progress tracking).
  • Engine: AchievementService automatically processes every activity log to update progress and unlock badges.
  • Scoring: Implemented GrindScore algorithm (Hard=3x, Medium=2x, Easy=1x) for fair rankings.
  • Leaderboard: Aggregation pipelines for Global and Friends-only rankings with percentile calculation.
  • Seeding: Auto-seeds default achievements (Consistency, LeetCode, Hard Hitter tiers) on startup.
  • Real-time: Integrated WebSocket triggers for "Achievement Unlocked" notifications.

API Endpoints

Method Endpoint Description
GET /api/achievements List user's locked/unlocked badges
GET /api/leaderboard/global Global ranking with pagination
GET /api/leaderboard/friends Ranking among friends

Fixes #190

@SatyamPandey-07
feat: implement hierarchical achievement engine and global leaderboard
8b3f12e 
- Created Achievement and UserAchievement models- Implemented AchievementService for real-time progress tracking- Added logic for consistency, platform, and difficulty-based badges- Built LeaderboardService with GrindScore calculation and weighted ranking- Added REST APIs for achievements and leaderboards- Integrated achievement seeding on server start
@Yugenjr
Copy link
Owner

Yugenjr commented Jan 22, 2026

conflicts !!

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 22, 2026

image resolved @Yugenjr sir

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 22, 2026

No conflict here sir

@Yugenjr
Copy link
Owner

Yugenjr commented Jan 22, 2026

add some screenshots of the issue being solved please !

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 22, 2026

image

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 22, 2026

done @Yugenjr

1 similar comment
@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 22, 2026

done @Yugenjr

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 23, 2026

review and merge it sir

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 23, 2026

@Yugenjr

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 24, 2026

@Yugenjr

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 25, 2026

image

@SatyamPandey-07
Copy link
Contributor Author

SatyamPandey-07 commented Jan 25, 2026

No conflicts with base branch @Yugenjr

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Feature] Implement Hierarchical Achievement Engine & Global Leaderboard Logic

2 participants

@SatyamPandey-07 @Yugenjr