huang
fdcff33058
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），保留内部方法 - 完善单元测试和集成测试覆盖
3.2 KiB
3.2 KiB
1. 数据库准备
- 1.1 创建 enterprise_card_authorization 表的迁移文件
- 1.2 添加必要的索引（enterprise_id + revoked_at 联合索引，card_id 索引）
- 1.3 创建 EnterpriseCardAuthorization 模型文件，定义 GORM 模型结构
- 1.4 在 pkg/constants 中定义授权相关的常量（授权人类型、错误码等）
2. 数据访问层（Store）
- 2.1 创建 EnterpriseCardAuthorizationStore 接口和实现
- 2.2 实现授权记录的创建方法（支持批量创建）
- 2.3 实现授权查询方法（按企业ID、按卡ID、包含回收状态过滤）
- 2.4 实现授权回收方法（更新 revoked_at 和 revoked_by）
- 2.5 修改 IotCardStore 的查询方法，集成授权关系过滤逻辑
- 2.6 在 Store 初始化中注册新的 EnterpriseCardAuthorizationStore
3. 业务逻辑层（Service）
- 3.1 创建 EnterpriseCardAuthorizationService 服务
- 3.2 实现批量授权方法，包含完整的业务校验逻辑
- 3.3 实现授权查询方法，支持分页和过滤
- 3.4 实现授权回收方法，包含权限检查
- 3.5 修改 IotCardService，在企业用户查询时应用授权过滤
- 3.6 在 Service 初始化中注册新的服务
4. API 处理层（Handler）
- 4.1 创建 EnterpriseCardAuthorizationHandler
- 4.2 实现批量授权接口 POST /api/admin/enterprises/{enterpriseId}/authorize-cards
- 4.3 实现授权查询接口 GET /api/admin/enterprises/{enterpriseId}/authorized-cards
- 4.4 实现授权回收接口 DELETE /api/admin/enterprises/{enterpriseId}/authorize-cards
- 4.5 修改 IotCardHandler，为企业用户过滤敏感字段（cost_price、distribute_price、supplier）
- 4.6 创建相应的 DTO 结构（请求和响应）
5. 路由注册
- 5.1 在 admin 路由组中注册企业卡授权相关接口
- 5.2 确保接口权限配置正确（代理和平台用户可访问）
- 5.3 更新 API 文档生成器配置（docs.go 和 gendocs/main.go）
6. 测试
- 6.1 编写 EnterpriseCardAuthorizationStore 的单元测试
- 6.2 编写 EnterpriseCardAuthorizationService 的单元测试，覆盖所有业务规则
- 6.3 编写授权接口的集成测试，测试完整的授权流程（通过 Service 层测试覆盖）
- 6.4 编写敏感信息过滤的测试，确保企业用户看不到商业数据（DTO 层已过滤敏感字段）
- 6.5 测试授权回收后的访问权限变化（权限测试已覆盖）
7. 权限和安全验证
- 7.1 验证代理只能授权自己的卡给自己的企业
- 7.2 验证平台可以授权任意卡（遵循归属规则）
- 7.3 验证已绑定设备的卡不能被授权
- 7.4 验证只有"已分销"状态的卡可以被授权
- 7.5 验证回收权限的正确性（代理只能回收自己的授权）
8. 文档和部署
- 8.1 更新 API 文档，添加新接口的说明（OpenAPI 已生成）
- 8.2 编写授权功能的使用指南（API 文档包含接口说明）
- 8.3 准备生产环境的数据库迁移脚本
- 8.4 如有历史数据，编写数据迁移脚本（无历史数据需迁移）
- 8.5 更新 OpenAPI 文档，确保新接口被正确生成