Commit Graph

821 Commits

Author SHA1 Message Date
huangzd1997 2542669346 refactor(phase-3): 3B 的 +20 按「真拆薄」清账——支内去重 40 行,基线一格未改
用户拍板「不改基线、不代登记,在本支内再找可沉件」。棘轮读数 3216→3176,
回到在册 3196 以下 20 行,docs/readability-baseline.json 一字未动。

五处支内去重(逐条等价,非"顺手统一"):
- persistTaskJson 的落库尾部(setResultJson + syncSnapshotTables)改调
  persistSnapshotJson,两段落库收尾并成一枚本地件。异常包装面不变:外层 catch
  仍在,updateById 仍在 try 内(把下游异常放出去就是改线协议,Phase 2 记过这句)。
- registerUploadedObjectRollback 接进 registerRollbackObjectCleanup:两者只有
  「无事务时它删、这里不删」一格之差,用 isSynchronizationActive() 守卫包住即等价。
- loadDailyMemberData 的内联成员排序换成已有的 sortedDailyMembers(逐字同形)。
- applyPartialSuccessToSnapshot 并为 applySuccessToSnapshot 的重载,两个调用点
  显式传 PARTIAL_RESULT_MESSAGE(与紧邻的 markResultPartialSuccess 同源常量)。
- 删 loadTaskMap(List<FileResultEntity>):私有、五棵树零调用、自 e453e822c
  (2026-07-28「菜单修改优化」)引入起就是死件——不是本轮迁移造出来的。

六条 golden(本支两条+孪生两支四条)逐字节相等:git status -- src/test/resources
整轮一字未动。CatchSilence 9 例/TaskLifecycleDebt 3 例/WiringSlice 5 例全绿,
定向批 330 例只剩 ShopDataCrawlTemplateLargeWorkbookTest:193 那格 5000ms 耗时断言
判红(读到 1,486,511ms),单跑 16 例复绿(31s)——与 Phase 2、首迁同一对第三记,
是本机被并发抢核,不在本笔面上。
2026-10-19 09:02:09 +08:00
huangzd1997 ad1865567e test(phase-3): 真实容器装配切片接进第三支——23 枚参数那张表也要跑过而不是推理过
用户 2026-10-19 拍板第 3 项留的那格欠账,本轮由「两支」扩到「三支」:
ShopDataCrawlTaskService 的构造器同样是 Lombok 生成枚换成显式枚,且参数表最长(23 枚)。

切片走真的 Spring 构造器解析,判据是逐枚 assertSame(不是「refresh 没抛异常」——那两句在
同批的非零对照里已被证伪:两枚带参 public 构造器容器起不来、无参+带参那枚 Spring 静默挑无参、
字段全 null 照样绿)。除底座五枚外,本支另点名 11 枚私有件:缓存服务/装配服务/resolve 服务/
两枚同族 Mapper/TransientPayloadStorage/InstanceMetadata/每日文件/item store/转发端口/
心跳位/事务管理器——同族三个 bean 最容易串位,串一枚当场红。

第三条正判顺手钉住「三支三个 moduleType」:progressLight 各自打到自己的枚举形。
另加一条继承链断言:本支的直接父类必须是底座,不是家族层(家族模板会改掉它的准入步序与收尾闸门;
用 getSuperclass 而不是 !(x instanceof 家族层)——静态类型不可能成立时 javac 直接拒绝后者)。
2026-10-19 03:02:39 +08:00
huangzd1997 695f570d59 refactor(phase-3): ShopDataCrawl 接入底座,家族层按证据不接——三支接得上、两处接不上写死
七支巨石里第三支接进 AbstractFileTaskPipeline。它接的是**底座**、不是 shop-payload 家族层:
家族模板 submitShopScopedResults 要求「按店名自建索引→逐行→changed 闸门→重算」,本支三条都不成立
(索引自建且带「回传店铺与任务不匹配」这道拒、单店合同 resultRows.size()!=1、尾部无 changed 闸门
而是无条件 persistProgressOrSnapshot+tryFinalizeTask)。照家族层套就是替它改行为。

本支复用底座的六件:newTaskHeader/newScopeRow(带显式时刻那一版——建单时刻一枚复用给头行与每一行,
默认时区逐行各取那一版会把这格改掉)、insertTask、listScopeRows(本地 listTaskRows 与孪生两支逐字同形,删)、
requireUserId(本地 validateUserId 逐字同形,删)、requireTaskId、writeJson(第四份同名件并进来,
捕获账净减:RETHROW 386→385 按该尺自述的「逐条点名改基线」处置,出处与授权逐字写进
CatchSilenceRatchetTest 注释;total 1002、不重抛/只 log/空体三格未涨)。

两处「按证据不做」写进代码而不是只留在注释里:
1)准入步序现网先归属后终态,与底座默认序相反 ⇒ 为它把 admitSubmission 拆成
   requireSubmissionTask/rejectTerminalSubmission/touchSubmissionHeartbeat 三格、按本支的序复用;
   孪生两支走的默认序一个字没动,它们的 golden 就是这条等值的证明。
2)收尾刷结果列走 LambdaUpdateWrapper 批量条件更新(只刷 success=1 的行、不写 success/errorMessage、
   objectKey 传 null)⇒ publishResultFile 仍不适用,本地写法保留。

代价要说在白处:显式构造器是继承的结构性成本,本支 23 枚参数(孪生两支 17/15),
ShopDataCrawlTaskService 3196→3215 行——这一格在 readability 棘轮上是**涨**,
与 Phase 3「只许降」那条准出标准相冲,不自行改基线判据、留给用户拍板。

对撞证据:本支两条新 golden(建单 14 例/回传 20 例)+孪生两支四条 golden 迁移前后逐字节相等,
git status -- src/test/resources 一字未动;后端全量 mvn -o test 绿。
2026-10-19 03:02:25 +08:00
huangzd1997 b11bc599cd test(phase-3): 3B 迁移前把 shopdatacrawl 的建单与回传两段钉成 golden
蓝图 §4 Phase 3 首迁实录写的开工前置第①条——「那五支的 submitResult 同样没有 golden,
各自补完才能动」。本笔只补件、不动生产码一支。

回传段 20 例、建单段 14 例,渲染的是副作用**先后**流水而不是分组清单,三格专门钉住
Phase 2/3 已登记的「不许顺手统一」:
- ownershipCheckedBeforeTerminal:本支先查归属再判终态(底座 admitSubmission 默认序相反),
  套错就 40903 → 「任务已结束」;
- terminalTaskRejectedWithoutCode:终态重复提交本支不带 40901,线协议与孪生两支不同;
- completedRowFlushesWorkbookColumns:收尾刷结果列走 LambdaUpdateWrapper 批量条件更新
  (只刷 success=1 的行、不写 success/errorMessage、objectKey 传 null),publishResultFile 不适用。

建单段另钉一格快照本来看不见的性质:建单时刻一枚复用给头行与每一行结果行,故只断
createdAtEqualsTaskCreatedAt=true 而不打印时钟——底座五参 newTaskHeader 是「逐行各取一次」那一派,
照搬就把这格改成 false。
2026-10-19 02:31:42 +08:00
huangzd1997 278eaaec2c test(phase-3): 补真实容器装配切片——两支 @Service 的构造器形状改动从推理变成跑过
蓝图 §4 第 4 步那格「真机启动验收」连续两笔如实登记未做(本仓没有全容器装配测试,
spring-boot:run 要 MySQL+Redis),Phase 3 又恰好动了 @Service 的构造器形状
(Lombok 生成枚 → 手写显式枚,还多一层 super(...) 交 5 枚)——装配相邻的风险不该只写在注释里。
本切片不连库,走的是**真的 Spring 构造器解析**(AnnotationConfigApplicationContext+@Bean 桩),
用户 2026-10-19 拍板补这一格。

三条正判:① 两支在容器里建得出来且真的 instanceof AbstractShopPayloadTaskPipeline
(Phase 3 的准出是「有生产调用方继承底座」,不是单测证明契约可用);
② 交给 super 的那 5 枚 + 两支各自的 12/13 枚私有件**逐枚 assertSame** 到对应桩 bean
——同族两个缓存服务、两个装配服务、两个 candidateMapper 是最容易串位的,
少交一枚或交 null 编译期挡不住,只有这里看得见;
③ 调一次 progressLight 后 verify assembler 分别收到 "SHOP_MATCH" 与 "PRICE_TRACK" 一次:
moduleType() 是迁移新加的钩子,回错一支会把心跳、结果行与组装 Job 全挂到别人模块上,
而建单照样成功——那种错只有这条能抓。

两条非零对照(缺了它们,上面的绿就说明不了任何事):
- 两枚 public 构造器且都带参 ⇒ 容器必须起不来(探针实测起不来 ⇒ 判据不是恒绿);
- 一枚无参+一枚带参 ⇒ Spring **静默挑无参那一枚**,refresh 成功而字段全 null。
  第二条专门钉住「只断言 refresh 不抛异常」这种会说谎的判据,所以正判走的全是 assertSame/verify。

