234 lines
4.9 KiB
Markdown
234 lines
4.9 KiB
Markdown
# AR02 — 前端架构
|
|
|
|
> 状态：当前有效
|
|
> 最后更新：2026-09-21
|
|
>
|
|
> 说明：
|
|
> 本文档描述当前前端的真实结构与当前统一方向。
|
|
> 历史培训系统版本已归档至 `Historical_Records/AR02_前端架构-培训系统旧稿.md`。
|
|
|
|
---
|
|
|
|
## 1. 当前前端定位
|
|
|
|
当前前端定位为：
|
|
|
|
**以 Workbench 为前门、以任务为中心、以对象目录和 App 为一级结构的数字员工平台前端。**
|
|
|
|
培训与考试业务当前以 App 形式挂载在前端中，旧业务页面持续收编到 App 运行面内。
|
|
|
|
## 2. 当前前端主结构
|
|
|
|
当前前端主体位于：
|
|
|
|
`eai_agentplatform/frontend/src`
|
|
|
|
主要包含以下几层：
|
|
|
|
### 2.1 平台壳层
|
|
|
|
- `layout`
|
|
- `router`
|
|
- `config`
|
|
- `store`
|
|
|
|
职责：
|
|
|
|
- 提供主布局
|
|
- 注册路由
|
|
- 驱动导航
|
|
- 承载全局状态
|
|
|
|
### 2.2 工作台层
|
|
|
|
- `views/workbench`
|
|
|
|
这一层是当前前端的主入口，承接：
|
|
|
|
- 新建任务
|
|
- 项目
|
|
- 知识应用
|
|
- 工坊
|
|
- 控制台
|
|
- 对象目录详情运行面
|
|
|
|
### 2.3 对象层
|
|
|
|
- `specialists`
|
|
- `skills`
|
|
- `xapps`
|
|
- `connectors`
|
|
|
|
这几类目录与后端对象域一一对应，是当前前端最明确的对象化结构。
|
|
|
|
### 2.4 兼容业务页面层
|
|
|
|
- `views/companyTrain`
|
|
- `views/product`
|
|
- `views/salesTrain`
|
|
- `views/exam`
|
|
- `views/knowledge`
|
|
- `views/system`
|
|
- `views/me`
|
|
|
|
这部分作为兼容业务页面层继续运行。
|
|
|
|
## 3. 当前路由骨架
|
|
|
|
当前路由集中在：
|
|
|
|
`frontend/src/router/index.js`
|
|
|
|
当前一级结构可概括为：
|
|
|
|
1. `/home`
|
|
2. `/projects`
|
|
3. `/catalog/*`
|
|
4. `/xapps`
|
|
5. `/knowledge-hub`
|
|
6. `/admin`
|
|
7. `/studio`
|
|
8. `/console`
|
|
|
|
这说明当前前端的中心已经从“培训栏目集合”切到“工作入口 + 对象目录 + App + 知识库 + 治理入口”。
|
|
|
|
## 4. 当前导航口径
|
|
|
|
当前导航配置集中在：
|
|
|
|
`frontend/src/config/nav.js`
|
|
|
|
当前一级导航已经明确为：
|
|
|
|
1. 新建任务
|
|
2. 项目
|
|
3. 专员·技能·APP·连接器
|
|
4. APP
|
|
5. 知识库
|
|
6. 后台管理
|
|
|
|
说明：
|
|
|
|
- 代码当前仍使用 `专员` 与 `APP`
|
|
- 文档统一口径倾向 `专家` 与 `App`
|
|
- 因此前端当前属于**显示词与统一术语仍在过渡中**的状态
|
|
|
|
当前导航已经以任务与对象为中心，显示词仍处于术语收口阶段。
|
|
|
|
## 5. 当前前端对象模型
|
|
|
|
前端当前已形成三类主要对象入口：
|
|
|
|
### 5.1 专员目录
|
|
|
|
- `/catalog/specialists`
|
|
|
|
当前实现命名是 `specialist`，文档统一口径应理解为专家对象。
|
|
|
|
### 5.2 技能目录
|
|
|
|
- `/catalog/skills`
|
|
|
|
技能当前主要作为：
|
|
|
|
- 可浏览的能力定义
|
|
- 可被任务挂载的能力包
|
|
- 可被 App 或专员调用的复用能力
|
|
|
|
### 5.3 App 目录
|
|
|
|
- `/catalog/xapps`
|
|
- `/xapps`
|
|
|
|
当前实现命名是 `xapp`，文档统一口径应理解为 App。
|
|
|
|
其中：
|
|
|
|
- `/catalog/xapps` 更偏定义目录
|
|
- `/xapps` 更偏可运行 App 入口
|
|
|
|
这里需要特别区分：
|
|
|
|
- `xapp` 当前是对象目录中的成品入口壳
|
|
- `Workbench + task` 仍然是当前统一执行前门
|
|
- 前台已经有 xapp 壳，但当前运行主语仍然沿 task 上的 specialist 挂载展开
|
|
|
|
### 5.4 连接器目录
|
|
|
|
- `/catalog/connectors`
|
|
- `/console`
|
|
|
|
连接器当前既有目录入口，也有控制台式治理入口。
|
|
|
|
## 6. 当前 Workbench 架构角色
|
|
|
|
当前 Workbench 是平台真正的运行前门。
|
|
|
|
它承担的职责包括：
|
|
|
|
- 任务入口
|
|
- 对象挂载
|
|
- 项目承载
|
|
- 上下文推进
|
|
- 知识消费
|
|
- 结果留痕
|
|
|
|
`/home` 当前是 Workbench 的 canonical URL，这说明平台前门已经完成切换。
|
|
|
|
## 7. 当前培训与考试业务的正确理解
|
|
|
|
培训与考试相关页面当前仍存在于：
|
|
|
|
- `views/companyTrain`
|
|
- `views/product`
|
|
- `views/salesTrain`
|
|
- `views/exam`
|
|
|
|
但在当前路由组织里，它们已经被挂入：
|
|
|
|
- `TrainingXAppShell`
|
|
- `ExamXAppShell`
|
|
|
|
当前培训与考试已进入 App 运行面收编过程，内部页面仍沿用部分旧实现。
|
|
|
|
## 8. 当前前端的混合态现实
|
|
|
|
当前前端同时存在两套东西：
|
|
|
|
### 8.1 已形成的新骨架
|
|
|
|
- Workbench
|
|
- 项目
|
|
- 对象目录
|
|
- App 目录
|
|
- 知识台
|
|
- 工坊/控制台
|
|
|
|
### 8.2 尚未完全消失的旧页面实现
|
|
|
|
- 公司介绍页
|
|
- 产品页
|
|
- 销售培训页
|
|
- 考试页
|
|
- 知识管理页中的部分旧业务界面
|
|
|
|
因此当前前端处于**新骨架主导、旧页面继续挂载收编**的混合阶段。
|
|
|
|
## 9. 当前前端设计原则
|
|
|
|
后续前端整理应遵循：
|
|
|
|
1. 任务入口优先于专题页面入口
|
|
2. 对象目录负责“看定义”，运行面负责“做任务”
|
|
3. App 是长程运行壳，承载结构化运行面
|
|
4. 培训、考试等旧专题应继续优先收敛到 App 壳层内
|
|
5. 新增业务不再扩张旧栏目式导航
|
|
6. xapp 作为入口壳持续增强，但不能替代当前 task / specialist 运行主轴的表达
|
|
|
|
## 10. 建议阅读
|
|
|
|
1. `docs/01_System_Overall/SY22_角色技能应用统一任务架构.md`
|
|
2. `docs/02_Architecture/AR05_工作台架构约定.md`
|
|
3. `docs/02_Architecture/AR09_对象命名规范.md`
|
|
4. `docs/02_Architecture/AR03_数据库架构.md`
|