Commit Graph

714 Commits

Author SHA1 Message Date
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
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
huangzd1997 6325a63b52 补提交(去重库收口): 上一笔漏了 DuplicateSubmissionContractTest 的 filter 双参
上一笔按 pathspec 提交 22 个文件时,把这支从目录名(modules/task/contract)误判成
别人的在飞件——它其实是 CollectDataBatchQuery.filter(rows, ownerUserId) 的调用方之一。
后果是干净检出 5ccf3c89 后 mvn test-compile 直接失败(主树工作树里编译得过,
因为那棵树同时带着别人的未提交件,把漏项盖住了)。

出包用 detached worktree 才暴露这件事:主树"绿"不等于 commit 自洽。
2026-10-09 18:12:51 +08:00
huangzd1997 5ccf3c896f 收口(去重库): 五处比对与写入口按 company_id 认公司,不再跨公司去重
读侧(列表/导出)早已按公司收窄,但"去重"这个动作本身一直查全平台:
selectExistingDataValues 是 `WHERE data_value IN (...)`,一个租户条件都没有。
库里唯一键自 V145 起就是 uk_company_data_value(company_id, data_value)——
同值本来就允许归两家,是代码没跟上库的口径。

五处一起收口(第 5 处由编译器抓出,正是 V145 头注释 §1.2 点名的采集侧):
去重执行 ASIN 过滤 / 导入预检"已存在就跳过" / 手工新增与编辑的重名校验
(文案改「本公司已存在该数据」)/ 删除导入(超管不选分组时原先一次删掉全平台
同名行)/ 采集结果过滤(CollectDataBatchQuery 直连 mapper,改为经 dedupe 侧推导)。

超管代导入的归属分裂一并修掉:前端两个导入接口把公司 tab 发下去——原先
group_id 落别家的组、company_id 落超管自己那一家。公司身份一律在请求线程上由
DataReadScope.readCompanyIdOrOwn 解析后传入(导入与去重跑在虚拟线程,那时已无
请求上下文),service 侧 requireScopedCompanyId 只判空不兜底。

删两条零调用者的跨公司通道(selectAllDataValues/listComparableValues 全表读、
deleteFromExcel 两个同步重载)。反转一条反向钉:comparableValueLookupRemainsGlobal
原显式断言"比对不参与公司收窄"(多公司一期的半套遗留),现为 IsScopedToOneCompany。

三把尺子随之改动,均带出处:tsv 基准行搬家(三个标量双双不动)、前端发送口分母
17→18 组/21→22 处、CatchSilenceRatchet 重抛下限 387→386(随死代码离开树那处)。

验证:后端全量 4198 例 0 失败/0 错误/7 跳过;前端 1778 例全绿;变异自证
6/6 全部 KILLED,注入文件按 sha256 还原并复跑绿。
现网只读探针:misfiled=0、同值跨家=0 ⇒ 存量比对结果不变,行为改变只在将来
A 家导入 B 家已有 ASIN 那一刻;两口径差额 1,452 行(0.26%)全属公司 1、
全源于 10-05 账号硬删。
2026-10-09 17:57:37 +08:00
huangzd1997 24a94428e8 feat(停用账号): 停用/删除即强制下线并点名成因——写入口、X-Auth-Reason 头、三面接线
- Java:AdminUserUpdateRequest 加 disabled 开关(不能停自己、归属门沿用既有闸),
  AccountExpiryService/AdminAuthSupport 抛停用/删除子类型,GlobalExceptionHandler 打
  X-Auth-Reason: disabled|deleted 响应头;业务码保持 401 不变,不惊动三个既有消费者
- 后台管理:用户页停用/解除停用按钮 + 已停用徽章;拦截器把成因随 &auth= 带给登录页,
  登录页分停用/删除两种文案;源码钉子棘轮基线按正路重生成
- 用户端:kick-handler 按 X-Auth-Reason 分支亮停用/删除标记(互斥清理),
  登录页两段专属文案且各自关自动登录;跳转目标仍是 /login?expired=1
