Initial_commit_SecMPS_v2

warehouse/docs/巡更管理系统改造/CONSENSUS_巡更管理系统改造.md

@@ -0,0 +1,91 @@
+# 巡更管理系统改造 - 共识文档
+
+## 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