huang
03a0960c4d
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m2s
- 移除 RegisterDataPermissionCallback 和 SkipDataPermission 机制 - 在 Auth 中间件预计算 SubordinateShopIDs 并注入 Context - 新增 ApplyShopFilter/ApplyEnterpriseFilter/ApplyOwnerShopFilter 等 Helper 函数 - 所有 Store 层查询方法显式调用数据权限过滤函数 - 权限检查函数 CanManageShop/CanManageEnterprise 改为从 Context 获取数据 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
data-permission Specification
Purpose
数据权限过滤机制，通过业务层显式调用实现数据隔离。
Requirements
Requirement: Subordinate IDs Caching
系统 SHALL 缓存用户的下级店铺 ID 列表以提高查询性能。
Scenario: 缓存命中
- WHEN 获取用户下级店铺 ID 列表
- AND Redis 缓存存在
- THEN 直接返回缓存数据
Scenario: 缓存未命中
- WHEN 获取用户下级店铺 ID 列表
- AND Redis 缓存不存在
- THEN 执行递归查询获取下级店铺 ID
- AND 将结果缓存到 Redis（30 分钟过期）
Scenario: 请求级别复用
- WHEN 同一请求内多次需要下级店铺 ID 列表
- THEN 从 Context 中获取预计算的值
- AND 不重复查询 Redis 或数据库
Requirement: Store 层显式数据权限过滤
系统 SHALL 在 Store 层查询方法中显式调用数据权限过滤函数。
Scenario: 有 shop_id 字段的表
- WHEN Store 执行列表查询
- AND 表包含
shop_id字段 - THEN 显式调用
ApplyShopFilter(ctx, query) - AND 代理用户只能查询
shop_id IN (subordinateShopIDs)的数据
Scenario: 有 enterprise_id 字段的表
- WHEN Store 执行列表查询
- AND 表包含
enterprise_id字段 - AND 当前用户为企业用户
- THEN 显式调用
ApplyEnterpriseFilter(ctx, query) - AND 企业用户只能查询
enterprise_id = ?的数据
Scenario: 有 owner_shop_id 字段的表
- WHEN Store 执行列表查询
- AND 表包含
owner_shop_id字段（如 Enterprise 表） - THEN 显式调用
ApplyOwnerShopFilter(ctx, query) - AND 代理用户只能查询
owner_shop_id IN (subordinateShopIDs)的数据
Scenario: NULL shop_id 不可见
- WHEN 代理用户查询有
shop_id字段的表 - AND 记录的
shop_id为 NULL（平台库存） - THEN 该记录对代理用户不可见
Scenario: 平台用户/超管不过滤
- WHEN 平台用户或超级管理员执行查询
- THEN Helper 函数不添加任何过滤条件
- AND 可查询所有数据