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

9.3 KiB

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