@librex/education-core
v2.0.0
Published
LibreX Education Core - question domain contracts and fixtures
Readme
@librex/education-core
教育题目领域模型和转换工具,不含 UI。Web 题目编辑和展示见 @librex/education-web。
安装与导入
npm install @librex/education-coreimport {
createDefaultQuestionData,
inspectQuestionDocument,
inspectQuestionResponse,
projectStudentQuestion,
QUESTION_DOCUMENT_SCHEMA,
} from '@librex/education-core'
import type { QuestionData, QuestionDocument, QuestionType } from '@librex/education-core'所有 API 从唯一根入口导入。
旧式题目草稿
const question: QuestionData = createDefaultQuestionData('single')
question.stem = '1 + 1 = ?'
question.options[0] = { content: '2', isCorrect: true }QuestionData 适用于编辑器草稿,支持题干、选项、答案、解析及 RichContent 字段。QuestionType 包含单选、多选、判断、简答、填空、匹配和排序;QUESTION_TYPES 提供对应目录。resolveQuestionContent() 与 normalizeQuestionContent() 处理传统字符串和 RichContent 字段的兼容。
发布题目契约
版本化的 QuestionDocument 使用 QUESTION_DOCUMENT_SCHEMA。先用 inspectQuestionDocument(value) 检查外部数据,再用 projectStudentQuestion(question) 生成不包含答案和解析的学生视图;inspectQuestionResponse(value) 检查作答结构。QuestionSubmission 与 QuestionResponse 表达提交记录,不负责后端持久化或身份授权。
另导出 DWMG 与 legacy 题目适配器。建议在系统边界转换一次,再在应用内部使用同一题目契约。
