ross/penracourses
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add HTMX-based aggregated response summary for exam questions

Browse Source
This commit is contained in:
Ross
2025-11-09 22:09:23 +00:00
parent 092c4a1be6
commit 3e9a96d99f
4 changed files with 116 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files
sbas/templates/sbas/partials/exam_review_question_fragment.html
+7 -41
View File
@@ -109,49 +109,15 @@
<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 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 id="response-summary"
hx-get="{% url 'sbas:exam_review_question_summary' exam.pk q_index %}"
hx-trigger="load"
hx-swap="innerHTML">
<div class="small text-muted">Loading summary…</div>
</div>
</div>
{# Responses partial: load on demand via HTMX. Button fetches partial into #responses-container #}
sbas/templates/sbas/partials/exam_review_question_summary_fragment.html
+43
View File
@@ -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
+10
View File
@@ -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
+56
View File
@@ -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)