docs: 重构仓库文档目录并迁移训练素材

按当前架构重组 docs 目录，统一中文命名与目录分层，并将训练原材料迁移到独立目录以保持架构文档边界清晰。
2026-09-22 23:23:16 +08:00
parent 9288f0215a
commit 90031b75f3
9046 changed files with 23786 additions and 3483 deletions
@@ -0,0 +1,45 @@
+# CP01 — 内部考试域
+
+> 状态：当前有效
+> 代码依据：`backend-go/internal/api/exam.go`
+> 最后更新：2026-09-21
+
+## 1. 当前定位
+
+内部考试是：
+
+**兼容业务域中的业务 xapp 支撑域。**
+
+它不承担后端主轴定义职责。
+
+## 2. 当前核心对象
+
+- `question`
+- `exam_paper`
+- `exam_record`
+- `mistake_record`
+- `certificate`
+- `position_exam_blueprint`
+
+## 3. 当前接口
+
+- `GET /api/exam/list`
+- `GET /api/exam/cover`
+- `POST /api/exam/start`
+- `POST /api/exam/submit`
+- `GET /api/exam/record`
+- `GET /api/exam/mistakes`
+- `GET /api/exam/certificates`
+
+管理员侧继续管理题目和试卷：
+
+- `GET /api/exam/questions`
+- `POST /api/exam/questions`
+- `GET /api/exam/papers`
+- `POST /api/exam/papers`
+
+## 4. 当前判断
+
+- 考试仍然是有效运行场景
+- 它当前通过 `internal-exam` xapp 进入前台
+- 它在后端中的位置是兼容业务域，而不是平台主轴
@@ -0,0 +1,33 @@
+# CP02 — 内部培训与学习资产域
+
+> 状态：当前有效
+> 最后更新：2026-09-21
+
+## 1. 当前定位
+
+内部培训当前属于兼容业务域中的业务 xapp 支撑域。
+
+它通过 `internal-training` xapp 进入前台。
+
+## 2. 当前核心对象
+
+- `company_train`
+- `product`
+- `course`
+- `learning_progress`
+- `position_knowledge`
+
+## 3. 当前接口
+
+- `GET /api/company-train`
+- `POST /api/company-train/suggest-material`
+- `GET /api/products`
+- `GET /api/products/:id`
+- `GET /api/courses`
+- `GET /api/courses/:id`
+
+## 4. 当前判断
+
+- 产品、课程与学习进度继续有效
+- 它们当前属于培训学习场景资产
+- 它们通过知识底座、培训 xapp 和考试域继续被消费
@@ -0,0 +1,16 @@
+# 05_兼容业务域 — 目录说明
+
+本目录描述当前仍在运行的兼容场景域。
+
+这些场景继续有效，但不承担后端主轴定义职责。
+
+当前重点包括：
+
+- 内部培训
+- 内部考试
+- 产品、课程与学习资产
+
+建议阅读顺序：
+
+1. `CP01_内部考试域.md`
+2. `CP02_内部培训与学习资产域.md`