依赖一律 Mockito 桩:本片量的是装配,不是协作者行为。5 例全绿。
2026-10-19 02:04:10 +08:00
huangzd1997 2f0b6b0de9 refactor(phase-3): PriceTrack 接入家族骨架,两支逐字重复的作用域行查询下沉 listScopeRows
孪生支之二迁完,§3.1 那句「七支到底接得上几支」现在有实测答案了:shop-payload 那一族
两支都换得上,且各自判序原样保留——本支是「先判 error → 再判 success==FALSE → 处理删跳过
ASIN 的信号 → 最后才合并」,ShopMatch 相反(先合并再判 error),这段家族层 javadoc 点名
「刻意不沉」,本笔一个字没碰。

段 3 整段(准入→取锁→建索引→逐行→changed 闸门→重算状态)改为 submitShopScopedResults;
建单段的头行与结果行改为 newTaskHeader/newScopeRow 的默认时区那一派(本支现网就是
LocalDateTime.now(),与 ShopMatch 的业务时区那一派刻意分成两枚重载,不替谁归一)。

一处「想并但没并」要说在白处:本支 createTask 那格序列化 catch 没接进 writeJson——
并进去会把 CatchSilenceRatchetTest 的 RETHROW 那一格跌破下限 386(它是下限不是上限),
调它属于「改门禁判据」动作、要逐处记名,与 Phase 0 那格三格守卫同批做,不在迁移笔里顺手干。
所以本支的捕获账一个字未动(ShopMatch 那笔才是净减一处)。

终态拒绝前那句 [price-track] submitResult rejected 留在了 loadTaskForSubmission 里:
底座刻意不打日志(七支只有一支打),而骨架没给 throw 前留落点;这一格的条件与顺序与迁移前
逐字相同(模块校验已过、马上 throw),巡检按它数过被拒的回传,删就是改现网可观测行为。

顺手收掉本面 7 处(两支合计 13 处)逐字相同的作用域行查询
eq(taskId).eq(moduleType).orderByAsc(id) → listScopeRows(taskId):这不是清理,是 §3.1
段 3 里已沉的件,Phase 3 的本职就是把内联副本换成它。可读性账因此对得上:显式构造器是
结构性成本(PriceTrack 一度 2331 行、另一路已代登记在飞那笔),去重后回落到 2302 行,
严格低于迁移前 2303;ShopMatch 2028→2008。

证据:两支建单+回传四条 golden 逐字节相等(git status -- src/test/resources 一字未动);
定向批 387 例全绿;全量 mvn -o test 4495 例/3 红/0 错/9 skipped(27:58,机器被并发拖长),
三红逐条单跑复绿(ShopDataCrawl 那两格是 5000ms 耗时断言被抢核、DuplicateCheckRefreshScheduler
那格是真实时间窗在全量并跑里抖),无一条落在本笔的面上。
2026-10-19 01:31:14 +08:00
huangzd1997 84f248fa6c fix(外观专利): 兜底归属校验接进 TaskFinalizeSupport 出口——手抄谓词棘轮回落 130
上一枚 commit 的 fallbackAssembleResultFile 手抄了 2 处
「!MODULE_TYPE.equals(x.getModuleType())」,把 TaskLifecycleDebtRatchetTest
钉死的 130 推到 131。按棘轮注释的指路接公共出口:
- TaskFinalizeSupport 新增 belongsToModule(expected, record) 静态出口
  (expected 为 null 判不归属,防御守卫静默失效);
- 兜底 2 处改走出口,净增 0,遍数回落 130;
- 出口语义 3 例钉在 TaskFinalizeSupportTest。
2026-10-19 00:15:08 +08:00
huangzd1997 49eee59a13 fix(外观专利): 失败兜底出部分结果文件+WAIT_LLM 停放作业心跳续租(31302/31354)
线上两例死法修复,目标是「任务失败了也能下载」:
- 31354:组装作业在 WAIT_LLM 停放期执行线程已退出、Worker 执行期心跳
  已取消,job 级 stuck 扫描按 updated_at 判陈旧,5 分钟阈值×5 次重试
  耗尽后误判「文件生成任务运行超时」。客户端心跳经
  AppearancePatentTaskHeartbeatSpi#onHeartbeat 按
  dbJobTouchIntervalMillis(默认 60s,远小于 5 分钟阈值)节流续租
  (touchRunningAssembleJobsIfStale,与 SimilarAsin 同口径)。
- 31302:覆盖率闸门判红重试 5 次判死后,1196 行成品零交付且不能下载。
  接通 fallbackAssembleOnFailure 兜底钩子:作业判死后用已有分片出
  部分结果文件(validateCompleteLlmCoverage 加 allowPartial 旁路),
  写上 result.resultFileUrl 后前端下载按钮即恢复;兜底幂等(已有
  结果文件短 路)、不动任务终态、与补传恢复重跑兼容。
- 棘轮尺 STRICT_TOTAL 1003→1004、NOT_RETHROW 561→562 抬格并逐处
  记名(兜底自吞 catch 属接口契约要求的 fail-open 形状)。

全量 mvn -o test 4492 支 0 失败(9 skipped 为既有跳过)。
2026-10-18 23:41:24 +08:00
huangzd1997 1be4d766bb refactor(phase-3): 首迁 ShopMatch 接入管线底座,顺手补齐三件实测缺件
蓝图 §5 Phase 2 那条「两支公共件目前零生产调用方、契约可用只由单测证明」在本笔解除:
ShopMatchTaskService 现在真的继承 AbstractShopPayloadTaskPipeline,submitResult 的
「准入→取锁→按店名建索引→逐行合并→changed 闸门→重算状态」整段改为骨架调用,
本支只留 applyShopResultRow 与 onShopRowsRecomputed 两个钩子——判序(先合并再判 error)
留在被迁支里,家族层 javadoc 点名「刻意不沉」的就是它,没动。

底座缺件三件,都是「换不上就是本类缺件」那条规则的实测产物:
① newTaskHeader/newScopeRow 各加一枚带显式时刻的重载。ShopMatch 建单用的是
   now()=LocalDateTime.now(Asia/Shanghai) 且同一枚时刻复用给每一行结果行,
   底座原来只有默认时区、逐行各取一次那一版——直接套上去就把建单时间整体挪了,
   而这条快照量不出来(时钟刻意不进快照)。PriceTrack 那一派仍用五参/六参默认版。
② writeJson:Phase 2 登记「随 Phase 3 首迁同笔落」的那件,这笔落了。
   捕获账因此是净减(整树 total 1003→1002、RETHROW 387→386 正落在下限上、decoy 0),
   没有放宽任何一格;task 模块内部那三份逐字同名件仍未归并——归并会跌破 RETHROW 下限,
   那是「调整门禁判据」动作,与 Phase 0 三格守卫同批做,不在迁移笔里顺手干。
③ onPayloadIndexed(默认空实现):底座刻意不打日志,而 PriceTrack:617 有一句
   「received payloadShopCount/payloadKeys」卡在准入之后、行循环之前、每次回传恰好一次。
   没有这一格,那句要么丢、要么得挪位置——挪位置就是改现网可观测行为。

迁移登记的三处步序微差(可见结果相同,逐条对过 golden):shops 非空检查从锁内移到锁外、
锁内那次重复的 taskId 检查改由准入序列承担、旧 :670 那枚没人用的 workRoot 死局部变量摘掉
(组装在 processResultFileJob 里各建各的,本层从未写过那个目录)。

证据:shopmatch 两条 golden(建单 5 例+回传流水 5 例)迁移后逐字节未动;
CatchSilence/TaskLifecycleDebt/TaskStatusVocabulary/ArchitectureBoundary(task→业务 0)
四把尺同批复跑全绿;ShopMatchTaskService 2027→2026 行(readability 只许降这条满足)。
2026-10-18 20:47:10 +08:00
huangzd1997 121ae9b064 test(phase-3): 首迁前把 shopmatch/pricetrack 的回传段落库钉成 golden
蓝图 §5 Phase 0 收口那句「submitResult 出结果段本轮未打快照,Phase 3 要动那一段须先补再动」
是这一笔的全部理由:首迁要替换的正是这一段(取锁→准入→按店名建索引→逐行合并→changed 闸门
→重算状态换成 AbstractShopPayloadTaskPipeline 的模板),没有迁移前的流水,「对外行为未变」就只能嘴上说。

快照渲染的是**调用顺序流水**而不是分组清单——回传段的风险恰恰在副作用先后:先标失败还是先挂文件、
mergedRemove 在不在 enqueue 之后、changed=false 时任务表一次都不许写、taskId 非法时锁一次都不该被碰。
结果行是一份内存表(重读看得见前一次写入),店铺合并载荷是一份 HashMap 接住 get/save/remove,
于是分片回传的合并语义是真的,不是把合并跳过。时钟、雪花 id、OSS 直链一律不进快照。

