91 lines
3.4 KiB
Markdown
91 lines
3.4 KiB
Markdown
# 巡更管理系统改造 - 共识文档
|
||
|
||
## 1. 需求描述
|
||
### 1.1 名称变更
|
||
- 将所有与"巡检"相关的名称改为"巡更"，包括：
|
||
- 路由名称和路径
|
||
- 组件名称和内容
|
||
- 按钮和提示文字
|
||
- 表格列名和标题
|
||
|
||
### 1.2 路径管理功能改造
|
||
- **交互方式**：点击添加或修改按钮后，直接在地图上依次点击支持的设备来生成路径点位列表
|
||
- **自动生成**：
|
||
- 自动按点击顺序生成序号
|
||
- 自动获取设备名称和ID
|
||
- 自动关联地图模型ID
|
||
- **无需额外输入**：用户不需要进行任何表单输入，只需要点击地图上的设备
|
||
- **保存方式**：点击保存按钮后，将所有点击生成的路径点一次性保存
|
||
|
||
### 1.3 排班功能增强
|
||
- **班次设置**：一天分为12个班次，每两小时一班
|
||
- **排班表单**：添加排班表单，支持：
|
||
- 选择多个班次（可全选）
|
||
- 选择巡更人员（最多3人）
|
||
- 选择巡更线路
|
||
- **批量保存**：一次操作可保存多个班次的排班信息
|
||
|
||
## 2. 技术实现方案
|
||
### 2.1 前端框架
|
||
- 使用现有Vue 3 + TypeScript + Vite技术栈
|
||
- 基于Element Plus组件库开发
|
||
- 使用Pinia进行状态管理
|
||
|
||
### 2.2 核心组件改造
|
||
1. **路由修改**：
|
||
- 将`/index/inspection/*`路由改为`/index/patrol/*`
|
||
- 更新路由名称和组件引用
|
||
|
||
2. **PathManagement.vue**改造：
|
||
- 移除原有的表单对话框
|
||
- 增强地图点击事件处理
|
||
- 实现路径点自动生成和排序
|
||
- 简化保存逻辑
|
||
|
||
3. **ScheduleManagement.vue**改造：
|
||
- 添加排班表单
|
||
- 实现班次选择功能
|
||
- 实现人员和线路选择功能
|
||
- 实现批量保存功能
|
||
|
||
### 2.3 数据流转
|
||
1. **路径管理**：
|
||
- 用户点击地图设备 → 触发点击事件 → 生成路径点对象 → 添加到路径点列表 → 用户点击保存 → 批量提交到后端
|
||
|
||
2. **排班管理**：
|
||
- 用户填写排班表单 → 选择班次、人员、线路 → 点击保存 → 生成多个排班记录 → 批量提交到后端
|
||
|
||
## 3. 验收标准
|
||
1. **名称变更**：所有页面和组件中不再出现"巡检"字样，全部替换为"巡更"
|
||
2. **路径管理**：
|
||
- 点击地图设备可自动添加路径点
|
||
- 路径点按点击顺序自动排序
|
||
- 保存功能正常，能正确提交到后端
|
||
3. **排班功能**：
|
||
- 可选择多个班次进行排班
|
||
- 可选择巡更人员和线路
|
||
- 批量保存功能正常
|
||
- 排班数据能正确显示在列表中
|
||
4. **原有功能**：所有原有功能保持正常运行
|
||
|
||
## 4. 技术约束
|
||
1. **API兼容性**：保持与现有后端API的兼容性，不修改API接口
|
||
2. **性能要求**：页面加载时间不超过3秒，交互响应时间不超过500ms
|
||
3. **用户体验**：操作流程简洁明了，减少用户点击次数
|
||
4. **代码质量**：保持原有代码风格和架构，添加必要的注释
|
||
|
||
## 5. 依赖关系
|
||
- 依赖现有地图组件和设备点击事件
|
||
- 依赖现有后端API接口
|
||
- 依赖Element Plus组件库
|
||
|
||
## 6. 风险评估
|
||
1. **地图点击事件兼容性**：需确保地图设备点击事件能正常触发
|
||
2. **批量保存性能**：当选择大量班次时，需确保批量保存不会导致页面卡顿
|
||
3. **数据一致性**：需确保生成的路径点数据格式符合后端要求
|
||
|
||
## 7. 项目计划
|
||
- **启动时间**：2025-12-25
|
||
- **完成时间**：2025-12-26
|
||
- **测试时间**：2025-12-26
|
||
- **交付时间**：2025-12-26 |