Add comprehensive quiz system with leaderboard integration

Add Quiz, QuizQuestion, and UserScore models for tracking quiz sessions and scores
- Implement quiz functionality with 15 questions per category (5 easy, 5 medium, 5 hard)
- Add quiz views: start_quiz, take_quiz, submit_quiz_answer, quiz_results
- Create interactive quiz templates with progress bar and timer
- Implement real-time scoring system that saves UserScore on quiz completion
- Add leaderboard view displaying top 10 scorers per category with rankings
- Integrate user scores display in navigation bar via context processor
- Fix template syntax error by replacing invalid 'mul' filter with 'widthratio'
- Remove Quiz model unique constraint to allow multiple quizzes per user/category
- Add comprehensive error handling and debug logging for quiz completion
- Ensure quiz scores are immediately visible in leaderboard and navigation

Features:
- Category-based quizzes (crypto, network, web, general)
- Difficulty-based question selection (easy/medium/hard)
- Real-time progress tracking and scoring
- Best score tracking per category
- Leaderboard with rankings 1-10
- User total score display in navigation
- Quiz completion with automatic score saving
- Responsive quiz interface with timer and progress bar

Author: kri2tle

core/settings.py

@@ -173,8 +173,7 @@
                 "django.contrib.messages.context_processors.messages",
                 'home.context_processors.dynamic_page_title',
                 'home.context_processors.recaptcha_site_key',
-
-
+                'home.context_processors.user_scores',
             ],
         },
     },

home/context_processors.py

@@ -1,6 +1,7 @@
 # home/context_processors.py
 from django.utils.text import capfirst
 from django.conf import settings
+from .models import UserScore
 
 def dynamic_page_title(request):
     # Extract the path and capitalize it
@@ -31,4 +32,15 @@ def dynamic_page_title(request):
 def recaptcha_site_key(request):
     return {
         'RECAPTCHA_SITE_KEY': settings.RECAPTCHA_SITE_KEY
-    }
+    }
+
+def user_scores(request):
+    """Add user scores to context for navigation display"""
+    if request.user.is_authenticated:
+        user_scores = UserScore.objects.filter(user=request.user).order_by('-score')
+        total_score = sum(score.score for score in user_scores)
+        return {
+            'user_scores': user_scores,
+            'user_total_score': total_score
+        }
+    return {}

home/management/commands/create_sample_challenges.py

@@ -0,0 +1,48 @@
+# Generated by Django 4.2.14 on 2025-09-16 07:56
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('home', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Quiz',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('category', models.CharField(choices=[('network', 'Network Security'), ('web', 'Web Application Security'), ('crypto', 'Cryptography'), ('general', 'General Knowledge'), ('python', 'Python'), ('javascript', 'JavaScript'), ('html_css', 'HTML & CSS'), ('web_security', 'Web Security'), ('reverse_engineering', 'Reverse Engineering'), ('forensics', 'Forensics'), ('binary_exploitation', 'Binary Exploitation'), ('linux', 'Linux'), ('algorithms', 'Algorithms'), ('data_structures', 'Data Structures'), ('databases', 'Databases'), ('regex', 'Regex'), ('secure_coding', 'Secure Coding'), ('logic_reasoning', 'Logic & Reasoning'), ('misc', 'Miscellaneous')], max_length=20)),
+                ('started_at', models.DateTimeField(auto_now_add=True)),
+                ('completed_at', models.DateTimeField(blank=True, null=True)),
+                ('is_completed', models.BooleanField(default=False)),
+                ('total_score', models.IntegerField(default=0)),
+                ('questions_answered', models.IntegerField(default=0)),
+                ('current_question_index', models.IntegerField(default=0)),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'unique_together': {('user', 'category')},
+            },
+        ),
+        migrations.CreateModel(
+            name='QuizQuestion',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('question_order', models.IntegerField()),
+                ('user_answer', models.CharField(blank=True, max_length=200, null=True)),
+                ('is_correct', models.BooleanField(default=False)),
+                ('answered_at', models.DateTimeField(blank=True, null=True)),
+                ('challenge', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='home.cyberchallenge')),
+                ('quiz', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='questions', to='home.quiz')),
+            ],
+            options={
+                'ordering': ['question_order'],
+                'unique_together': {('quiz', 'question_order')},
+            },
+        ),
+    ]

home/migrations/0002_quiz_quizquestion.py

@@ -0,0 +1,29 @@
+# Generated by Django 4.2.14 on 2025-09-16 08:10
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('home', '0002_quiz_quizquestion'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='UserScore',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('category', models.CharField(choices=[('network', 'Network Security'), ('web', 'Web Application Security'), ('crypto', 'Cryptography'), ('general', 'General Knowledge'), ('python', 'Python'), ('javascript', 'JavaScript'), ('html_css', 'HTML & CSS'), ('web_security', 'Web Security'), ('reverse_engineering', 'Reverse Engineering'), ('forensics', 'Forensics'), ('binary_exploitation', 'Binary Exploitation'), ('linux', 'Linux'), ('algorithms', 'Algorithms'), ('data_structures', 'Data Structures'), ('databases', 'Databases'), ('regex', 'Regex'), ('secure_coding', 'Secure Coding'), ('logic_reasoning', 'Logic & Reasoning'), ('misc', 'Miscellaneous')], max_length=20)),
+                ('score', models.IntegerField(default=0)),
+                ('quiz_completed_at', models.DateTimeField(auto_now_add=True)),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'ordering': ['-score', '-quiz_completed_at'],
+                'unique_together': {('user', 'category')},
+            },
+        ),
+    ]

