Add homework dashboard insights

Author: alexeygrigorev

courses/templates/courses/dashboard.html

@@ -42,6 +42,10 @@ <h2 class="text-base font-semibold app-heading">Course overview</h2>
           <dt class="app-muted">Project completion rate</dt>
           <dd class="font-semibold app-heading">{{ project_completion_rate }}%</dd>
         </div>
+        <div class="grid grid-cols-[minmax(0,1fr)_auto] gap-4 px-4 py-3">
+          <dt class="app-muted">Average total score</dt>
+          <dd class="font-semibold app-heading">{{ avg_total_score }}</dd>
+        </div>
         {% if graduates_count > 0 %}
           <div class="grid grid-cols-[minmax(0,1fr)_auto] gap-4 px-4 py-3">
             <dt class="app-muted">Graduates</dt>
@@ -97,6 +101,7 @@ <h2 class="text-base font-semibold app-heading">Homework statistics</h2>
             <tr>
               <th class="px-3 py-2">Homework</th>
               <th class="px-3 py-2 text-right">Submissions</th>
+              <th class="px-3 py-2 text-right">Completion</th>
               <th class="px-3 py-2 text-right">Lecture time</th>
               <th class="px-3 py-2 text-right">Homework time</th>
               <th class="px-3 py-2 text-right">Total time</th>
@@ -108,6 +113,7 @@ <h2 class="text-base font-semibold app-heading">Homework statistics</h2>
               <tr>
                 <td class="min-w-48 px-3 py-2 font-medium app-heading">{{ hw_stat.homework.title }}</td>
                 <td class="px-3 py-2 text-right">{{ hw_stat.submissions_count }}</td>
+                <td class="px-3 py-2 text-right">{{ hw_stat.completion_rate }}%</td>
                 <td class="px-3 py-2 text-right">
                   {% if hw_stat.time_lecture_median %}
                     <span title="Most students spent between {{ hw_stat.time_lecture_q25|floatformat:1 }} and {{ hw_stat.time_lecture_q75|floatformat:1 }} hours on lectures">
@@ -152,6 +158,10 @@ <h3 class="font-medium app-heading">{{ hw_stat.homework.title }}</h3>
                 <dt class="app-muted">Submissions</dt>
                 <dd class="font-semibold app-heading">{{ hw_stat.submissions_count }}</dd>
               </div>
+              <div>
+                <dt class="app-muted">Completion</dt>
+                <dd class="font-semibold app-heading">{{ hw_stat.completion_rate }}%</dd>
+              </div>
               <div>
                 <dt class="app-muted">Median score</dt>
                 <dd class="font-semibold app-heading">{% if hw_stat.score_median %}{{ hw_stat.score_median|floatformat:0 }}{% else %}-{% endif %}</dd>
@@ -175,6 +185,39 @@ <h3 class="font-medium app-heading">{{ hw_stat.homework.title }}</h3>
     </section>
   {% endif %}
 
+  {% if homework_difficulty_stats %}
+    <section class="mt-6 overflow-hidden rounded-md border app-border app-surface">
+      <div class="border-b app-border app-surface-muted px-4 py-3">
+        <h2 class="text-base font-semibold app-heading">Assignment difficulty</h2>
+        <p class="mt-1 text-sm app-muted">
+          Ranked by lowest median homework score. Lower median scores usually indicate harder assignments.
+        </p>
+      </div>
+      <div class="overflow-x-auto">
+        <table class="min-w-full text-sm">
+          <thead class="app-surface-muted text-left text-xs font-semibold uppercase app-muted">
+            <tr>
+              <th class="px-3 py-2">Rank</th>
+              <th class="px-3 py-2">Homework</th>
+              <th class="px-3 py-2 text-right">Median score</th>
+              <th class="px-3 py-2 text-right">Completion</th>
+            </tr>
+          </thead>
+          <tbody class="divide-y app-divide">
+            {% for hw_stat in homework_difficulty_stats %}
+              <tr>
+                <td class="px-3 py-2 font-semibold app-heading">{{ hw_stat.difficulty_rank }}</td>
+                <td class="min-w-48 px-3 py-2 font-medium app-heading">{{ hw_stat.homework.title }}</td>
+                <td class="px-3 py-2 text-right">{{ hw_stat.score_median|floatformat:0 }}</td>
+                <td class="px-3 py-2 text-right">{{ hw_stat.completion_rate }}%</td>
+              </tr>
+            {% endfor %}
+          </tbody>
+        </table>
+      </div>
+    </section>
+  {% endif %}
+
   {% if graduates_count > 0 %}
     <section class="mt-6 border-t app-border pt-5">
       <h2 class="text-base font-semibold app-heading">Graduates</h2>