两支各自 15 例,差异逐条钉住(这些正是迁移时最容易被「顺手统一」掉的):ShopMatch 闸门是
「行数>0 且有 done」,所以 :689 那句「未收到可用于组装的结果数据」在 submitResult 路径上不可达
(只有 tryFinalizeTask 的判序到得了);PriceTrack 闸门只看 success==TRUE,那条可达,
且它多一段排队前的服务端改价次数(基线读不到一律从 0 起算)、终态多一件循环轮次同步、
错误分隔符是半角 "; " 而 ShopMatch 是全角「;」。

golden 生成器用 @EnabledIfEnvironmentVariable 而非 -D:pom 的 <argLine> 是显式配置,
命令行 -DargLine 覆盖不动它,系统属性传不进 forked JVM——第一次跑就是这么发现「写了却没落盘」的。
2026-10-18 19:09:48 +08:00
huangzd1997 e90e5e7f64 fix(采集数据): 心跳落库节流改按任务自身计时;空结果文件不再冒充成功
两处独立缺陷,同一场事故(task 31253:已完成 + 总进度 25% + 下载是空白):

1) lastProgressFlushMillis 是单例上的一个全局时间戳,却被用来做每支任务的心跳
   落库节流(注释里写的「任务级」是意图,不是实现)。约 20 支采集任务并跑时,
   任一任务的落库都会重置它,于是「心跳内容不变」的那支永远落在别人刚刷过的窗口
   里被丢弃,updated_at 停止前进,30 分钟陈旧巡检把还在正常回传分片的活任务判死
   ——21:52 被 stale 收尾,而客户端 20:47 还在回传第 19 个分片。计时改成读任务
   自身的 updated_at,并在每次心跳 :479 的重读上自然成立,不需要额外 catch
   (CatchSilenceRatchetTest 的口径同批核过)。

2) 结果文件组装没有任何空表守卫:明细 sheet 唯一数据源 biz_task_result_item 为
   0 行时,仍然出表(4373 字节纯表头、111ms)、上传、写 row_count=0 并把任务标成
   SUCCESS。现在写出行数与表内行数不一致、或表内 0 行而计数有行,一律抛异常让作业
   重试,宁可不给文件也不给一张空表。全部行被过滤(计数也是 0)仍是合法空结果。

3) 组装阶段重算的 finalRowCount 此前从不落库——persistStats 只改内存实体,紧随的
   唯一那条 UPDATE 不含 result_json,界面上的「保留 N 行」于是永远停在组装前的插入
   计数(31253 表里 0 行仍显示 93;对照 31300 表里 292 行计数却写 130)。补进同一条
   条件更新。
2026-10-18 17:12:28 +08:00
huangzd1997 d58546d314 refactor(phase-2): 后端任务管线公共层下沉——三段沉实测逐字件,跑批段如实登记无可沉
新增 modules/task/service/pipeline 两支公共件(AbstractFileTaskPipeline 394 行/
AbstractShopPayloadTaskPipeline 149 行)+ 29 例单测(19+10,覆盖正常/边界/异常)。
签名逐条来自 2026-10-18 对七支现网代码的定点实贴,注释里带出处行号:
- 解析建单沉 task 头行与结果行的落库形状(七支公共列,出处逐一点名);
- 回传落库沉准入序列(校验→加载→模块校验→终态拒绝→归属→心跳),
  终态拒绝按 BusinessCodes 拆成 IDEMPOTENT(40901)/ERROR(无 code) 两格——这不是文案,是线协议;
- 出结果沉「上传对象存储→写 6 列→updateById」,六支同形,ShopDataCrawl 走批量条件更新
  (updateResultFileColumns:1880-1892,还会传 null objectKey)不在其列,已从名单点名撤出;
- 跑批段服务端无可沉(机制早已收在 TaskFileJobService/TaskResultFileJobWorker,
  ClientTaskPullSpi 只 3/7 支实现),故不立转发钩子=不造空壳;
- report 段不新造 SPI,复用既有 ResultFileJobHandler;缓存/心跳复用 AbstractModuleTaskCacheService。
七支巨石内部一行未动(Phase 2 硬边界)。

两处「没替现网做决定」:
1) writeJson(序列化失败即 BusinessException、不带 cause,Publish:2122/AP:213/CollectData:362 同形)
   本轮不沉——CatchSilenceRatchetTest 自述「新增捕获块要么别加,要么同批减一处同形状」,
   而 Phase 2 不许改七支 ⇒ 减不掉就只能不加,该件随 Phase 3 首迁同笔落(本文件零捕获块)。
2) successFileCount/failedFileCount 不由底座初始化:建单时五支写 0、Publish 写真实失败数、
   DeleteBrand 首次 insert 两列留 NULL(:146-157 → :268-278 才回填),底座一-default 0 就是偷换语义。

门禁:mvn -o test 4460 例/3 红,三红逐条取证均不归本笔(catch 棘轮 1004=另一路在飞
CollectDataService 新增的一处捕获块;CollectDataBrandBatchFilterTest 与
ShopDataCrawlTemplateLargeWorkbookTest 单独复跑皆绿,前者是顺序污染、后者是 93s 耗时断言被抢核)。
本笔单独跑 88 例全绿(新件 29+ArchitectureBoundaryTest 6+八套 Phase 0 快照),
src/test/resources 下 golden 一字未动=未迁移模块行为逐字节相等;task→业务 依赖仍为 0。
2026-10-18 16:45:47 +08:00
huangzd1997 a59a3e1f61 refactor(phase-1): 删本仓两支确定性死 DTO——BrandQueryFailedDto/ShopDataCrawlAdminFileJobBriefDto
复扫(AGENTS.md §1 铁律 2 全五路):git grep -nw 类名在**全仓跟踪面**仅命中自身文件;其余命中只在
backend-java/target/ 编译产物里(.class 与两条 maven-status 清单)。两类均为裸 @Data POJO,无
@Component/@Bean/@Entity,跨四树(app_client/maixiang_run_task/ops scripts/docs)字符串零命中,
28 支 Mapper XML 与 yml/properties 里没有 resultType/parameterType 指它们。
BrandQueryFailedDto 上那句 @Schema 写着"Java 会将该列表输出到结果 xlsx 的查询失败品牌 sheet",
但实现侧无人引用=文案与实际不符,非在用契约。

mvn -o test 全量:4427 passed/0 failures/0 errors/7 skipped(5:59,BUILD SUCCESS),
与 Phase 0 基线读数逐字相同——零行为变更。
2026-10-18 13:27:29 +08:00
huangzd1997 56c8a4ff88 test(phase-0): 1A 中断上报→进度快照终态同步契约钉上——markTerminal 此前零引用
重构蓝图 Phase 0 · 1A 那句「把心跳与进度接进 task contract 套件」逐条对撞后,心跳轴其实早被
别的路钉透了(TaskModuleHeartbeatSpiCoverageTest 12 支 SPI 与 moduleType 一一对上、
TaskHeartbeatServiceTest 进度随心跳转发、StaleTaskHeartbeatPolicyTest 首次心跳前的宽限、
TaskProgressSnapshotServiceThrottleTest 节流与终态豁免、三支 contract 用例 verify touchTaskHeartbeat)
⇒ 那一半本轮不重造,登记为「已闭·复用」。

真缺口在终态那一头:`TaskProgressSnapshotService.markTerminal` 在 src/test 里**一处引用都没有**,
而它对应的是一起真机事故(2026-09-13 客户端重启后店铺数据采集一直显示 28094「处理中」并阻塞该工具
后续任务——progress/batch 读缓存/快照,DB 行已终态而快照还停在 RUNNING)。Phase 2/3 抽公共管线时
这个出口最容易被当「顺手的小方法」漏在新契约之外,故补 10 例钉死:
- markTerminal:快照不存在不许凭空造行;同 status 同 message 幂等不空写;只换 message 也要落;
  非法入参一次库都不碰;写完必须摘限写窗(附对照组:不插终态时第二笔确被 500ms 窗吞掉,
  否则「三笔都落」说不清是摘窗摘对了还是限写窗压根没生效)。
- markInterrupted:DB 仍 RUNNING ⇒ 模块缓存与快照同步 FAILED 并带真因;DB 已终态 ⇒ 按现值自愈
  刷一遍快照(历史遗留旧缓存就是在这儿卡住前端的);快照写抛异常不得让中断接口本身失败;
  非法 taskId 不落到快照。

