DRU-663 -- Name subjects with __str__ and let a model declare its order

[czpython]

A subject's __str__ is its name on runs, events, the Activity feed, and its board, replacing get_key(). The default stays its type and id, such as note 7.

class Decision(StoredSubject, ordering=("-created_at",)):
    title: Mapped[str]
    outcome: Mapped[DecisionAction]   # a Literal, stored under a CHECK

    def __str__(self) -> str:
        return self.title

• The subject title goes from runs, events, the feed and its search, and SubjectSummary, and summary_class goes with it. The platform builds its header from the id and the name; an app with its own frontend overrides get_summary().
• A model declares its order on the class line in Django's form, and filter and the default board follow it.
• A Literal column is stored under a CHECK of its values, like a StrEnum.
• An identity-only Subject answers get(id), which raises ObjectNotFound like Model.get.
• A page for a missing subject links back to its parent page, or to the app's landing page.
• Gate.answer and Workflow.cancel read their run through Run.get_latest_for_subject, which can narrow to the gate a run is parked on.
• Software Factory builds a pull request subject with PullRequest(id=...), and a work item names itself with its ticket key and title.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
druks	🟢 Ready	View Preview	Sep 27, 2026, 4:43 PM

💡 Tip: Enable Automations to automatically generate PRs for you.