- 反假绿:摘掉成因头注入实测 2/4 红(变异自证),还原等值后复跑回绿
2026-10-09 16:35:35 +08:00
huangzd1997 703760e008 尺子(棘轮): 用棘轮自己的正路收敛改动,只抬两条 SQL 记账分母
CatchSilenceRatchet 咬到三处,两处不该动它的数字:
JwtService 的过期分支改 instanceof 分流(ExpiredJwtException 本就是 JwtException 子类
且 jj 先验签后查 exp)——catch 子句数回到 1,且带 [auth] jwt expired-but-signed 锚点,
否则「过期」与「伪造」在日志里又是同一个读数;容忍分支读库失败当场抛 401,
不吞异常,「不重抛」那一格因此不涨。登出那次不再 catch NumberFormatException,
改为先校验 subject 是数字。
只剩两条 SQL 分母是记账式抬升(XML 语句 96→97、select 66→67),
并把 countLiveWorkFor 登记成非迁移语句:它没有注解时代原文可对撞,
登记而不是让它红,是为了「谁新写了语句」留痕。
2026-10-09 15:31:32 +08:00
huangzd1997 9fa9dcc4c2 feat(续期): 凭据领取顺带回发新 JWT——旧客户端忽略未知键故服务端可先行
挂点是现成的:桌面端每 30 分钟带 JWT 领一次凭据(TTL_SECONDS=1800),不必新加往返、
也不必客户端先学会调 refresh。既有 5 个键名逐字不动(旧客户端按 data.get 取值),
用例同时钉住「不许改名/删键」——那会让存量设备当场领不到凭据,比装机率更糟。
2026-10-09 15:11:37 +08:00
huangzd1997 7edbae0cda feat(容忍): requireUser 接三态——先认人、再吊销、再到期,最后才谈在跑
判定顺序就是语义:selectById 拿不到行就 401(硬删账号留下的孤儿 RUNNING 行不许继续供令牌),
assertNotRevoked 挂在 assertSameDevice 之前(那条路径第一行豁免超管)。
读库失败/超时按「没有在跑」处理,方向必须是拒。
既有用例里 4 处 jwtService.parse 打桩同步补 parseWithVerdict——接缝动了测试跟着走,
不给产品留兼容层;那条「JWT 一律解析失败」的内部令牌用例映射成 INVALID,
留 null 会让 requireUser 直接 NPE。
2026-10-09 15:06:29 +08:00
huangzd1997 19498610dc feat(停用): disabled_at 同挂登录与已发令牌两条闸,各沿用既有状态码
只挡请求不挡登录 = 被停用的人重登一次就把停用冲掉,所以四个入口(两张实体 × 两条闸)都要有。
停用判定排在到期之前:被停用的账号不该先收到续费提示。
2026-10-09 14:55:08 +08:00
huangzd1997 3f5f081cb5 fix(登出): logout 此前只清 cookie——现写 machine 吊销标记且先于超管豁免
吊销必须挂在 assertSameDevice 之前:那条路径第一行就是 if (exempt) return;,
放它下面等于超管永不见吊销。也不能清空 machine(本类对空值是「尚未绑定=放行」语义)。
前缀避开 claude-*/e2e-*:users.machine 还被当测试号签名用。写值带 deviceId 做 CAS,
不把别处刚登录的新会话一起打死。
2026-10-09 14:48:11 +08:00
huangzd1997 d349bc1a7d feat(容忍): 在跑判定 countLiveWorkFor——三张表各带 15 分钟新鲜度、读失败 fail-closed
三段标量子查询相加而非 UNION(UNION 会因列级排序规则差异报 1271)。
清单口径来自生产 information_schema 普查而非扫迁移文件:后者实测恒漏报
(V1 建表列名不带反引号、老表 user_id 来自后续 ALTER、现网有 dump 重建漂移),
静默少报的尺子比没尺子更糟,故改为「登记的表必须出现在 SQL 里」的对照钉。
2026-10-09 14:43:47 +08:00
huangzd1997 3c86d7090f fix(鉴权): JWT 解析拆三态——过期但签名有效从此可与伪造区分
ExpiredJwtException 必须先于通用 JwtException 捕获,否则被后一个 catch 吞掉、三态恒退回两态。
parse() 保持过期→null 原语义(requireUser / currentDeviceId / checkLogin 三处消费者按 null 判),
本批 73 例含这三处既有测试全绿。
2026-10-09 14:35:26 +08:00
huangzd1997 49f786f30f feat(停用): V155 给 users 加 disabled_at——停用第一次有账号级载体
生产 users 只有 11 列、无任何状态列,expires_at 140 行全 NULL,所以停用既无字段可落、
也不能借 machine(那是测试号签名 + 互踢判定在用)。不复用 expires_at 塞哨兵:取消停用
会把收费到期日一起抹掉。两张 users 实体同批改,少一张就有一条鉴权路径读不到。

台账同步:文件数 153、范围 V1..V155、取号起点推到 V156
2026-10-09 14:30:57 +08:00
huangzd1997 b4b2fe2aa5 feat(MQ降级): 补可巡检的计数出口——task.file.job.mq.degraded 指标 + 8 例纯单元
§2 那行「保留回落本地 worker 的语义,但必须产出可巡检的计数出口,不许只有日志」的后半句
从没落地:三条降级出口全是 log.warn + return false,通知表与看板都不感知。

- MeterRegistry 走 ObjectProvider,取不到就按 null 兜住(与 ClientVersionGuardFilter 同口径),
  降级判定与 return false 语义一字未动 ⇒ 现网零行为变更;不新增 catch(CatchSilenceRatchet
  钉着四数,加一个 catch 就判红)
- reason 两支:template-missing(模板取不到)、send-failed(熔断打开 / 发送失败各计一次)
- 8 例含一条反向钉"正常发送时该指标 0 次 increment",防"无脑 increment"蒙绿;
  变异自证:摘掉 template-missing 那处 increment ⇒ 2 例红(expected 1.0),还原后字节哈希相等并复跑绿
