Commit Graph

544 Commits

Author SHA1 Message Date
huangzd1997 49107bb2ad test(phase-3): 3C 就地更正——装配切片注释里的同族件数(Mapper 5→6、ExcelAssemblyService 3→4)
e6853a0e 那段「风险最高的三组」是按前五支的读数写的,本支接进来之后:本支私有
Mapper 是六枚(另有交给 super 的两枚),跨支同族的 ExcelAssemblyService 是四支、
LocalFileStorageService 是三支。判据一条没改、assertSame 一条没动,只是注释别再
把下一个读的人带偏。复跑 5 例/0 红。
2026-10-19 15:38:19 +08:00
huangzd1997 e6853a0e4f refactor(phase-3): 3C 第六支接入底座——八件十一点,接不上的七格逐格立账
CollectDataService extends AbstractFileTaskPipeline<CollectDataResultRowVo>:
@RequiredArgsConstructor 换成显式 29 枚构造子(参数表逐枚沿用原字段声明序,
两处 29 枚实参的测试调用点一个字未改),五枚底座依赖交 super;钩子两枚
moduleType()/loadTaskForSubmission()(DB 直读派)。

接上的公共件(八件十一点):newTaskHeader/insertTask/newScopeRow×2(建单结果行
+ ensureTaskResult 补建行)/requireSubmissionTask×2(锁外预检+锁内复核,全族
第一次同一格被一支用两次)/rejectTerminalSubmission(IDEMPOTENT)×2/
enqueueResultAssembly。锁外那格的 warn 留在调用点(底座件刻意不打日志)。

接不上、逐格留本地写法并写明理由:admitSubmission 整段(本支两段准入、那一格一次
走完);requireUserId(现网把 request 空判与 userId 非法合并成同一格判据);
requireTaskId(本支没有那一格,golden 已证);acquireSubmissionLockOrThrow(文案
差一个字、warn 还带 waitMillis);listScopeRows(本支要 limit 1 首行);
publishResultFile(底座把上传捆在写列内,本支现网先上传→persistStats→再写列,
那条时序是注释里立着的自愈前提);writeJson 两处未并(要 RETHROW_FLOOR 383→381
的逐处记名授权,本笔未动门禁)。

行数账:显式构造子+钩子 ≈+65、②抵掉 22 ⇒ 本支棘轮 2080→2123(+43),对在册
基线 2209 仍净减 86;基线一格未改、--write 未跑。额度来源是上一笔 A 聚类抽件的
−129,抵平因此跨了两笔,这一点如实登记。

装配面:TaskServiceWiringSliceTest 补第六支——真容器起六支、本支 24 枚私有件逐枚
assertSame、并断言本支不再留 taskFileJobService 同名字段;moduleType() 第五个读数
assemble("COLLECT_DATA")。

门禁:定向 341 例/0 红/2 skipped;wiring 5 例/0 红;后端全量 4528 例/0 红/
14 skipped/BUILD SUCCESS(真实 rc=0,用例数与上一读数相同——本笔只加断言不加
方法);两套 golden 非写模式逐字节复现;ops ruff All checks passed、readability
棘轮 9 passed;格式步未纳管 ⇒ 如实跳过。真机启动验收本格仍欠。
2026-10-19 15:33:50 +08:00
huangzd1997 465ee06b7c test(phase-3): 3C 快照自我更正——selectById 改成按主键取,别再拿替身的形状当现网语义
上一笔 c4cf7bab 的 invalidTaskIdFallsThroughToNotFound 那格没有证到它在 message 里
声称的东西:替身写的是「selectById(any()) 一律返回那只内存任务」,于是 taskId=0 一路
跑完了整条 happy path,golden 里那 20 行证的是**测试替身的形状**,不是现网语义。
而 commit message 与用例名都写着「非法 id 一路走到『任务不存在』」——那句当时并不成立。

改法:selectById 按主键取行(Objects.equals(id, TASK_ID) ? task : null),非法 id 在
锁外预检就得到「任务不存在」;用例改名 invalidTaskIdRejectedAsNotFound。
现在那一格读出来是 task.load id=0 status=- / thrown code=- message=任务不存在 /
lockAcquire=0 outsideLock=0 —— 这支没有 requireTaskId 那一格这件事,第一次被真证住。

