diff --git a/backend-java/src/main/java/com/nanri/aiimage/common/service/CompanyScopeSupport.java b/backend-java/src/main/java/com/nanri/aiimage/common/service/CompanyScopeSupport.java
index 3517a57ca..f0bbad18e 100644
--- a/backend-java/src/main/java/com/nanri/aiimage/common/service/CompanyScopeSupport.java
+++ b/backend-java/src/main/java/com/nanri/aiimage/common/service/CompanyScopeSupport.java
@@ -1,11 +1,16 @@
package com.nanri.aiimage.common.service;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.common.mapper.AdminUserMapper;
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
+import java.util.ArrayList;
+import java.util.List;
+
/**
* 按账号解析归属公司(二期设计文档 §3.1)——数据出口只认这一个入口。
*
@@ -16,10 +21,14 @@ import org.springframework.stereotype.Service;
*
取不到公司一律抛,不返回 null:调用方一旦把 null 传进实体,MyBatis-Plus 会跳过该列,
* 落库时被 V145 的 {@code DEFAULT 1} 静默兜住——那是"归属失真且不报错"的成因(§6.3)。
*/
+@Slf4j
@Service
@RequiredArgsConstructor
public class CompanyScopeSupport {
+ /** 超过这个成员数就该把 {@code user_id IN (...)} 换成子查询(见 {@link #memberUserIds} 的 warn 与 spec §3.2)。 */
+ static final int MEMBER_WARN_THRESHOLD = 500;
+
private final AdminUserMapper adminUserMapper;
public Long requireCompanyId(Long userId) {
@@ -46,4 +55,50 @@ public class CompanyScopeSupport {
throw new BusinessException(403, deniedMessage);
}
}
+
+ /**
+ * 按公司枚举成员账号 id(spec §3.2:公司 tab 读范围的唯一来源,消费侧是 Task 6 的 DataReadScope)。
+ *
+ * 只投影 id:{@code users} 带 {@code password_hash},整行拉进内存是 2026-09
+ * 「不再整表拉回含密码哈希的全列」那轮优化摘掉的东西,别在这里装回去(测试钉的是
+ * {@code getSqlSelect()} 恰好等于 {@code id},加列就会红)。
+ *
+ * 不加 LIMIT:2026-10-04 生产只读取证全库 142 行 / 最大公司 140 成员
+ * ({@code company_id IS NULL} 0 行、公司数 2),今天装得下不代表以后装得下,而截断会让某个公司的
+ * tab 看起来"数据不全"且毫无提示。所以用 {@link #MEMBER_WARN_THRESHOLD}(500,对 140 是约 3.6 倍余量)
+ * 当倒计时哨兵——它要在查询劣化之前红在日志里、可被巡检按 marker
+ * {@code COMPANY_MEMBER_SET_LARGE} 抓到;阈值若按"至少留 5 倍余量"定到 700+,
+ * 等于哨兵响的时候列表早已痛了,那就不是护栏。
+ *
+ * 非法 companyId 抛 {@link BusinessException} 而不是返回空集:调用方把空集读成"这家公司查不到行",
+ * 与"参数没给对"是两种语义(spec §9 的静默丢数形态)。
+ *
+ * @return 成员账号 id 列表(顺序不保证;合法但没有成员时返回空集)
+ */
+ public List memberUserIds(Long companyId) {
+ if (companyId == null || companyId <= 0) {
+ throw new BusinessException("公司 id 不能为空");
+ }
+ List rows = adminUserMapper.selectList(
+ new LambdaQueryWrapper()
+ .select(AdminUserEntity::getId)
+ .eq(AdminUserEntity::getCompanyId, companyId));
+ List ids = new ArrayList<>(rows.size());
+ for (AdminUserEntity row : rows) {
+ if (row.getId() != null && row.getId() > 0) {
+ ids.add(row.getId());
+ }
+ }
+ if (shouldWarn(ids.size())) {
+ log.warn("COMPANY_MEMBER_SET_LARGE companyId={} size={} threshold={}"
+ + " —— user_id IN (...) 列表已过长,改成 SELECT id FROM users WHERE company_id = ? 子查询",
+ companyId, ids.size(), MEMBER_WARN_THRESHOLD);
+ }
+ return ids;
+ }
+
+ /** 哨兵的判定口径,抽出来给测试当接缝用;日志事件本身另有断言,这里不算护栏。 */
+ static boolean shouldWarn(int size) {
+ return size > MEMBER_WARN_THRESHOLD;
+ }
}
diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyScopeSupportTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyScopeSupportTest.java
index 8a7a1ca08..8b10c7006 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyScopeSupportTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyScopeSupportTest.java
@@ -1,16 +1,36 @@
package com.nanri.aiimage.common.service;
+import ch.qos.logback.classic.Level;
+import ch.qos.logback.classic.Logger;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.read.ListAppender;
+import com.baomidou.mybatisplus.core.MybatisConfiguration;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.common.mapper.AdminUserMapper;
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
+import org.apache.ibatis.builder.MapperBuilderAssistant;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.ArgumentCaptor;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
+import org.slf4j.LoggerFactory;
+
+import java.util.ArrayList;
+import java.util.List;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
/**
@@ -18,13 +38,72 @@ import static org.mockito.Mockito.when;
*
* 这里最重要的不是"能取到公司",而是取不到时必须炸:漏传 company_id 一旦退回 null,
* 下游就落进 V145 的列 DEFAULT=1,第二家公司开通后每个漏传都会静默归到厦门米椿花(§6.3 / §11.2)。
+ *
+ * 三期(公司 tab)在同一出口加 {@code memberUserIds}:tab 的读范围=这家公司的成员 id 集合,
+ * 它是后续 {@code user_id IN (...)} 的长度来源,所以"只投影 id"与"过阈值出声"两条都得钉住。
*/
@ExtendWith(MockitoExtension.class)
class CompanyScopeSupportTest {
+ /** G6 倒计时哨兵在日志里的唯一可 grep 标记(巡检按它抓,别让文案改动悄悄摘掉护栏)。 */
+ private static final String MEMBER_WARN_MARKER = "COMPANY_MEMBER_SET_LARGE";
+
+ /**
+ * MyBatis-Plus 的 lambda 列解析需要实体的 TableInfo。本类用 mock mapper、不启动 Spring,
+ * 而 memberUserIds 的 wrapper 走 select(AdminUserEntity::getId).eq(AdminUserEntity::getCompanyId, ?),
+ * 没有 TableInfo 会在构造 wrapper 时抛「can not find lambda cache」。
+ * 同款初始化见 PermissionMenuServiceTest.initMybatisPlusTableInfo 与
+ * AppearancePatentTaskServiceHistoryBatchTest.setUp。
+ */
+ @BeforeAll
+ static void initMybatisPlusTableInfo() {
+ TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""),
+ AdminUserEntity.class);
+ }
+
@Mock AdminUserMapper adminUserMapper;
@InjectMocks CompanyScopeSupport companyScope;
+ /** 类日志的真实出口:哨兵的护栏要做进日志,所以断言必须挂在 logback 事件上,而不是包内布尔。 */
+ private ListAppender logEvents;
+
+ @BeforeEach
+ void attachLogAppender() {
+ Logger logger = (Logger) LoggerFactory.getLogger(CompanyScopeSupport.class);
+ logEvents = new ListAppender<>();
+ logEvents.setContext(logger.getLoggerContext());
+ logEvents.start();
+ logger.addAppender(logEvents);
+ }
+
+ @AfterEach
+ void detachLogAppender() {
+ ((Logger) LoggerFactory.getLogger(CompanyScopeSupport.class)).detachAppender(logEvents);
+ logEvents.stop();
+ }
+
+ /** 只取 WARN 级、已插值的消息;level 单独断言,避免 info/error 混进来也能过。 */
+ private List warnMessages() {
+ List messages = new ArrayList<>();
+ for (ILoggingEvent event : logEvents.list) {
+ if (event.getLevel() == Level.WARN) {
+ messages.add(event.getFormattedMessage());
+ }
+ }
+ return messages;
+ }
+
+ /** 造 count 行"只有 id"的查询结果,模拟 mapper 按投影返回。 */
+ private static List rowsWithIds(int count) {
+ List rows = new ArrayList<>(count);
+ for (long i = 1; i <= count; i++) {
+ AdminUserEntity row = new AdminUserEntity();
+ row.setId(i);
+ rows.add(row);
+ }
+ return rows;
+ }
+
@Test
void resolvesCompanyIdFromUserIdThroughUsersTable() {
AdminUserEntity user = new AdminUserEntity();
@@ -73,4 +152,101 @@ class CompanyScopeSupportTest {
assertThatThrownBy(() -> companyScope.assertSameCompany(1L, null, "无权操作其他公司的数据"))
.isInstanceOf(BusinessException.class).hasMessageContaining("其他公司");
}
+
+ @Test
+ @DisplayName("按公司枚举成员:只投影 id,别把整行拉进内存")
+ void memberUserIdsSelectsOnlyIdColumn() {
+ AdminUserEntity a = new AdminUserEntity(); a.setId(11L);
+ AdminUserEntity b = new AdminUserEntity(); b.setId(12L);
+ when(adminUserMapper.selectList(any())).thenReturn(List.of(a, b));
+
+ assertThat(companyScope.memberUserIds(2L)).containsExactlyInAnyOrder(11L, 12L);
+
+ ArgumentCaptor> captor = ArgumentCaptor.forClass(LambdaQueryWrapper.class);
+ verify(adminUserMapper).selectList(captor.capture());
+ LambdaQueryWrapper q = captor.getValue();
+ // 钉成等值而不是 contains:containsIgnoringCase("id") 会被 "password_hash,username,id" 这种整行投影白过。
+ // 整行投影(含 password_hash)是 2026-09「不再整表拉回含密码哈希的全列」那轮优化摘掉的东西。
+ assertThat(q.getSqlSelect()).as("必须只 select id:2026-10-04 只读取证全库 142 行 / 最大公司 140 成员,不代表以后也是")
+ .isEqualTo("id");
+ // 先碰一次 getSqlSegment(),MP 3.5.7 才把条件参数铺进 paramNameValuePairs
+ // (同款见 CompanyServiceNameLookupTest.batchLookupSendsEachCompanyIdOnce);
+ // 顺带钉住"按公司等值过滤"——少了它就是把全库账号发出去。
+ assertThat(q.getSqlSegment()).contains("company_id =");
+ assertThat(q.getParamNameValuePairs()).containsValue(2L);
+ }
+
+ @Test
+ @DisplayName("非法公司 id 直接抛,不返回空集——空集在调用方是「查不到行」,语义完全不同")
+ void memberUserIdsRejectsBadCompanyId() {
+ assertThatThrownBy(() -> companyScope.memberUserIds(null))
+ .isInstanceOf(BusinessException.class);
+ assertThatThrownBy(() -> companyScope.memberUserIds(0L))
+ .isInstanceOf(BusinessException.class);
+ verify(adminUserMapper, never()).selectList(any());
+ }
+
+ @Test
+ @DisplayName("合法但没成员的公司返回空集:与「非法 id 抛」配对,两个语义不能互相冒充")
+ void memberUserIdsReturnsEmptySetForCompanyWithoutMembers() {
+ when(adminUserMapper.selectList(any())).thenReturn(List.of());
+
+ assertThat(companyScope.memberUserIds(5L)).isEmpty();
+ }
+
+ @Test
+ @DisplayName("脏行(id 为 null / <=0)不进结果集:这条集合会原样拼进 user_id IN (...)")
+ void memberUserIdsDropsRowsWithoutUsableId() {
+ AdminUserEntity nullId = new AdminUserEntity();
+ AdminUserEntity zeroId = new AdminUserEntity(); zeroId.setId(0L);
+ AdminUserEntity negativeId = new AdminUserEntity(); negativeId.setId(-1L);
+ AdminUserEntity usable = new AdminUserEntity(); usable.setId(11L);
+ when(adminUserMapper.selectList(any())).thenReturn(List.of(nullId, zeroId, negativeId, usable));
+
+ assertThat(companyScope.memberUserIds(2L)).containsExactly(11L);
+ }
+
+ @Test
+ @DisplayName("G6 倒计时哨兵:成员数过阈值必须打 COMPANY_MEMBER_SET_LARGE(护栏在代码出口,不在注释)")
+ void warnsWhenMemberSetExceedsThreshold() {
+ // 阈值本身也得钉住:下面所有用例都按 MEMBER_WARN_THRESHOLD±1 造数据,只把常量抬到 5000 一条都不会红,
+ // 可生产最大公司只有 140 成员——抬上去等于哨兵永不响,就是「护栏等于不存在」。
+ // (变异实证:抬到 5000 后本类 11 条全绿,见 task-5-report.md 的变异表。)
+ assertThat(CompanyScopeSupport.MEMBER_WARN_THRESHOLD)
+ .as("哨兵钉在 500:2026-10-04 生产只读取证全库 142 行 / 最大公司 140 成员,约 3.6 倍余量")
+ .isEqualTo(500);
+
+ when(adminUserMapper.selectList(any()))
+ .thenReturn(rowsWithIds(CompanyScopeSupport.MEMBER_WARN_THRESHOLD + 1));
+
+ List ids = companyScope.memberUserIds(3L);
+
+ assertThat(ids).hasSize(CompanyScopeSupport.MEMBER_WARN_THRESHOLD + 1);
+ assertThat(warnMessages()).as("越阈值必须有一条 WARN")
+ .anySatisfy(message -> assertThat(message)
+ .contains(MEMBER_WARN_MARKER)
+ .contains("companyId=3")
+ .contains("size=" + (CompanyScopeSupport.MEMBER_WARN_THRESHOLD + 1)));
+ assertThat(CompanyScopeSupport.shouldWarn(CompanyScopeSupport.MEMBER_WARN_THRESHOLD + 1)).isTrue();
+ }
+
+ @Test
+ @DisplayName("G6 反例:阈值以下(含正好 500)不出声——同一次挂载里再越阈值,自证 appender 不是死的")
+ void staysSilentAtOrBelowThreshold() {
+ when(adminUserMapper.selectList(any()))
+ .thenReturn(rowsWithIds(CompanyScopeSupport.MEMBER_WARN_THRESHOLD));
+
+ assertThat(companyScope.memberUserIds(4L)).hasSize(CompanyScopeSupport.MEMBER_WARN_THRESHOLD);
+
+ assertThat(warnMessages()).as("阈值以下不该有任何 WARN:一条都不许").isEmpty();
+ assertThat(CompanyScopeSupport.shouldWarn(CompanyScopeSupport.MEMBER_WARN_THRESHOLD)).isFalse();
+
+ // 正对照:同一个 appender 换越阈值的入参就必须抓到,否则上面那句 isEmpty() 可能是空转(appender 根本没挂上)。
+ when(adminUserMapper.selectList(any()))
+ .thenReturn(rowsWithIds(CompanyScopeSupport.MEMBER_WARN_THRESHOLD + 1));
+ companyScope.memberUserIds(4L);
+
+ assertThat(warnMessages()).as("正对照:appender 必须收得到越阈值那条").isNotEmpty();
+ assertThat(warnMessages()).allSatisfy(message -> assertThat(message).contains(MEMBER_WARN_MARKER));
+ }
}