home/migrations/0003_userscore.py

@@ -0,0 +1,21 @@
+# Generated by Django 4.2.14 on 2025-09-16 09:38
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('home', '0003_userscore'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='quiz',
+            options={'ordering': ['-started_at']},
+        ),
+        migrations.AlterUniqueTogether(
+            name='quiz',
+            unique_together=set(),
+        ),
+    ]

home/migrations/0004_remove_quiz_unique_constraint.py

@@ -422,6 +422,53 @@ def __str__(self):
         return self.title
 
 
+class UserScore(models.Model):
+    """Model to track user scores for each category"""
+    user = models.ForeignKey(User, on_delete=models.CASCADE)
+    category = models.CharField(max_length=20, choices=CyberChallenge.CATEGORY_CHOICES)
+    score = models.IntegerField(default=0)
+    quiz_completed_at = models.DateTimeField(auto_now_add=True)
+    
+    class Meta:
+        unique_together = ['user', 'category']
+        ordering = ['-score', '-quiz_completed_at']
+    
+    def __str__(self):
+        return f"{self.user.first_name} {self.user.last_name} - {self.category}: {self.score}"
+
+class Quiz(models.Model):
+    """Model to track quiz sessions for each category"""
+    user = models.ForeignKey(User, on_delete=models.CASCADE)
+    category = models.CharField(max_length=20, choices=CyberChallenge.CATEGORY_CHOICES)
+    started_at = models.DateTimeField(auto_now_add=True)
+    completed_at = models.DateTimeField(null=True, blank=True)
+    is_completed = models.BooleanField(default=False)
+    total_score = models.IntegerField(default=0)
+    questions_answered = models.IntegerField(default=0)
+    current_question_index = models.IntegerField(default=0)
+    
+    class Meta:
+        ordering = ['-started_at']
+    
+    def __str__(self):
+        return f"{self.user.username} - {self.category} Quiz"
+
+class QuizQuestion(models.Model):
+    """Model to track individual quiz questions and answers"""
+    quiz = models.ForeignKey(Quiz, on_delete=models.CASCADE, related_name='questions')
+    challenge = models.ForeignKey(CyberChallenge, on_delete=models.CASCADE)
+    question_order = models.IntegerField()
+    user_answer = models.CharField(max_length=200, blank=True, null=True)
+    is_correct = models.BooleanField(default=False)
+    answered_at = models.DateTimeField(null=True, blank=True)
+    
+    class Meta:
+        unique_together = ['quiz', 'question_order']
+        ordering = ['question_order']
+    
+    def __str__(self):
+        return f"{self.quiz} - Q{self.question_order}"
+
 class UserChallenge(models.Model):
     user = models.ForeignKey(User, on_delete=models.CASCADE)
     challenge = models.ForeignKey(CyberChallenge, on_delete=models.CASCADE)

home/models.py

@@ -359,6 +359,14 @@
           <span class="header-profile-name">{{ request.user.first_name }} {{ request.user.last_name }}</span>
       </a>
 
+      <!-- User Score Display -->
+      {% if user_total_score > 0 %}
+      <div class="user-score-display">
+        <span class="score-label">Score:</span>
+        <span class="score-value">{{ user_total_score }}</span>
+      </div>
+      {% endif %}
+
 
         {% else %}
         <div class="sign-up-button-container">
@@ -458,6 +466,35 @@
 <style>
   .header-profile-name { color: #1a1a1a !important; }
   body.dark-mode .header-profile-name { color: #fff !important; }
+  
+  .user-score-display {
+    display: inline-flex;
+    align-items: center;
+    background-color: #ffa500;
+    color: #000;
+    padding: 6px 12px;
+    border-radius: 20px;
+    margin-left: 10px;
+    font-weight: bold;
+    font-size: 14px;
+  }
+  
+  .score-label {
+    margin-right: 5px;
+  }
+  
+  .score-value {
+    background-color: #000;
+    color: #ffa500;
+    padding: 2px 8px;
+    border-radius: 10px;
+    font-weight: bold;
+  }
+  
+  body.dark-mode .user-score-display {
+    background-color: #ffa500;
+    color: #000;
+  }
   </style>
 
 <style>

home/templates/includes/navigation.html

@@ -145,6 +145,23 @@ <h2 class="category-heading">{{ category|title }} Challenges</h2>
     <a href="{% url 'challenge_list' %}" class="back-button">← Back to Categories</a>
   </div>
 
+  <!-- Quiz Option -->
+  <div class="row mb-4">
+    <div class="col-12">
+      <div class="card" style="background-color: #34344a; border: 2px solid #ffa500; border-radius: 16px;">
+        <div class="card-body text-center">
+          <h4 class="text-white mb-3">🎯 Take Category Quiz</h4>
+          <p class="text-white-50 mb-3">
+            Test your knowledge with 15 questions (5 Easy, 5 Medium, 5 Hard) from {{ category|title }} category.
+          </p>
+          <a href="{% url 'start_quiz' category %}" class="btn btn-warning btn-lg px-4">
+            <i class="fas fa-play-circle me-2"></i>Start Quiz
+          </a>
+        </div>
+      </div>
+    </div>
+  </div>
+
   <div class="row mt-4">
     {% for challenge in challenges %}
       <div class="col-md-6 col-lg-4 mb-4 d-flex">