wangziqi/ruoyi-vue-pro
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(education): define manual collection contract

Browse Source
This commit is contained in:
wangziqi
2026-07-31 01:25:52 +08:00
parent 2daeb43c5a
commit 62bbdd4b87
3 changed files with 73 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
yudao-module-education/CONTEXT.md
View File

@@ -80,6 +80,30 @@ _Avoid_: Question Placement Version, Question Content Version
An append-only Education domain fact recording actor, authoring version, and a valid Content Node Publication State transition in the same transaction.
_Avoid_: Operation log as activation proof
**Manual Question Collection**:
A tenant-owned, author-curated ordered set of Published Question Content attached to one existing active, visible Content Node. Its membership is selected explicitly rather than derived from filters, categories, or blueprints.
_Avoid_: Dynamic question bank, Category, Practice Blueprint
**Collection Publication State**:
The lifecycle of a Manual Question Collection: Draft is author-editable and undiscoverable, Active is immutable and discoverable through its Content Node, and Archived is terminal and undiscoverable through the collection route.
_Avoid_: Question Publication State, hidden flag
**Collection Authoring Version**:
The single non-negative optimistic concurrency version advanced by each accepted draft revision, membership replacement, or collection lifecycle transition.
_Avoid_: Question Content Version, Question Placement Version
**Collection Membership**:
The complete ordered list of Published Question Content explicitly curated into a Manual Question Collection. It is replaceable only as a whole while the collection is Draft, and the same question cannot occur more than once.
_Avoid_: Dynamic filter result, incremental published playlist
**Collection Route Discovery**:
Student discovery of questions through an Active Manual Question Collection on its Content Node. Archiving the collection closes only this route and does not withdraw directly visible Question Content or alter historical Question Snapshots.
_Avoid_: Question publication, snapshot invalidation
**Collection Access Rules**:
Descriptive collection metadata reserved for a future access contract. Its presence does not grant, deny, or prove paid, private, membership, or other entitlement in the current Education model.
_Avoid_: Entitlement policy, authorization rule
**Protected Answer Key**:
Server-only correctness and explanation data captured for stable scoring of a practice session. It is never included in a Safe Question, Question Snapshot JSON, or pre-submit response.
_Avoid_: Question Snapshot, frontend answer