docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录，统一中文命名与目录分层，并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
eaiadmin
@@ -0,0 +1,50 @@
|
||||
# FE01 — 前端总体结构
|
||||
|
||||
> 状态：当前有效
|
||||
> 代码依据：`frontend/src/layout/MainLayout.vue`、`frontend/src/config/nav.js`、`frontend/src/router/index.js`
|
||||
> 最后更新：2026-09-21
|
||||
|
||||
## 1. 当前定位
|
||||
|
||||
当前前端是：
|
||||
|
||||
**以平台壳为统一前门、以 Workbench 为执行入口、以对象目录和 xapp 为主要可见结构的数字员工平台前端。**
|
||||
|
||||
## 2. 当前主结构
|
||||
|
||||
前端当前可以分成五层：
|
||||
|
||||
1. 平台壳层
|
||||
`layout / router / config / store`
|
||||
|
||||
2. Workbench 运行层
|
||||
`/home`、`/projects`
|
||||
|
||||
3. 对象目录层
|
||||
`/catalog/specialists`、`/catalog/skills`、`/catalog/xapps`、`/catalog/connectors`
|
||||
|
||||
4. xapp 运行层
|
||||
`/xapps`、`/xapps/internal-training/*`、`/xapps/internal-exam/*`
|
||||
|
||||
5. 知识层
|
||||
`/knowledge-hub`、`/knowledge-management`、`/knowledge/*`
|
||||
|
||||
6. 治理层
|
||||
`/admin`、`/studio`、`/console`、`/system/*`
|
||||
|
||||
## 3. 当前结构判断
|
||||
|
||||
- `MainLayout` 已经是统一平台壳
|
||||
- `/home` 已经是当前任务执行前门
|
||||
- 对象目录与 xapp 目录已经分开
|
||||
- 培训、考试页面继续存在，但当前落在 xapp 运行壳下
|
||||
- 知识页和治理页与 Workbench、对象目录、xapp 壳并列存在
|
||||
|
||||
## 4. 当前阅读口径
|
||||
|
||||
- 看平台入口与前台导航：读 `FE02`
|
||||
- 看任务执行与工作面：读 `FE03`
|
||||
- 看 specialist / skill / xapp / connector 如何暴露给前端：读 `02_对象层`
|
||||
- 看培训考试如何被前端收编为 xapp：读 `03_XApp层`
|
||||
- 看知识页与知识治理：读 `04_知识层`
|
||||
- 看工坊、控制台与系统治理：读 `05_治理层`
|
||||
@@ -0,0 +1,39 @@
|
||||
# FE02 — 平台导航与路由
|
||||
|
||||
> 状态：当前有效
|
||||
> 代码依据：`frontend/src/config/nav.js`、`frontend/src/router/index.js`
|
||||
> 最后更新：2026-09-21
|
||||
|
||||
## 1. 当前一级导航
|
||||
|
||||
当前前端一级导航已经按平台口径组织为：
|
||||
|
||||
1. 新建任务
|
||||
2. 项目
|
||||
3. specialist / skill / xapp / connector 对象目录
|
||||
4. xapp
|
||||
5. 知识库
|
||||
6. 后台管理
|
||||
|
||||
## 2. 当前一级导航与路由映射
|
||||
|
||||
| 一级结构 | 主要路由 | 当前作用 |
|
||||
|---|---|---|
|
||||
| 新建任务 | `/home` | 当前统一执行前门 |
|
||||
| 项目 | `/projects` | 任务容器与项目视图 |
|
||||
| 对象目录 | `/catalog/*` | 浏览 specialist / skill / xapp / connector |
|
||||
| xapp | `/xapps`、`/xapps/internal-*` | 打开长程运行壳与内置 xapp |
|
||||
| 知识库 | `/knowledge-hub`、`/knowledge-management` | 知识应用与知识治理 |
|
||||
| 后台管理 | `/admin`、`/studio`、`/system/*` | 管理后台与对象治理 |
|
||||
|
||||
## 3. 当前导航判断
|
||||
|
||||
- `对象目录` 与 `xapp` 已经分开，前者负责看对象，后者负责进入运行壳
|
||||
- `知识库` 既有用户侧知识应用，也有管理员侧知识治理
|
||||
- `后台管理` 是横切治理层，不承担对象主轴定义
|
||||
|
||||
## 4. 当前边界
|
||||
|
||||
- 旧“首页 / 公司 / 产品 / 课程 / 考试”不再作为前端一级主导航口径
|
||||
- 培训和考试当前通过 xapp 壳进入
|
||||
- 旧导航草图只保留在 `Historical_Records`
|
||||
@@ -0,0 +1,40 @@
|
||||
# FE03 — Workbench 运行面
|
||||
|
||||
> 状态：当前有效
|
||||
> 代码依据：`frontend/src/views/workbench/*`、`frontend/src/store/taskRuntime.js`
|
||||
> 最后更新：2026-09-21
|
||||
|
||||
## 1. 当前定位
|
||||
|
||||
Workbench 是当前前端的统一执行工作面。
|
||||
|
||||
它承接：
|
||||
|
||||
- 新建任务
|
||||
- 打开已有任务
|
||||
- 挂载 specialist
|
||||
- 挂载 skill / xapp 上下文
|
||||
- 查看项目与交付结果
|
||||
|
||||
## 2. 当前核心页面
|
||||
|
||||
- `/home`：统一任务执行前门
|
||||
- `/projects`：项目列表与项目视图
|
||||
|
||||
## 3. 当前运行关系
|
||||
|
||||
当前前端运行关系可以理解为：
|
||||
|
||||
`项目 -> 任务 -> specialist 执行 -> 结果与交付物`
|
||||
|
||||
其中：
|
||||
|
||||
- task 是前台执行上下文
|
||||
- specialist 是主要执行人格
|
||||
- skill 与 xapp 可以通过运行时状态挂载到当前任务
|
||||
|
||||
## 4. 当前判断
|
||||
|
||||
- 当前前端已经以任务为中心组织工作面
|
||||
- 当前运行中心仍然是 specialist-led task
|
||||
- xapp-native task 是演进方向，但不是当前唯一落地形态
|
||||
Reference in New Issue
Block a user