ether-docs/01-REQUIREMENTS/pending-features-spec/task_list.md

# Ether 待开发功能 - 任务列表

## 📋 任务概览

本文档记录待开发功能的详细任务分解，涵盖：功能开发、前后端联调、集成测试、业务流程验证。

---

## 🎯 任务统计

| 模块 | 开发任务 | 联调任务 | 测试任务 | 总计 | 优先级 |
|------|---------|---------|---------|------|--------|
| 设备管理 | 4 | 3 | 4 | 11 | P0 |
| 收费管理 | 1 | 3 | 3 | 7 | P0 |
| 巡检管理 | 0 | 4 | 3 | 7 | P1 |
| 工单管理 | 0 | 4 | 3 | 7 | P1 |
| 访客管理 | 0 | 4 | 3 | 7 | P1 |
| 通知管理 | 0 | 4 | 3 | 7 | P1 |
| E2E测试 | 0 | 0 | 6 | 6 | P0 |
| **总计** | **5** | **22** | **25** | **52** | |

---

## 📝 详细任务列表

### 模块1: 设备管理 (P0)

#### 1.1 后端开发任务

- [ ] **T1.1.1** 创建设备实体类
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/entity/Equipment.java`
  - 映射表: `mdm_equipment`
  - 包含所有字段映射、JPA注解

- [ ] **T1.1.2** 创建设备枚举类
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/enums/EquipmentType.java`
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/enums/EquipmentStatus.java`
  - 定义设备类型和状态枚举值

- [ ] **T1.1.3** 创建Repository层
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/repository/EquipmentRepository.java`
  - 包含自定义查询方法（按项目、类型、状态、空间节点查询）

- [ ] **T1.1.4** 创建Service层
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/service/EquipmentService.java`
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/service/impl/EquipmentServiceImpl.java`
  - 实现CRUD、状态管理、编码生成、二维码生成

- [ ] **T1.1.5** 完善Controller层
  - 文件: `ether-mdm/src/main/java/com/ether/mdm/controller/EquipmentController.java`
  - 添加 `/api/v1/asset/equipments` 路径映射
  - 实现所有前端需要的API接口

#### 1.2 前端修改任务

- [ ] **T1.2.1** 启用设备管理API调用
  - 文件: `ether-ui-admin/src/views/mdm/equipment/index.vue`
  - 移除 `showFeatureTip` 提示
  - 启用所有API调用

#### 1.3 联调任务

- [ ] **T1.3.1** 设备列表API联调
  - 验证分页、筛选、搜索功能
  - 验证返回数据格式与前端匹配

- [ ] **T1.3.2** 设备CRUD API联调
  - 验证创建、编辑、删除功能
  - 验证数据校验规则

- [ ] **T1.3.3** 设备特殊功能联调
  - 验证二维码生成和扫码功能
  - 验证维修历史记录功能
  - 验证设备编码自动生成

#### 1.4 集成测试任务

- [ ] **T1.4.1** 设备管理API单元测试
  - 测试所有Controller接口
  - 测试Service层业务逻辑

- [ ] **T1.4.2** 设备管理业务流程测试
  - 测试完整设备台账管理流程
  - 测试设备状态变更流程

- [ ] **T1.4.3** 设备关联功能测试
  - 测试设备与空间节点关联
  - 测试设备与工单关联

- [ ] **T1.4.4** 设备管理E2E测试
  - 文件: `tests/e2e/equipment.spec.ts`
  - 测试完整业务流程

---

### 模块2: 收费管理 (P0)

#### 2.1 前端修改任务

- [ ] **T2.1.1** 启用收费管理API调用
  - 文件: `ether-ui-admin/src/views/mdm/fee/index.vue`
  - 移除 `showFeatureTip` 提示
  - 启用所有API调用

#### 2.2 联调任务

- [ ] **T2.2.1** 收费项目API联调
  - 验证收费项目CRUD功能
  - 验证项目配置数据

