feat(公司范围): memberUserIds 按公司枚举成员,只投影 id + 500 成员倒计时哨兵

Step 0 分母(2026-10-04 生产只读取证,controller 实跑;本任务零 SSH、零写库):
全库 users = 142 行 / 最大一家公司 = 140 成员 / company_id IS NULL = 0 行 / 公司数 = 2。
三个数各兑现一件事:140 对阈值 500 是约 3.6 倍余量(哨兵要在 500 元素 user_id IN(...)
劣化之前红在日志里,按 brief 那句"余量小于 5 倍=阈值太高"反过来定到 700+ 等于护栏永不响,
故维持 500 并在 javadoc 写死理由);游离账号 0 行是"按公司等值查不把人从每个 tab 丢掉"的前提;
公司数 2 与 spec §1 对账一致。brief 正文那句"今天全库 140 行"是过期读数,已按实跑改写。

出口 List<Long> memberUserIds(Long companyId):只 select id(users 带 password_hash,
整行投影是 2026-09 那轮优化摘掉的东西);非法 companyId 抛 BusinessException 而非返回空集
(调用方把空集读成"这家公司查不到行",两种语义不能互冒充);越阈值打 WARN
marker COMPANY_MEMBER_SET_LARGE。本轮只做后端能力,无 controller/前端/UI 暴露。

测试:CompanyScopeSupportTest 追加 6 支,本类 11/11 绿。G6 按本仓 idiom 用 logback
ListAppender 断真实 WARN 事件(不是只断包内布尔),反例里带正对照防空转。
变异自证 5 项,其中"阈值抬到 5000"第一跑 11 支全绿=变异存活(用例都按常量±1 造数据),
补一条字面断言 isEqualTo(500) 后才变红——这条正是"哨兵等于不存在"的合入路径。
This commit is contained in:
2026-10-05 00:58:05 +08:00
parent ccf93cb1c5
commit 27c83d5e64
2 changed files with 231 additions and 0 deletions
@@ -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;
*
* <p>这里最重要的不是"能取到公司",而是<b>取不到时必须炸</b>:漏传 company_id 一旦退回 null,
* 下游就落进 V145 的列 DEFAULT=1,第二家公司开通后每个漏传都会静默归到厦门米椿花(§6.3 / §11.2)。</p>
*
* <p>三期(公司 tab)在同一出口加 {@code memberUserIds}:tab 的读范围=这家公司的成员 id 集合,
* 它是后续 {@code user_id IN (...)} 的长度来源,所以"只投影 id"与"过阈值出声"两条都得钉住。</p>
*/
@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<ILoggingEvent> 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<String> warnMessages() {
List<String> 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<AdminUserEntity> rowsWithIds(int count) {
List<AdminUserEntity> 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<LambdaQueryWrapper<AdminUserEntity>> captor = ArgumentCaptor.forClass(LambdaQueryWrapper.class);
verify(adminUserMapper).selectList(captor.capture());
LambdaQueryWrapper<AdminUserEntity> 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<Long> 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));
}
}