test(phase-0): v1.1 验收契约预置(AC-7~12/16~19)与两处棘轮台账登记

后端 9 支 @Disabled 契约只引用现存签名(mvn -o test-compile rc=0),逐条
钉住审计 ✅ 缺口:清空全表删、每日档按 id 越权、出厂默认下匿名可写的
interrupted/upload、12 格共享执行器与拒绝即内联、心跳抢锁变 40902、
批查整实体与无优雅停机、PENDING 被 Math.min(4) 钉死永不终态、
视频详情 SQL 双转义、无 statement timeout、删除多写无事务、
深 OFFSET/ORDER BY RAND/心跳整行/菜单每请求重算、补检 WARN 风暴与无 MDC。

两前端 3 支用 { skip } 预置 AC-16/17/18(网络错误登出、全局兜底与脱敏
上报、单次 PUT 无分片、element-plus 回首屏、列表无竞态门)。

台账两处按官方口径重钉,非放宽:source-pin-ledger 用仓内
UPDATE_SOURCE_PIN_BASELINE=1 生成(含他人 3 支零钉子件记账);
SourceScanTest 点名台账 10→22 名/8→16 支,逐个出处写在注释里。
This commit is contained in:
2026-10-28 14:37:17 +08:00
parent 46774fffed
commit 632efa6a8e
14 changed files with 1281 additions and 11 deletions
@@ -0,0 +1,75 @@
package com.nanri.aiimage.config;
import com.nanri.aiimage.testutil.SourceScan;
import org.junit.jupiter.api.Disabled;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import java.nio.file.Files;
import java.nio.file.Path;
import static org.assertj.core.api.Assertions.assertThat;
/**
* AC-21(R8/审计 §5、PERF_REPORT §6):补检 WARN 必须按 job/轮次收敛,全站日志必须能按请求关联。
*
* <p>两条实测证据:
* <ul>
* <li><b>补检 WARN 风暴</b>:{@code AppearancePatentDeliverySupport.java:123-124} 对同一
* task/job 每轮补检打一条 {@code 交付缺口触发补检轮} WARN;
* {@code docs/audit/PERF_REPORT.md:189} 实录 task 32609/job 23345 三分钟 478 条
* (≈9,560 条/小时),任务长期停在"有 12 行未完成检测,补检一轮后重新组装"的循环里。
* 同文件 {@code :167-201} 的 {@code scheduleFallbackRecheck} 已经有轮次闸
* ({@code taskCacheService.recheckRounds/countRecheckRound}),
* AC 要的正是把同一对计数键接到 {@code requestRecheckForMissingRows} 上:
* 要么按 job/轮次限流,要么一条汇总。</li>
* <li><b>无 MDC</b>:{@code RequestTraceFilter.java:47-51} 已经解析出
* {@code X-Request-Id / X-Amzn-Trace-Id / Traceparent},但只塞进日志参数
* (:63-79),从不 {@code MDC.put}——全仓 {@code grep MDC} 零命中;
* {@code logback-spring.xml:7-8} 的两条 pattern 里也没有 {@code %X{...}},
* 于是 571 处 log 无法按请求关联(审计 §5.2 判断:"补 MDC 比加日志量更有效")。</li>
* </ul>
*
* <p>客户端/worker 的单文件大小上限与保留口径统一,另有两支预置:
* {@code app_client/tests/test_pending_phase1_日志脱敏与轮转.py}(AC-1,含大小轮转)与
* {@code scripts/tests/test_pending_phase5_worker日志轮转与保留.py}(AC-21 的 worker 侧)。
*/
@Disabled("Pending Phase 5: AC-21 补检 WARN 限流/汇总与 MDC 关联")
@DisplayName("AC-21 日志量级与请求关联契约")
class PendingPhase5LogVolumeAndMdcTest {
@Test
void 补检轮_WARN_必须按_job_或轮次收敛() {
String support = SourceScan.withoutComments(
SourceScan.sourceText("AppearancePatentDeliverySupport.java"));
String body = SourceScan.methodBody(support, "requestRecheckForMissingRows");
assertThat(body)
.as("§5/PERF §6:每轮一条 WARN 就是 9,560 条/小时;必须复用 :182/:197 那对轮次计数键")
.containsAnyOf("recheckRounds", "countRecheckRound", "throttle", "summary");
}
@Test
void 请求入口必须把_requestId_写进_MDC() {
String filter = SourceScan.withoutComments(SourceScan.sourceText("RequestTraceFilter.java"));
assertThat(filter)
.as("§5.2:requestId 已解析却不入 MDC,571 处日志无法按请求关联")
.contains("MDC.put");
assertThat(filter)
.as("退出请求必须清 MDC(线程复用会把上一请求的 id 带给下一条日志)")
.contains("MDC.clear");
}
@Test
void 日志_pattern_必须带出_MDC_位() throws Exception {
Path moduleRoot = com.nanri.aiimage.testutil.SourceScan.mainSourcesRoot()
.resolve("../../src/main/resources/logback-spring.xml")
.normalize();
String xml = Files.readString(moduleRoot);
assertThat(xml)
.as("pattern 里没有 %X{...} 时,MDC 写了也看不见(FILE/CONSOLE 两条都要带)")
.contains("%X{requestId}");
}
}