0e6c18d886
Figures
A question could carry exactly one stem image and one explanation image, each a
bare path with no title, no legend, and no way for the prose to refer to it.
`question_media` makes a figure a row: it points at an image already in the bank,
carries a role, a label the text can name ("Figure 1"), a caption and an order,
and there can be as many as the question needs. The same radiograph can serve two
questions without being stored twice.
The 346 existing paths were backfilled into figure records and retitled —
`page_339_img_0.png` says where a file came from and nothing about what it shows,
so the filename moved into the caption where it is still searchable, and the
title became something a person can read.
On the editor question: no new platform needed. Milkdown is already installed —
ProseMirror-based, MIT, GFM tables, code blocks, LaTeX — and already used for
articles, courses and the quick question modal. Only the question *page* still
has plain textareas, and that swap is written down rather than rushed, because
the stem carries manual-highlight offsets and a WYSIWYG rewrite would move them.
Fewer hints during a quiz
The category trail and the difficulty pill were shown beside every stem. Being
told a question is filed under Neonatology, or that it is "hard", narrows the
answer before the stem has been read. Both now wait until the answer is in,
where the trail becomes a way to more of the same topic.
The dashboard is about questions
Quizzes and attempts describe how the material happens to be packaged. What a
learner is working through is questions: how many of the bank they have seen,
how many they have answered correctly, and their average. The old per-quiz
performance card — which needed two attempts before it showed anything — is
gone, superseded by the session analysis. The greeting sits above "continue your
study" rather than below it, where it read as a heading for the wrong section.
208 backend, 249 frontend green.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TqXevQJhxFrM7jJg82cgZN
26 lines
1.2 KiB
Python
26 lines
1.2 KiB
Python
from sqlalchemy import Column, ForeignKey, Integer, String, Text, UniqueConstraint
|
|
|
|
from app.database import Base
|
|
|
|
|
|
class QuestionMedia(Base):
|
|
"""One figure on a question.
|
|
|
|
A figure is a row rather than a path so it can be labelled, ordered, and
|
|
reused: the same radiograph can illustrate two questions without being
|
|
stored twice, and the bank knows where each one is used.
|
|
"""
|
|
|
|
__tablename__ = "question_media"
|
|
__table_args__ = (UniqueConstraint("question_id", "media_id", "role", name="uq_question_media"),)
|
|
|
|
id = Column(Integer, primary_key=True, index=True)
|
|
question_id = Column(Integer, ForeignKey("questions.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
media_id = Column(Integer, ForeignKey("media_assets.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
# stem | explanation. A figure that gives the answer away must never sit
|
|
# beside the question, which is the mistake this area started with.
|
|
role = Column(String(20), nullable=False, default="stem")
|
|
# What the prose calls it, so "shown in Figure 1" refers to something.
|
|
label = Column(String(80), nullable=True)
|
|
caption = Column(Text, nullable=True)
|
|
position = Column(Integer, default=0)
|