300 lines
8.8 KiB
Markdown
300 lines
8.8 KiB
Markdown
# 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*
|