2026-10-09 13:12:51 +08:00
huangzd1997 1553635124 feat(多公司): V154 摘去重库 company_id 的 DEFAULT 1,前置是 Java 侧归属闸门
- 只读取证(scripts/_probe_dedupe_default.py,主机A):哨兵四张表里只剩这张带 DEFAULT 1;归属分布 1=546,344 / 3=8,125,无 0 无 NULL,孤儿归属 0 行;写侧显式落值那版上线后真实导入 29,555 行(10-07 09:48→10-08 23:57)⇒ V152 第 6 段"先修写侧、上线并验证真实导入"的前提成立
- 关键差异:本表批量导入是 INSERT IGNORE,在 STRICT_TRANS_TABLES 下省略该列不会 1364,而是落成隐式默认 0(不属于任何公司、对所有公司隐形)⇒ 顺序必须是先上 Java 闸门再让迁移生效,反过来会把"静默归第 1 家"换成"静默归 0 家"
- DedupeTotalDataService.requireCompanyAttribution 接在两条写通道(create / insertImportBatch)上;新用例 4 例含接线钉(按行首语句数调用点==2,避开 javadoc 同名提及那个坑),反证:摘掉一处调用 ⇒ 1 红 BUILD FAILURE
- 迁移只有一条 ALTER COLUMN ... DROP DEFAULT(纯元数据、瞬时、可重跑);禁 MODIFY COLUMN 重建表那条禁令沿用 V144/V150/V152;回滚补丁在 Flyway 扫描路径之外
2026-10-09 11:58:43 +08:00
huangzd1997 603e08243f test(护栏基线): RETHROW 下限 388→387,出处点名到具体提交与方法
- 触发:pre-push 闸门拦下推送,CatchSilenceRatchetTest.fourNumbersMustNotGrow 报重抛 387 < 388
- 查证:6aa4f821「摘 13 处零引用私有方法」删掉 DeleteBrandRunService 一个无人调用的私有方法,其 catch 体是 throw new BusinessException(...) ⇒ RETHROW 形状随死代码离开;不重抛/只 log/空体三数未涨 ⇒ 没有一处"异常会往外走"被改回吞掉
- 所以是基线该跟着代码走,而不是代码该回滚;下调理由必须写成逐处出处,"总数变小了"不算——那种要看的是不重抛那一侧有没有涨
- 复跑:CatchSilenceRatchetTest 9 例全绿(BUILD SUCCESS)
2026-10-09 11:32:00 +08:00
huangzd1997 d1a3e8a214 fix(发布通道): 开机自检的用例不再依赖"测试 classpath 上恰好没有章"——这条前提每次正规出包都自己翻转
- 现象:mvn -o clean package 在 4138 例里报 1 红 BuildInfoLoggerTest.开机自检在没有章的classpath上会打missing(expected WARN but was INFO)
- 根因:发版通道要求打包前 _git_stamp.py write,写出的 git.properties 就落在 src/main/resources 下 ⇒ 监听器读到章念 INFO,用例的"没章"前提没了。等于"正规出包必红"
- 修法不是放宽断言:给 BuildInfoLogger 加 logOnBoot(Resource) 接缝,用例显式喂"不存在的资源名"(缺章必吵,级别仍是断言主体)
- 另加一条接线对撞:无参监听器读的资源名与字面量 git.properties 逐一比对——常量改名时监听器念"无章"而字面量仍读到章 ⇒ 红(两侧都用常量就永远测不出来)
- 两态各 9 例全绿:章存在(正规出包态)与章不存在(开发态)
2026-10-09 09:34:18 +08:00
huangzd1997 65b40e5cc0 fix(多公司): 站点超管不替别家公司建下级账号,admin 候选与首任管理员都收在本公司
- AdminUserService:建号前两道不变式——ensureSubSuperAccountStaysWithOperatorCompany(超管只能往别家开"那家的公司超管",往下的组长/员工一律 403)+ ensureCreatorSharesCompany 提成执行体(created_by_id 与 company_id 不得分属两家,超管是唯一豁免),建号与移人共用一份,避免"另一侧照样落库"
- 列表侧 admin 候选按 companyIdFilter 过滤:全平台列 admin 就是"admin 替别家建账号"的入口
- ShopManageController 同步一处;配套 AdminUserServiceCompanyTest 9 例(本机 mvn -o test 19 例全绿,含 PublishBrandLabel/PublishWorkbook 两支)
- 前端 CreateUserDialog/GroupEditorDialog/UsersPage + 两个 model 与 types 随之收口,新增 company-user-create.test.ts 61 行用例
- 注:这批改动原为另一路会话在飞文件,按用户"所有的都提交推送"指示收口,提交前已跑其自带用例
2026-10-09 09:11:30 +08:00
huangzd1997 39fc5d537f test(护栏): 把"三类静默出口必须含 throw 或锚点"做成真判据,缺口 11 处/10 文件钉成只许减
§2 后端「静默出口成片」那行的断言写了两件事,尺子只实现了棘轮那一半就一直按达标计;
而 SilentCatchScanner.Site.hasAnchor() 是死代码、零调用者 —— 工具造好了但没接进判据。

