Ok Testaudit Server

测试维度矩阵

每次审计覆盖以下 7 个维度（已按本项目重映射）：

1. 单元测试 — Service / 工具 (Unit)

目标: Service 业务分支、纯逻辑、参数→Mapper 透传、异常路径（BusinessException / ResultCode） 典型覆盖: ProductServiceTest、PermissionServiceTest、AuthServiceTest 优先级: 高 关键模式:

@ExtendWith(MockitoExtension.class)
class ProductServiceTest {
    @Mock IotProductMapper productMapper;
    @InjectMocks ProductService service;

    @Test
    void listPage_passesDtoToMapperAndReturnsPageVO() {
        when(productMapper.selectPage(any(), any())).thenReturn(new Page<>(1, 15));
        var vo = service.listPage(dto);
        assertThat(vo.getPageNo()).isEqualTo(1);
        verify(productMapper).selectPage(any(), any());
    }

    @Test
    void create_duplicateCode_throwsBusinessException() {
        assertThatThrownBy(() -> service.create(req))
            .isInstanceOf(BusinessException.class);
    }
}

2. Controller / Web 层 (Controller)

目标: 入参绑定、委派 Service、Result/PageVO 包装、状态码/权限注解 典型覆盖: ProductControllerTest（Mockito 直测 controller，项目主流）；需要真过滤链时用 @WebMvcTest + MockMvc 优先级: 最高（核心业务入口） 关键模式:

@ExtendWith(MockitoExtension.class)
class ProductControllerTest {
    @Mock ProductService service;
    @InjectMocks ProductController controller;
    @Test void list_delegatesAndWraps() {
        when(service.listPage(dto)).thenReturn(page);
        Result<PageVO<ProductVO>> r = controller.list(dto);
        assertThat(r.getData().getItems()).hasSize(1);
    }
}

3. 持久层 / Mapper (Mapper) ⬅ Testcontainers

目标: 自定义 SQL、动态条件、JSONB、uuidv7、索引、分页正确性 典型覆盖: AiConversationMapperTest、AbstractConversationMapperIT（共享单例 PG） 位置/命名: 真 DB → *IT 或基于 Abstract*MapperIT 优先级: 高 关键点: 单例容器；127.0.0.1 jdbcUrl；stringtype=unspecified；DDL 一次性 SCHEMA_READY 守卫

4. 安全 / 多租户隔离 (Security) ⬅ 后端头等维度

目标: JWT 校验、权限点、跨租户/跨用户数据隔离、未授权 401/403 典型覆盖: JwtAuthenticationFilterTest、*PermissionTest、CrossUserIsolationIT、ConversationStoreMultiTenantIT、ScriptCrossTenantIT 优先级: 最高 审计要点: 每个带 tenant/user 维度的查询，是否有「A 租户写 → B 租户读不到」的成对断言；沙箱脚本是否验证跨租户泄漏（cross-tenant-leak fixture）

5. 集成测试 (Integration) ⬅ *IT

目标: 多组件 + 真 DB 的业务链路（会话创建/续写、短事务原子性、重启后持久化、设备/跨设备续连） 典型覆盖: Conversation*IT、ShortTransactionIT、ChatShortTxAtomicityIT、TaskContinuityIT 工具: @SpringBootTest + Testcontainers 优先级: 中高

6. LLM / AI 引擎 (LLM) ⬅ WireMock

目标: ReAct 循环、工具调用（单/串/并行）、流式输出、token 统计、计时、MDC 追踪、超时隔离 典型覆盖: ReActEngine*Test、*ToolTest、ai/integration/llmtool/*WireIT（WireMock stub OpenAI）、TimeoutIsolationIT 工具: WireMock（复用 OpenAiRequestMatchers / Fake*Tool / AbstractWireMockScenarioIT）；流式断言配 reactor-test 优先级: 高（项目核心能力）

7. 沙箱 / 脚本执行 (Sandbox)

目标: Docker 沙箱跑用户脚本的安全边界：panic / OOM / 死循环 / 超时 / 跨租户泄漏 典型覆盖: DockerCliTest、MultiTenantIsolationIT、ScriptCrossTenantIT，fixture 在 test/resources/scripts-fixture/* 优先级: 高（安全相关）

审计流程

Phase 1: 扫描现状

1. 列出源文件: src/main/java/**/*.java（按 controller/service/mapper/ai/auth/iot 分包）
2. 列出测试: src/test/java/**/*Test.java（快）与 **/*IT.java（重），分别统计
3. 按 7 维度归类现有测试
4. 生成覆盖矩阵

Phase 2: 识别缺口

对每个源类标记: ✅ 已覆盖 / ⚠️ 部分（缺异常分支或隔离用例）/ ❌ 未覆盖
重点扫: 新 Service 有无单测; 新 Mapper 有无 Testcontainers IT;
        带 tenant/user 的路径有无跨租户隔离断言; 新 Tool 有无 WireMock 用例

Phase 3: 优先级排序

1. 安全 / 多租户隔离（底线）
2. Controller / Service（业务核心）
3. LLM / AI 引擎 + 沙箱（核心能力 + 安全）
4. Mapper（数据正确性，需 Docker）
5. 集成 IT（链路）
6. 纯工具单测

Phase 4: 并行生成

- 不同类/不同维度无依赖，可用 Agent 并行生成
- 快单测(*Test)与需 Docker 的 IT 分开排（IT 受容器并发限制）
- 复用既有基类: Abstract*MapperIT / AbstractWireMockScenarioIT / Fake*Tool
- 生成后 ./mvnw test 验证

Phase 5: 验证 & 修复

- ./mvnw test（无 Docker 时 *IT 会失败 —— 报告须区分「逻辑缺口」与「需 Docker 环境」）
- 常见失败: 容器未就绪 / IPv6 jdbcUrl / Mockito unnecessary-stubbing(lenient) / 跨租户上下文未清理(@AfterEach TenantContext.clear)
- 全绿后提交

常见陷阱与解法

输出格式

## 测试审计报告 (os-server · Spring Boot)

| 维度 | Test | IT | 覆盖源 | 状态 |
|------|------|----|--------|------|
| Service 单测       | N | - | ProductService… | ✅ |
| Controller         | N | - | ProductController| ⚠️ 缺 XxxController |
| Mapper (容器)      | - | N | Conversation*    | ✅ |
| 安全/多租户隔离    | N | N | CrossUser*       | ⚠️ 缺 XxxMapper 隔离 |
| 集成 IT            | - | N | Conversation*IT  | ✅ |
| LLM/AI 引擎        | N | N | ReActEngine*     | ✅ |
| 沙箱/脚本          | N | N | Script*          | ⚠️ |

总计: N 个 *Test, N 个 *IT, N 个 @Test 方法
缺口（标注是否需 Docker）与建议补齐顺序: 1) … 2) …