前端迁移¶
目标¶
用 src/ui-v3(Vue 3 + Element Plus + Vite + Pinia)完全替代旧版 src/ui(Vue 2 + BK-MagicBox),并且不是重写,而是1:1 复刻:老前端的文案、接口 payload、URL 契约、默认值、操作符、视觉(色彩/图标/布局)与交互时序("何时出现什么")全部以旧版源码为唯一事实源逐项对齐。
旧版 src/ui |
新版 src/ui-v3 |
|
|---|---|---|
| 框架 | Vue 2 | Vue 3 |
| 组件库 | BK-MagicBox(蓝鲸) | Element Plus + 全局样式复刻 |
| 构建 | Webpack | Vite |
| 状态 | Vuex | Pinia |
| 端口 | 8091(对照基线) | 8090(部署目标) |
替代门禁¶
只有当以下全部通过后,模块才可标记为"完整替代":
页面与深链 ✓ API 读写闭环 ✓ 权限/异常状态 ✓ 视觉基线截图对照 ✓ E2E 自动化 ✓
不能仅凭"路由存在"或"主流程可用"宣称替代——每项能力都要区分:页面存在 / 核心流程 / API 写回 / 异常与权限态 / 视觉 / E2E / 旧版全量可达 / 依赖阻塞 八个层级。
模块覆盖(2026-09-30 迁移收官)¶
| 域 | 模块 | 状态 |
|---|---|---|
| 首页 | 主机搜索 / IP 过滤跳转、404 与空态体系 | ✅ 核心流程 |
| 业务 | 业务拓扑(树/工具栏/主机列表/四对象关联)、服务实例与进程、服务模板、集群模板与同步、服务分类、主机自动应用(三步向导)、动态分组、自定义字段、业务同步、进程模板、跨业务转移确认页 | ✅ 核心流程 |
| 资源 | 资源目录、资源池主机(导入导出/转移/列配置)、业务管理(完整 CRUD)、业务集、项目、删除历史、管控区域、云账户、云资源发现、通用模型实例(含 Excel 导入导出) | ✅ 核心流程 |
| 模型 | 模型管理、模型详情(字段/关系/唯一校验)、模型拓扑、关联类型、字段组合模板 | ✅ 核心流程 |
| 运营与平台 | 操作审计、运营统计、全局配置(三 tab 与保存契约) | ✅ 核心流程 |
| 平台权限 | 登录会话/401、IAM 权限态、权限管理页、v-perm 指令 |
✅ 已接入自研 IAM |
旧版深链(business/:bizId/index、resource/host/:business/:id 等十余种)全部保留兼容,自动重定向到新路由。
依赖阻塞项¶
以下能力依赖 standalone 未启用的外部数据链路,属预期阻塞而非迁移缺口:
- 全文检索:需 Elasticsearch(独立模式默认关闭)
- Pod / 容器详情:需 Kubernetes 集群纳管数据链路
- 云资源实际同步:需真实云厂商凭据(云账户管理功能本身可用)
验证体系¶
- E2E:Playwright 全量回归(路由 smoke + 十余个专项脚本,
src/ui-v3/e2e/run-all.cjs汇总),断言覆盖 URL 契约与请求体 - 视觉对照:关键页面在 1440×900、禁缓存条件下新旧截图逐张评审
- 契约测试:接口 payload / 前缀(
/api/v3与根路径导入导出)不得混用,深链跳转不得回归
完整迁移矩阵(逐模块门禁记录)见仓库 docs/architecture/frontend-migration-matrix.md。