# 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`