From d0f488a0579ad5f1d8ffa52da48c72b370b88b9c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Sun, 4 Oct 2026 22:33:44 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E6=9D=83=E9=99=90):=20getUserColumnIds=20?= =?UTF-8?q?=E6=9C=89=E6=84=8F=E4=B8=8D=E8=BF=87=E6=BB=A4=E7=9A=84=E7=90=86?= =?UTF-8?q?=E7=94=B1=E5=85=A5=E6=96=87,=E5=B9=B6=E8=AE=A2=E6=AD=A3?= =?UTF-8?q?=E8=B6=85=E7=AE=A1=E6=8E=88=E6=9D=83=E6=A0=91=E9=82=A3=E5=8F=A5?= =?UTF-8?q?=E9=99=88=E6=97=A7=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 纯注释,行为一字未改: - 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))一字未动,只改注释。 --- .../service/PermissionMenuService.java | 16 +++++++++++++++- .../service/PermissionMenuServiceTest.java | 10 +++++++++- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java index bc280623f..026e0861d 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java @@ -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. + * + *
回填集有意不过滤(无节点可勾,提交侧出口 3 兜住):目标历史上挂着 + * {@link #SUPER_ADMIN_ONLY_KEYS} 那条授权时,这里仍原样返回它的 id(如 109)。这不是第四处出口该做的事—— + * 出口 1 已把该节点从授权树摘掉,弹窗里没有节点会为这个多余 id 亮起;前端 {@code @check} 从 + * {@code getCheckedKeys()} 现算提交集,它进不了载荷;用户原样保存时由出口 3 剥离并只留一条 warn。 + * 想在这里再剪一刀=未经批准的行为变化,得自带一记变异,别顺手加(review Q8 裁决)。
+ * + *调用方那一侧的残留风险(详见 task-4 报告「遗留」):{@code AdminUserService.replaceDirectPermissions} + * (:336/:349)先按 {@link #resolveMenuTypes} 给 id 归类,归不出类型的 id 会直接抛 + * 「存在无效或不属于当前类型的菜单权限项」,位置在本方法之后、出口 3 的剥离之前。今天碰不到 + * (菜单行在、生产 0 条授权),但 V143 的回滚脚本会删 {@code admin_companies} 那一行——真要执行它, + * 得先确认授权也已清干净,否则建号/改号整单失败(09-16 的形状)。
+ */ public UserColumnIdsVo getUserColumnIds(AdminUserEntity operator, Long userId, String menuType) { AdminUserEntity user = getUserById(userId); ensureTargetAccessible(operator, user); diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/permission/service/PermissionMenuServiceTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/permission/service/PermissionMenuServiceTest.java index cccab71b7..90d019853 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/permission/service/PermissionMenuServiceTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/permission/service/PermissionMenuServiceTest.java @@ -1268,7 +1268,15 @@ class PermissionMenuServiceTest { .containsExactlyInAnyOrder(tuple(1L, false), tuple(2L, true)); } - /** 超管的授权树不受过滤影响,仍拿到全量目录且全部可授予。 */ + /** + * 超管的授权树不受「按操作者范围」那刀过滤影响,仍拿到全量目录且全部可授予。 + * + *口径订正(Task 4):这句只描述 {@code resolveGrantableMenuIds} 对超管返回 null 这条路径;
+ * {@code SUPER_ADMIN_ONLY_KEYS} 是另一刀,方向相反——它对**所有角色(含超管)**都从可授予树里摘掉
+ * 那几个 key,钉在 {@code PermissionCompanyMenuHiddenTest#grantTreeDropsSuperAdminOnlyMenuEvenForSuperAdminButCatalogKeepsIt}。
+ * 本用例的夹具 columnKey 是 {@code menu-