简体中文
系统架构
本页依据后端main df87ca0。本轮只确认后端契约,不据此宣称前端已经完成接入。
内容身份与版本
知识点是可独立引用的公共知识实体,知识点版本保存其某次确定的内容。讲义是作者内容和公共知识点引用的有序组织,讲义版本包含完整目录和内容块。章节、小节属于具体讲义版本,不再承担公共知识身份。知识分类与讲义分类独立维护。
引用块同时固定knowledge_point_id和knowledge_revision_id,只允许已审核版本。知识点新版通过不会自动替换已有讲义内容。occurrence_id标记章、节或块的出现实例;掌握记录关联知识点永久ID。免登录个人讲义、批注及掌握记录保存在浏览器,本轮没有云端同步接口。
编辑与公开
知识点贡献者或管理员编辑知识点草稿;讲义所有者、管理员和edit协作者编辑讲义草稿,view协作者只读。两种草稿通过edit_version检查并发。保存与提交均递增并发号;提交后不能再编辑内容,修改须复制为新草稿。
管理员审核确定版本。通过知识点审核更新其公开版本;通过讲义审核发布该完整版本。上下架和推荐另有状态,不能与审核混用。公开讲义读取固定引用版本内容,下架返回404。管理员目前可以自审;停用知识点的已有引用仍返回固定版本正文,归档讲义也可重新上架。这些行为的产品规则仍待确认。
前置关系
知识点前置关系独立于讲义目录,由管理员维护整组关系,数据库检查成环。当前接口不返回旧课程的章节上卷edges。前端展示路线图的进一步规则需单独约定,不能从旧图谱实现推定。
具体请求见接入流程。