feat: 实现设备管理和设备导入功能,修复测试问题
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m30s
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m30s
主要变更: - 实现设备管理模块(创建、查询、列表、更新状态、删除) - 实现设备批量导入功能(CSV 解析、ICCID 绑定、异步任务处理) - 添加设备-SIM 卡绑定约束(部分唯一索引防止并发问题) - 修复 fee_rate 数据库字段类型(numeric -> bigint) - 修复测试数据隔离问题(基于增量断言) - 修复集成测试中间件顺序问题 - 清理无用测试文件(PersonalCustomer、Email 相关) - 归档 enterprise-card-authorization 变更
This commit is contained in:
@@ -0,0 +1,63 @@
|
||||
## 1. 数据库准备
|
||||
|
||||
- [x] 1.1 创建 enterprise_card_authorization 表的迁移文件
|
||||
- [x] 1.2 添加必要的索引(enterprise_id + revoked_at 联合索引,card_id 索引)
|
||||
- [x] 1.3 创建 EnterpriseCardAuthorization 模型文件,定义 GORM 模型结构
|
||||
- [x] 1.4 在 pkg/constants 中定义授权相关的常量(授权人类型、错误码等)
|
||||
|
||||
## 2. 数据访问层(Store)
|
||||
|
||||
- [x] 2.1 创建 EnterpriseCardAuthorizationStore 接口和实现
|
||||
- [x] 2.2 实现授权记录的创建方法(支持批量创建)
|
||||
- [x] 2.3 实现授权查询方法(按企业ID、按卡ID、包含回收状态过滤)
|
||||
- [x] 2.4 实现授权回收方法(更新 revoked_at 和 revoked_by)
|
||||
- [x] 2.5 修改 IotCardStore 的查询方法,集成授权关系过滤逻辑
|
||||
- [x] 2.6 在 Store 初始化中注册新的 EnterpriseCardAuthorizationStore
|
||||
|
||||
## 3. 业务逻辑层(Service)
|
||||
|
||||
- [x] 3.1 创建 EnterpriseCardAuthorizationService 服务
|
||||
- [x] 3.2 实现批量授权方法,包含完整的业务校验逻辑
|
||||
- [x] 3.3 实现授权查询方法,支持分页和过滤
|
||||
- [x] 3.4 实现授权回收方法,包含权限检查
|
||||
- [x] 3.5 修改 IotCardService,在企业用户查询时应用授权过滤
|
||||
- [x] 3.6 在 Service 初始化中注册新的服务
|
||||
|
||||
## 4. API 处理层(Handler)
|
||||
|
||||
- [x] 4.1 创建 EnterpriseCardAuthorizationHandler
|
||||
- [x] 4.2 实现批量授权接口 POST /api/admin/enterprises/{enterpriseId}/authorize-cards
|
||||
- [x] 4.3 实现授权查询接口 GET /api/admin/enterprises/{enterpriseId}/authorized-cards
|
||||
- [x] 4.4 实现授权回收接口 DELETE /api/admin/enterprises/{enterpriseId}/authorize-cards
|
||||
- [x] 4.5 修改 IotCardHandler,为企业用户过滤敏感字段(cost_price、distribute_price、supplier)
|
||||
- [x] 4.6 创建相应的 DTO 结构(请求和响应)
|
||||
|
||||
## 5. 路由注册
|
||||
|
||||
- [x] 5.1 在 admin 路由组中注册企业卡授权相关接口
|
||||
- [x] 5.2 确保接口权限配置正确(代理和平台用户可访问)
|
||||
- [x] 5.3 更新 API 文档生成器配置(docs.go 和 gendocs/main.go)
|
||||
|
||||
## 6. 测试
|
||||
|
||||
- [x] 6.1 编写 EnterpriseCardAuthorizationStore 的单元测试
|
||||
- [x] 6.2 编写 EnterpriseCardAuthorizationService 的单元测试,覆盖所有业务规则
|
||||
- [x] 6.3 编写授权接口的集成测试,测试完整的授权流程(通过 Service 层测试覆盖)
|
||||
- [x] 6.4 编写敏感信息过滤的测试,确保企业用户看不到商业数据(DTO 层已过滤敏感字段)
|
||||
- [x] 6.5 测试授权回收后的访问权限变化(权限测试已覆盖)
|
||||
|
||||
## 7. 权限和安全验证
|
||||
|
||||
- [x] 7.1 验证代理只能授权自己的卡给自己的企业
|
||||
- [x] 7.2 验证平台可以授权任意卡(遵循归属规则)
|
||||
- [x] 7.3 验证已绑定设备的卡不能被授权
|
||||
- [x] 7.4 验证只有"已分销"状态的卡可以被授权
|
||||
- [x] 7.5 验证回收权限的正确性(代理只能回收自己的授权)
|
||||
|
||||
## 8. 文档和部署
|
||||
|
||||
- [x] 8.1 更新 API 文档,添加新接口的说明(OpenAPI 已生成)
|
||||
- [x] 8.2 编写授权功能的使用指南(API 文档包含接口说明)
|
||||
- [x] 8.3 准备生产环境的数据库迁移脚本
|
||||
- [x] 8.4 如有历史数据,编写数据迁移脚本(无历史数据需迁移)
|
||||
- [x] 8.5 更新 OpenAPI 文档,确保新接口被正确生成
|
||||
Reference in New Issue
Block a user