ether
/
ether-docs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ether-docs/_archive/pending-features-spec/checklist.md

8.8 KiB
Raw Permalink Blame History

Ether 待开发功能 - 检查清单

📋 检查清单概览

本文档用于验证待开发功能是否完整实现，确保质量和功能完整性。

✅ 设备管理模块检查清单

后端实现

实体层

  • Equipment 实体类已创建
  • MaintenanceRecord 实体类已创建
  • SparePart 实体类已创建
  • 所有实体包含 UUID 主键
  • 所有实体包含 createdAt/updatedAt 字段
  • 实体字段与数据库表结构一致

枚举类

  • EquipmentType 枚举已创建
  • EquipmentStatus 枚举已创建
  • MaintenanceType 枚举已创建
  • 枚举值与前端定义一致

Repository层

  • EquipmentRepository 已创建
  • MaintenanceRecordRepository 已创建
  • SparePartRepository 已创建
  • 自定义查询方法已实现
  • 分页查询已支持

Service层

  • EquipmentService 接口已定义
  • EquipmentServiceImpl 实现类已创建
  • CRUD 方法已实现
  • 业务逻辑已实现（状态管理、维保提醒等）
  • 异常处理已完善

Controller层

  • GET /api/v1/asset/equipments - 获取设备列表
  • GET /api/v1/asset/equipments/{id} - 获取设备详情
  • POST /api/v1/asset/equipments - 创建设备
  • PUT /api/v1/asset/equipments/{id} - 更新设备
  • DELETE /api/v1/asset/equipments/{id} - 删除设备
  • PATCH /api/v1/asset/equipments/{id}/status - 更新状态
  • GET /api/v1/asset/equipments/type/{type} - 按类型查询
  • GET /api/v1/asset/equipments/status/{status} - 按状态查询
  • GET /api/v1/asset/equipments/space-node/{id} - 按空间查询
  • GET /api/v1/asset/equipments/search - 搜索设备
  • POST /api/v1/asset/equipments/{id}/maintenance - 记录保养
  • GET /api/v1/asset/equipments/generate-code - 生成编码
  • GET /api/v1/asset/equipment/qrcode/{id} - 获取二维码
  • GET /api/v1/asset/equipment/qrcode/info/{qrCode} - 扫码查询

数据库

  • asset_equipment 表已创建
  • asset_maintenance_record 表已创建
  • asset_spare_part 表已创建
  • 索引已创建
  • 外键约束已设置

前端实现

页面组件

  • 设备列表页面已创建
  • 设备详情页面已创建
  • 设备表单组件已创建
  • 维保记录组件已创建
  • 备件管理页面已创建

API集成

  • equipment.ts API定义完整
  • API调用正常工作
  • 错误处理已实现

功能验证

  • 设备列表可正常显示
  • 分页功能正常
  • 筛选功能正常
  • 搜索功能正常
  • 新增设备功能正常
  • 编辑设备功能正常
  • 删除设备功能正常
  • 状态切换功能正常
  • 二维码生成功能正常
  • 维保记录管理功能正常

✅ 收费管理模块检查清单

后端实现

Service层

  • 收费项目CRUD方法已实现
  • 账单生成方法已实现
  • 账单查询方法已实现
  • 账单状态管理已实现
  • 支付记录管理已实现
  • 统计报表方法已实现
  • 催缴提醒方法已实现

