# 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*