docs(公司tab): 把 Task 11 的两处执行期定案回写计划

计划正文还写着「list(Long) 有活调用方」和「凭据闸门收 companyMemberIds」,前者落地
后是死代码、后者会把「建在我可访问分组里、创建人是别人」的行 403 掉。后面几批要照这
份计划做,留着旧形状等于下一个人照着写回来。
This commit is contained in:
2026-10-05 17:00:52 +08:00
parent d04bf6c3d1
commit cc3b15241a
+29 -8
View File
@@ -2001,8 +2001,8 @@ git commit -m "feat(公司tab): 任务看板五个端点按公司筛(一处 reso
- Consumes: `DataReadScope.readScope(AdminUserEntity, Long)` → `ReadScope.userIdsOr(List<Long>)`(Task 6)
- Produces:
- `ShopManagePageVo page(long page, long pageSize, Long groupId, String shopName, Long operatorId, boolean superAdmin, List<Long> companyMemberIds)` —— `companyMemberIds == null` 表示不筛(超管没选公司 / 非超管由既有分支自己锁)
- `List<ShopManageGroupItemVo> list(Long createdById, List<Long> companyMemberIds)`(保留现有 `list()` / `list(Long)` 两个重载委托到它,`list()`→`list(null, null)`;**实查 `list()` 有其它调用方,删重载会编译断**)
- `ShopManageCredentialVo getCredentialById(Long id, List<Long> companyMemberIds)` —— 成员集非 null 且行的 `created_by_id` 不在其中 ⇒ `BusinessException(403, ...)`
- `List<ShopManageGroupItemVo> list(Long createdById, List<Long> companyMemberIds)`(零参 `list()` 保留并委托到它`list(null, null)`;`list()` 有活调用方 `listAccessible`,删了编译断。原稿点名的单参 `list(Long)` 落地后无人调用,**已删**——见 Step 3(c) 那条执行期订正)
- `ShopManageCredentialVo getCredentialById(Long id, Long operatorId, boolean superAdmin)` —— 非超管时行的 `created_by_id ∈ 可访问创建人集` **或** `group_id ∈ 可访问分组集` 才放行,两腿都不认 ⇒ `BusinessException(403, ...)`;超管短路不查可见集。**为什么不是原稿那个成员集版**见 Step 3(d) 的执行期定案(用账号集合当闸门会把"建在我可访问分组里、创建人是别人"的行 403 掉 = 静默删掉正当访问)
- 写侧**不新增任何参数**——见 Step 4 的口径与它那条反向钉
- [ ] **Step 1: 写失败的测试(读侧一条 + 分组括号一条 + 凭据闸门一条 + 写侧"不得回流"一条)**
@@ -2305,12 +2305,18 @@ public final class SourceScan {
}
```
保留 `list()` 与 `list(Long)` 两支既有重载委托到它(`list()` 被同文件 `listAccessible:60` 调用,`list(Long)` 被 `ShopManageController.java:120` 调用——实查这两支都有活调用方,**删重载直接编译断**)。
只保留 `list()` 一支委托到它(`list()` 被同文件 `listAccessible` 调用)。**执行期订正**:原稿说的 `list(Long)` 单参重载并没有活调用方——controller 那一支从一开始就要传公司成员集,落地时调的是二参 `list(createdById, memberIds)`(`ShopManageController.java:129`),单参那支成了死代码,已随修复轮删除(`grep` 全仓 `src/main` + `src/test` 零命中)。零参 `list()` 仍在用,删它才会编译断。
**(d) `getCredentialById` 的闸门**(`ShopManageService.java:155-164`)—— 这是本任务里唯一一处"不做就是真越权"的东西:`:175-182` 的 `adminCredential(id)` 走 `requireOperator` = **`requireAdminOrInternal`**(`:50-52`),今天**任何**已认证后台账号(含内部令牌通道)拿一个 id 就能读到**别家店铺的明文账号密码**,连分组都不判。§6.1 那条"列表筛了、按 id 照读 = 越权"在这里是字面成立的,而且读出来的是凭据。
(下面这段代码块是**执行期定案后的实际形状**,原稿设想的 `companyMemberIds` 版已被替换,理由见代码块之后。)
**执行期定案(与原稿不同,差异是实质性的,照原稿写会静默删掉正当访问)**:闸门不收 `companyMemberIds`,
收 `(Long id, Long operatorId, boolean superAdmin)`,判据用 `page()` 那把尺子的**两腿**——
`created_by_id ∈ 可访问创建人集` **或** `group_id ∈ 可访问分组集`:
```java
public ShopManageCredentialVo getCredentialById(Long id, List<Long> companyMemberIds) {
public ShopManageCredentialVo getCredentialById(Long id, Long operatorId, boolean superAdmin) {
if (id == null || id <= 0) {
throw new BusinessException("店铺 ID 不合法");
}
@@ -2318,15 +2324,30 @@ public final class SourceScan {
if (entity == null) {
throw new BusinessException("店铺不存在");
}
// 与列表同一把尺子:memberIds 非 null 时,行的 created_by_id 必须落得进去。
// 抛 403 而不是静默返回 null —— 静默会让调用方以为"这店铺没配凭据",那是数据问题伪装成权限问题。
if (companyMemberIds != null && !companyMemberIds.contains(entity.getCreatedById())) {
throw new BusinessException(403, "无权查看该店铺的凭据");
// 尺子必须与 page() 那一条同形:created_by_id IN creators OR group_id IN groups。
// 账号集合表达不了分组那一腿(店铺建在我可访问的分组里、创建人却不在我的账号集),
// 拿它当闸门会把列表看得见的行读凭据时 403 掉——那是把正当访问静默删掉。
if (!superAdmin) {
Set<Long> creators = shopManageGroupService.listAccessibleCreatorUserIds(operatorId, false);
Set<Long> groups = shopManageGroupService.listAccessibleGroupIds(operatorId, false);
boolean visible = (entity.getCreatedById() != null && creators.contains(entity.getCreatedById()))
|| (entity.getGroupId() != null && groups.contains(entity.getGroupId()));
if (!visible) {
throw new BusinessException(403, "无权查看该店铺的凭据");
}
}
return toCredentialVo(entity);
}
```
为什么不能用原稿那个 `companyMemberIds.contains(created_by_id)`:这一页的列表口径本来就是"创建人集 ∪ 分组集"两条腿
(`page()` 里那条 `... OR group_id IN (...)`),而成员集只表达前一条腿。用它当闸门 ⇒ 超管选了公司时、以及管理员读
"建在自己分组里、创建人是别人"的店铺时会被 403,**症状是列表看得见、点开除凭据报无权**,而这类"把正当访问筛没了"
的错误不会有任何接口红。钉这个差异的用例是 `ShopManageServiceTest.credentialByIdKeepsGroupVisibleRowsReadable`
(分组可见、创建人不在账号集 ⇒ 必须 200),它是防误伤的正样本;反向越权由
`credentialByIdRejectsRowOutsideBothVisibleSets` 钉(两腿都不认 ⇒ 403)。超管仍走 `superAdmin` 短路不查可见集
(tab 不是安全边界,这一页的既定口径)。
⚠️ **`getCredentialByShopName`(`:156-171`)这轮刻意不动**,理由与影响记进附B:它的调用方是 Python 自动化与 4.0.44 起的登录态客户端(`ShopManageCredentialAuthTest` 钉着那两条通道),`requireUser` 拿到的可能是**根本不是后台账号**的客户端用户 —— 那里没有"操作者公司"可推导,硬加闸门会把跟价机整片打停。它今天同样是跨公司的(按名字就能读凭据),**那是一期就存在的洞,不是本计划引入的**,要修得单独一张工单、单独授权。
- [ ] **Step 4: 写侧**——本任务**不动**它,并说明为什么(这是 2026-10-04 定下的口径,不是偷懒)