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)