- [ ] **T2.2.2** 账单管理API联调
  - 验证账单列表、创建、编辑、删除
  - 验证账单状态流转

- [ ] **T2.2.3** 统计报表API联调
  - 验证统计数据准确性
  - 验证导出功能

#### 2.3 集成测试任务

- [ ] **T2.3.1** 收费管理业务流程测试
  - 测试完整收费流程：项目配置→账单生成→缴费→统计

- [ ] **T2.3.2** 收费数据一致性测试
  - 测试账单金额计算
  - 测试统计数据准确性

- [ ] **T2.3.3** 收费管理E2E测试
  - 文件: `tests/e2e/fee.spec.ts`
  - 测试完整业务流程

---

### 模块3: 巡检管理 (P1)

#### 3.1 联调任务

- [ ] **T3.1.1** 巡检计划API联调
  - 验证计划CRUD功能
  - 验证计划状态切换
  - 验证计划启用/停用

- [ ] **T3.1.2** 巡检点API联调
  - 验证巡检点配置
  - 验证巡检点与空间节点关联

- [ ] **T3.1.3** 巡检任务API联调
  - 验证任务自动生成
  - 验证任务执行流程
  - 验证任务完成提交

- [ ] **T3.1.4** 巡检记录API联调
  - 验证记录查询
  - 验证异常上报

#### 3.2 集成测试任务

- [ ] **T3.2.1** 巡检管理业务流程测试
  - 测试完整巡检流程：计划配置→任务生成→执行→记录

- [ ] **T3.2.2** 巡检统计数据测试
  - 测试完成率统计
  - 测试异常率统计

- [ ] **T3.2.3** 巡检管理E2E测试
  - 文件: `tests/e2e/inspection.spec.ts`
  - 测试完整业务流程

---

### 模块4: 工单管理 (P1)

#### 4.1 联调任务

- [ ] **T4.1.1** 工单创建API联调
  - 验证工单创建功能
  - 验证工单类型选择
  - 验证优先级设置

- [ ] **T4.1.2** 工单流转API联调
  - 验证分配→接单→开始→完成→关闭流程
  - 验证状态变更记录

- [ ] **T4.1.3** 工单分配API联调
  - 验证派单功能
  - 验证处理人选择

- [ ] **T4.1.4** 工单统计API联调
  - 验证工单统计数据
  - 验证处理时效统计

#### 4.2 集成测试任务

- [ ] **T4.2.1** 工单管理业务流程测试
  - 测试完整工单流程：创建→分配→处理→关闭

- [ ] **T4.2.2** 设备关联工单测试
  - 测试设备与工单关联
  - 测试设备维修历史记录

- [ ] **T4.2.3** 工单管理E2E测试
  - 文件: `tests/e2e/work-order.spec.ts`
  - 测试完整业务流程

---

### 模块5: 访客管理 (P1)

#### 5.1 联调任务

- [ ] **T5.1.1** 访客预约API联调
  - 验证预约创建功能
  - 验证预约信息填写

- [ ] **T5.1.2** 访客审批API联调
  - 验证审批通过/拒绝流程
  - 验证审批通知

- [ ] **T5.1.3** 出入场管理API联调
  - 验证入场登记功能
  - 验证离场登记功能

- [ ] **T5.1.4** 黑名单API联调
  - 验证黑名单添加/移除
  - 验证黑名单拦截功能

#### 5.2 集成测试任务

- [ ] **T5.2.1** 访客管理业务流程测试
  - 测试完整访客流程：预约→审批→入场→离场

- [ ] **T5.2.2** 黑名单拦截测试
  - 测试黑名单访客拦截
  - 测试拦截通知

- [ ] **T5.2.3** 访客管理E2E测试
  - 文件: `tests/e2e/visitor.spec.ts`
  - 测试完整业务流程

---

### 模块6: 通知管理 (P1)

#### 6.1 联调任务

- [ ] **T6.1.1** 通知渠道API联调
  - 验证渠道配置功能
  - 验证渠道启用/停用

