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)); + } }