From 898a8e2258d7b1a1615ba4cfc7d1b84be2fe1afa 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 19:42:59 +0800 Subject: [PATCH] =?UTF-8?q?feat(=E5=85=AC=E5=8F=B8=E9=85=8D=E7=BD=AE):=20?= =?UTF-8?q?=E5=85=AC=E5=8F=B8=E7=9B=AE=E5=BD=95=E8=AF=BB=E4=BE=A7=E6=94=B6?= =?UTF-8?q?=E6=88=90=E8=A7=92=E8=89=B2=E5=86=85=E5=9C=A8=E9=97=B8=E9=97=A8?= =?UTF-8?q?,=E9=9D=9E=E8=B6=85=E7=AE=A1=E4=B8=80=E5=BE=8B403?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../company/service/CompanyService.java | 32 +++++------- .../service/CompanyReadPathMenuGateTest.java | 4 +- .../service/CompanyServiceDirectoryTest.java | 49 ++++++++----------- 3 files changed, 35 insertions(+), 50 deletions(-) diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyService.java index 350504ff2..7aec8146f 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyService.java @@ -45,31 +45,25 @@ public class CompanyService { } /** - * 公司目录(设计文档 §2.3):超管看全部,公司内管理员只看自己那一家。 + * 公司目录(设计文档 §2.3):仅超管读写,非超管一律 403(spec §12 需求 2—— + * 除了超管都不能操作公司配置,读写都不行)。「用户管理」页的公司下拉也只超管可见: + * Task 2 起前端按角色剪枝、非超管根本不发这个请求,这里再兜一道服务端闸门。 * - *

读口径必须和写口径一起收窄——只把写拦成超管、列表仍返回全部公司,等于把别家公司的 - * 名字泄露给本公司管理员。管理员没有公司归属时是拒绝,不是"那就不过滤"。

- * - *

这里不查菜单权限:{@code admin_companies} 那道闸门管的是「公司管理」这个页面 - * 出不出现在侧边栏,而本方法同时是「用户管理」页公司下拉的数据源,两者不是一回事。 - * 收窄靠 role + companyId 已经到位,本公司管理员能读到的那一行就是他在登录响应和 - * /current-user 里本来就拿着的那个自己的公司名,菜单闸门在这里多守不住一个字节。

+ *

闸门判角色、不判菜单授权:{@code admin_companies} 那道菜单闸门挂在 + * {@code user_column_permission} 上,2026-10-04 12:3x 就是因为它一笔授权都没发, + * 让 15 个公司内管理员一开「用户管理」就吃 403、被前端拦成"登录闪退"。 + * 角色不会被"忘了授权"打穿,所以这里用 {@link #ensureSuperAdmin} 与写入口共用同一个出口。

*/ public List listVisible(AdminUserEntity operator) { String role = adminAuthSupport.currentRole(operator); if (role == null) { throw new BusinessException(403, "需要管理员权限"); } - if ("super_admin".equals(role)) { - return companyMapper.selectList(new LambdaQueryWrapper() - .orderByAsc(CompanyEntity::getId)); - } - Long ownCompanyId = operator.getCompanyId(); - if (ownCompanyId == null) { - throw new BusinessException(403, "当前账号没有所属公司,无法查看公司目录"); - } + // 读写都只超管(spec §2 的 A 类):判角色、不判菜单授权—— + // 12:3x 已经证明"把可见性挂在 user_column_permission 上"会因一笔授权没发而全员 403。 + ensureSuperAdmin(operator); return companyMapper.selectList(new LambdaQueryWrapper() - .eq(CompanyEntity::getId, ownCompanyId)); + .orderByAsc(CompanyEntity::getId)); } /** @@ -77,7 +71,7 @@ public class CompanyService { * *

这个方法不做权限判断:它只是把调用方已经拿在手里的那些 id 换成名字, * 谁能看到哪些行由调用方的查询范围决定(同 {@code AdminUserService.loadCreatorMap} 的口径)。 - * 要给前端列公司目录请走 {@link #listVisible},它才按角色和公司收窄。

+ * 要给前端列公司目录请走 {@link #listVisible},它才做超管闸门(非超管一律 403)。

*/ public Map namesByIds(Collection companyIds) { if (companyIds == null || companyIds.isEmpty()) { @@ -197,7 +191,7 @@ public class CompanyService { private void ensureSuperAdmin(AdminUserEntity operator) { if (!"super_admin".equals(adminAuthSupport.currentRole(operator))) { - throw new BusinessException(403, "只有超级管理员可以新增或修改公司"); + throw new BusinessException(403, "只有超级管理员可以查看或修改公司配置"); } } } diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyReadPathMenuGateTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyReadPathMenuGateTest.java index 6266bb3b6..f83b0000b 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyReadPathMenuGateTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyReadPathMenuGateTest.java @@ -46,8 +46,8 @@ class CompanyReadPathMenuGateTest { .filter(line -> line.contains("ensureSuperAdmin(operator);")) .collect(Collectors.toList()); assertThat(guards) - .as("create 与 update 两处写入口的超管闸门 must 保留") - .hasSize(2); + .as("create / update / listVisible 三处的超管闸门 must 保留") + .hasSize(3); } /** 取样集非空自检:扫描一旦 0 命中,上面几条就恒绿,等于没护栏。 */ diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyServiceDirectoryTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyServiceDirectoryTest.java index d7551faa3..8b624bc7d 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyServiceDirectoryTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/company/service/CompanyServiceDirectoryTest.java @@ -28,9 +28,10 @@ import static org.mockito.Mockito.when; /** * 公司目录(设计文档 §2.3)的可见范围与写入边界。 * - *

读口径与写口径必须一起收窄:只把写拦成超管、列表仍返回全部公司,等于把别家公司的 - * 名字泄露给本公司管理员。收窄靠 role + companyId,不靠菜单权限(见 - * {@link CompanyReadPathMenuGateTest} 钉住的那条)。

+ *

读写共用同一道角色闸门:非超管(含公司内管理员)一律 403 —— spec §12 需求 2 的口径是 + * 「除了超管都不能操作公司配置,读写都不行」。收窄只靠 role,不靠 companyId、更不靠菜单权限: + * 挂在 {@code admin_companies} 的菜单授权上会因"一笔授权没发"而全员 403(2026-10-04 12:3x), + * "公司服务不查菜单"这条由 {@link CompanyReadPathMenuGateTest} 实跑钉住。

*/ class CompanyServiceDirectoryTest { @@ -118,16 +119,12 @@ class CompanyServiceDirectoryTest { } @Test - @DisplayName("公司内管理员的目录只查自己公司:读口径必须跟写口径一起收窄") - void companyScopedAdminDirectoryIsFilteredToOwnCompany() { - when(companyMapper.selectList(any())).thenReturn(List.of(company(2, "福州数富", 1))); - - List visible = companyService.listVisible(operator("admin", 2L)); - - assertThat(visible).hasSize(1); - LambdaQueryWrapper query = capturedSelectList(); - assertThat(query.getSqlSegment()).contains("id"); - assertThat(query.getParamNameValuePairs()).containsValue(2L); + @DisplayName("公司内管理员读不到公司目录:读写都只超管(spec §12 需求 2)") + void companyScopedAdminCannotReadDirectory() { + assertThatThrownBy(() -> companyService.listVisible(operator("admin", 2L))) + .isInstanceOf(BusinessException.class) + .hasMessageContaining("公司"); + verify(companyMapper, never()).selectList(any()); } @Test @@ -149,27 +146,21 @@ class CompanyServiceDirectoryTest { } /** - * 回归用例(2026-10-04 生产事故):「用户管理」页的公司下拉也走这个读端点, - * 而 admin_companies 菜单 V143 建了行却一笔授权都没发,15 个公司内管理员因此全被 403, - * 前端把 403 当未登录整页踢回登录页,症状看起来是"登录闪退"。 - * - *

菜单权限管的是「公司管理」这个页面出不出现在侧边栏,不是这份数据谁能读。 - * 读端点挂菜单闸门等于把"页面可见性"当"数据可见性"用;收窄靠 role + companyId 就够了, - * 何况公司名在登录响应和 /current-user 里本来就回带,这道闸门一个字节都没多守住。

+ * 回归用例(2026-10-04 12:3x 生产事故)的**新形态**:当年挂 403 的是菜单授权(一笔都没发 ⇒ 全员闪退), + * 现在挂 403 的是角色。区别在于角色不会被"忘了授权"打穿,但**前端必须自己不发这个请求** + * (见 Task 2 与 tests/company-config-entry-super-only.test.ts),否则非超管照样吃 403。 */ @Test - @DisplayName("公司内管理员读到本公司那一行:读端点不查 admin_companies 菜单") - void companyScopedAdminReadsOwnCompanyWithoutTheMenuGrant() { - when(companyMapper.selectList(any())).thenReturn(List.of(company(2, "福州数富", 1))); - - List visible = companyService.listVisible(operator("admin", 2L)); - - assertThat(visible).hasSize(1); - assertThat(capturedSelectList().getParamNameValuePairs()).containsValue(2L); + @DisplayName("非超管读公司目录只认角色,不认菜单授权(菜单那条已经不可能再伤到人)") + void directoryReadGateIsRoleIntrinsicNotMenuBased() { + assertThatThrownBy(() -> companyService.listVisible(operator("admin", 2L))) + .isInstanceOf(BusinessException.class) + .hasMessageContaining("超级管理员"); + verify(companyMapper, never()).selectList(any()); } @Test - @DisplayName("新增公司仅超管:公司内管理员读得到目录也不能建第二家公司") + @DisplayName("新增公司仅超管:公司内管理员读不到目录也建不了公司") void companyAdminCannotCreate() { assertThatThrownBy(() -> companyService.create(operator("admin", 2L), request("福州数富", null, null))) .isInstanceOf(BusinessException.class)