- threeCategoriesMustRethrowOrCarryAnchor:按文件逐处点名 GAP_LEDGER(11 处/10 文件,
  Java 扫描器与一份独立 Python 普查对平:26 候选 / 15 带锚点 / 11 缺口),只许减。
  台账空即判红("一处都没扫到"与"确实一处都没有"必须可区分)。
- anchorAndThrowBothCloseTheGapOnlyWhenActuallyPresent:内存注入自证 —— throw 放过、
  带 [silent-degrade] 放过、两者都没有才记缺口,无关类别连进名单都不许进。

缺口里 8 处是逐行失败路径(把失败写进结果项,没有日志):往那儿加 log.warn 就是 10-07
通知放大的同族事故(逐行 × 每任务 × 扇出 16 人),所以本轮只做实判据、不硬塞日志。
锚点正则只认 ASCII \[[A-Za-z0-9_.-]{3,}\],任务书写的 [静默降级] 匹配不上,约定改为
[silent-degrade],命名偏差记在任务书 §2。

mvn -o test -Dtest=CatchSilenceRatchetTest:Tests run 9, Failures 0, Errors 0。
2026-10-09 02:10:48 +08:00
huangzd1997 233182b0c5 fix(上架品牌): 清洗挪到 biz_publish_item 唯一写库出口,回传重插不再灌回脏值
上一笔 15e04511 只堵了服务端解析 Excel 那一个入口。现网取证(10-09 01:3x,主机A 业务库)显示
脏值有两个来源:7 个脏值任务里 5 个的行创建时间等于任务完成时刻,即任务完成时
PublishTaskService.replaceRows 用客户端回传的分片整表删后重插写回的路径。也就是说每完成一个
上架任务,"Brand:" 就会从回传值里再落库一次,存量清洗会被自己顶回去。

改为:新增 PublishBrandLabel 作为标签正则的唯一持有者,insertRows 写实体前清洗(replaceRows
与解析路径都汇到这里),PublishWorkbookService 删掉本地那份正则改为委派。

配套 PublishBrandLabelTest 5 例:标签形状与反例("Brands: NIKE"、"Super Brand: Nike"、
"Brand: NIKE: X")、publish 模块内 entity.setBrand 出口必须走清洗、全模块只允许一份标签正则。
四条变异实跑全杀(去锚 / strip 原值返回 / 出口不清洗 / 解析层另抄正则);publish 相关
11 个测试类 101 例在独立 worktree 跑绿。
2026-10-09 02:04:16 +08:00
huangzd1997 97ca6810f7 fix(护栏自证): 切片桩不冒充产品端点;版本闸门少一处异常控制流,把 catch 棘轮记回原基线
把这期后端护栏类并进"实跑档"以后,一次 mvn 就当夜逼出两处真红。两处都是测试件/我自己
上一笔提交的问题,不是产品逻辑错,但都必须改代码而不是改基线:

1) 上一版切片的桩控制器写了 GET /api/admin/users,与真 AdminUserController#listUsers
   撞在同一条完整映射上。MappedPathProbe 把整棵 main 树的映射枚举进同一个
   RequestMappingHandlerMapping,于是 ApiGuardCoverageBreachTest 先炸 Ambiguous mapping
   (2 errors);把桩路径改成 /api/client/slice-ping、/api/admin/slice-probe 后又暴露第二层:
   测试桩本身被当成"新增未设防端点"进判定 ⇒ 探针改为不登记测试夹具里的控制器
   (按最外层类名 Test/Tests/IT 排除,main 树里这种命名的真控制器实测 0 个)。
   分母守卫照旧有效:mapped.size() > 300 那条断言仍在,排掉桩不会把清单清成空的。

2) CatchSilenceRatchetTest 红的是我自己 9d762c55(20:25 提交)里那处
   `catch (NumberFormatException overflow) { return null; }`:total 1002→1003、
   不重抛 559→560。也就是说**那笔提交是带着一支红的护栏类交进去的**——上一轮我只把切片
   纳入实跑分母,没把这支棘轮一起跑,所以"7 例绿"的读数过期了。
   修法不是抬基线:版本号的单段长度超过 18 位本来就该按"判不出来"处理,于是用
   MAX_SEGMENT_DIGITS 上限替掉 try/catch,判定走向逐字不变(仍是 return null ⇒ 不拒),
   total 与不重抛都记回 1002/559,验收基线一格没动。RETHROW 下限 388、logOnly 172、
   empty 56 三档本轮都没碰。
   顺手改掉失败文案里的错算式(原写"= 验收基线 1000 + 1 处",实际那 2 处各自有出处)。

版本闸门本身仍未上线(现网 jar 是 12:3x 那版,9d762c55 在 20:25)⇒ 本改动零现网影响。

