150 lines
4.4 KiB
Markdown
150 lines
4.4 KiB
Markdown
# 巡更管理系统改造 - 任务分解文档
|
||
|
||
## 1. 任务概述
|
||
将现有巡检管理系统改造为巡更管理系统，包括名称变更、路径管理交互优化和排班功能增强。
|
||
|
||
## 2. 子任务分解
|
||
|
||
### 2.1 任务1：路由和名称修改
|
||
**输入契约**：
|
||
- 现有路由配置文件 `src/router/index.ts`
|
||
- 现有组件文件
|
||
|
||
**输出契约**：
|
||
- 更新后的路由配置，将`/index/inspection/*`改为`/index/patrol/*`
|
||
- 所有组件中"巡检"字样改为"巡更"
|
||
|
||
**实现约束**：
|
||
- 保持路由功能不变
|
||
- 保持组件结构不变
|
||
- 只修改显示名称和路由路径
|
||
|
||
**依赖关系**：
|
||
- 无前置依赖
|
||
- 后续任务依赖此任务完成
|
||
|
||
### 2.2 任务2：PathManagement.vue改造
|
||
**输入契约**：
|
||
- 现有 `src/view/patrol/PathManagement.vue` 文件
|
||
- 地图组件和点击事件
|
||
- Pinia状态管理
|
||
|
||
**输出契约**：
|
||
- 改造后的PathManagement.vue，支持地图点击生成路径点
|
||
- 移除原有表单对话框
|
||
- 实现自动生成路径点功能
|
||
- 简化保存逻辑
|
||
|
||
**实现约束**：
|
||
- 保持原有API调用方式不变
|
||
- 保持路径列表和路径点列表的显示格式
|
||
- 只修改路径点添加和保存逻辑
|
||
|
||
**依赖关系**：
|
||
- 依赖任务1完成
|
||
- 后续任务无直接依赖
|
||
|
||
### 2.3 任务3：ScheduleManagement.vue改造
|
||
**输入契约**：
|
||
- 现有 `src/view/patrol/ScheduleManagement.vue` 文件
|
||
- 后端API接口
|
||
|
||
**输出契约**：
|
||
- 改造后的ScheduleManagement.vue，支持批量排班
|
||
- 添加排班表单
|
||
- 实现班次选择功能
|
||
- 实现人员和线路选择功能
|
||
- 实现批量保存功能
|
||
|
||
**实现约束**：
|
||
- 保持原有API调用方式不变
|
||
- 保持排班列表的显示格式
|
||
- 新增排班表单和批量保存功能
|
||
|
||
**依赖关系**：
|
||
- 依赖任务1完成
|
||
- 后续任务无直接依赖
|
||
|
||
### 2.4 任务4：测试和验证
|
||
**输入契约**：
|
||
- 改造后的所有组件
|
||
- 现有测试环境
|
||
|
||
**输出契约**：
|
||
- 测试报告，包括功能测试和边界情况测试
|
||
- 修复发现的问题
|
||
- 确保所有功能正常运行
|
||
|
||
**实现约束**：
|
||
- 测试所有核心功能
|
||
- 测试边界情况
|
||
- 测试异常情况
|
||
|
||
**依赖关系**：
|
||
- 依赖任务2和任务3完成
|
||
- 无后续任务
|
||
|
||
## 3. 任务依赖图
|
||
```mermaid
|
||
gantt
|
||
title 巡更管理系统改造任务依赖图
|
||
dateFormat YYYY-MM-DD
|
||
section 改造阶段
|
||
任务1：路由和名称修改 :a1, 2025-12-25, 0.5d
|
||
任务2：PathManagement改造 :a2, after a1, 1d
|
||
任务3：ScheduleManagement改造 :a3, after a1, 1d
|
||
任务4：测试和验证 :a4, after a2, a3, 0.5d
|
||
```
|
||
|
||
## 4. 验收标准
|
||
|
||
### 4.1 任务1验收标准
|
||
- 所有路由路径中"inspection"字样已改为"patrol"
|
||
- 所有组件中"巡检"字样已改为"巡更"
|
||
- 路由功能正常，可正常访问各页面
|
||
|
||
### 4.2 任务2验收标准
|
||
- 路径管理页面中"巡检"字样已改为"巡更"
|
||
- 可通过点击地图设备自动添加路径点
|
||
- 路径点按点击顺序自动生成序号
|
||
- 路径点保存功能正常
|
||
|
||
### 4.3 任务3验收标准
|
||
- 排班管理页面中"巡检"字样已改为"巡更"
|
||
- 排班表单可正常打开和关闭
|
||
- 可选择多个班次进行排班
|
||
- 可选择巡更人员和线路
|
||
- 批量保存功能正常
|
||
|
||
### 4.4 任务4验收标准
|
||
- 所有功能测试通过
|
||
- 边界情况测试通过
|
||
- 异常情况处理正常
|
||
- 无明显性能问题
|
||
|
||
## 5. 风险评估
|
||
|
||
| 风险项 | 风险等级 | 应对措施 |
|
||
|-------|---------|---------|
|
||
| 地图点击事件不触发 | 中 | 检查地图组件事件绑定，确保事件能正常传递到PathManagement组件 |
|
||
| 批量保存时API请求失败 | 中 | 实现请求重试机制，添加错误提示 |
|
||
| 班次选择逻辑复杂 | 低 | 采用Element Plus的多选组件，简化实现逻辑 |
|
||
| 数据格式不符合后端要求 | 中 | 严格按照现有API数据格式进行开发，添加数据验证 |
|
||
|
||
## 6. 资源需求
|
||
|
||
| 资源类型 | 需求数量 | 备注 |
|
||
|---------|---------|------|
|
||
| 开发人员 | 1人 | 熟悉Vue 3和Element Plus |
|
||
| 测试环境 | 1套 | 包含地图组件和后端API |
|
||
| 开发工具 | 1套 | VS Code、Chrome浏览器 |
|
||
|
||
## 7. 时间计划
|
||
|
||
| 任务 | 预计耗时 | 开始时间 | 结束时间 |
|
||
|-----|---------|---------|---------|
|
||
| 任务1：路由和名称修改 | 0.5天 | 2025-12-25 | 2025-12-25 |
|
||
| 任务2：PathManagement改造 | 1天 | 2025-12-25 | 2025-12-26 |
|
||
| 任务3：ScheduleManagement改造 | 1天 | 2025-12-25 | 2025-12-26 |
|
||
| 任务4：测试和验证 | 0.5天 | 2025-12-26 | 2025-12-26 |
|
||
| 总计 | 3天 | 2025-12-25 | 2025-12-26 | |