Add HTMX-based aggregated response summary for exam questions

sbas/templates/sbas/partials/exam_review_question_fragment.html

@@ -109,50 +109,16 @@
             <a class="btn btn-sm btn-outline-secondary" href="{% url app_name|add:':question_detail' question.pk %}" target="_blank">View full question details</a>
         </p>
 
-        {# Aggregated summary: always shown if aggregation context is available #}
+        {# Aggregated summary: HTMX-loaded automatically on fragment load #}
         <div class="mt-3">
             <h6>Response summary</h6>
-            {% if exam_response_total %}
+            <div id="response-summary" 
-                <div class="small text-muted mb-2">Total responses: {{ exam_response_total }}</div>
+                 hx-get="{% url 'sbas:exam_review_question_summary' exam.pk q_index %}"
-                <div class="row mb-2">
+                 hx-trigger="load"
-                    <div class="col-auto">Correct:</div>
+                 hx-swap="innerHTML">
-                    <div class="col">
+                <div class="small text-muted">Loading summary…</div>
-                        {% if exam_response_correct_count is not None %}
-                            <strong>{{ exam_response_correct_count }}</strong>
-                            {% if exam_response_correct_pct is not None %}
-                                <span class="text-muted">({{ exam_response_correct_pct }}%)</span>
-                            {% endif %}
-                        {% else %}
-                            <span class="text-muted">N/A</span>
-                        {% endif %}
             </div>
         </div>
-                <div class="list-group">
-                    <div class="list-group-item d-flex justify-content-between align-items-center">
-                        <div>A</div>
-                        <div><span class="me-2">{{ exam_response_counts.a|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.a|default:0 }}%</small></div>
-                    </div>
-                    <div class="list-group-item d-flex justify-content-between align-items-center">
-                        <div>B</div>
-                        <div><span class="me-2">{{ exam_response_counts.b|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.b|default:0 }}%</small></div>
-                    </div>
-                    <div class="list-group-item d-flex justify-content-between align-items-center">
-                        <div>C</div>
-                        <div><span class="me-2">{{ exam_response_counts.c|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.c|default:0 }}%</small></div>
-                    </div>
-                    <div class="list-group-item d-flex justify-content-between align-items-center">
-                        <div>D</div>
-                        <div><span class="me-2">{{ exam_response_counts.d|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.d|default:0 }}%</small></div>
-                    </div>
-                    <div class="list-group-item d-flex justify-content-between align-items-center">
-                        <div>E</div>
-                        <div><span class="me-2">{{ exam_response_counts.e|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.e|default:0 }}%</small></div>
-                    </div>
-                </div>
-            {% else %}
-                <div class="small text-muted">No responses recorded for this question in the exam yet.</div>
-            {% endif %}
-        </div>
 
         {# Responses partial: load on demand via HTMX. Button fetches partial into #responses-container #}
         <div class="mt-3">

sbas/templates/sbas/partials/exam_review_question_summary_fragment.html

@@ -0,0 +1,43 @@
+{# Partial: aggregated response summary for a question within an exam. HTMX-loadable. #}
+<div id="response-summary-content">
+    {% if exam_response_total %}
+        <div class="small text-muted mb-2">Total responses: {{ exam_response_total }}</div>
+        <div class="row mb-2">
+            <div class="col-auto">Correct:</div>
+            <div class="col">
+                {% if exam_response_correct_count is not None %}
+                    <strong>{{ exam_response_correct_count }}</strong>
+                    {% if exam_response_correct_pct is not None %}
+                        <span class="text-muted">({{ exam_response_correct_pct }}%)</span>
+                    {% endif %}
+                {% else %}
+                    <span class="text-muted">N/A</span>
+                {% endif %}
+            </div>
+        </div>
+        <div class="list-group">
+            <div class="list-group-item d-flex justify-content-between align-items-center">
+                <div>A</div>
+                <div><span class="me-2">{{ exam_response_counts.a|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.a|default:0 }}%</small></div>
+            </div>
+            <div class="list-group-item d-flex justify-content-between align-items-center">
+                <div>B</div>
+                <div><span class="me-2">{{ exam_response_counts.b|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.b|default:0 }}%</small></div>
+            </div>
+            <div class="list-group-item d-flex justify-content-between align-items-center">
+                <div>C</div>
+                <div><span class="me-2">{{ exam_response_counts.c|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.c|default:0 }}%</small></div>
+            </div>
+            <div class="list-group-item d-flex justify-content-between align-items-center">
+                <div>D</div>
+                <div><span class="me-2">{{ exam_response_counts.d|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.d|default:0 }}%</small></div>
+            </div>
+            <div class="list-group-item d-flex justify-content-between align-items-center">
+                <div>E</div>
+                <div><span class="me-2">{{ exam_response_counts.e|default:0 }}</span><small class="text-muted">{{ exam_response_pcts.e|default:0 }}%</small></div>
+            </div>
+        </div>
+    {% else %}
+        <div class="small text-muted">No responses recorded for this question in the exam yet.</div>
+    {% endif %}
+</div>

sbas/urls.py

@@ -122,6 +122,16 @@ urlpatterns = [
         views.exam_review_question_responses,
         name="exam_review_question_responses",
     ),
+    path(
+        "exam/<int:pk>/review/<int:q_index>/summary",
+        views.exam_review_question_summary,
+        name="exam_review_question_summary",
+    ),
+    path(
+        "exam/<int:pk>/review/<int:q_index>/responses",
+        views.exam_review_question_responses,
+        name="exam_review_question_responses",
+    ),
     path("question/<int:pk>/toggle_frcr/", views.toggle_frcr_appropriate, name="toggle_frcr"),
     path("category/merge/", views.merge_category, name="merge_category"),
     #path(

sbas/views.py

@@ -120,6 +120,62 @@ def exam_review_question_responses(request, pk: int, q_index: int):
     return render(request, "sbas/partials/exam_review_question_responses_fragment.html", context)
 
 
+@login_required
+def exam_review_question_summary(request, pk: int, q_index: int):
+    """Return the aggregated response summary partial for a given exam question (HTMX-friendly).
+
+    Computes counts and percentages for choices a..e and returns the summary partial.
+    """
+    exam = get_object_or_404(Exam, pk=pk)
+
+    questions = exam.get_questions()
+    try:
+        question = questions[q_index]
+    except Exception:
+        raise Http404("Question not found in exam")
+
+    # Aggregate user answers for this question & exam
+    ua_qs = question.cid_user_answers.filter(exam=exam)
+    total_responses = ua_qs.count()
+
+    counts = {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0}
+    for ans in ua_qs.values_list("answer", flat=True):
+        if ans in counts:
+            counts[ans] += 1
+        else:
+            # Unexpected answer labels — store them as-is (rare)
+            counts[ans] = counts.get(ans, 0) + 1
+
+    pcts = {}
+    if total_responses:
+        for k, v in counts.items():
+            pcts[k] = round(100.0 * v / total_responses, 1)
+    else:
+        for k in counts.keys():
+            pcts[k] = 0.0
+
+    correct_count = None
+    correct_pct = None
+    if hasattr(question, "best_answer") and question.best_answer:
+        correct_count = ua_qs.filter(answer=question.best_answer).count()
+        if total_responses:
+            correct_pct = round(100.0 * correct_count / total_responses, 1)
+
+    context = {
+        "exam": exam,
+        "question": question,
+        "q_index": q_index,
+        "app_name": "sbas",
+        "exam_response_counts": counts,
+        "exam_response_pcts": pcts,
+        "exam_response_total": total_responses,
+        "exam_response_correct_count": correct_count,
+        "exam_response_correct_pct": correct_pct,
+    }
+
+    return render(request, "sbas/partials/exam_review_question_summary_fragment.html", context)
+
+
 class AuthorOrCheckerRequiredMixin(object):
     def get_object(self, *args, **kwargs):
         obj = super().get_object(*args, **kwargs)