# 巡更管理系统改造 - 共识文档

## 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