其余 14 段 case 逐字节未动(diff 只有这一格),说明替身收紧没有波及其他形状。
门禁:CollectDataSubmitResultSnapshotTest 5 例(写模式)+非写模式复跑 4 passed/1 skipped,
golden 跨两个 JVM 逐字节相同。
2026-10-19 14:20:54 +08:00
huangzd1997 c4cf7bab7f test(phase-3): 3C 前置——补 collectdata 回传段 golden,钉住「两段准入」的现网步序
CollectDataSnapshotTest 只锁到建单+解析+载荷,submitResult 那一段按 §5「先补再动」
必须先在非源上落一笔。本笔吃真实入口 service.submitResult,golden 270 行/15 段 case,
渲染的是调用顺序流水而非分组清单。

这支与另五支最不一样的是**准入发生两次**:锁外预检(快速失败,不为终态任务白跑
去重与品牌检测)+锁内重读复核。于是流水把四个锁外副作用(filter/brandFilter/
asinCache.write/recheck.enqueue)也记下来,terminalRejectedBeforeLock 与
taskNotFoundBeforeLock 两格读出来是 lockAcquire=0 outsideLock=0 ——
「预检在取锁与全部预处理之前」这条形状从此改不动了。

钉住的其他现网形状:
- 重复分片:锁外预处理照跑、锁内 dup 命中后一条库都不写,vo.currentChunkRows=0
- 结果行按需新建(sourceFilename 空串那一形),scopeKey 用 submissionId 回落 "task:{id}"
- done=true 才挂最终组装;带 error 且已收到分片 ⇒ 标失败也照常组装(28599 那起的账)
- 空 ASIN 的行不进过滤链但仍进 chunk payload(结果文件 sheet 要全量)
- requireRustfsPayload 的形状:指针不是 rustfs: 前缀 ⇒ 先 deletePayloadIfPresent 再抛,
  顺序反了就是留垃圾对象(chunkPointerNotRustfs 那格钉住)
- 锁竞争抛的是 code=40902 +「任务正在处理,请稍后再试」——与底座件的
  「任务正在处理中,请稍后再试」差一个字,本笔只登记不统一
- 这支没有「taskId 不合法」那格:非法 id 一路走到「任务不存在」(invalidTaskId... 那格)

长内容只进长度与 sha256 前 12 位(resultJson/chunk payload),时钟与雪花 id 不进快照;
同一夹具跑两次+跨两个 JVM 复跑逐字节相同(golden 由写模式生成后,非写模式复跑一字未动)。
门禁:collectdata 全面+棘轮/边界/面数见证 定向 320 例/0 红,BUILD SUCCESS。
2026-10-19 14:16:37 +08:00
huangzd1997 394145deb5 refactor(phase-3): 3E 第五支接入底座——接得上七件九点,接不上的六格逐格立账
DeleteBrandRunService extends AbstractFileTaskPipeline<DeleteBrandParsedFileCacheDto>:
@RequiredArgsConstructor 换显式 14 枚构造子,五枚(两支 Mapper+锁+Job+OSS)交 super,
本支不再重复声明那五个字段;moduleType()/loadTaskForSubmission() 两枚钩子落地。

接上并逐点核对的七件九点:requireUserId(:176)、newTaskHeader+insertTask(:180/183)、
newScopeRow 两处(:259/271)、requireSubmissionTask(:1372)、enqueueResultAssembly(:1516)、
listScopeRows 两处(:1609/1717)。

接不上、且都写了实测理由的六格(不是「没做」,是「做了会改行为」):
- requireTaskId:本支 :1361 文案「任务 id 不合法」≠ 底座「taskId 不合法」,且它在取锁之前
- rejectTerminalSubmission:本支 :1384 只说「任务已结束」——同一 ERROR 形内部有两种文案,
  底座把文案写死了
- acquireSubmissionLockOrThrow:本支 :2249 抛不带 TASK_BUSY code 的那句,而 :1577 用
  message.contains("任务正被占用,请稍后重试") 当收尾跳过的判据 ⇒ 换件=改锁竞争语义
- writeJson:本支建单走 hutool JSONUtil,压根没有 Jackson 序列化失败那一格
- publishResultFile:形状同但本支 :1916-1924 写的是可空 Integer rowCount(缓存 DTO),
  底座件收 int ⇒ 套上去要么 NPE 要么把 NULL 洗成 0
