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,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;
* <p>取不到公司一律抛,不返回 null:调用方一旦把 null 传进实体,MyBatis-Plus 会跳过该列,
* 落库时被 V145 的 {@code DEFAULT 1} 静默兜住——那是"归属失真且不报错"的成因(§6.3)。</p>
*/
@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)。
*
* <p>只投影 id:{@code users} 带 {@code password_hash},整行拉进内存是 2026-09
* 「不再整表拉回含密码哈希的全列」那轮优化摘掉的东西,别在这里装回去(测试钉的是
* {@code getSqlSelect()} 恰好等于 {@code id},加列就会红)。</p>
*
* <p>不加 LIMIT:2026-10-04 生产只读取证<b>全库 142 行 / 最大公司 140 成员</b>
* ({@code company_id IS NULL} 0 行、公司数 2),今天装得下不代表以后装得下,而截断会让某个公司的
* tab 看起来"数据不全"且毫无提示。所以用 {@link #MEMBER_WARN_THRESHOLD}(500,对 140 是约 3.6 倍余量)
* 当倒计时哨兵——它要在查询劣化<b>之前</b>红在日志里、可被巡检按 marker
* {@code COMPANY_MEMBER_SET_LARGE} 抓到;阈值若按"至少留 5 倍余量"定到 700+,
* 等于哨兵响的时候列表早已痛了,那就不是护栏。</p>
*
* <p>非法 companyId 抛 {@link BusinessException} 而不是返回空集:调用方把空集读成"这家公司查不到行",
* 与"参数没给对"是两种语义(spec §9 的静默丢数形态)。</p>
*
* @return 成员账号 id 列表(顺序不保证;合法但没有成员时返回空集)
*/
public List<Long> memberUserIds(Long companyId) {
if (companyId == null || companyId <= 0) {
throw new BusinessException("公司 id 不能为空");
}
List<AdminUserEntity> rows = adminUserMapper.selectList(
new LambdaQueryWrapper<AdminUserEntity>()
.select(AdminUserEntity::getId)
.eq(AdminUserEntity::getCompanyId, companyId));
List<Long> 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;
}
}
@@ -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));
}
}