Files
junhong_cmp_fiber/openspec/changes/enterprise-card-authorization/specs/iot-card/spec.md
huang fdcff33058
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m9s
feat: 实现企业卡授权和授权记录管理功能
主要功能:
- 添加企业卡授权/回收接口 (POST /enterprises/:id/allocate-cards, recall-cards)
- 添加授权记录管理接口 (GET/PUT /authorizations)
- 实现代理用户数据权限过滤(只能查看自己店铺下企业的授权记录)
- 添加 GORM callback 支持授权记录表的数据权限过滤

技术改进:
- 原生 SQL 查询手动添加数据权限过滤(ListWithJoin, GetByIDWithJoin)
- 移除卡授权预检接口(allocate-cards/preview),保留内部方法
- 完善单元测试和集成测试覆盖
2026-01-26 15:07:03 +08:00

1.9 KiB
Raw Blame History

MODIFIED Requirements

Requirement: IoT 卡查询和权限控制

系统 SHALL 支持基于用户类型和授权关系的 IoT 卡查询权限控制。

查询权限规则

  • 超级管理员/平台用户:可以查询所有 IoT 卡
  • 代理用户:可以查询自己店铺和下级店铺的 IoT 卡
  • 企业用户
    • 可以查询分配给自己企业的卡owner_type="enterprise" 且 owner_id=自己的企业ID
    • 可以查询授权给自己企业的卡(通过 enterprise_card_authorization 表关联)
  • 个人客户:只能查询自己拥有的卡

数据过滤

  • 企业用户查询时自动过滤敏感商业信息cost_price、distribute_price、supplier
  • 其他用户类型可以看到完整信息

Scenario: 企业用户查询自己拥有的卡

  • WHEN 企业用户查询 IoT 卡列表,且存在 owner_type="enterprise" 且 owner_id=该企业ID 的卡
  • THEN 系统返回这些卡的信息,但隐藏 cost_price、distribute_price、supplier 字段

Scenario: 企业用户查询被授权的卡

  • WHEN 企业用户查询 IoT 卡列表,且存在通过 enterprise_card_authorization 授权给该企业的卡
  • THEN 系统返回这些授权卡的信息,但隐藏商业敏感字段,同时包含授权人和授权时间信息

Scenario: 企业用户无法查询未授权的卡

  • WHEN 企业用户尝试查询既不属于自己也未被授权的卡
  • THEN 系统在查询结果中不包含这些卡,如同它们不存在

Scenario: 代理用户正常查询

  • WHEN 代理用户查询 IoT 卡
  • THEN 系统返回该代理店铺及其下级店铺的所有卡,包含完整信息

Scenario: 授权被回收后企业无法查询

  • WHEN 卡的授权被回收后revoked_at 不为空),企业用户查询该卡
  • THEN 系统不返回该卡信息,企业无法再看到该卡