pj0235-eai_agentplatform/docs/02_Architecture/AR02_前端架构.md

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