实跑:mvn -o test -Dtest=ClientVersionGuardContextSliceTest,ApiGuardCoverageBreachTest,
ApiGuardCoverageAuditorTest,ApiGuardCoverageAuditorWiringTest,CatchSilenceRatchetTest,
ClientVersionGuardFilterTest,BuildInfoLoggerTest
⇒ Tests run: 53, Failures: 0, Errors: 0 / BUILD SUCCESS(逐类 6/10/8/2/7/12/8)。
2026-10-09 00:23:14 +08:00
huangzd1997 4e154e5318 test(后端切片): 不连库的 @SpringBootTest 装配切片,把 §2 那个 "0 例进容器" 变成 1
四面 9 分任务书 §2 后端一行的实测是「@Test 4035、@SpringBootTest=0、@MockBean=0」——
纯 mock 写法证不到两件版本硬地板的前提:properties 里的 aiimage.client-version.* 能不能
绑进闸门(@Value),以及闸门作为 bean 会不会真被挂进 servlet 过滤器链。任一件坏掉,
4,035 例照样全绿,现网是"闸门写了但没生效"。

本支切片把这两件事变成实跑判据:真容器 + MockMvc + 真实的 SecurityConfig 一起装,
不扫描业务包、不加载 DataSource/MyBatis/Redis/RocketMQ,所以本机无 Docker/无 MySQL
也能跑(任务书要的正是这个形状,真库用例一条都没写进来)。

踩到并写进注释的一个形状坑:一开始没装 SecurityConfig,切片落到 Boot 默认安全规则上,
POST 被 CSRF 打成 403、GET 被匿名打成 401,闸门根本没执行机会——那种红绿都不说明任何事。
现网是 csrf disable + anyRequest permitAll,闸门 @Order(LOWEST_PRECEDENCE) 排在它之后,
所以必须带上真实那一层,切片跑的才是同一条链。

实跑:mvn -o test -Dtest=ClientVersionGuardContextSliceTest ⇒ Tests run: 6, Failures: 0,
Errors: 0(本机 Java 21,无 Docker)。

变异自证(三刀,逐轮还原后 sha8=763e30cd 与原始字节相等并复跑 6/0/0):
  地板 4.0.40→4.0.1        ⇒ 1 例红(@Value 确实在从 properties 取值)
  @Import 摘掉闸门          ⇒ 2 failures + 1 error(闸门确实是容器里的,不是测试 new 的)
  enforce=true→false       ⇒ 2 例红(记账档与拒绝档真由属性决定)
没有这三刀,"6 例绿"和"6 例恒绿"是同一个读数。

覆盖面如实收窄:这一支只守版本闸门一例装配,鉴权拦截器/幂等闸门还没进容器,
不是"容器化已铺开"。本文件是纯测试,现网行为零变更。
2026-10-08 23:53:10 +08:00
huangzd1997 15e0451191 fix(上架): Excel 品牌列剥掉 Brand: 标签前缀,止住脏值进 biz_publish_item
biz_publish_item.brand 实测 3,001/34,697 行以 "Brand: " 开头,是这批值流入
品牌检测后成批失败的源头(同一 payload 从工作站直连复现:value="NIKE" 回正常
密文,value="Brand: NIKE" 回 undefined field Brand)。上架 Excel 解析入口
toRow() 此前把第 4 列原样收下,normalize() 只处理空白,标签前缀就此入库;
用户再把这些行导出去做品牌检测,整单被 WIPO 按 Solr 字段限定符拒掉。

只剥开头一次:值中间的冒号属品牌自身内容,"Brands:" 也不是标签——测试里这两条
是排他断言,打死「无条件砍掉开头若干字符」的写法。存量 3,001 行的清洗属生产写,
未包含在本提交内。
2026-10-08 22:57:55 +08:00
huangzd1997 85b6bdd152 fix(产品风险结果文件): 表头样式改在 SXSSF flush 之前施加,大结果集不再永久卡死
现网证据(10-08 19:42,biz_task_file_job):job 21603 / task 30219 / user 983 的 ASSEMBLE_RESULT
FAILED,error_message 是 `generate product-risk excel failed: Cannot invoke
"Row.getCell(int)" because "headerRow" is null`,retry_count=5 全是同一个错;
10-07 20:55 的 job 21549 是同一条错 ⇒ 不是这次重启弄的,是早就存在的确定性缺陷,只是没人归因过。

机制:SxssfWorkbookWriter 用的是 SXSSF(流式,行访问窗口 200)。
`writeWorkbook` 在把整批数据行写完之后才 `applyDetailHeaderStyle(sheet.getRow(0), detailStyle)`,
而数据一超过 200 行,第 0 行早被 flush 出内存,`getRow(0)` 回读到 null,逐格取样式就 NPE;
外层 `catch (Exception)` 把它吞成一条业务失败文案,于是**结果集小的任务正常、大的永远出不来文件**,
任务一直挂 RUNNING。所以这条 bug 只在行数跨过分界时出现,跟数据内容无关。