courses/tests/test_dashboard.py

@@ -93,6 +93,7 @@ def test_dashboard_context_basic(self):
         self.assertIn("course", response.context)
         self.assertIn("total_enrollments", response.context)
         self.assertIn("homework_stats", response.context)
+        self.assertIn("homework_difficulty_stats", response.context)
         self.assertIn("project_passing_score", response.context)
 
         self.assertEqual(response.context["course"], self.course)
@@ -216,6 +217,7 @@ def test_homework_statistics_calculation(self):
         hw_stat = hw_stats[0]
         self.assertEqual(hw_stat["homework"], self.homework)
         self.assertEqual(hw_stat["submissions_count"], 5)
+        self.assertEqual(hw_stat["completion_rate"], 100.0)
 
         # Check quartile calculations (median should be middle value)
         self.assertEqual(hw_stat["time_lecture_median"], 3.0)
@@ -241,6 +243,51 @@ def test_homework_statistics_with_insufficient_data(self):
         self.assertIsNone(hw_stat["time_lecture_q25"])
         self.assertIsNone(hw_stat["time_lecture_median"])
         self.assertIsNone(hw_stat["time_lecture_q75"])
+        self.assertEqual(hw_stat["completion_rate"], 40.0)
+
+    def test_homework_difficulty_ranking(self):
+        """Test homework difficulty ranking by lowest median score."""
+        harder_homework = Homework.objects.create(
+            course=self.course,
+            slug="hw2",
+            title="Homework 2",
+            due_date=timezone.now() + timedelta(days=14),
+            state=HomeworkState.OPEN.value,
+        )
+
+        for i, (user, enrollment) in enumerate(
+            zip(self.users, self.enrollments)
+        ):
+            Submission.objects.create(
+                homework=self.homework,
+                student=user,
+                enrollment=enrollment,
+                time_spent_lectures=2.0,
+                time_spent_homework=3.0,
+                total_score=90 + i,
+            )
+            Submission.objects.create(
+                homework=harder_homework,
+                student=user,
+                enrollment=enrollment,
+                time_spent_lectures=2.0,
+                time_spent_homework=3.0,
+                total_score=50 + i,
+            )
+
+        url = reverse("dashboard", args=[self.course.slug])
+        response = self.client.get(url)
+
+        difficulty_stats = response.context["homework_difficulty_stats"]
+
+        self.assertEqual(difficulty_stats[0]["homework"], harder_homework)
+        self.assertEqual(difficulty_stats[0]["difficulty_rank"], 1)
+        self.assertEqual(difficulty_stats[0]["score_median"], 52)
+        self.assertEqual(difficulty_stats[1]["homework"], self.homework)
+        self.assertEqual(difficulty_stats[1]["difficulty_rank"], 2)
+
+        self.assertContains(response, "Assignment difficulty")
+        self.assertContains(response, "Completion")
 
     def test_homework_statistics_with_null_values(self):
         """Test homework statistics with some null time values"""

courses/views/course.py

@@ -827,6 +827,11 @@ def safe_quartiles(data):
             {
                 "homework": homework,
                 "submissions_count": len(hw_submissions),
+                "completion_rate": round(
+                    len(hw_submissions) / total_enrollments * 100, 1
+                )
+                if total_enrollments > 0
+                else 0.0,
                 "time_lecture_q25": hw_time_lecture_q25,
                 "time_lecture_median": hw_time_lecture_median,
                 "time_lecture_q75": hw_time_lecture_q75,
@@ -860,6 +865,22 @@ def safe_quartiles(data):
             }
         )
 
+    homework_difficulty_stats = [
+        hw_stat
+        for hw_stat in homework_stats
+        if hw_stat["score_median"] is not None
+    ]
+    homework_difficulty_stats.sort(
+        key=lambda hw_stat: (
+            hw_stat["score_median"],
+            -hw_stat["submissions_count"],
+            hw_stat["homework"].title,
+        )
+    )
+
+    for rank, hw_stat in enumerate(homework_difficulty_stats, start=1):
+        hw_stat["difficulty_rank"] = rank
+
     # Calculate total project submissions
     project_total_submissions = project_pass_count + project_fail_count
 
@@ -885,6 +906,7 @@ def safe_quartiles(data):
         "project_passing_score": course.project_passing_score,
         "graduates_count": graduates_count,
         "homework_stats": homework_stats,
+        "homework_difficulty_stats": homework_difficulty_stats,
     }
 
     return render(request, "courses/dashboard.html", context)