docs(权限): getUserColumnIds 有意不过滤的理由入文,并订正超管授权树那句陈旧注释

纯注释,行为一字未改:
- getUserColumnIds(review Q8 裁决):写明"回填集有意不过滤(无节点可勾,提交侧出口 3 兜住)"——
  出口 1 已把节点从授权树摘掉、前端 @check 从 getCheckedKeys() 现算、原样保存时由出口 3 剥离并 warn,
  所以这里多回一个 109 是无害形状;想再加第四处出口属于未批准的行为变化,得自带一记变异。
  同段记下调用方那一侧的残留风险:AdminUserService.replaceDirectPermissions(:336/:349) 先按
  resolveMenuTypes 归类、归不出就抛「存在无效或不属于当前类型的菜单权限项」,位置在剥离之前;
  今天碰不到(菜单行在、生产 0 条授权),但 V143 回滚脚本会删 admin_companies 那一行。
- PermissionMenuServiceTest 里"超管的授权树不受过滤影响"这句按 Task 4 之后的口径收窄到
  "不受按操作者范围那一刀影响",并点名 SUPER_ADMIN_ONLY_KEYS 是方向相反的另一刀;
  下面两条断言(含 :1273 的 containsExactly(1L, 3L))一字未动,只改注释。
This commit is contained in:
2026-10-04 22:33:44 +08:00
parent 7557cdb27a
commit d0f488a057
2 changed files with 24 additions and 2 deletions
@@ -293,7 +293,21 @@ public class PermissionMenuService {
return getUserColumnIds(null, userId, menuType);
}
/** Controller-facing variant with target-user scope checks. */
/**
* Controller-facing variant with target-user scope checks.
*
* <p><b>回填集有意不过滤</b>(无节点可勾,提交侧出口 3 兜住):目标历史上挂着
* {@link #SUPER_ADMIN_ONLY_KEYS} 那条授权时,这里仍原样返回它的 id(如 109)。这不是第四处出口该做的事——
* 出口 1 已把该节点从授权树摘掉,弹窗里没有节点会为这个多余 id 亮起;前端 {@code @check} 从
* {@code getCheckedKeys()} 现算提交集,它进不了载荷;用户原样保存时由出口 3 剥离并只留一条 warn。
* 想在这里再剪一刀=未经批准的行为变化,得自带一记变异,别顺手加(review Q8 裁决)。</p>
*
* <p>调用方那一侧的残留风险(详见 task-4 报告「遗留」):{@code AdminUserService.replaceDirectPermissions}
* (:336/:349)先按 {@link #resolveMenuTypes} 给 id 归类,归不出类型的 id 会直接抛
* 「存在无效或不属于当前类型的菜单权限项」,位置在本方法之后、出口 3 的剥离之前。今天碰不到
* (菜单行在、生产 0 条授权),但 V143 的回滚脚本会删 {@code admin_companies} 那一行——真要执行它,
* 得先确认授权也已清干净,否则建号/改号整单失败(09-16 的形状)。</p>
*/
public UserColumnIdsVo getUserColumnIds(AdminUserEntity operator, Long userId, String menuType) {
AdminUserEntity user = getUserById(userId);
ensureTargetAccessible(operator, user);