修法是把那一次表头样式施加挪到写数据之前(createSheet 刚建好第 0 行,必然在窗口内),
一行位置变动,样式范围(6..8 列)与语义都不动。

验证:先写复现用例(260 行 > 窗口)⇒ 红,且报错文字与现网逐字一致;挪位置后 5/5 绿、
`ProductRiskTaskServiceTest` 5 例同绿(共 10 例 0 红)。变异自证 3/3 被杀:
M1 把调用挪回循环之后(生产原样)1 红、M2 整行删掉调用 1 红(断言同时钉住"样式还在",
不许只钉"不抛异常")、M3 把 6..8 悄悄缩成只第 6 列 1 红;三轮还原后文件哈希
`68c32f8ef2c0` 与注入前逐字节一致。
2026-10-08 20:53:27 +08:00
huangzd1997 9d762c552a feat(版本硬地板): ClientVersionGuardFilter 双模式闸门,默认惰性+只记账
口径出处:四面 9 分文档 §2 后端最后一项。此前全仓唯一的 minClientVersion 在 digitalhuman
里,且 DigitalHumanVersionService:86 写入、:258 读出两处都是**透传**,全树没有一处比较过它
(grep getMinClientVersion 只有这两处命中)——对桌面客户端 API 面零约束。

新增 backend-java/src/main/java/com/nanri/aiimage/config/ClientVersionGuardFilter.java:
读 X-Client-Version,与 aiimage.client-version.min-supported-version 比较,三档开关:
- min 留空(默认)= 闸门整条惰性,逐请求等价于没装;
- enforce=false(默认)= 只记账:Counter aiimage.client.version.floor{verdict,version,enforce}
  + 每个 (verdict,version) 至多一条 [版本地板] WARN(日志去重不吞计数,与 10-06 通知放大同口径);
- enforce=true 才拒,响应体沿用项目约定 HTTP 200 + {success:false, code:4012, message, data}。
另有一条 reject-unreported=false:4.0.46 及更早的装机不知道有这个头,光翻 enforce 就把它们
判死等于用一次配置变更打停全线存量,所以"未上报"默认只进 unreported 桶;报不出格式的
(4.x.6)永不拒。

受管前缀**复用** AdminApiGuardFilter.USER_TOOL_PREFIXES(同一份"桌面客户端直连的用户态前缀"
口径,改成包级可见,不复制清单),另补 /api/client(取凭据第一跳)。/api/version/** 明确不在
名单内——被拒的老客户端必须永远能拿到升级信息,否则闸门把自己变成砖。

ClientVersionGuardFilterTest 12 例(mvn -o test -Dtest=ClientVersionGuardFilterTest:
Tests run: 12, Failures: 0, Errors: 0):两种模式各钉一条正断言(记账必须"响应体一个字节都
不许多"、执法必须"chain 不前进"),另钉默认态零行为、三类非客户端面零判定、unreported 与
unparsable 分桶、名单逐条继承 + 三个排除项、版本解析/比较边界(4.0==4.0.0、4.0<4.0.1、
4.0.46.2>4.0.46、v4.0.6/4..6/4.x.6 判不出)、WARN 去重与计数不相干、min 配置写坏时不拒任何人。

不出包、不重启、不改任何 yml(默认值即现网态)。
2026-10-08 20:25:59 +08:00
huangzd1997 a24d7b9bac fix(客户10-08): 分组名收到同公司唯一、去重按分组写不再 403、登录态失效前端会真退出
付费客户「先锋-团队」一次报的四件事,根因各自独立,这一版一起收:

1) 去重数据汇总「新增导入」选自己公司的分组提交必 403。DedupeTotalDataService
   .resolveAccessScope 给 company_super_admin 时只开了 wholeCompany 那一支、groupIds
   留空集,而写侧闸门 resolveWritableGroup / ensureImportTaskAccess 只认 allUsers 与
   groupIds——读侧宽、写侧窄,表现就是「下拉选得到、提交就 403」,且 403 是 HTTP 状态
   不是中文文案,前端只能显示 Request failed with status code 403。改为同一口径把本公司的
   分组 id 一起带上(src/main/.../DedupeTotalDataService.java:86,104,112 + 注释)。

2) 「暂无分组」与「分组名称已存在」是同一行的两面:老「先锋」的组长 uid=1188 已被删,
   分组 id=33 成了孤儿行,仍占着全平台唯一的组名;而 list() 只按 created_by_id 筛,
   这一行被每一个公司的 tab 静默排除(生产 13 个分组里 2 个组长只落在旧列 user_id 上)。
   V153 给 biz_shop_manage_group 加 company_id(建组按组长定死、改名按组长当前公司纠回,
   顺手治「移人」造成的落值漂移),唯一键换成 uk_company_group_name(company_id, group_name),
   先 ADD 后 DROP。校验收窄到本公司,文案也从「分组名称已存在」改成「本公司内已存在同名分组」。
   MySQL 唯一索引里 NULL 互不相异 ⇒ 迁移上线后 (NULL,'先锋') 不挡 (3,'先锋'),
   客户当场就能建组,不需要先清那两行孤儿数据。

3) 删号/凭证过期后「软件还能用、没有强制退出」:前端 http 拦截器只认业务码 4011(互踢),
   JWT 过期或被拒返回的 401 一路静默,页面停在原处。新增 handleSessionExpired(),
   401 与「code/status=401」都清本地登录态并跳 /login?expired=1;匿名 401 不收口
   (那是常态噪声,且没登录态可清)。403 仍不触发下线——那是权限缺口,不能说成登录坏了。

4) 互踢(客户要「支持同时登录」)走配置不改码:AIIMAGE_AUTH_SINGLE_DEVICE_ENABLED=false,
   开关只有 3 个消费点、OFF 支已有用例钉着。这里只把公司超管的角色串收成
   DeviceSessionPolicy.COMPANY_SUPER_ADMIN,并记下它 src/main 仍有 22 处手抄比较
   (SuperAdminPredicateSingleOutletTest 那支绊线只管 super_admin,别以为它也在守这一串)。

⚠ 本提交带着并行会话 10-07 那批分组公司归属校验一起上线(ShopManageGroupService 的
ensureLeaderSharesOperatorCompany / resolveMembers 公司校验等,约 58 行):HEAD 里这个类
连 companyScope 字段都没有,我的写侧代码压在同一处,逐 hunk 拆不出「纯本批」的一版,
拆出来的也编不过。他那支 ShopManageGroupCompanyScopeTest(5 例)一并收了,否则这 58 行进仓
却没有用例。他的 ShopKey*/AdminUserService/admin-frontend-vue 账号页那批一个字没动,仍在
工作树里等他自己发。