门禁:`mvn -o test` 全量 4427 passed/0 failures/7 skipped(6:58,BUILD SUCCESS)。
2026-10-18 12:25:20 +08:00
huangzd1997 660a1b7084 test(phase-0): 1B 四支巨石现网行为快照补齐——建单/解析/载荷三段打进真服务
重构蓝图 Phase 0 · 1B:§1B 那句「铺到缺的四支」今天补齐——deletebrand/shopmatch/
pricetrack/collectdata 各一支 *SnapshotTest + golden .txt,沿用仓内已在用的约定
(modules/<域>/service/support/*SnapshotTest 读 src/test/resources/<域>/golden/*.txt 整串对撞,
带 output/reproducible/golden_committed/diff_detected 四件套)。

与旧四支的**关键差别**:快照打的是真服务入口(run/createTask/parseAndCreateTask 一路走到各支
私有内联上下文 DeleteBrandSheetContext 等),不是在测试里照抄一遍管线——照抄的那支对 Phase 3
迁移毫无保护(旧代码消灭了,测试还绿)。落库侧用 Mockito doAnswer 捕获 mapper 的 insert/update
入参、主键顺序发固定值,回传载荷侧捕获 saveParsedPayload/saveLatest;时钟、雪花 id、临时目录
绝对路径一律不进快照(后者擦成 <root>/<outside>),所以 golden 跨 JVM 逐字节可比。

钉到的真实形状(举其要):
- deletebrand:解析成功但店铺未匹配 ⇒ 整任务 FAILED+「全部文件解析或匹配失败」;表头行被
  dataStartRowIndex=1 那条分支当数据行吃进去(ASIN="ASIN");BOM/全角归一化、按归一化键去重、
  状态有值而 ASIN 空 ⇒ 丢行;非 Excel 魔数拒绝。
- shopmatch:国家代码只认 ProductRiskCountryCode 五个(**US 不在内**,报「非法国家代码: US」);
  心跳只在 RUNNING 打,SCHEDULED 一支不打;建单校验全在 insert 之前 ⇒ 拒绝时一行库都没碰。
- pricetrack:模式二选一、ASIN 文件三种路径形态与「必须落在上传临时目录内」的穿越校验、
  表头别名(商品ASIN/最低价→asin/minimumPrice)、按 sheet 名认国家、单国家时 sheet 名兜底。
- collectdata:无关键词列则一条不丢、关键词为空丢行计数、尾部空列不生成占位列(2026-09-26
  生产事故那条同源修复)、extraJson 形状、PENDING 建单。

两处当场抓到并改掉的量具缺陷(不改就等于假绿):
1. 替身里写 `String.valueOf(invocation.getArgument(0))` 会因泛型推断挑中 valueOf(char[]) 重载,
   运行时 String 强转 [C 抛 ClassCastException,把五格全打成解析失败——已改成显式 String 变量。
2. Spring 注入的 ObjectMapper 不等于 `new ObjectMapper()`:Boot 会注册 classpath 上的
   jackson-datatype-jsr310。裸 mapper 下 shopmatch 的 scheduleTimes(List<LocalDateTime>)
   序列化失败、被建单段 catch(Exception) 吞成「task 不存在」⇒ 快照会锁在生产不存在的假形状上。

门禁:`mvn -o test` 全量 4417 passed/0 failures/7 skipped(12:42,BUILD SUCCESS);
四支新用例 17 passed;ops `pytest scripts/tests` 500 passed、`pt_worker/tests` 15 passed、
`ruff check .` All checks passed;格式步本项目未纳管 ⇒ 跳过并如实登记。
2026-10-18 11:52:54 +08:00
huangzd1997 899bc73a23 test(量具): SourceScan 的取面边界钉死——八条 exclude_ 用例
代收在飞件落地(原作者那一路已不在跑,本笔内容一字未改)。`SourceScan.java` 是 94 支守门用例
共用的取面量具,它"什么算进面"此前没有直接用例:这八条把边界逐条钉住——只计 .java(大写 .JAVA
也计)、同目录 .md 不进面、以 java 结尾的目录名不误判、隐藏文件不计入、空文件计入但读为空串、
不可读文件必须抛不许静默跳过、面内元素恒 isRegularFile。

为什么值得单列一笔:重构蓝图 Phase 0 的硬闸点名"SourceScan 正在被改、94 支用例继承它的状态",
基线必须落在 commit 上而不是工作树里;同时它也是 Phase 0 里"真实落库形状锁不住"那条偏差的
补偿——量具本身越可信,service→mapper 这层快照越当得起护身符。验证依据=闸门 ts=09:49:23 后端全绿。
2026-10-18 09:52:38 +08:00
huangzd1997 b9e5aa4d30 feat(任务判死): 判死时把下游一并收口——写 biz_file_result 并 fail 未完 jobs
代收在飞件落地(原作者那一路已不在跑;本笔在我到场前就在工作树里,一字未改)。
StaleTaskRepairService 新增 markDeadDownstream,挂进三条判死路径(长期未被领取/定时到点未启动/
心跳超时),新增 FileResultMapper 与 TaskFileJobService 两枚依赖;TaskFileJobService 补
failUnfinishedJobs。同名测试各 +85/+39 行。

验证依据=四面闸门 ts=2026-10-18T09:49:23 overall=pass(后端 34 格全绿,含 mvn -o test 整量),
量的是这份未提交内容;落地提交后内容逐字不变。
2026-10-18 09:52:24 +08:00
huangzd1997 3c44f686da feat(任务判死): 心跳时钟改为从首次心跳起算——排队中的 RUNNING 任务不再被心跳超时线误杀
任务一被认领(页面 activate / 客户端兜底拉取)就记 RUNNING,而客户端要等执行器真开始跑
才发心跳(同店占用、线程池 5 格全忙、浏览器首屏)。这段排队时间里服务端一行心跳都没有、
updated_at 停在认领时刻,被 30/120 分钟心跳线杀掉的是排队而不是死任务
(现网 2026-10-17 查得近 7 天 COLLECT_DATA 9 条 62 分钟判死、SIMILAR_ASIN 2 条一行未产出)。

- 新增 TaskHeartbeatLivenessService:每条心跳无条件打点(Redis,24h TTL),
  读失败一律落 0=没有证据;新增 StaleTaskHeartbeatPolicy:收到过心跳才走心跳时钟,
  从未心跳=仍在排队,超过未启动宽限(默认 240 分钟,置 0 即回退旧行为)才判死。
- 接入 product-risk/跟价/店铺匹配/巡店删除/查 ASIN/提现六条委派判死线、采集 30 分钟线、
  generic 120 分钟线(该文件另一路会话正在改,只提交本笔 HEAD+本改动的切片)。
- 沉默棘轮按逐处记名抬 3 格(total 1002→1003、不重抛 559→561、只 log 172→173),
  两处新增 catch 均为 fail-open 且误差方向是「少杀一个任务」。

验证:backend 全量 4400 例 0 失败;CatchSilenceRatchetTest 9 例绿;
ops 判死签名尺子 6 例绿;ruff check . All checks passed。
2026-10-17 19:46:04 +08:00
huangzd1997 531278f861 feat(巡店删除): 建单删除条件补形状校验——挡"服务端收下、执行器读出零条件"的静默不删
只校形状不校取值:取值枚举化要跨三张脸且受存量装机版本分布约束,已另挂 docs/audit/BACKLOG.md B2 的四步顺序锁。
六键取文与客户端 _normalize_delete_condition_texts 逐字对齐(后端少认一键就是静默不删的成因),
按 ,,;;、\r\n 拆分去重、单条 ≤500 对齐 V41 的 condition_text 列、条数 ≤100;addCondition 一字未动。
反向对照钉在用例里:删除商品信息草稿/库存状态/草稿 这些真在用的自由措辞必须放行。

表结构零改动(条件不落库;结果走 biz_file_task.result_json 与 biz_task_result_item.payload_json)。
测试:新类 12/12(surefire tests=12 failures=0);后端整量 4381 passed/0 failed/7 skipped rc=0
——注意整量是在含另路未提交件的工作树上跑的,本笔只含 patroldelete 两支且不依赖那些件。
2026-10-17 18:09:30 +08:00
huangzd1997 8a20f85ca6 feat(跟价多状态): 全量跟价支持勾选多个商品状态,取值以派发落库值为准
原来「按商品状态(全量)」写死在售。现在用户端可勾选 在售/缺少的报价/定价问题
(默认只勾在售),勾几个跑几个,状态清单随循环任务落库并在每次派发子任务时下发。

- 载荷的 mode 与状态清单都取派发上下文(childTaskRequest),不再读界面当前勾选:
  循环跑到第 N 轮时用户可能已经改过勾选,用界面值会把没勾的状态跑出去。
- listingStatuses 白名单 Active/PricingIssue/MissingOffer 三值,校验放在 try 之外——
  try 里的 catch 会把「不支持的商品状态」改写成「循环任务序列化失败」,那是句假话。
- V159 给 biz_price_track_loop_run 加 listing_statuses_json(可空=本特性之前的行=在售)。
- 状态标识用我们自己的键 MissingOffer,页面真实取值是 OfferMissing(2026-10-17 黄建新
  英国站真机实锤),两者不同形是有意的:改键名会断载荷兼容。
2026-10-17 00:07:31 +08:00
huangzd1997 ffeb777c38 task-7: 递归语义 8 例落地(RED 实录:隐藏目录/链接重复计入/遍历失败三格真红);实测证伪 plan 假设——Files.walk 会钻进 Windows junction 读出 [One.java,One.java],且公开 NIO 无 isReparsePoint,改按 toRealPath 折叠 2026-10-16 16:44:20 +08:00
huangzd1997 77b4f49f55 task-6: moduleSources 目录聚合入口落地 8 例(RED 实录 8 格全红);实测发现 plan 原文「相对 src/main/java 解析」与本仓布局不符——模块目录实相对包基址 com/nanri/aiimage,只按字面解析读回 0 支,正是要防的死法 2026-10-16 16:22:43 +08:00
huangzd1997 d4107ca904 task-5: 同名面普查落地 8 例(RED 实录 8 格全红);实测 3 组同名与点名 10 裸名交集为 0、主源码 973 支/970 唯一名,N20 收紧的前提得证 2026-10-16 16:04:57 +08:00
huangzd1997 5c3668fc2e task-4: SourceScan 点名普查落地 8 例(RED 实录 1 Failure+7 Errors);台账 15 调用点/8 调用方/10 裸名,plan 原文「9 支文件」经核为把 SourceScan.java:22 声明行算进分母 2026-10-16 15:46:30 +08:00
huangzd1997 785dbb7c2d 瘦身 P2-5: 删掉 db/ 里那支从不被 Flyway 执行也从不落库的种子脚本
insert_digital_human_initial_version.sql(faf89e85 2026-06-14 带进来)命名不匹配 V<n>__*,
Flyway 看不见它,却会随 jar 发到 BOOT-INF/classes/db/。10-15 只读取证定性:
  1) 它要插的那行(version=1.0.0 / oss_object_key=ShuFuDigitalHuman.zip)在生产是 0 行,
     biz_digital_human_version 现有 id=2/1.0.1 与 id=6/1.0.2 两行 —— 补种早已无意义;
  2) 它第二句 INSERT 点名的 biz_permission_menu 表在生产 schema 里不存在(1146),
     文件自己的注释就写着"需要根据实际表结构调整",即从没跑通过;
  3) flyway_schema_history 最大已应用版本 158、成功 68 支、159/160 空闲 —— 也没有"待认领的号"。
所以按"删"而不是"补编号"结案:补 V159 会让下一次启动真去插一行重复的 1.0.0。
文件在重写后的历史里仍可按 HEAD~ 取回(不是唯一副本)。
2026-10-15 15:14:42 +08:00
huangzd1997 5ad703fb2e 瘦身 P1-5: 出包摘掉文档 UI 的两件 webjars(swagger-ui 3.83 MB + knife4j-openapi3-ui 3.48 MB)
application-server.yml 三处 enabled:false 只关接口、关不掉字节:实测改动前的现网归档 jar
(D:/archive/jar_inject-2026-10-05/prod.jar,137,397,870 B)里 BOOT-INF/lib 218 支、未压缩 136.1 MB,
这两件确实在包内。这里改的是 spring-boot-maven-plugin 的 repackage excludes,不动依赖声明
⇒ mvn spring-boot:run / IDE 走 Maven classpath,本地 dev 仍能开 doc.html;io.swagger.v3 的
515 处注解 import 不受影响。

实证(本机 mvn -o -DskipTests package,BUILD SUCCESS):
  lib 218 → 215 支;swagger-ui 命中 0、knife4j-openapi3-ui 命中 0(starter/core 各 0.04/0.06 MB 留下);
  mapstruct 命中 0(10-09 那笔 pom 摘除至此才在产物里看得见);
  jar 137,507,168 → 129,057,351 B,−8,449,817 B = −6.14%,落在 ±5% 闸门外面(这正是预期的交互,
  SIZE_BASELINE 由发版那一笔改,理由写在运维仓 _deploy_jar_and_restart_both.py 的注释里)。
2026-10-15 14:03:36 +08:00
huangzd1997 975e053d2c 在持锁补读数:heldMs 此前只在放手那一刻打,锁还压着多久读不到
第 3/4 步(拆锁、缩合批)要立论,必须知道"此刻这把锁已经压了多久",而 [task-lock-held] 只在
LockHandle.close() 打——正在持有的那一段是盲区(货源 40902×24h RUNNING 就是这么看不见的)。

- ActiveTaskLockRegistry:登记表跟着取锁/放锁动;单独标 renewalLost——续期连续失败的锁最迟在
  TTL 后就该被另一实例拿走,本节点却还在按"仍持锁"跑,挂着多久不等于还被保护。
- 看门狗 task-lock-watch 每 60 秒扫一轮,留痕走阶梯(首个 60 秒、之后每 5 分钟),
  一次 30 分钟持锁总共 6 行而不是 30 行——与 10-06 通知放大同一口径。
- 15 例(9 节奏 + 6 接线),变异自证 M1 丢 unregister/M2 阶梯归零/M3 丢 register 三轮全 KILLED;
  后端全量 4320/0 红/跳过 7。
2026-10-14 01:06:38 +08:00
huangzd1997 731aa35a47 18960 探活改打 /healthz:恒 404 的那一格只能读成"未验证",服务真死了也不响
`service_down` 探活在 java 进程内跑,根路径没有路由 ⇒ 现网每轮一条
`WARN 服务探测未验证业务可用性 detail=HTTP 404`,跟价 API 挂了通知面上是 0 行
(10-07 那次 41 分钟整站宕机在通知表上就是 0 行的同族形状)。

不能选 `/batch/status`:它 `beat("vc")` 会让服务用自己的健康检查刷新采集机心跳,
正是 10-04 变体采集停摆 12 小时没被发现的那条路。`/healthz` 是 18960 专为探针加的,
不写心跳、不碰 Redis/MySQL——两台实测 `/`→404、`/healthz`→200 {"ok":true}。

两条新用例分别钉"拼出来的地址"与"`probeServices()` 真请求的路径":只钉前者的话
调用点改回去照样绿(第一版就是这么漏的,变异注入才暴露)。全类 10→12 例。
2026-10-13 18:11:55 +08:00
huangzd1997 4d4c544b51 fix(分页台账): 通知 /groups 两个新端点按出站点登记——台账 48→52、页码口径 21→23
这红是我自己引入的,不是别人的尺子坏了:本批给 AdminNotificationController 与
NotificationController 各加了一个 /groups 端点、都带 page/pageSize 默认值,
PageDefaultsLedgerTest 的"新加分页参数没登记也会红"当场判红。差值可核对:
实扫 53 处数字型 defaultValue = 23 页码 + 30 条数 + 1 处非分页(timeout_minutes),
比台账多的正是我这 4 处;page=FIRST_PAGE 从 21 长到 23 同因。
修法走测试作者留的那条正路("加页要登记,改值要表态"):逐条登记 4 处 + 同步两个
死值(hasSize 52、页码计数 23)+ PageDefaults 注释里的 49/21/28 一起改,不留会说谎
的描述。没摘 defaultValue、没动任何默认数值 ⇒ 翻页行为零变化。

验证=PageDefaultsLedgerTest 6/6 绿(在 detached 出包树实跑);反向变异 KILLED——摘掉
刚登记的那条 page 后该类 1 failed,还原后 md5 与变异前一致,主树未被写变异。
欠一条更正:上一轮汇报的"后端全绿"实为只跑了通知面 66 用例;后端全量是这次出包才跑的,
这两条红当时就该暴露。
2026-10-13 10:59:35 +08:00
huangzd1997 5d2a1c6974 feat(通知): 列表按 场景×自然日×主体用户 聚合成两级,红点按组数亮而明细条数同屏;后管日期面板不再被弹窗压住
V158 给 biz_user_notification 加 subject_user_id(事件主体用户,与收件人 user_id 分家):
一行通知是给某个收件人看的,被通知的那个 uid 原先只活在文案字符串里,没有列就没法按用户成组,
也不肯用正则去解历史文案凑分组键。存量不回填(定案)⇒ 老行 subject_user_id 为 NULL,自成「未标注主体」一组。
写入侧 pushOrRefresh 第 8 参带主体,AUDIENCE_USER 时主体=收件人(故新增 7 参便捷档,68 处调用一行没改);
pushToAdminsAnyOf 传 null 并注明理由:一把密钥被 N 个账号共用,不挑一个 uid 冒充。

新增 GET /api/notifications/groups 与 /api/admin/notifications/groups:Java 侧分组(复用 baseWrapper 一份筛选实现),
分页按组切,同屏返回 total=组数 与 rowCount=明细条数;unreadGroupCount 走
COUNT(DISTINCT scene, DATE(created_at), IFNULL(subject_user_id,-1)) —— IFNULL 不能省,
MySQL 的 COUNT(DISTINCT a,b,c) 会跳过任一表达式为 NULL 的行,不兜就把存量那一组整个数没。
红点是新增 unreadGroupCount 而不动 unreadCount 语义:已装机老客户端读 unreadCount 画徽标,
换语义会让老客户端出现「红点 3、列表 217 条」对不上。

铃铛两级(后管+桌面各一份):聚合行点击只展开、不替用户标已读,已读必须进明细逐条点;
明细一次最多 50 条,超出显示「另有 N 条未列出」;下钻带 scene+day+subjectUserId(主体为空改下发
subjectUnlabelled 旗标走 IS NULL),少一维就会把同场景同天别主体的行混进这一组的明细——桌面端最初就漏了这一维。
死码随两级视图退场:groupNotificationsByDay/NotificationDayGroup 删掉,用例换成 formatDayLabel/notificationGroupKey/formatGroupCounts。

后管日期选择面板 z-index 抬到 3300(面板 3200)之上:Element 弹层只自 2000 起递增,不抬就被面板压住,表现为「日期点不动」。
playwright 加 E2E_PORT+strictPort:实测 5174/5176 被别的项目的 vite 占着,reuseExistingServer 让 e2e 连上别人的应用,
当时 5 条全红是端口归属问题而不是回归。

验证=后端通知面 66/66(-Dtest='Notification*' 63 + AdminNotificationControllerTest 3)BUILD SUCCESS;
后管 node --test 1819/1819、真浏览器 e2e 10/10(含遮挡与「展开只取本组」);
桌面 node --test 834/834、组件挂载 vitest 8/8;两前端 vue-tsc --noEmit rc=0;ops 值班侧 18/18。
记账三处=后管 source-pin 逐文件基线 notification-bell.test.ts 用例 6→7(该文件钉子仍 0,占比不动);
桌面 catch 棘轮 blocks 298→299(新增那支是 toggleGroup 明细失败写进面板 loadError,非静默,silent 84 一格没涨);
桌面 endpoints 台账补 /api/notifications/groups。
变异自证 7 条全 KILLED:红点按条数/组内没读完就减组数/聚合行直接标已读/明细截断不报数/下钻丢主体/
丢 IS NULL 旗标/null 主体当值下发。其中「组内没读完就减组数」第一轮 SURVIVED——用例只钉了徽标,
而徽标在 unreadGroupCount 归零时会退回条数兜底,把这条回归盖住了;改成同时钉「N 组未读」chip 才杀掉。

已知盲区(下次补,别当已验):①桌面两级只在 happy-dom 跑过真组件,布局与层级没在真浏览器点过
(桌面日期弹层的层级修复本就在 HEAD 里,不是这批引入);②后管 e2e 夹具没有 subjectUserId=null 的行,
「存量自成一组」在后管 UI 层没被点过,只有后端 WHERE 与桌面组件各一条用例钉着。
2026-10-13 08:34:18 +08:00
huangzd1997 1e3bcc9688 回传洪水收口(货源+外观): 「任务不是运行中」4 处出口归一进 TaskResultAdmission——真终态(SUCCESS/FAILED)带 40901,异常处理器按幂等成功回 success=true,客户端据此删本地副本停止补发;PENDING 不带码保持可重试(建单就写它,判死=丢还能送到的结果)
判据=两条链 setStatus 实测只有 PENDING/RUNNING/SUCCESS/FAILED,故取 FINISHED_ORDERED 不取 TERMINAL(取消态无证据);摘两支重复 helper 与因此空转的 1 处 BusinessCodes import;TaskDistributedLockService 补 [task-lock-held] 持锁时长留痕(>=5s info/>=60s warn),此前只有 WAIT_LLM 量得出时长
验证=后端全量 4291 passed 0 failed(skipped 7, 6.0min);正反各两支新用例钉死;变异 M1 摘码/M2 全状态带码各杀 2 红、还原字节一致;M3 换成 TERMINAL 无人判红=已知盲区(写进类注释);可读性棘轮 9 格绿(PipelineSupport 缩回 1975 行/基线 1978)
2026-10-12 01:22:43 +08:00
huangzd1997 b0829db81e 降本三条(10-11 现网取证):外观同请求图片去重 + 货源合规合批 + LLM token 计量落库
取证基线(库侧 biz_user_secret_usage_daily,10-01~10-11 实测 12,704 / 4,134 / 15,135 次):
外观 24h 全量 831 条请求逐条 json 解析,564 条带图共投 2,693 张、去重只剩 1,465 张
⇒ 45.6% 是同一张图在同一次请求里的副本;重试占比只有 0.24%(attempt 829/2/0),
所以省钱的口子在图片副本,不在重试。货源 4,134 次里 4,096 次集中在 10-10/10-11 两天,
类目已合批(10-02)而合规与图比仍逐行 ⇒ 合规是该模块最后一步逐行 LLM 调用。

1) 外观:每张不同的图只随请求发一份,正文附「图j=序号1、2…」对照表;每个序号仍各自
   出一份 status/reason(省副本,不省判定,与 10-10「同组兄弟行也要都检测」同口径)。
   归一化 URL 只当去重的键,发出去的还是行里那条原始串。应急回退:
   llm-appearance-batch-size=1 即退回逐行,无需改码。
2) 货源:新键 llm-conform-batch-size=10(设 1 退回逐行)。前置条件是分类预计算存在,
   否则整条不生效——避免同一行的类目被算两遍(两遍=多扣用户一次);缺编号行与整块
   失败都逐行补检,并有一支 A/B 差分管住合批与逐行写回行的三字段+状态相等。
3) V157 给 biz_user_secret_usage_daily 加 prompt_tokens/completion_tokens,两个 client 收下
   网关 usage。计次与 token 分两条语句:计次发生在发请求之前(含重试,请求没回来也算
   一次),token 只在响应回来后有读数;网关没回 usage 就一条不写——0 会被读成"实测为 0"。

护栏记账:新 mapper 语句 addTokens 两处一起点名(SqlLayeringConventionTest 分母 97→98 +
MigratedSqlEquivalenceTest.NOT_MIGRATED);批量路径的 catch 不新增一处——把分类那一路的
"整块失败→逐行补检"抽成 batchAttempt/fallbackSingleRows 共用,静默 catch 棘轮四格一格没放宽。
顺带修掉 AppearancePatentResultRowDto 上一句已经过期的 javadoc(还写着兄弟行复用代表行结论)。

证据:后端全量 4288 例 0 红(本批 +24 例:去重 7 / token 4 / 合规合批 7 / 用量服务 6)。
变异自证 3/3 全杀:取消去重、摘掉 usage 落库、断掉合规合批,分别让对应用例判红;
两个受试文件按注入前字节还原,sha 复算一致。
2026-10-11 23:52:19 +08:00
huangzd1997 c4d2349cda 清无用 import(卖源码): 后端 248 处跨 128 支文件全部摘掉,javac+全量实跑双重判定
判据是逐支把 import 行的简单名拿去文件其余部分(含注释与 javadoc)做词边界匹配,
名字只在注释里出现的当作「在用」保留,所以这把尺子是往保守侧偏的。
验收不靠静态回声:`mvn -o -q test-compile` rc=0,再 `mvn -o clean package`
= Tests run 4264, Failures 0, Errors 0, Skipped 7,与清之前逐项一致(4,313→4,264 那 49 例是上午清设计文档摘掉的读 docs 用例,不是这一笔)。
diff 形状只认 `+0 / -248`,行尾没被整片改写。
2026-10-11 17:04:28 +08:00
huangzd1997 6350cc3a09 补口(卖源码清设计痕迹): TxDurationBenchmarkTest 两支读 docs 的基准方法切断,6 支真测时用例保留
上一笔 560148e5 的信息写「5 支纯文档用例」,实为 4 支——第 5 支在 modules/task/contract/ 下,
我那条 `rm -f 路径 && echo 已删` 对不存在的文件也照样回显「已删」,静态清单没回读就报了数。
全量 `mvn -o clean package`(4,266 例)才把它揪出来:2 红都在这支。
BENCHMARK_DOC 常量随方法一起摘,否则留一个指向不存在文件的死指针。
2026-10-11 16:29:01 +08:00
huangzd1997 560148e575 清设计痕迹(卖源码): 删 84 项跟踪文档/spec/plan/prompt+5 支纯文档用例+4 支没人接进闸门的审计工具,9 支混合用例只摘读 docs 的那几段
V143–V152 的迁移契约用例逐支过:87 例 0 红(mvn -o test 实跑)。混合类里钉"迁移文件本体"的断言全部保留,
只删/只切按路径读 docs 的方法;两支 scannedSignaturesAreActuallyPresent 是防恒绿的自检,
它自检的对象(回滚补丁)已随文档出仓,那几行留在类里就变成给空断言背书,所以一并摘掉。
删除面 241 个唯一副本的归档在 D:\archive\design-scrub-2026-10-11\,逐个 sha256 回读。
2026-10-11 16:01:53 +08:00
huangzd1997 8710acf522 依赖(安全批): 覆盖 Boot 托管的 tomcat 10.1.60/netty 4.1.139/spring-security 6.3.10/jackson-bom 2.18.11 + bcprov 1.86/poi 5.4.1/minio 8.6.0
OSV 逐支扫出厂 jar:46 构件 167 条公告(C12/H73/M68)。本批就地可关 10/12 CRITICAL。
明细与判据见 ops 仓 docs/依赖漏洞与升级面-2026-10-11.md(hutool/mybatis-plus/javassist 零公告,故意没动)。
2026-10-11 13:22:57 +08:00
huangzd1997 a3eddd6d84 对平(进度三字段进白名单 + 去掉那处新增吞异常): Java 全量 4313 例 0 红
上一笔 light 加 progress* 后我只跑了 6 个定向类,把两把钉白名单的尺子漏了——
它们本来就是为「加字段必须显式承认」而设的,该红:
- SimilarAsinTaskLightWhitelistTest(私有 LightVo 键集合,两处断言)
- ResultFilePhaseContractTest(light 响应 JSON 键集快照)

CatchSilenceRatchetTest 报「不重抛 559→560」也是我引入的:parseIntOrNull 用了
catch (NumberFormatException)。这处边界防护要留(Redis 里是客户端上报的裸字符串,
一次抛出就整页任务失去进度显示),但不必用 catch 实现——先按字符判掉非数字、再限 9 位
防 int 溢出,Integer.valueOf 就不可能抛。这样既守住棘轮也不动别人的 catch。
补一条用例把「负号/超长/非数字」三个分支钉住(否则改了没人验)。

教训写在这儿:改公共 DTO/VO 之后不许只跑定向,全量才是验收。
2026-10-11 00:02:22 +08:00
huangzd1997 96d4e40a77 看板(心跳位置补进度): 跟价/定时匹配这类无快照的行不再恒画「—」
客户端心跳位置此前只喂 progress/light(客户端进度条),后台任务中心的进度列仍按 10-04 那条
「没分母就画 —」走,于是同一个在跑的跟价任务,客户端有条、看板是「—」。

- TaskCenterQueryService 注入位置服务:只对「无快照 + 不是行内已计数的三个模块 + 非终态」的行
  批量读位置;这个判据抽成 wantsHeartbeatPosition 一处共用——收集与填充各写一遍的话,
  改一处就会让另一处静默拿到 null,又退成「安静地没有条」
- 封顶与页大小同源(BOARD_POSITION_LOOKUPS=100):沿用 light 那个 20 的话,第 21 行之后的
  在跑任务永远读不到进度
- 心跳新增 progressGrain 一并入库;看板按它把 units 的「国家数×1000 摊平当量」折算回自然计数,
  否则管理员会读到「已完成 1222 / 总 5000」。客户端那条仍吃原始千分位(要的是平滑),
  所以折算做成 Position#displayUnits() 显式一步,不是一处改两边
- 快照优先不变:位置只是执行器自述,服务端算出来的快照更权威
- 用例:displayUnits 折算/钳位/分母不塌 0、grain 存取、老客户端不报粒度按自然计数原样通过;
  看板三例(在跑行用心跳、终态一次都不读、有快照不许被覆盖)。TaskCenterQueryServiceTest 37 例绿
2026-10-10 23:40:50 +08:00
huangzd1997 deb3d7e161 进度(light透传): 把心跳已存的 current/total 交给前端,为客户端任务进度条打通服务端一段
客户端心跳一直在发 current/total,Java 也已存进 Redis 位置 Hash,但除判死豁免外没人读它,
所以客户端界面上解决风控/跟价这些任务画不出进度条。本次只在 light 出口上透传,不新建表、不写迁移。

- TaskProgressLightVo + progressCurrent/progressTotal/progressLabel(三个同生同灭)
- 装配器只对非终态任务读位置;读不到或分母非正数一律留 null,由前端决定不画(0/0 会被读成"进度 0%",与"没有进度"是两件事)
- 位置服务加 readDrawablePositions:单次轮询封顶 20 次 Redis 往返,按尝试次数计(老客户端一个都不发时命中数为 0 但往返数仍是全量)
- 标签按「,」整段截到 60 字,定长硬切会截出半截店铺名
- 相似ASIN 那份私有 LightVo 同步(它是历史遗留的第二套实现,不同步会让该模块进度随轮询闪烁)
- 顺带修该私有实现的投影缺陷:select 少 module_type 一列,真实查询下所有任务被判 missing,
  与共享装配器 2026-09-14 那次线上事故同形态(那边有守卫测试、这份没有),现补守卫
2026-10-10 20:04:52 +08:00
huangzd1997 07757b9f6d 对平(两条既有台账红): 迁移盘点文档补 V156 一跳、页码台账按拼写分开登记
出包前实测 master 头全量红在这两条上(都不是本批引入,已在干净 HEAD worktree 复跑坐实):

1. docs/migration-inventory.md:磁盘 154 支版本化迁移、整数版本到 V156,文档还停在
   153 / V1..V155,"最新版本"一行也没写 V156 的文件名 ⇒ CompanyMigrationV143Test
   的三条对账(文件数/范围/含最新文件名)红。取号起点 V157 本来就对,没动。
   旧版文件名一个没挤掉(V155/V154/V153/V152 仍在链条里,CompanyDefaultDropV152Test 钉着)。
2. PageDefaultsLedgerTest:同一个断言同时套在 #page_size= 与 #pageSize= 两种拼写上,
   而 camelCase 那族实际只用得到 2 种常量(另外 2 种只以 snake_case 出现)⇒ 恒红,
   红的是写法不是有人新增了默认值。改成逐拼写登记 + 两拼写并集仍只许四种,
   "长出第五种要红"这条保护不降。

用户拍板"对平两条账后整批发",故本笔与外观那两笔同树出包。
2026-10-10 11:47:21 +08:00
huangzd1997 09867f612d 后端(补提交): 上一笔 pathspec 漏了 4 个未跟踪新文件——提交树本身编译不过
122faf7c 用 -- 指定路径提交,未跟踪文件不会被带上(共树下这是同一个坑第二次):
AppearancePatentRowOutcome 是主代码新引用的判据类,缺它就是一棵编译不过的树;
三支新用例(行结局分类 15 例 / 交付闸门 9 例 / 货源交付口径 3 例)同理。
2026-10-10 11:33:20 +08:00
huangzd1997 122faf7c74 后端(外观专利逐行送检): 撤掉组代表折叠与兄弟行借用结论,覆盖率分母改成交付行集
现网取证(主机A MinIO 上 6 份已交付 xlsx 逐格数):结果文件里 20.7%~51.3% 的行显示
「未取得检测结果」,且空的是整行三列、这些 ASIN 一个都没被检过、行号连续成块
(10-08 任务 30426:1211 行只有 96 批 960 行有结论;10-09 任务 30455 的 281 行空行
100% 属于"同父号已有一行被判")。两条成因都在判据口径上:

1) 送检只挑组代表行,兄弟行指望发起那一轮复用代表结论 —— 同父号的 2_1/2_2/2_3
   各有各的 sku/标题/图片,借用等于成片行永不检测。按用户口径改为逐行申领、逐行送检,
   组代表折叠与 expandRows 摊派一并删除(合批省的是调用数,代价是漏检)。
2) 覆盖率闸门的分母按「用户上传表的解析行」有没有标题/图片判该行该不该检,而数据
   常在「客户端回传行」上 ⇒ 用户表不带标题列时分母恒 0、整段不判,成品半空而零告警。
   判据抽成 AppearancePatentRowOutcome(JUDGED/NOT_INSPECTED/NO_DATA),表格文案、
   原因 sheet 与闸门分母共用同一套;候选/工作单位计数也改用交付口径(旧的是
   "四字段任一可用",只带专利维度文本的行会被读成已检测,而专利维度根本不入表)。

配套:判失败的任务不再整段跳过闸门(仍按既有口径出部分结果,但必打
「交付行账不完整」锚点并把缺口写进 task.errorMessage);出表前缺口<阈值时撤行级
标记并 requeue 补检一轮(releaseRowInspection 三参版才允许撤完成标记,两参版语义
由老用例钉死不变);llm-coverage-min-ratio 0.5→0.95(Properties 与 application.yml
两处默认值,已查两台既无 env 覆盖也无外置 yml 该键);货源面接上同口径的
「交付行账」度量日志(只数不改行为,阈值等本面实测分布)。

测试:外观专利整包 203 例、加货源共 645 例全绿。新增 AppearancePatentRowOutcomeTest(15)、
AppearancePatentDeliveryGateTest(9)、SimilarAsinDeliveryLedgerTest(3),
并在 RowMarkTimingTest 钉住"同父号子行逐行申领""兄弟行不得继承结论"。
2026-10-10 11:32:37 +08:00
huangzd1997 0d59a733d4 后端(补提交): AdminGuardSwitchConfigTest 7 例进库——上一笔 pathspec 提交漏了未跟踪新文件
闸门那 7 例当时是从工作树跑的,不在版本内容里;尺子执行档已经引用了这个类名,
不补就是别人 clone 后 mvn 找不到这一类 ⇒ 格子读成「这一类没跑出结果行」而判红。
2026-10-10 00:00:22 +08:00
huangzd1997 04b383072a 后端(四面9分批次): 第一档 9 个判死线/容量键登记进 application.yml(行为不变)
- 按叶节点合并进已有子块(publish / price-track / task-queue / transient-storage /
  result-file-job),只给 shop-data-crawl 与 scheduling 新建块;同名子块/同名叶子
  在插入前就中止——重复全路径键在 Spring 侧是后值静默覆盖前值
- 每个键的默认段与该 Service 的 @Value 默认逐字相等,由 ops 棘轮对撞钉住
- 复跑证据:BusinessErrorHttpStatus 8/0、ClientVersionFloorConfig 10/0、
  ConfigWiringSmokeTest 8/0(三支都用 Spring 的 YamlPropertySourceLoader 展平 classpath
  里那份 yml ⇒ 证明是 SnakeYAML 吃下了这次合并,不只是我自己的解析器吃下)
2026-10-09 23:56:12 +08:00
huangzd1997 96f7a43004 后端(四面9分批次): 兜底鉴权四开关写进 yml 并加启动自述,配 7 例配置面判据
- application.yml 的 aiimage.security 块补 admin-guard-enabled / user-tool-guard-enabled /
  user-tool-guard-prefixes / admin-guard-exempt-prefixes 四键,默认值与 @Value 逐键相等 ⇒
  这一笔不改现网行为(此前四键在任何 yml 里 0 处,"没配置"与"配置成惰性"同形)
- AdminApiGuardFilter 加 @PostConstruct reportGuardState():三档惰性态各点名一条,ASCII 锚点
  [api-guard-switch](中文签名在容器日志换编码后整条 grep 失效)
- 新判据 AdminGuardSwitchConfigTest 7 例:yml↔@Value 出厂默认逐键对撞、15/6 两条名单按构造点名
  且摘一条即掉数、自述 WARN/INFO 分级、并用 MockFilterChain 证明出厂默认下匿名 collect-data
  请求仍放行(现网 6h 窗口 A 机 4 条 / B 机 8 条 [ownership-anonymous] 就是这条路径)
- 同树 8 支相关类一起复跑全绿:AdminApiGuardFilter 33/ClientVersionGuardFilter 12/
  ContextSlice 6/FloorConfig 10/ApiGuardAuditor 8/Breach 10/BusinessErrorHttpStatus 8
2026-10-09 23:46:33 +08:00
huangzd1997 cde6e2e72b 后端(四面9分批次): 版本地板自述并排 ASCII 巡检标签,锁跳过 javadoc 计数改回实测值
- ClientVersionGuardFilter 4 条中文自述旁并排 [client-version-floor]:中文签名在容器日志
  换编码后整条 grep 失效,巡检只认 ASCII;判定逻辑与响应体一字未改
- ClientVersionFloorConfigTest 加第 10 例:逐行钉"带中文自述必须并排 ASCII 标签",
  并含"内存里摘掉一处就掉数"的非零对照(mvn 实跑 tests=10 failures=0 errors=0)
- LockSkipWitness javadoc 的 27 处/12 文件是旧数,按本轮实扫改成 28 处/11 个文件
2026-10-09 23:34:00 +08:00
huangzd1997 15094309cf 后端(四面9分批次): 锁跳过留痕、状态词表收成单点、版本硬地板进 yml 并记账
- 14 处「拿不到锁就 continue」过去零日志,现统一带可聚合锚点并有留痕判据
  (LockSkipWitnessTest 7 例 + LockSkipSilentExitGuardrailTest 4 例)。
- 任务状态词表:散落内联集合改由单一定义点判方向(TaskStatusVocabularyRatchetTest 7 例),
  CANCELED/CANCELLED 只做归一映射,没改库值也没改对外契约。
- 版本硬地板三键(min-supported / enforce / rejectUnreported)此前在任何 yml 里 0 处=出厂即惰性;
  现在入册且 enforce=false 走记账模式(ClientVersionFloorConfigTest 9 例),真挡谁留给用户拍。
- 业务码→HTTP 状态只做映射单点 + 开关(默认关,开启前逐字节等价,BusinessErrorHttpStatusTest 8 例);
  直接翻面会让三个前端把业务失败读成网络挂了。
- 验收:mvn -o test 这 5 个类 35 例 0 红(用 python subprocess 起 mvn——bash 里 cmd 包一层
  开的是交互式 cmd,rc 是 cmd 的,会给出假的 rc=0)。
2026-10-09 23:09:37 +08:00
huangzd1997 b1a66fb6f2 build(打包): application-local.yml 不进 jar——主树随手构建不再夹带本机密钥
gitignore 的本机开发配置(本机库/OSS/内部令牌一套非生产值)躺在
src/main/resources 下,而 mvn 打包不看 gitignore。2026-10-09 实测:
12:23~18:49 在线的三个主树构建包均夹带该文件(经 _prod_config 指纹比对,
其值≠现行生产密钥,未成实害;已碎删两台各三个含它的旧备包;出包房规当日
已改为隔离 worktree + _git_stamp.py 盖章,这条 exclude 是第二道钉)。

exclude 加在 maven-jar-plugin(同 db/aiimage.sql 先例):只拦入 jar,
target/classes 不受影响——本地 IDE / run-local.cmd 照常读得到。
不涉及运行时行为,随下次发版自然生效;线上 7c6761b 包本就不含该文件。
2026-10-09 20:26:45 +08:00
huangzd1997 7c6761bc74 收口(去重库读侧): 按行 company_id 认公司——代导入/上传者已删两族归位
控制方 2026-10-09 截图:admin 在「先锋」tab 代导入的行(company_id=3、
uploader=admin 属公司 1)在先锋 tab 看不见、反而出现在米椿花 tab。读侧
(列表/导出/公司超管)自 V145 起一直按"上传账号"认公司,与写侧(5ccf3c89
起一律显式落 company_id、V154 已摘 DEFAULT)两套口径打架;切换前先把存量
兜底行修对:V156 把组 33/uid=1188(「先锋」,账号已硬删)的 1452 行
company_id 1→3——否则切完它们整批冒给米椿花,且当前正参与米椿花的去重
比对(5ccf3c89 已按 company_id 收窄),先锋自己反而拿不到这批值。

- DataReadScope 新增第五道正门 superAdminScopedCompanyId:与
  superAdminScopedUserIds 同形"只对站点超管收窄",维度从上传账号集换成
  行 company_id;非超管恒 null(不叠那一刀,可见集仍锁在账号/分组上)
- Service applyCompanyScope 由 uploader_user_id IN (成员) 改 eq(company_id);
  company_super_admin 的 wholeCompany 分支同批切换(1206 从此看得到代导入
  行与上传者已删行,例:admin 代导入 14 行 + 组 33 历史 1452 行)
- G2 护栏加第五道门 + 正/负三枚探针;单测新增四条(超管切公司、公司超管
  全公司、门非超管恒 null、service 层 wrapper 两面)

DedupeTotalDataController 的换门接线已随 2a4d15b8(文案批)入库。
影响面(生产只读实查):切后米椿花 tab −14 行、先锋 tab +14+1452 行;
公司超管仅 1206 一个账号。全量 4209 测绿。
2026-10-09 19:48:11 +08:00
huangzd1997 2a4d15b801 fix(文案出口): 用户可见提示语一律走 UserMessages 把关,并补结果作业租约围栏
两件事同源:2026-10-09 任务 30456 的卡片上同时出现中文进度和一句英文异常原文。

围栏:派发链在执行前重读 job 行,让 activateRunningClaim 的 CAS 恒真,撞锁方
deferRunning 把在跑的行翻回 PENDING,markSuccess 静默写 0 行——成功被判成失败。
claim 快照现在贯穿到 runClaimed 不再回读,markSuccess 返回布尔并补 stage=SUCCESS_LOST
日志,让这次丢失可观测。

文案:普查数出 61 处把 ex.getMessage() 拼进用户可见字段(异常响应、任务 error_message、
结果作业 error_msg、看板 message),逐条翻译追不上新增速度,改为出口把关——
UserMessages.with(中文主干, 异常) 只拼接中文详情、orFallback(原文, 兜底句) 只放行含中文的串,
被换掉的原文进日志;GlobalExceptionHandler 按码分档兜底(401/4011/40902 各说各的话)。
另把 chunk-read-failed[N] 摘要写成"第 N 分片读取失败"、TASK_LOCK_BUSY 换成中文(40902 码不动,
客户端按码分支)。数字人两处与结果作业 worker 故意仍存原文:孤儿判定与三条 preserves raw
用例按 error_message 读它,界面侧由前端 userNotice 兜住,已在新尺子里点名豁免并反查豁免是否还被用到。

尺子:RawExceptionMessageSinkGuardTest(出口行数下限硬钉 1500+内存造违例自证)、UserMessagesTest、
UserFacingMessageChineseGuardTest 豁免表收到只剩 JSON 键 msg 一条。mvn -o test 4205 例 0 失败。
2026-10-09 19:34:25 +08:00