284 lines
8.4 KiB
Markdown
284 lines
8.4 KiB
Markdown
# 前端业务裁剪与清除清单
|
||
|
||
## 1. 目的
|
||
|
||
本文基于 `doc/项目基础功能保留与业务裁剪方案.md`，整理当前 `frontend` 目录下前端页面、接口、状态管理、入口配置中的保留项、清除项和联动调整项，为后续前端裁剪提供执行依据。
|
||
|
||
## 2. 裁剪原则
|
||
|
||
- 保留平台基础能力对应的前端页面与接口。
|
||
- 移除检测业务、设备业务、报告业务相关前端页面与接口。
|
||
- 保留通用请求能力、登录鉴权能力、菜单权限能力。
|
||
- 通讯底层能力如 WebSocket、SSE 只保留通用连接能力，不保留检测业务语义。
|
||
- 对“名称看起来是平台功能，但内容实际属于检测业务”的页面，按实际功能裁剪，不按目录名裁剪。
|
||
|
||
## 3. 建议保留的前端能力
|
||
|
||
### 3.1 登录与权限管理
|
||
|
||
建议保留：
|
||
|
||
- `frontend/src/views/login/index.vue`
|
||
- `frontend/src/views/login/components/LoginForm.vue`
|
||
- `frontend/src/views/authority/user/index.vue`
|
||
- `frontend/src/views/authority/role/index.vue`
|
||
- `frontend/src/views/authority/resource/index.vue`
|
||
- `frontend/src/api/user`
|
||
- `frontend/src/stores/modules/user.ts`
|
||
- `frontend/src/stores/modules/auth.ts`
|
||
|
||
### 3.2 平台基础管理
|
||
|
||
建议保留：
|
||
|
||
- `frontend/src/views/log/index.vue`
|
||
- `frontend/src/views/system/dictionary/dictType/index.vue`
|
||
- `frontend/src/views/system/dictionary/dictData/index.vue`
|
||
- `frontend/src/views/system/dictionary/dictTree/index.vue`
|
||
- `frontend/src/api/system/log`
|
||
- `frontend/src/api/system/dictionary`
|
||
- `frontend/src/stores/modules/dict.ts`
|
||
|
||
### 3.3 通用请求与通讯底层
|
||
|
||
建议保留：
|
||
|
||
- `frontend/src/api/index.ts`
|
||
- `frontend/src/utils/webSocketClient.ts`
|
||
|
||
说明：
|
||
|
||
- `api/index.ts` 中的 Axios 封装、Token 处理、SSE 基础能力可保留。
|
||
- `webSocketClient.ts` 可保留为通用连接客户端，但后续需要去掉与“预检、检测、对比检测”相关的业务语义。
|
||
|
||
## 4. 建议清除的前端页面
|
||
|
||
### 4.1 首页与检测入口
|
||
|
||
建议清除整个 `home` 模块：
|
||
|
||
- `frontend/src/views/home`
|
||
|
||
清除原因：
|
||
|
||
- 当前首页并非平台门户，而是检测模式入口、检测统计总览、设备检测、报告生成、归档、数据操作入口。
|
||
- 与后端文档中“删除检测业务域”的目标一致。
|
||
|
||
### 4.2 检测计划模块
|
||
|
||
建议清除整个 `plan` 模块：
|
||
|
||
- `frontend/src/views/plan`
|
||
|
||
清除原因：
|
||
|
||
- 对应后端明确下线的检测计划管理能力。
|
||
- 页面中包含预检、自动检测、统计分析、子计划管理等完整检测业务流程。
|
||
|
||
### 4.3 设备与检测资源模块
|
||
|
||
建议清除整个 `machine` 模块：
|
||
|
||
- `frontend/src/views/machine`
|
||
|
||
包含但不限于：
|
||
|
||
- 被检设备
|
||
- 标准设备
|
||
- 检测源
|
||
- 控制源
|
||
- 检测脚本
|
||
- 误差体系
|
||
- 设备类型
|
||
- ICD
|
||
|
||
### 4.4 报告模板与业务字典页面
|
||
|
||
建议清除：
|
||
|
||
- `frontend/src/views/system/template/index.vue`
|
||
- `frontend/src/views/system/dictionary/dictPq/index.vue`
|
||
|
||
清除原因：
|
||
|
||
- 报告模板属于报告业务能力。
|
||
- `dictPq` 属于电能质量检测业务字典，不属于通用平台字典。
|
||
|
||
## 5. 建议清除的接口层
|
||
|
||
建议清除以下业务接口目录：
|
||
|
||
- `frontend/src/api/plan`
|
||
- `frontend/src/api/device`
|
||
- `frontend/src/api/home`
|
||
- `frontend/src/api/result`
|
||
- `frontend/src/api/check`
|
||
- `frontend/src/api/socket/socket.ts`
|
||
|
||
说明：
|
||
|
||
- `api/socket/socket.ts` 虽然名称包含 `socket`，但当前封装的是检测业务动作，如预检、恢复检测、对比检测、导出对齐数据，不属于纯通讯底层接口。
|
||
|
||
## 6. 建议清除的状态管理
|
||
|
||
建议清除：
|
||
|
||
- `frontend/src/stores/modules/check.ts`
|
||
|
||
清除原因：
|
||
|
||
- 该 store 存储的是检测设备、检测计划、检测项、复检方式、通道连线等检测运行态数据。
|
||
- 与平台保留能力无关。
|
||
|
||
## 7. 条件保留或待确认项
|
||
|
||
### 7.1 激活能力
|
||
|
||
可选保留：
|
||
|
||
- `frontend/src/views/system/versionRegister/index.vue`
|
||
- `frontend/src/api/activate/index.ts`
|
||
|
||
说明：
|
||
|
||
- 后端文档中 `activate-tool` 被列为可选保留。
|
||
- 如果项目后续仍保留授权、激活码、许可文件能力，则前端激活相关页面和接口可以保留。
|
||
- 如果不再保留激活能力，应一并清理。
|
||
|
||
### 7.2 名称为系统配置但内容偏检测业务的页面
|
||
|
||
建议纳入删除候选：
|
||
|
||
- `frontend/src/views/system/base/index.vue`
|
||
- `frontend/src/api/system/base/index.ts`
|
||
- `frontend/src/api/system/versionRegister/index.ts`
|
||
|
||
原因：
|
||
|
||
- 当前页面内容实际是检测配置、有效数据配置、模式相关配置。
|
||
- 不属于纯平台基础配置页面。
|
||
|
||
## 8. 必须联动调整的入口与配置
|
||
|
||
### 8.1 首页默认路由
|
||
|
||
需要调整：
|
||
|
||
- `frontend/src/config/index.ts`
|
||
|
||
当前问题：
|
||
|
||
- `HOME_URL` 当前指向 `/home/index`。
|
||
- 如果 `home` 模块删除，必须同步修改默认首页。
|
||
|
||
### 8.2 登录后跳转逻辑
|
||
|
||
需要调整：
|
||
|
||
- `frontend/src/views/login/components/LoginForm.vue`
|
||
|
||
当前问题：
|
||
|
||
- 登录后默认跳转 `HOME_URL`。
|
||
- 删除 `home` 后必须同步修改跳转目标。
|
||
|
||
### 8.3 模式切换与菜单显示逻辑
|
||
|
||
需要调整：
|
||
|
||
- `frontend/src/stores/modules/auth.ts`
|
||
- `frontend/src/stores/modules/mode.ts`
|
||
|
||
当前问题：
|
||
|
||
- 当前逻辑围绕“模拟式、数字式、比对式、场景切换、进入检测后显示菜单”设计。
|
||
- 如果检测业务整体下线，这套逻辑需要一起收缩或重构。
|
||
|
||
### 8.4 动态路由与菜单数据
|
||
|
||
需要联动确认：
|
||
|
||
- `frontend/src/routers/modules/dynamicRouter.ts`
|
||
|
||
说明：
|
||
|
||
- 当前动态路由来源于后端菜单配置。
|
||
- 如果后端未同步清理业务菜单，前端即使删除页面，也仍可能收到失效路由配置。
|
||
|
||
## 9. 当前前端裁剪结论
|
||
|
||
建议前端最终保留的主要内容：
|
||
|
||
- 登录页
|
||
- 用户管理
|
||
- 角色管理
|
||
- 菜单/资源管理
|
||
- 日志管理
|
||
- 通用字典管理
|
||
- 通用请求封装
|
||
- 通用 WebSocket/SSE 底层能力
|
||
- 可选的激活能力
|
||
|
||
建议前端最终清除的主要内容：
|
||
|
||
- 首页检测门户
|
||
- 检测计划
|
||
- 被检设备
|
||
- 标准设备
|
||
- 检测源
|
||
- 控制源
|
||
- 检测脚本
|
||
- 检测结果
|
||
- 报告模板
|
||
- 电能质量业务字典
|
||
- 检测运行态 store
|
||
- 检测业务接口层
|
||
|
||
## 10. 推荐执行顺序
|
||
|
||
1. 先确认激活能力是否保留。
|
||
2. 再确定新的默认首页与登录后跳转页。
|
||
3. 删除 `home / plan / machine` 页面模块。
|
||
4. 删除对应业务接口目录与检测业务 store。
|
||
5. 调整 `auth / mode / dynamicRouter / HOME_URL` 等入口逻辑。
|
||
6. 最后联动清理后端菜单、权限、字典和动态路由来源。
|
||
|
||
## 11. 当前执行进度（2026-04-08）
|
||
|
||
### 11.1 已完成
|
||
|
||
- `frontend/src/views/home` 已删除
|
||
- `frontend/src/views/plan` 已删除
|
||
- `frontend/src/views/machine` 已删除
|
||
- `frontend/src/views/system/template/index.vue` 已删除
|
||
- `frontend/src/views/system/dictionary/dictPq/index.vue` 已删除
|
||
- `frontend/src/views/system/base/index.vue` 已删除
|
||
- `frontend/src/api/plan` 已删除
|
||
- `frontend/src/api/device` 已删除
|
||
- `frontend/src/api/home` 已删除
|
||
- `frontend/src/api/result` 已删除
|
||
- `frontend/src/api/check` 已删除
|
||
- `frontend/src/stores/modules/check.ts` 已删除
|
||
- `frontend/src/config/index.ts` 中 `HOME_URL` 已调整为 `/authority/user`
|
||
- `frontend/src/views/login/components/LoginForm.vue` 登录后已跳转新的平台首页
|
||
- `frontend/src/stores/modules/auth.ts` 已增加业务菜单过滤逻辑，用于屏蔽已下线页面对应菜单
|
||
- `frontend/src/api/user/login/index.ts` 中残留的检测业务接口定义已删除
|
||
- `frontend/src/stores/modules/mode.ts` 已删除，退出登录时不再清理检测模式/场景状态
|
||
- `frontend/src/components/ImportExcel` 已删除
|
||
- `frontend/src/components/ImportZip` 已删除
|
||
- `frontend/src/views/authority/resource/index.vue` 中误留的业务权限标识已修正
|
||
- `frontend/src/api/system/dictionary/dictData.ts` 业务静态字典样例已删除
|
||
- `frontend/src/api/system/log/logData.ts` 业务日志样例已删除
|
||
|
||
### 11.2 进行中
|
||
|
||
- 后端菜单、权限、字典与接口若仍保留旧业务数据，前端仍需要依赖 `auth.ts` 中的过滤逻辑进行保护
|
||
- 构建配置、全局类型、类型导入规范等历史工程问题仍存在，但不属于本轮业务裁剪直接目标
|
||
|
||
### 11.3 当前判断
|
||
|
||
- 当前前端裁剪已完成主体删除工作
|
||
- 当前已完成一轮业务语义残留和无引用旧代码清理
|
||
- 当前重点已转向联动验证和历史工程问题收尾
|
||
- 在后端菜单与接口未同步彻底下线前，前端仍需保留动态菜单过滤作为保护措施
|