验证:mvn -o clean test 全量在 detached worktree(HEAD + 本批白名单)跑;定向 8 支类 61 例 0 红;
shopkey+dedupe 整包 130 例 0 红;本批判据变异自证 6/6 被杀(每轮还原后与注入前哈希逐字节一致);
前端 node --test 21 例 0 红、变异 3/3。回滚:jar 单独回退即可,V153 的手术式回滚见
backend-java/docs/rollback-V153-shop-manage-group-company-id.sql(不要 DROP COLUMN,它是资产)。
2026-10-08 19:04:51 +08:00
huangzd1997 6d835e947e feat(店铺密钥): 筛选改走服务端、新增认当前 tab,操作列不再裁掉删除
三家公司的密钥挤在一页上,而"筛选"是拿当前页那 10 行在前端筛的:total 不动,
第 2 家的令牌要翻到它所在页才筛得出来。操作列给 160px 装不下三颗按钮,
最后一颗(删除)被 td 的 overflow:hidden + table-layout:fixed 整颗裁掉——
DOM 里在、事件也在,就是看不见点不到,这就是"没有删除功能"的真相。

- GET /api/admin/shop-keys 新增 keyword / token / whitelist_status,在公司读范围之内
  由服务端筛。keyword 那组 OR 必须括起来:不括就被后续 AND 短路成
  「备注名命中 OR (账号命中 AND 本公司)」,第 2 家的 tab 能读到第 1 家的令牌。
- create 的归属改为过读门(认当前 tab),不再只认操作者会话那一家。
  读认 tab、写认会话=两把尺子:admin 是 super_admin 且 company_id=1,
  他在别家 tab 点新增会"提示已新增、行却落进米椿花名下",再点一次就撞令牌唯一键。
  这一条推翻 10-06 定案,controller 的反向钉子(create 不许碰读门)同步换成
  「tab 必须过门 + 不许把请求原值直传下去」。
- 操作列 160→270px,.ops-cell 补 flex-wrap: wrap,把"超宽=静默消失"退化成"多占一行";
  同族结构隐患一次扫过 8 个页面(宽度够不够是像素账,会不会消失是结构账)。
- 护栏:ops-cell-must-wrap 钉跨页结构,shop-key-filter-params 钉参数下发与列宽;
  source-pin 棘轮补第二把尺子 reads=全文读点(体内+体外),
  pins 降而 reads 不同步降=把 readSource 挪出用例体冒充改进,当场红。

验证:将要提交的树(HEAD + 本批白名单)在独立 worktree 实跑——前端 1762 例 0 红、
vue-tsc rc=0、Java 41 例 0 红且 959 主源 + 498 测试源全量编译过(证明不依赖并行会话
未提交的符号);主树全量 1766 例 0 红。变异自证三支全杀:摘掉一页的 flex-wrap ⇒ 恰好
1 红点名该页;把体内读盘挪进 helper ⇒ 棘轮 1 红且文案点名"不算改进";
归属退回按会话、controller 绕门直传原值 ⇒ 各自红。
2026-10-08 18:39:19 +08:00
huangzd1997 520044c8a4 feat(取证): 开机自报这份 jar 出自哪笔 commit
制品名自始没 bump 过(aiimage-backend-0.0.1-SNAPSHOT.jar),pom 也没有 git-commit-id,
所以出问题时光看线上机器答不出"在跑的是哪版代码"——10-07 那次是靠"哪个类只有那笔才有"人工认的。

