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