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,28 @@
+# FE21 — XApp 壳与目录关系
+
+> 状态：当前有效
+> 代码依据：`frontend/src/xapps/views/*`、`frontend/src/router/index.js`
+> 最后更新：2026-09-21
+
+## 1. 当前结构
+
+前端当前同时存在：
+
+- xapp 对象目录
+- xapp 运行壳
+
+这两层共同构成 xapp 的前端表达。
+
+## 2. 目录与壳的分工
+
+| 结构 | 主要路由 | 当前职责 |
+|---|---|---|
+| xapp 对象目录 | `/catalog/xapps` | 看 xapp 定义、能力摘要与打开入口 |
+| xapp 运行目录 | `/xapps` | 看当前可直接进入的长程 xapp |
+| xapp 独立壳 | `/xapps/internal-training/*`、`/xapps/internal-exam/*` | 承载具体场景页 |
+
+## 3. 当前判断
+
+- xapp 是平台一级对象
+- xapp 壳是前端运行面，不是对象定义本身
+- 培训考试当前属于“以 xapp 壳承载的兼容场景”
@@ -0,0 +1,24 @@
+# FE22 — 内部培训 XApp
+
+> 状态：当前有效
+> 代码依据：`frontend/src/xapps/views/TrainingXAppShell.vue`、`frontend/src/router/index.js`
+> 最后更新：2026-09-21
+
+## 1. 当前定位
+
+内部培训当前以前端独立 xapp 壳存在。
+
+它是：
+
+**兼容场景域中的业务 xapp。**
+
+## 2. 当前路由
+
+- `/xapps/internal-training`
+- 其下继续挂接公司介绍、产品、课程、学习相关页面
+
+## 3. 当前判断
+
+- 它不再承担系统一级导航定义职责
+- 它在前端中的位置是 xapp 运行面
+- 它内部继续承载旧培训内容页
@@ -0,0 +1,24 @@
+# FE23 — 内部考试 XApp
+
+> 状态：当前有效
+> 代码依据：`frontend/src/xapps/views/ExamXAppShell.vue`、`frontend/src/router/index.js`
+> 最后更新：2026-09-21
+
+## 1. 当前定位
+
+内部考试当前以前端独立 xapp 壳存在。
+
+它是：
+
+**兼容场景域中的业务 xapp。**
+
+## 2. 当前路由
+
+- `/xapps/internal-exam`
+- 其下继续挂接考试封面、开始考试、记录、错题、证书等页面
+
+## 3. 当前判断
+
+- 内部考试已经从系统主导航心智中降为 xapp 运行面
+- 考试对象与记录继续存在，但由 xapp 壳组织前端入口
+- 它和对象目录中的 xapp 定义层是两层结构