- taskCacheService():DeleteBrandTaskCacheService 不继承 AbstractModuleTaskCacheService
  (第二例,第一例是 AP 的兄弟抽象)⇒ 心跳那格没有承接件,admitSubmission 整段用不上
另有 :1770 那处 enqueueAssembleResult 因吃掉返回值(按 job.status/retryCount 判组装已终态
失败)也没换。底座 javadoc 的四处出处账按上述实测更正,并把 :1265 那枚会腐烂的行号指针
改成方法名指针。

拆薄同笔抵账(readability 点名基线只许降):删两枚零调用私有件 countCompletedFiles/
inNewTransaction,接走建单 12 行与结果行各 5-7 行;棘轮读数 2305→2300。本支手抄的
「!MODULE_TYPE.equals(」由 8 处降到 7 处(TaskLifecycleDebt 那格方向对)。基线一格未改。

接线:TaskServiceWiringSliceTest 加第五支(3 枚新 @Bean 桩+逐枚 assertSame 本支 9 枚私有件
+「五枚底座字段不许在本支重复声明」那条 NoSuchFieldException 断言+DELETE_BRAND 那对
moduleType 验证);顺手把这篇测试自己两处会撒谎的计数(两支/三支)改成实数。

门禁:后端全量 mvn -o test 4523 例/0 红/0 错/13 skipped,BUILD SUCCESS;两条 deletebrand
golden(run-snapshot+昨日新落 submit-result-snapshot)跑完 git status 一字未动 ⇒ 建单/解析/
载荷/回传四段对外行为零变化;定向 79 例全绿;ops 面 ruff All checks passed、readability 9 passed。
⚠ 真机启动验收(mvn -o spring-boot:run)仍未做,五支都欠着,账在 Phase 8。
2026-10-19 13:33:19 +08:00
huangzd1997 8c771b277e test(phase-3): 3E 前置——补 deletebrand 回传段 golden,先立是非源再动代码
蓝图 §5 的「先补再动」对这支仍然生效:1B 那枚 run-snapshot 只锁到建单+解析+载荷,
submitResult 出结果段一直空着。本笔落 DeleteBrandSubmitResultSnapshotTest(真入口
service.submitResult,不在测试里照抄管线)+ golden 256 行 25 例:

- 事件流水而非分组清单:取锁→加载→模块校验→终态拒→复位 RUNNING→逐片存→恢复重排→
  早挂组装 job→收尾尝试,顺序换了就红(这支的准入步序与底座默认序相反,正是最怕改的一格)
- 补传恢复那格单独一例钉住:terminalFailed=true 且分片齐 ⇒ resetForRecovery+再 enqueue
- 十二格准入/校验拒绝逐格点名,写库计数全零;非法 taskId 连锁都不碰
- 实测抓到第九处读数坑:收尾 progress 走 Map.of(...),JDK 不可变 Map 的迭代顺序每次起
  JVM 重排——同一棵树两次生成 keys 顺序不同。渲染改为按 key 排序,锁内容不锁桶序
  (Redis hash 本就不保序,这条不损耗契约)
- 现网一条事实顺手打进流水:loadTaskForExecution 命中 DB 后会回写缓存,故「一次库都不碰」
  的准确读法是 taskUpdate=0,而 taskCacheSave 可以为 1

门禁:定向 114 例全绿(四支 deletebrand 测试+六套棘轮/边界/接线),golden 跨 JVM 逐字节复现,
非写模式复跑一字未动。
2026-10-19 13:12:32 +08:00
huangzd1997 ac873b24bf refactor(phase-3): 3A 拆薄第四笔——结果打包与命名抽出,并补上上一笔声称已加的见证
AppearancePatentTaskService 棘轮读数 3165→3049(本会话累计 3458→3049,净减 409 行);
新落 service/support/AppearancePatentResultPackager 206 行(<800 报警线)。
搬的是「按源文件分组 + zip 打包 + 成品命名」四枚:splitRowsBySourceFile、
packageResultWorkbooksAsZip、uniqueZipEntryName、normalizeZipFilename、writeResultZipEntry、
safeFileStem,连同只有它们用的 SourceRowsBuilder 与 SourceRows/SourceResultWorkbook 两枚 record。
分组键的三级回落(sourceFileKey → sourceFilename → __default__)、条目名去重后缀 (2)(3)…、
Windows 非法字符换下划线、异常文案——判据与字面量逐字带过来。
两处如实说明:① 三个重复出现的字面量(appearance-patent/appearance-patent-result.xlsx/8192)
收成本类常量,值一字未改;② 服务侧留三枚薄委托+一个无状态访问器(与 historyAssembler() 同一先例,
所以本笔不动构造器、不动装配),不是为了保反射接缝——AP 测试按名反射的清单里根本没有这四枚
(那批点名在 writeResultWorkbook/validateCompleteLlmCoverage 那一侧),这条前置扫描是上一笔
栽过之后固定下来的动作。

⚠ 更正上一笔的登记(768f8e05 的 commit message 说了没做):那句「另加两条 anyMatch 点名新落件」
实际没进文件——当时脚本改的是数字、那段追加从未落地。本笔把三枚新件逐枚点名进 witness,
并如实留这句更正:只把分母数字改大,护栏证的还是「数对不对」,不是「扫不扫得到」。

顺带一条既有事实登记(不是本笔引入、本笔没顺手改):文本归一化在 src/main 里有两遍——
Task 93 抽出的 AppearancePatentRowNormalizer(normalize/firstNonBlank/baseId/normalizeDisplayId)
与 AppearancePatentTaskService 自己那两枚同名私有件,服务至今一处没用过 util。扫描件本可以抄第三份,
直接引用 util 了;把服务侧那两枚切过去是纯粹的重复消除(十几处调用点同形),但那是另一笔的账。

门禁:后端全量 mvn -o test 4518 例/0 红/0 错/12 skipped,BUILD SUCCESS(无管道取码);
八条 golden 逐字节相等(git status -- src/test/resources 一字未动);ops 面 ruff All checks passed、
readability 棘轮 9 passed(3049<在册 3458,两枚新件都在报警线以下,基线一格未改)。
2026-10-19 12:28:41 +08:00
huangzd1997 768f8e0573 test(phase-3): 3A 拆件后同步 SourceScan 的面数见证——28→30、5→7,并让 witness 真指到新件
全量 mvn -o test 4518 例里唯一两记红都在这一支,红因是本会话的拆件:modules/appearancepatent
的服务面从 28 支涨到 30 支(support 从 5 涨到 7——新增 TaskOwnership 与 StaleTaskScanner)。

改法按该格自己的判据来。它原文写的就是「聚合入口存在的理由=拆分后的新文件要自动被看到」,
所以这不是一枚需要放宽的上限,而是一枚需要跟着真面走的**分母见证**:
- 方法名里的 28 一并改成 30(名字与断言不符就是下一处读数坑);
- 逐层拆解的注释同步(5 service/support → 7,并注明 7=既有 5+3A 新落 2);
- 另加两条 anyMatch,点名新落的两枚文件必须在面里。只把数字改大而不指到具体新件,
  下一回拆件就又会只剩一个「数不对」的红,而这条护栏真正要证的是「扫得到」。

其余判据一条未动(dto 7/vo 9 未变,model 那两层嵌套没受影响)。
SourceScanTest 40 例全绿;后端全量重跑读数随后登记。
2026-10-19 12:00:39 +08:00
huangzd1997 f0c672025d refactor(phase-3): 3A 接入底座——建单段与一格准入沉下去,回传段其余部分按证据未动
AppearancePatentTaskService 继承 AbstractFileTaskPipeline<AppearancePatentResultRowDto>。
棘轮读数 3458(在册基线)→3381:显式构造器成本 +26,被建单段下沉(-25)与三枚零调用
私有件出仓(-33)对冲掉,本笔自身净减 7 行、较基线净减 77 行。

接得上什么、接不上什么(这次是第四条实测,答案与前三支都不同):
- 接得上底座:newTaskHeader/insertTask/newScopeRow/writeJson/requireUserId/
  requireSubmissionTask/ensureTaskOwnedByCurrentInstance(本支那枚私有同名件签名逐字相同,
  改成 @Override 就接上了)。
- 接不上家族层:本支是 chunk+scope 族(按 submissionId 分片),套 shop-payload 就是把
  「按分片合并」换成「按店铺合并」。装配切片里那条 getSuperclass 断言现在盯住了这一点。
- 接不上缓存钩子:本支的 AppearancePatentTaskCacheService 继承的是同族兄弟
  AbstractPendingRowTaskCacheService,不是 AbstractModuleTaskCacheService ⇒ 底座
  taskCacheService() 钩子对它无类型可套。处置是不覆写那一格(默认 null 已经对),心跳留在
  persistSubmittedChunk 自己那句 touchTaskHeartbeat——不是本支没心跳,是两套抽象接不上。
  底座 javadoc 把 AppearancePatent 列进「4/7 支有模块缓存服务」那格,这条读数不准,
  已在本笔注释里点名更正(蓝图 §5 同步登记)。
- 没动的部分:回传段其余步骤(终态判定用 TaskResultAdmission.rejectNotRunning,比底座
  rejectTerminalSubmission 宽——凡非 RUNNING 皆拒,且 40901 只在真终态那格带)与
  acquireTaskLock 的非阻塞变体(抢不到返回 null 让巡检跳过下一轮,底座只有「抢不到即拒提交」
  两型)。这一段没有 golden,按「先补再动」只做了 prepareSubmittedChunk 那一格
  逐字同形的四行替换,其余一个字节没碰。

捕获账:本支两处序列化 catch(私有 writeJson(Object,String) 与建单那段 try/catch)并进底座
已有的 writeJson ⇒ RETHROW 385→383,按该尺自己写的处置口径逐处记名(出处写在
CatchSilenceRatchetTest 常量上方),用户授权沿用 3B 那一笔的同项拍板。不重抛/只 log/
空体三格未涨,其余判据一格没放宽。

门禁:定向批 452 例/0 红/0 错/5 skipped(五格是 golden 生成器,未设环境变量时如实 skip),
BUILD SUCCESS 取码走无管道写法。八条 golden 逐字节相等——git status -- src/test/resources
一字未动(本支新建单那条 + 前三支那六条都在跑)。装配切片接进第四支:22 枚参数逐枚点名,
含「五枚交 super 之后本支不再持有同名字段」那格 assertSame。
真机启动验收仍没做(要 MySQL+Redis),这条账继续挂在 Phase 8。
2026-10-19 09:36:48 +08:00
huangzd1997 7b7d22cbb4 test(phase-3): 3A 迁移前补建单段 golden——吃真服务入口,不再抄一遍管线
AppearancePatentCreateTaskSnapshotTest(8 例)+ appearancepatent/golden/create-task-snapshot.txt。
渲染的是建单的落库事件流水:task.insert → payload.store → task.update → result.insert → scope.insert。

为什么已有 parse-snapshot.txt 还要再补一支:那支锁的是解析本身,而且是在测试里
重跑管线(自建 ExcelParser + 自己抄一份 baseId/hydratePromptFields),一行库没碰、
真入口一次没进。3A 要换掉的恰恰是 parseAndCreateTask 里那几行落库,那份 golden
对这件事零保护——蓝图 §5 的规矩写得很直白:「照抄那种对迁移零保护(旧代码消灭了测试还绿)」。

钉住的三段本支特有形状:
- 建单全程无事务:载荷存储失败时任务头行已经 insert(最后一节只剩 task.insert 一行),
  这是副作用边界,不是 bug 登记——底座不提供任何事务语义,迁移时必须原样保住。
- 结果行 success 留 NULL(不是 0 也不是 ShopDataCrawl 的 -1)、rowCount 写的是接受行数,
  所以底座 newScopeRow 的这两列只能由本支显式交进去。
- resultJson 是索引不是数据(六个顶层键+一枚载荷指针),真载荷只留 ptr://。

顺手钉出一条反直觉读数:maxParseRows 是「截断」口径不是「拒绝」口径——单文件读到上限
行数时 aggregate 那格的上限判定根本不触发,整单照建(golden 末行 events=5 就是这条)。
不顺手改,只登记。

时钟与雪花 id 不进快照;长内容取 sha256 前 12 位当摘要。两次独立 JVM 复跑逐字节相同
(generator 那格在未设环境变量时如实 skip)。AppearancePatent*Test 264 例全绿。
2026-10-19 09:24:59 +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 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 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 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 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 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 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