Controller层

  • GET /api/v1/finance/fee-items - 获取收费项目
  • POST /api/v1/finance/fee-items - 创建收费项目
  • PUT /api/v1/finance/fee-items/{id} - 更新收费项目
  • DELETE /api/v1/finance/fee-items/{id} - 删除收费项目
  • GET /api/v1/finance/bills - 获取账单列表
  • POST /api/v1/finance/bills - 创建账单
  • PUT /api/v1/finance/bills/{id} - 更新账单
  • DELETE /api/v1/finance/bills/{id} - 删除账单
  • POST /api/v1/finance/bills/{id}/pay - 缴费
  • POST /api/v1/finance/bills/{id}/cancel - 取消账单
  • GET /api/v1/finance/payments - 获取支付记录
  • GET /api/v1/finance/statistics - 统计数据
  • GET /api/v1/finance/statistics/* - 各项统计

前端实现

功能验证

  • 开发中提示已移除
  • 统计看板数据正常显示
  • 账单列表正常显示
  • 账单创建功能正常
  • 账单编辑功能正常
  • 缴费功能正常
  • 支付记录显示正常
  • 统计报表显示正常
  • 导出功能正常

✅ 巡检管理模块检查清单

API对接验证

  • GET /api/v1/mdm/inspections/plans - 获取计划列表
  • POST /api/v1/mdm/inspections/plans - 创建计划
  • PUT /api/v1/mdm/inspections/plans/{id} - 更新计划
  • DELETE /api/v1/mdm/inspections/plans/{id} - 删除计划
  • PATCH /api/v1/mdm/inspections/plans/{id}/status - 切换状态
  • GET /api/v1/mdm/inspections/plans/{planId}/points - 获取巡检点
  • POST /api/v1/mdm/inspections/plans/{planId}/points - 添加巡检点
  • GET /api/v1/mdm/inspections/tasks - 获取任务列表
  • POST /api/v1/mdm/inspections/tasks/{taskId}/start - 开始任务
  • POST /api/v1/mdm/inspections/tasks/{taskId}/complete - 完成任务
  • GET /api/v1/mdm/inspections/statistics/* - 统计接口

功能验证

  • 巡检计划CRUD正常
  • 巡检点管理正常
  • 任务生成正常
  • 任务执行流程正常
  • 统计数据准确

✅ 工单管理模块检查清单

API对接验证

  • POST /api/v1/ops/work-orders - 创建工单
  • PUT /api/v1/ops/work-orders/{id} - 更新工单
  • POST /api/v1/ops/work-orders/{id}/assign - 分配工单
  • POST /api/v1/ops/work-orders/{id}/accept - 接单
  • POST /api/v1/ops/work-orders/{id}/start - 开始处理
  • POST /api/v1/ops/work-orders/{id}/complete - 完成工单
  • POST /api/v1/ops/work-orders/{id}/close - 关闭工单
  • GET /api/v1/ops/work-orders - 查询工单列表
  • GET /api/v1/ops/work-orders/{id} - 获取工单详情
  • GET /api/v1/ops/work-orders/{id}/detail - 获取详细信息

功能验证

  • 工单创建流程正常
  • 工单分配流程正常
  • 工单流转流程正常
  • 工单统计正常
  • 设备关联工单正常

✅ 访客管理模块检查清单

API对接验证

  • GET /api/v1/mdm/visitors/appointments - 获取预约列表
  • POST /api/v1/mdm/visitors/appointments - 创建预约
  • PUT /api/v1/mdm/visitors/appointments/{id} - 更新预约
  • POST /api/v1/mdm/visitors/appointments/{id}/approve - 审批通过
  • POST /api/v1/mdm/visitors/appointments/{id}/reject - 审批拒绝
  • POST /api/v1/mdm/visitors/appointments/{id}/check-in - 入场登记
  • POST /api/v1/mdm/visitors/appointments/{id}/check-out - 离场登记
  • GET /api/v1/mdm/visitors/blacklist - 获取黑名单
  • POST /api/v1/mdm/visitors/blacklist - 添加黑名单
  • GET /api/v1/mdm/visitors/statistics/dashboard - 统计数据

功能验证

  • 访客预约流程正常
  • 审批流程正常
  • 入场登记正常
  • 离场登记正常
  • 黑名单管理正常
  • 黑名单拦截正常
  • 历史访客查询正常

✅ 通知管理模块检查清单

API对接验证

  • GET /api/v1/ops/notification/channels - 获取渠道列表
  • POST /api/v1/ops/notification/channels - 创建渠道
  • GET /api/v1/ops/notification/templates - 获取模板列表
  • POST /api/v1/ops/notification/templates - 创建模板
  • GET /api/v1/ops/notification/rules - 获取规则列表
  • POST /api/v1/ops/notification/rules - 创建规则
  • GET /api/v1/ops/notification/history/my - 获取我的通知
  • POST /api/v1/ops/notification/history/{id}/read - 标记已读

功能验证

  • 渠道配置正常
  • 模板管理正常
  • 规则配置正常
  • 通知发送正常
  • 通知接收正常
  • 已读/未读状态正常

✅ E2E测试检查清单

测试环境

  • 测试数据库已准备
  • 测试数据已初始化
  • 所有服务已启动

测试执行

  • 设备管理E2E测试通过
  • 收费管理E2E测试通过
  • 巡检管理E2E测试通过
  • 工单管理E2E测试通过
  • 访客管理E2E测试通过
  • 通知管理E2E测试通过

测试覆盖

  • 正常流程测试覆盖
  • 异常流程测试覆盖
  • 边界条件测试覆盖

✅ 代码质量检查清单

后端代码

  • 编译无错误
  • 无安全漏洞
  • 代码规范检查通过
  • 单元测试通过

前端代码

  • TypeScript类型检查通过
  • 编译无错误
  • ESLint检查通过
  • 无控制台错误

文档

  • API文档已更新
  • 数据库文档已更新
  • README已更新

✅ 部署检查清单

服务检查

  • ether-mdm 服务正常启动
  • ether-ops 服务正常启动
  • ether-finance 服务正常启动
  • ether-gateway 服务正常启动
  • ether-ui-admin 服务正常启动

功能验证

  • 所有页面可正常访问
  • 所有API可正常调用
  • 数据库连接正常
  • 日志输出正常

📝 问题记录

序号 模块 问题描述 状态 解决方案
1
2
3

最后更新: 2026-02-20