278 lines
13 KiB
Markdown
278 lines
13 KiB
Markdown
# 后台管理系统重构方案
|
||
|
||
> 日期：2026-05-26 | 范围：`frontend/web-admin` 前端页面与路由
|
||
|
||
---
|
||
|
||
## 一、现状概览
|
||
|
||
当前系统共有 **27 个 .vue 页面文件**，路由注册了 **22 条**，侧边栏导航挂了 **16 个入口**。
|
||
|
||
核心问题：
|
||
|
||
1. **6 组功能重叠** — 多个页面做同一件事，入口分散
|
||
2. **4 个幽灵页面** — 已写好但不在导航中，或完全是演示数据
|
||
3. **1 个死链** — 导航中的 `/customers/import` 在路由表中不存在
|
||
4. **1 个万能页面** — BusinessPage 把订单录入、履约、提醒、配置、员工管理全塞在一起
|
||
|
||
---
|
||
|
||
## 二、幽灵页面确认结论
|
||
|
||
通过对比 API 调用和数据来源，确认以下页面的状态：
|
||
|
||
| 页面 | 路由 | 数据来源 | 判断 |
|
||
|------|------|----------|------|
|
||
| **ManagerFlowPage** | `/manager`（不在导航） | **100% 硬编码演示数据**，零 API 调用 | **可删除** — 纯原型 |
|
||
| **SalesFlowPage** | `/sales-flow`（不在导航） | 调用 `/api/orders/flow-overview`（该接口后端未定义），全部回退到演示数据 | **可删除** — 功能已被 OrdersPage + ApprovalsPage + OrderTrackingPage 覆盖 |
|
||
| **EmployeesPage** | 无路由 | 调用 `fetchSystemUsers` / `fetchSystemRoles`，与 SystemPage 用户管理 tab 完全相同 | **可删除** — 是 SystemPage 的重复版本 |
|
||
| **ProductPage** | 无路由 | 独立产品管理页面，功能已被 MasterDataPage 的"产品管理"tab 完全覆盖 | **可删除** — MasterDataPage 已取代 |
|
||
| **SupplierPage** | 无路由 | 独立供应商管理页面，功能已被 MasterDataPage 的"工厂/供应商"tab 完全覆盖 | **可删除** — MasterDataPage 已取代 |
|
||
|
||
另外 DriverPage (`/driver/tasks`) 虽不在导航中，但有独立后端接口 `fetchDriverTasks`，属于有效功能，需要决定是否加入导航。
|
||
|
||
---
|
||
|
||
## 三、重叠组详细分析与合并策略
|
||
|
||
### 重叠组 1：配置管理（ConfigPage vs ConfigCenterPage）
|
||
|
||
| 维度 | ConfigPage (`/config`) | ConfigCenterPage (`/config-center`) |
|
||
|------|------------------------|-------------------------------------|
|
||
| 标题 | 配置管理 | 系统配置中心 |
|
||
| 核心功能 | 规则校验状态展示 + 配置项编辑 | 配置项编辑（含启用/禁用开关）+ 提醒检查触发 |
|
||
| 后端接口 | `fetchConfigItem` / `updateConfigItem` | 同左 + `runAllReminderChecks` 等 |
|
||
| 特有能力 | 自动校验项对齐展示 | 按业务分组查看 + 一键触发提醒检查 |
|
||
|
||
**合并方案：保留 ConfigPage，合入 ConfigCenterPage 的能力**
|
||
|
||
- ConfigPage 保留"配置项编辑"和"校验状态展示"
|
||
- 从 ConfigCenterPage 搬入：启用/禁用开关、配置分组视图、提醒检查按钮
|
||
- 删除 ConfigCenterPage
|
||
- 新路由：`/config`
|
||
|
||
### 重叠组 2：权限与审计（PermissionsCenterPage vs AuditPage）
|
||
|
||
| 维度 | PermissionsCenterPage (`/permissions`) | AuditPage (`/audit`) |
|
||
|------|----------------------------------------|----------------------|
|
||
| 标题 | 权限与可见性中心 | 权限与审计 |
|
||
| 角色可见性 | 有 | 有（相同） |
|
||
| 字段脱敏规则 | 有（可编辑开关） | 无 |
|
||
| 权限矩阵 | 有（角色 x 模块表格） | 无 |
|
||
| 审计日志 | 有（展示） | 有（展示 + 筛选 + 导出） |
|
||
|
||
**合并方案：保留 AuditPage，合入 PermissionsCenterPage 的独有能力**
|
||
|
||
- AuditPage 保留"审计日志"（筛选 + 导出）
|
||
- 从 PermissionsCenterPage 搬入：字段脱敏规则编辑、权限矩阵表格
|
||
- 删除 PermissionsCenterPage
|
||
- 新路由：`/audit`，标题改为"权限与审计"
|
||
|
||
### 重叠组 3：客户管理（CustomerCenterPage vs MasterDataPage 客户 tab）
|
||
|
||
| 维度 | CustomerCenterPage (`/customers`) | MasterDataPage 客户 tab (`/master-data`) |
|
||
|------|------------------------------------|-------------------------------------------|
|
||
| 客户录入 | 有（基础表单） | 有（完整表单 + 模态框） |
|
||
| 客户导入 | 有（基础） | 有（完整） |
|
||
| 客户列表 | 有（基础） | 有（完整 + 详情弹窗） |
|
||
| 新客户判定 | 有 | 有 |
|
||
| 欠款提醒 | 有 | 无 |
|
||
|
||
MasterDataPage 的客户管理功能更完整（对接了真实 API `fetchCustomerList`、`createCustomer`、`importCustomers`、`fetchCustomerDetail`），CustomerCenterPage 是早期简化版本。
|
||
|
||
**合并方案：保留 MasterDataPage 的客户管理代码，移至独立的 CustomerCenterPage**
|
||
|
||
- 用 MasterDataPage 客户 tab 的完整代码替换 CustomerCenterPage
|
||
- MasterDataPage 去掉"客户管理"tab，只保留：产品分类、产品管理、工厂/供应商
|
||
- 新路由：`/customers`（CustomerCenterPage）+ `/master-data`（MasterDataPage）
|
||
|
||
### 重叠组 4：员工/用户管理（EmployeeCenterPage vs SystemPage）
|
||
|
||
| 维度 | EmployeeCenterPage (`/employees`) | SystemPage (`/system`) |
|
||
|------|-----------------------------------|------------------------|
|
||
| 用户列表 | 有（只读展示） | 有（含查询、新增、编辑、重置密码） |
|
||
| 角色管理 | 无独立 tab | 有（角色 CRUD） |
|
||
| 菜单管理 | 无 | 有（菜单 CRUD） |
|
||
| 权限分配 | 有（基础表单） | 有（角色授权） |
|
||
|
||
SystemPage 功能远比 EmployeeCenterPage 完整。EmployeeCenterPage 实际上是 SystemPage 用户列表的简化只读版本。
|
||
|
||
**合并方案：保留 SystemPage，删除 EmployeeCenterPage**
|
||
|
||
- 导航中"员工中心"直接链接到 `/system`
|
||
- 删除 EmployeeCenterPage
|
||
- 新路由：`/system`
|
||
|
||
### 重叠组 5：订单录入（散落在 4 个页面）
|
||
|
||
| 页面 | 订单录入位置 |
|
||
|------|-------------|
|
||
| OrdersPage | 有完整录入表单（客户、来源、交付方式、备注） |
|
||
| SalesFlowPage | 有录入 tab（客户、产品、来源、交付方式、备注） |
|
||
| BusinessPage | 有"订单录入"tab（客户、产品、规格、数量、单价、来源、支付方式） |
|
||
| SalesmanCenterPage | 有"快速录单"（客户、产品、数量、售价、备注） |
|
||
|
||
**合并方案：统一到 OrdersPage，其余页面删除或精简**
|
||
|
||
- OrdersPage 作为订单录入的唯一入口，增加产品/数量/单价字段（从 BusinessPage 搬入）
|
||
- SalesFlowPage 整体删除（已在幽灵页面确认中）
|
||
- BusinessPage 删除订单录入功能
|
||
- SalesmanCenterPage 的录单功能改为跳转到 OrdersPage
|
||
|
||
### 重叠组 6：审批管理（ApprovalsPage vs ManagerFlowPage）
|
||
|
||
**合并方案：删除 ManagerFlowPage（已在幽灵页面确认中）**
|
||
|
||
ManagerFlowPage 的"发厂"和"履约"功能目前使用演示数据，后端未实现。如后续需要，可在 ApprovalsPage 中扩展 tab。
|
||
|
||
---
|
||
|
||
## 四、新导航结构（按功能域分组）
|
||
|
||
```
|
||
工作台
|
||
├── 后台工作台 /dashboard (DashboardPage)
|
||
└── 审批中心 /approvals (ApprovalsPage)
|
||
|
||
主数据
|
||
├── 客户管理 /customers (CustomerCenterPage — 用 MasterDataPage 客户 tab 代码替换)
|
||
├── 基础资料 /master-data (MasterDataPage — 去掉客户 tab)
|
||
└── 司机管理 /driver/tasks (DriverPage — 从隐藏提升到可见)
|
||
|
||
订单与审批
|
||
├── 订单中心 /orders (OrdersPage — 合并录入能力)
|
||
├── 订单轨迹 /orders/tracking (OrderTrackingPage)
|
||
└── 提醒中心 /reminders (ReminderCenterPage)
|
||
|
||
配置与权限
|
||
├── 配置管理 /config (ConfigPage — 合并 ConfigCenterPage)
|
||
├── 权限与审计 /audit (AuditPage — 合并 PermissionsCenterPage)
|
||
└── 系统管理 /system (SystemPage — 吸收 EmployeeCenterPage)
|
||
|
||
报表
|
||
├── 报表统计 /reports/performance (ReportsPage)
|
||
└── 报表核对 /reports/audit (ReportAuditPage)
|
||
|
||
AI 能力
|
||
└── AI 识别 /ai-recognition (AIRecognitionPage)
|
||
```
|
||
|
||
**对比变化：**
|
||
|
||
| 指标 | 重构前 | 重构后 |
|
||
|------|--------|--------|
|
||
| 导航入口数 | 16 | 12 |
|
||
| 页面文件数 | 27 | 18（减少 9 个） |
|
||
| 路由数 | 22 | 15（减少 7 条） |
|
||
| 死链 | 1（`/customers/import`） | 0 |
|
||
| 幽灵页面 | 5 | 0 |
|
||
|
||
---
|
||
|
||
## 五、具体文件变更清单
|
||
|
||
### 删除的文件（9 个）
|
||
|
||
| 文件 | 原因 |
|
||
|------|------|
|
||
| `views/SalesFlowPage.vue` | 幽灵页面，功能被 OrdersPage + ApprovalsPage 覆盖 |
|
||
| `views/ManagerFlowPage.vue` | 幽灵页面，100% 演示数据 |
|
||
| `views/EmployeesPage.vue` | 幽灵页面，SystemPage 的重复版本 |
|
||
| `views/ProductPage.vue` | 幽灵页面，已被 MasterDataPage 取代 |
|
||
| `views/SupplierPage.vue` | 幽灵页面，已被 MasterDataPage 取代 |
|
||
| `views/ConfigCenterPage.vue` | 合并入 ConfigPage |
|
||
| `views/PermissionsCenterPage.vue` | 合并入 AuditPage |
|
||
| `views/EmployeeCenterPage.vue` | 功能被 SystemPage 完整覆盖 |
|
||
| `views/BusinessPage.vue` | "万能页面"，各功能归还到对应专业页面 |
|
||
|
||
### 修改的文件（5 个）
|
||
|
||
| 文件 | 变更内容 |
|
||
|------|----------|
|
||
| `views/ConfigPage.vue` | 合入 ConfigCenterPage 的启用/禁用开关、分组视图、提醒检查按钮 |
|
||
| `views/AuditPage.vue` | 合入 PermissionsCenterPage 的脱敏规则编辑、权限矩阵表格 |
|
||
| `views/CustomerCenterPage.vue` | 用 MasterDataPage 客户 tab 的完整代码替换当前简化版本 |
|
||
| `views/MasterDataPage.vue` | 删除客户管理 tab，保留产品分类 + 产品 + 供应商三个 tab |
|
||
| `views/OrdersPage.vue` | 从 BusinessPage 搬入产品/数量/单价等字段，完善录入表单 |
|
||
|
||
### 修改的配置文件（2 个）
|
||
|
||
| 文件 | 变更内容 |
|
||
|------|----------|
|
||
| `router.js` | 删除 7 条废弃路由，更新组件引用，修复死链 |
|
||
| `App.vue` | 重写 `navGroups`，从 3 组 16 入口改为 5 组 12 入口 |
|
||
|
||
---
|
||
|
||
## 六、路由变更对照表
|
||
|
||
### 删除的路由
|
||
|
||
| 旧路由 | 对应组件 | 原因 |
|
||
|--------|----------|------|
|
||
| `/config-center` | ConfigCenterPage | 合并入 `/config` |
|
||
| `/permissions` | PermissionsCenterPage | 合并入 `/audit` |
|
||
| `/employees` | EmployeeCenterPage | 合并入 `/system` |
|
||
| `/manager` | ManagerFlowPage | 幽灵页面删除 |
|
||
| `/sales-flow` | SalesFlowPage | 幽灵页面删除 |
|
||
| `/customers/import` | （不存在） | 死链修复：客户导入改为 CustomerCenterPage 内的功能入口 |
|
||
| `/business` | BusinessPage | 万能页面删除，功能已分散 |
|
||
|
||
### 保留的路由
|
||
|
||
| 路由 | 组件 | 变更 |
|
||
|------|------|------|
|
||
| `/login` | LoginPage | 不变 |
|
||
| `/dashboard` | DashboardPage | 不变 |
|
||
| `/approvals` | ApprovalsPage | 不变 |
|
||
| `/approvals/:id` | ApprovalDetailPage | 不变 |
|
||
| `/customers` | CustomerCenterPage | 代码替换为 MasterDataPage 客户 tab 版本 |
|
||
| `/master-data` | MasterDataPage | 去掉客户 tab |
|
||
| `/orders` | OrdersPage | 合入 BusinessPage 录单字段 |
|
||
| `/orders/:id` | OrderDetailPage | 不变 |
|
||
| `/orders/tracking` | OrderTrackingPage | 不变 |
|
||
| `/driver/tasks` | DriverPage | 新增到导航 |
|
||
| `/driver/tasks/:id` | DriverTaskDetailPage | 不变 |
|
||
| `/config` | ConfigPage | 合入 ConfigCenterPage 能力 |
|
||
| `/audit` | AuditPage | 合入 PermissionsCenterPage 能力 |
|
||
| `/system` | SystemPage | 吸收 EmployeeCenterPage 功能 |
|
||
| `/reminders` | ReminderCenterPage | 不变 |
|
||
| `/ai-recognition` | AIRecognitionPage | 不变 |
|
||
| `/reports/performance` | ReportsPage | 不变 |
|
||
| `/reports/audit` | ReportAuditPage | 不变 |
|
||
|
||
---
|
||
|
||
## 七、实施建议
|
||
|
||
### 分批推进顺序
|
||
|
||
| 批次 | 内容 | 风险 | 预估工作量 |
|
||
|------|------|------|------------|
|
||
| **第 1 批** | 删除 5 个幽灵页面 + 更新路由 + 修复死链 | 低 — 这些页面本来就不在导航中 | 0.5h |
|
||
| **第 2 批** | 合并 ConfigPage + ConfigCenterPage | 中 — 需要整合两个页面的 UI 和逻辑 | 1.5h |
|
||
| **第 3 批** | 合并 AuditPage + PermissionsCenterPage | 中 — 权限矩阵和脱敏规则需要仔细搬移 | 1.5h |
|
||
| **第 4 批** | 用 MasterDataPage 客户 tab 替换 CustomerCenterPage | 中 — 需要确保 API 调用对齐 | 1h |
|
||
| **第 5 批** | 精简 MasterDataPage（去掉客户 tab）+ 删除 BusinessPage | 低 — 删减为主 | 0.5h |
|
||
| **第 6 批** | 合并 EmployeeCenterPage 到 SystemPage + 删除 EmployeeCenterPage | 低 — SystemPage 已经更完整 | 0.5h |
|
||
| **第 7 批** | OrdersPage 合入 BusinessPage 录单字段 + 更新导航 | 中 — 录单表单需要补齐字段 | 1h |
|
||
| **第 8 批** | 重写 App.vue navGroups + 最终验证 | 低 — 纯配置变更 | 0.5h |
|
||
|
||
### 每批的验证方法
|
||
|
||
每完成一批后：
|
||
|
||
1. 启动前端开发服务器，确认无编译报错
|
||
2. 逐个点击导航菜单，确认每个页面可正常加载
|
||
3. 检查浏览器控制台无 JS 报错
|
||
4. 确认被合并/删除页面的旧 URL 有合理的 404 或重定向处理
|
||
|
||
---
|
||
|
||
## 八、风险点
|
||
|
||
1. **MasterDataPage 客户 tab 代码量大（1700+ 行）**：替换 CustomerCenterPage 时需要确保 mockApi 的所有导入函数都存在
|
||
2. **BusinessPage 删除后，其中的"履约调度"功能**目前后端无真实接口，删除不影响实际业务，但如果后续需要，需要重新开发
|
||
3. **DriverPage 提升到导航**：需要确认司机功能是否已经对业务方可见，避免过早暴露未完成功能
|
||
4. **`/customers/import` 死链**：如果有用户书签了这个 URL，需要在路由中加一条重定向到 `/customers`
|