Add competitions with rewards including scholarships and prizes

[Copilot]

Implements a comprehensive competitions system that allows administrators to create educational competitions with multiple reward types, encouraging student participation and achievement.

Features

Models

• Competition: Manages competitions with configurable challenges, dates, entry fees, and participant limits
• CompetitionReward: Supports 7 reward types (scholarships, premium subscriptions, merchandise, points, badges, certificates, goods) with position-based distribution
• CompetitionParticipant: Auto-tracks participant scores, rankings, and claimed rewards

User Experience

• Competition listing page with status filters (upcoming, active, ended, archived)
• Detailed competition view showing rewards, challenges, and leaderboard
• Join competition functionality with entry fee validation
• Full leaderboard with participant rankings and statistics

Admin Interface

• Full CRUD operations with inline reward and participant management
• Custom admin actions for bulk score/rank updates
• Comprehensive field validation and help text

Automatic Features

• Challenge submissions automatically update competition participant scores
• Rank recalculation after score updates
• Reward distribution method for ended competitions
• Integration with existing Points and Challenge systems

Implementation Details

• URLs: /competitions/, /competitions/<id>/, /competitions/<id>/join/, /competitions/<id>/leaderboard/
• Templates: Responsive design with Tailwind CSS and dark mode support
• Migration: 0063_competition_competitionreward_competitionparticipant.py
• Tests: 313 lines of comprehensive unit tests in web/tests/test_competition.py

Documentation

• Complete feature documentation in docs/COMPETITIONS.md
• Sample data creation script in scripts/create_sample_competition.py
• Updated README with competition features

Code Quality

• ✅ All code formatted with black, isort, and djlint
• ✅ Passes flake8 linting with zero errors
• ✅ Comprehensive test coverage
• ✅ Full documentation and examples

Fixes #57

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Competitions with Rewards: Offer scholarships, premium subscriptions, or merchandise as prizes.</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

@A1L13N @coderabbitai please code this @A1L13N @coderabbitai please code this @A1L13N @coderabbitai please code this @A1L13N @coderabbitai what do you think of the proposal? @A1L13N @coderabbitai can you share your thoughts in code? @A1L13N @coderabbitai what would the django look like for this? @A1L13N @coderabbitai can you be a bit more technical with your feedback? @A1L13N @coderabbitai thanks for being more technical, can you now please code the whole solution @A1L13N @coderabbitai can you please rework your technical solution, remove django rest framework and just use django views @A1L13N @coderabbitai can you please rework your technical solution, remove django rest framework and just use django views @A1L13N @coderabbitai we already have some related models, can you check the code and see how we could integrate with what we have as well @A1L13N @coderabbitai I was thinking the competition could also be a set of Challenges (we have a model for this) @A1L13N @debadityaroy99 yes it's still available to work on

Fixes #57

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[A1L13N]

@copilot continue

[Copilot]

@copilot continue

I've completed the implementation of the Competitions with Rewards feature! 🎉

What's been implemented:

✅ Models (3 new models with full validation):

• Competition - Contains multiple challenges with configurable rewards
• CompetitionReward - Supports 7 reward types (scholarships, subscriptions, merchandise, points, badges, certificates, goods)
• CompetitionParticipant - Auto-tracks scores and rankings

✅ Admin Interface:

• Full CRUD for competitions with inline reward and participant management
• Admin action to bulk update scores/ranks
• Comprehensive field validation

✅ User Views (4 views):

• Competition list with status filtering
• Competition detail with rewards, challenges, and leaderboard
• Join competition (with entry fee validation)
• Full leaderboard view

✅ Automatic Features:

• Scores auto-update when users complete challenges
• Ranks recalculate automatically
• Integration with existing Points system

✅ Code Quality:

• All code formatted with black, isort, and djlint
• Passes flake8 linting
• 313 lines of comprehensive tests
• Full documentation in docs/COMPETITIONS.md
• Sample data script in scripts/create_sample_competition.py

Ready for manual testing! The feature is fully functional and follows Django/Tailwind best practices with dark mode support.

Commits: 88115a5 (formatting), d547400 (docs)