不用 git-commit-id 插件:现网出包是 mvn -o 离线,新插件当场解析失败,等于给发布通道加一根
只有联网才通的管子。改成打包前由 scripts/_git_stamp.py 生成 src/main/resources/git.properties
(已加进 .gitignore,入库就成孤儿构建产物,target/classes 里那个孤儿 V148 就是这么来的),
开机念 [build-info];念不到时打 [build-info-missing] 而不是静默当干净构建。

拒绝的职责不在这里:一个元数据文件读不到不该把在跑实例打死,那是发布闸门的事。
2026-10-08 17:36:32 +08:00
huangzd1997 305441b0bd feat(护栏): catch 静默形状做进代码出口 + 待处理行缓冲不再谎报"已暂存"
整棵 src/main 有 1002 个 catch 块,其中 559 个不重抛、172 个块内只有 log、55 个空体——
约三成是"记一条日志就往下走"。这没法一次清扫,先把形状钉成只许减的棘轮:扫描器自己数分母,
并与一把独立口径(原始文件里 "catch (" 出现次数)逐文件对平,两者不等就红——词法若把真代码
当字符串吃掉,total 会变小而"≤ 基线"照样绿,这一步就是防那个。

两处按三类高危出口点名改成重抛:待处理行入缓冲失败原先静默返回,等于向调用方谎报"已暂存",
装配阶段少这一行却照样把任务标成 SUCCESS;取 pending 行数失败原先返回 0,而 0 在调用方眼里
是"缓冲区空了",真实含义是"Redis 没答话"。

RETHROW 那一格刻意钉成下限(388)而非上限:把吞异常改成重抛会让这一格上涨,钉成"只许减"
就等于拦住别人做正确的事。
2026-10-08 17:36:22 +08:00
huangzd1997 f325f88bc3 feat(护栏): 鉴权覆盖审计从"只 WARN"升级为增量即拒绝启动
SecurityConfig 是 anyRequest().permitAll(),方法级 require* 只有 82 处对 401 个 handler,
所以"某个端点没被任何守卫前缀覆盖"这件事只能靠启动自检发现。审计器原先对 uncovered 只打一行
WARN,等于谁忘了登记也不会有人被打断。

改成:存量 uncovered 落 29 条快照进版本控制,profile=server 下**增量**非空即 IllegalStateException
(锚点 [api-guard-coverage-breach])。只拦增量、不拦存量,是为了不重演 10-07 那种"两台起不来"的
41 分钟宕机;判 server profile 复用 JwtService 的同一口径,不另立一套。
2026-10-08 17:36:10 +08:00
huangzd1997 419ab3be64 refactor(SQL分层): 剩余 85 条注解 SQL 全量迁进 mapper XML,等价性改由 MyBatis 自己判
96 条语句现在全在 src/main/resources/mapper/<模块>/ 下,注解侧 SQL 归零;判据从"基线清单"
改成完成态(逐接口必须为 0 + XML 语句总数 96 + 反向钉:XML 有则注解必须无)。

搬法上踩实了一个坑:注解参数是 Java 表达式("…" + CLIENT_MODULE_TYPES + "…"),
用只认字面量的抽取器搬家会把常量整段吞掉——上一轮生成的 26 份 XML 里因此出现
IN ()、AS status 前面没有表达式(MySQL 语法错),<script> 形态还被多转义一次变成 &amp;lt;。
更糟的是当时"搬迁前快照"与 XML 由同一个抽取器产出,两边一起错所以逐字比对全绿,
抓到现场的是既有的语义用例(TaskCenter 15 条 + 店铺查重那条断 <> 的)。

所以 MigratedSqlEquivalenceTest 改成:账本存注解原文,Java 侧现场用
getDefaultScriptingLanguageInstance().createSqlSource 编译原文,与 XML 解析出的
MappedStatement 各渲染一遍 BoundSql 对撞(空参数 + foreach 喂满 2 元素各一次),
转义对不对由 MyBatis 判定而不是由生成器判定;账本自己再钉 <script>/<if> 成对、不许出现 IN ()。
resultType 那一支不变:期望值由接口签名反射反推,66 条分母钉住。

取数入口跟着换:6 支原本读 @Select 注解的守卫(TaskCenter/Dedupe/店铺查重/通知保留/
鉴权形状/后台扩权)改走 MapperXmlSupport,断言内容一字未动;后台扩权那条"不许有 wrapper
投影"从全文 doesNotContain(".select(") 改成只扫可执行行——接口里现在只剩签名,
而 javadoc 正写着"别用 selectList(.select(...))",全文判会被自己的注释喂饱。

隔离树全量 4059 例 0 红(基线 4054,+5 为新增等价性与 XML 用例)。这批要生效得随下一版 jar 发版。
2026-10-08 12:00:43 +08:00