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

docs(education): document bounded EDU-011 capability

Browse Source
This commit is contained in:
wangziqi
2026-07-31 12:46:22 +08:00
parent e6202187ec
commit 26fa2dfaa2
4 changed files with 75 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -104,17 +104,29 @@ _Avoid_: Question publication, snapshot invalidation
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
**Category Publication State**:
The lifecycle of a tenant-owned Subject-scoped Category: Draft is author-editable and student-invisible, Active is immutable and discoverable, and Archived is terminal and undiscoverable. Category does not classify Questions.
_Avoid_: Question Placement, question category relation
**Content Import Asset**:
Tenant-owned metadata that identifies one private Infra-managed source object for an Education import. Education owns the business reference and checksum metadata, not generic file storage or a public download URL.
_Avoid_: Uploaded file owned by Education, public asset URL
**Practice Blueprint**:
A bounded tenant-owned practice configuration attached to exactly one active current-tenant Content Node or Manual Question Collection. Its route and eligible counts are server-derived; it does not define dynamic filtering, entitlement, or descendant traversal.
_Avoid_: Dynamic query, paid practice policy
**Content Import Job**:
A tenant-owned durable Education job that previews and, only when safe and executable, imports content from one Content Import Asset. Its five states are `PREVIEW`, `PENDING`, `PROCESSING`, `COMPLETED`, and `FAILED`.
_Avoid_: Generic Infra job, export job
**Practice Blueprint Publication State**:
The lifecycle of a Practice Blueprint: Draft is author-editable and student-invisible, Active is immutable and returned only while its target route remains available, and Archived is terminal and unavailable.
_Avoid_: Boolean availability as an independent state
**Import Job Lease**:
A fenced, expiring claim on a `PROCESSING` Content Import Job, identified by worker and lease token and kept alive by heartbeat. Expiry permits bounded recovery; it is not proof that the prior worker stopped.
_Avoid_: Redis lock as job ownership, permanent worker assignment
**Executable Import Preview**:
A preview whose source scan is clean and whose available parser produced executable content. Metadata-only CSV/XLSX preview is informative but not executable.
_Avoid_: Successful upload, clean scan alone
**Unavailable Import Scan**:
The fail-closed default when no scanner adapter can produce a clean result. `UNAVAILABLE`, infected, and errored scan outcomes all block execution.
_Avoid_: Scan skipped, assumed clean
**Export Redaction Policy**:
The request-time rule that authorized Education exports must omit answers and private fields. The current bounded capability defines this policy only; it does not generate an export file or persist an export job.
_Avoid_: Delivered export pipeline, downloadable export artifact
**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.