feat: 实现企业卡授权和授权记录管理功能
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m9s

主要功能:
- 添加企业卡授权/回收接口 (POST /enterprises/:id/allocate-cards, recall-cards)
- 添加授权记录管理接口 (GET/PUT /authorizations)
- 实现代理用户数据权限过滤(只能查看自己店铺下企业的授权记录)
- 添加 GORM callback 支持授权记录表的数据权限过滤

技术改进:
- 原生 SQL 查询手动添加数据权限过滤(ListWithJoin, GetByIDWithJoin)
- 移除卡授权预检接口(allocate-cards/preview),保留内部方法
- 完善单元测试和集成测试覆盖
This commit is contained in:
2026-01-26 15:07:03 +08:00
parent 45aa7deb87
commit fdcff33058
42 changed files with 4782 additions and 298 deletions

View File

@@ -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 文档,确保新接口被正确生成