- [ ] **T6.1.2** 通知模板API联调
  - 验证模板CRUD功能
  - 验证模板变量配置

- [ ] **T6.1.3** 通知规则API联调
  - 验证规则配置功能
  - 验证规则触发条件

- [ ] **T6.1.4** 通知发送API联调
  - 验证通知发送功能
  - 验证通知状态管理

#### 6.2 集成测试任务

- [ ] **T6.2.1** 通知管理业务流程测试
  - 测试完整通知流程：配置→触发→发送→接收

- [ ] **T6.2.2** 通知规则触发测试
  - 测试业务事件触发通知
  - 测试定时通知发送

- [ ] **T6.2.3** 通知管理E2E测试
  - 文件: `tests/e2e/notification.spec.ts`
  - 测试完整业务流程

---

### 模块7: E2E自动化测试 (P0)

- [ ] **T7.1** 设备管理E2E测试
  - 测试设备CRUD完整流程
  - 测试二维码功能
  - 测试维修历史

- [ ] **T7.2** 收费管理E2E测试
  - 测试账单管理流程
  - 测试缴费功能
  - 测试统计报表

- [ ] **T7.3** 巡检管理E2E测试
  - 测试计划管理流程
  - 测试任务执行流程

- [ ] **T7.4** 工单管理E2E测试
  - 测试工单创建流程
  - 测试工单流转流程

- [ ] **T7.5** 访客管理E2E测试
  - 测试预约审批流程
  - 测试出入场流程

- [ ] **T7.6** 通知管理E2E测试
  - 测试通知配置流程
  - 测试通知发送接收

---

## 📊 任务依赖关系

```
设备管理:
T1.1.1 → T1.1.2 → T1.1.3 → T1.1.4 → T1.1.5 → T1.2.1 → T1.3.1/1.3.2/1.3.3 → T1.4.1/1.4.2/1.4.3 → T1.4.4

收费管理:
T2.1.1 → T2.2.1/2.2.2/2.2.3 → T2.3.1/2.3.2 → T2.3.3

巡检管理:
T3.1.1 → T3.1.2 → T3.1.3 → T3.1.4 → T3.2.1/3.2.2 → T3.2.3

工单管理:
T4.1.1 → T4.1.2 → T4.1.3 → T4.1.4 → T4.2.1/4.2.2 → T4.2.3

访客管理:
T5.1.1 → T5.1.2 → T5.1.3 → T5.1.4 → T5.2.1/5.2.2 → T5.2.3

通知管理:
T6.1.1 → T6.1.2 → T6.1.3 → T6.1.4 → T6.2.1/6.2.2 → T6.2.3

E2E测试:
各模块完成后 → 对应E2E测试
```

---

## 🎯 里程碑

| 里程碑 | 任务 | 完成标准 |
|--------|------|---------|
| M1 | T1.1.1-T1.1.5 | 设备管理后端API开发完成 |
| M2 | T1.2.1, T2.1.1 | 设备和收费管理前端启用 |
| M3 | T1.3.x, T2.2.x | 设备和收费管理联调完成 |
| M4 | T1.4.x, T2.3.x | 设备和收费管理测试完成 |
| M5 | T3.1.x-T6.1.x | 所有模块联调完成 |
| M6 | T3.2.x-T6.2.x | 所有模块测试完成 |
| M7 | T7.1-T7.6 | E2E测试全部通过 |

---

## 📋 验收标准

### 功能验收
- [ ] 所有API接口正常响应
- [ ] 前后端数据格式匹配
- [ ] 业务流程完整可用

### 联调验收
- [ ] 前端页面正常显示数据
- [ ] 操作功能正常工作
- [ ] 错误处理正确

### 测试验收
- [ ] 单元测试覆盖率 > 80%
- [ ] 集成测试全部通过
- [ ] E2E测试全部通过

### 文档验收
- [ ] API文档更新
- [ ] 测试报告完成

---

*最后更新: 2026-02-20*