Commit Graph

159 Commits

Author SHA1 Message Date
huangzd1997 b963561043 fix(cr2-frontend): 代理归属回退、换号继承确认与请求竞态收口
- CR-04:全局代理加 proxy_uid 归属,跨账号不再静默回退/补报
- CR-12:取消静默继承,设置页显式确认;同 OS 作用域、locked 代理排除、无效快照清除、uid+epoch 双校验、登出 capture 超时
- CR-26/27:关键词分页初始值与档位一致;两页面请求序号闸丢弃旧响应

vue-tsc 两前端 rc=0;定向 35 + 8 + 2 例全绿。
2026-10-26 11:33:37 +08:00
huangzd1997 8323245567 fix(secrets): 同机换号继承上一账号的密钥与代理
A 号在桌面端配好密钥后登出,B 号登录时服务端与本地都缺这些配置,
任务只能整批失败。现在登出前把当前账号的明文密钥与代理存进本机
app.json,B 首次加载时只补服务端空缺的模块(fill-only,后台锁定的
代理不覆盖),并写回 B 的本地镜像与 proxy_users;检测状态不继承,
设置页提示逐项点「检测」确认。

同时修掉登出顺序反了的问题:原来先移除 uid 再清镜像,镜像键带
uid,实际删的是 uid=0 的键,A 的明文镜像会留在本机;换号/会话过期
后内存里的 A 明文也会被 B 继续读到。现在先留快照、再清缓存、最后
移除 uid,并在 uid 变化时作废旧会话缓存、给在飞的加载加 epoch 栅栏。
2026-10-25 22:37:13 +08:00
huangzd1997 e265c188f7 fix(appearance-patent): 代理缺失回填与任务前置提示
- 本地代理回填兼容旧版全局 proxy_url,补报成功后重拉服务端快照
- 创建任务前检查服务端代理,缺失时弹窗拦截并引导配置
- 商标查询失败的真实原因写入结果原因列,不再只显示查询失败
2026-10-25 21:28:26 +08:00
huangzd1997 813bed66a3 fix(前端): 代理IP共用弹窗改为精简口语文案 2026-10-25 00:46:29 +08:00
huangzd1997 445a7dfbd5 fix(前端): LLM 密钥共用不再弹窗,仅代理 IP 共用弹通知 2026-10-25 00:40:07 +08:00
huangzd1997 f93e7d95fc fix(前端): 密钥共用提示不再常驻界面,只走通知与铃铛 2026-10-25 00:17:25 +08:00
huangzd1997 bc818eb3ea fix(frontend): 外观专利当前任务区补下载入口
结果文件已生成时「当前任务」卡片只有删除按钮、下载只挂在历史弹层,
用户误读成"失败了不能下载"。现与历史区共用同一 canDownload 判据
(只看文件不看任务状态),并加防回归用例钉住判据不得掺入状态。
2026-10-24 16:35:39 +08:00
huangzd1997 ccb30aa99e test(frontend): 端点快照补 costGuard 两项,catch 棘轮 blocks 按实扫记到 300 2026-10-24 14:25:00 +08:00
huangzd1997 b94555f411 feat(frontend): 客户端损耗保护弹窗与共享密钥提示
- 30 秒轮询损耗状态;暂停时红色弹窗/横幅并提供「继续任务」
- 共享密钥黄色提示条,按类型去重,不重复刷屏
- 通知铃铛登记 cost_guard / secret_shared 场景
2026-10-24 10:50:24 +08:00
huangzd1997 634fefbc2f revert(common-tools): 回滚常用工具分类与三个工具页
按 2026-10-24 决定整体下线:工具目录分组、定价换算/五国ASIN/关键词共享
三页面与路由、资料下载区与测试全部移除;保留 package.json 的 test:mount
脚本(仓内测试基础设施,与后管同口径)。
2026-10-24 01:43:45 +08:00
huangzd1997 e36d363c57 fix(common-tools): 资料下载改挂站点 /static/ 静态位
/materials/ 是不在发布白名单里的新目录,deploy_app_web.py 只上传
index.html+assets+/static/ 清单 ⇒ 上线即 404。改走既有 /static/(nginx 已配),
发布清单在 ops 仓 deploy_app_web.py 同步登记 4 个文件。
2026-10-23 23:38:03 +08:00
huangzd1997 8fcf041a4e test(common-tools): 定价换算与五国ASIN页挂载冒烟测试
补两页的行为覆盖:换算四值与站点切换清空、资料下载/常用链接出口形态、
ASIN 规范化与域名随国家切换、位数不足报错并禁用打开按钮。
2026-10-23 23:08:23 +08:00
huangzd1997 de4465730f fix(common-tools): 关键词共享按后端真实返回接统计四段与日志字段
/stats-grouped 是四段各自 GROUP BY(对齐桌面版弹窗),前端原先按
「国家×一级类目」交叉表建模 ⇒ 弹窗恒为暂无数据;/logs 返回 userName/time
而表格读 operator/createdAt ⇒ 两列恒为占位符。改为 API 层映射 + 四段渲染,
日志去掉后端不产出的「说明」列。
2026-10-23 23:00:33 +08:00
huangzd1997 b5d08ed77e feat(common-tools): 定价换算页补常用链接与资料下载区
链接清单与桌面版资料页同源(2026-10-23 实测可达),4 个资料文件随
public/materials/ 部署(目录名避开 .gitignore 的 downloads/ 规则)。
2026-10-23 22:38:06 +08:00
huangzd1997 208583e14c feat(common-tools): 工具台新增常用工具分类,三个桌面工具网页化
- tool-catalog 最前插入「常用工具」组(brand_common_tools,23 工具·4 大分类),
  三工具各自权限键:pricing-calc / five-asin / keyword-share
- /pricing-calc:站点(英 GBP÷9、德法 EUR÷8)+ 买货价/运费 → 营业额/利润/
  利润率/换算汇率,公式与精度照抄桌面版,纯函数 node --test 钉住
- /five-asin:五国常量 + ASIN 10 位校验 → 亚马逊商品链接,window.open 与
  :href 出口全部过 safeHttpUrl(url-outlet 棘轮),邮编一键复制
- /keyword-share:筛选/四级类目级联/统计卡/表格分页 200/标记与取消使用/
  添加/删除/随机抽词/共享记录,对接 keywordshare 后端九端点
- 顶栏与 BrandTopBar 导航同步;router 注册三路由;补 test:mount 脚本
  (vitest mount 套件入口,与后管同口径)
2026-10-23 21:56:56 +08:00
huangzd1997 58c40b6695 fix(brand): 更新后「在跑的任务列表」不再静默变空——桥迟到自动重试、拉取失败不删本地态
现场(用户 2026-10-22):点「立即更新」→ 闸门确认并等待 → 进程被 update.exe 替换、
WebView 整页重载。重载那一刻 pywebview 桥还没注入,getPywebviewApi() 返回的降级桥里
vc_ 方法数为 0,而变体采集页把「桥不在」画成「暂无变体采集任务」:loadTasks 四条出口
全是静默 return(无桥/并发中/无 uid/!success),空 catch 也一样;首拉只发一次,
60 秒轮询又被「列表里有活跃任务」反锁 ⇒ 撞空一次就永久空,除手点刷新没有出路。

另外两页是另一种"没掉":跟价 loadHistory 一次 catch 把列表清空,紧接的
syncPollingIdsWithHistory 把「history 没有 + 无快照」的 id 连 localStorage 快照一起删
(不可恢复);商品风险同型且更狠,连快照豁免都没有。更新的几十秒里进程已退、
新进程未起,任何一次 /history 失败或 401 都踩得到。

改法:新增 shared/bridges/bridge-list-state.ts(失败分类/可见文案/首拉重试驱动,
退避复用 getTaskPollBackoffMs,8 轮约 35 秒);变体采集页桥未就绪→重试到成功或次数
用尽,失败态写进空列表文案并给一次 ElMessage;跟价/商品风险加 historyLoadOk 守卫,
拉取失败不清列表、不结算、不删本地 id。静默 catch 棘轮 83→81(实测;本轮减 1,
另 1 处是此前台账未缩,已一并拉平并逐文件改小)。

门禁:npx vue-tsc --noEmit rc=0;npm test 905/905 全绿(含新增 7 例
tests/bridge-list-first-load-retry.test.ts,改前对旧代码真红)。
2026-10-22 20:53:44 +08:00
huangzd1997 aa7e17f95c feat(task-board): 手动刷新铺满全部 16 个任务面板页
用户点名「只要是任务的功能都要加上」:TaskCenterPanel 的 on-refresh 按各自骨架接线
——useLiveTaskBoard 两页强拉 history+dashboard+进度;手写 fetch 五页 allSettled
(history+dashboard+refreshTaskBatch);useHistoryPolling 三页 refreshTaskViews+活跃进度;
useTaskProgressLoop 两页加 progressLoop.refreshOnce;一次性拉取三页直挂各自 load 函数;
品牌检测复用既有 syncTasksAndResumePolling。接线守卫测试扩到 16 页。
2026-10-22 15:48:44 +08:00
huangzd1997 6d52b95d85 fix(task-board): 任务卡片假死自救——轮询失败退避重试+面板刷新按钮+补检轮进度文案
task 31769:外观专利任务后端 18:08 已 SUCCESS,但页面卡片冻在「正在组装 xlsx 92%」
一天多——Patent 轮询配的 propagate 让一次瞬时错误永久杀死轮询,且无自救出口。
- useLiveTaskBoard 摘除 pollErrorMode:失败一律吞掉重试,连续失败按倍数降频(封顶 5x)
- TaskCenterPanel 头部新增「刷新」按钮,外观专利/货源查询两页接上(强拉 history+dashboard)
- 补检轮触发时进度文案改「有 N 行未完成检测,补检中」,不再停在「正在组装 xlsx」假死
- 回归:AppearancePatentRecheckProgressMessageTest+task-board-poll-resilience.test.ts
2026-10-22 15:34:36 +08:00
huangzd1997 86d78160fd feat(通知): 四级严重度与严重度/时间双排序,客户端与后台管理同步
通知表新增 severity(紧急/高危/中危/低危,V161),由 scene + level 推导且
不回改 level:老客户端配色不受影响,secret_balance 的余量偏低与欠费也能分档。
列表与聚合接口默认按严重度倒序(同档按时间倒序),sort=time 切纯时间排序;
聚合组取组内最高严重度。两端铃铛加彩色等级标签与排序切换,展开明细沿用
同一排序,严重度排序下隐藏会跨天误导的日期头。
2026-10-21 13:33:07 +08:00
huangzd1997 f6aa04d0f2 feat(代理): 多套餐余量预警与用户级 jikip 套餐配置
平台自费池由单个 planId/userId 改为 planId:userId 列表逐套餐探测,
套餐余量或账户余额低于阈值时推管理员预警;用户可在密钥设置里为自己
配置多个套餐,巡检跟随密钥检查按用户查余量并推站内通知,欠费状态在
客户端右上角常驻提示(V160 新建用户级套餐表)。

同时把测试里写死的真实代理 key 换成占位串,避免凭证随仓库扩散。
2026-10-21 13:32:56 +08:00
huangzd1997 4f948a2510 fix(产品风险): confirm 弹窗的标题不再谎称「已阻止推送」
真机验收(本地起 vite+桩后端,用真组件跑到真弹窗)点出来的:checkQueuePayload 把
blockTitle/confirmTitle 传成同一个串,于是「仍然继续/取消」那种问句的弹窗顶着一句
「任务数据不完整,已阻止推送」——它一样东西都没阻止,用户读到的第一行就是反的。
checkParseResult 早就是两档分开(解析结果无法执行/解析结果需要确认),这里补齐。
调用方自带 title 时仍两档共用,不改既有行为。

顺带记两条真机读数:确认框确实拦住推送(弹窗开着时入队 0 次,点仍然继续才 1 次、
点取消则始终 0 次);「一个国家都没选」那条 block 在界面上点不出来——最后一个国家的
勾选框是 disabled、还会弹「至少保留 1 个国家」,所以 product-risk.no-country 只是
给恢复空快照兜底的防线,不是日常路径。
2026-10-20 01:26:19 +08:00
huangzd1997 715bc791dc fix(定时匹配): 入队前接上 dispatch-guard——只补缺键那道,在售不弹窗
上一轮给产品风险补闸时把这支记成「同源没改」。复算后拆成两半:
- 缺筛选值确实同源。match_action.py:371 判空那三行与 approve.py 逐字同形,
  拿到 '' 会去页面上找 value='' 的选项、必然 0 行、再以「没有需要审批的商品」
  正常收尾;这一支的两个推送口(手动启动、定时泵)过去一个闸都没接,
  缺 taskId/空店铺/NaN 也是原样推过去让任务卡在執行中。现在都过 checkQueuePayload。
- 「在售要签字」不成立:shopMatchListingFilter 的默认值就是 Active,这一支的主用途
  正是给在售商品匹配价格。套过去等于每天默认发起签一次字,只会教会用户闭眼点。
  所以缺键判据收进 listingFilters 共用,confirm 仍只归产品风险,问题码按支分开。

定时泵没人签字,只认 guard.ok 并抛错交外层如实报错,绝不弹窗。
新增 8 例(含两枚接线钉),并做过反例自证:把两处闸摘掉,接线钉当场判红。
2026-10-20 01:10:18 +08:00
huangzd1997 a97dbf7f1d fix(产品风险): 启动前拦掉缺筛选值,选到「在售」要用户签字
「商品列表筛选」是产品风险审批唯一的取数条件,但它只随本地队列下发、不建单落库,
选错了界面上不留任何痕迹(2026-10-17 陈先锋·德国站选成在售,白跑 7 小时)。

- listingFilters.ts 新增 productRiskFilterIssues:缺键/空串 = block(Python 端会拿
  空值去页面上找一个不存在的选项,整国以「没有需要审批的商品」假成功收尾),
  「在售」这类非风险状态 = confirm(不禁止选,但要让人知道自己选了它)。
- checkQueuePayload 开一个 extraIssues 口子给业务侧判据用:ok/needsConfirm 与
  「有 block 就不展示 confirm」这条规则仍只在 dispatch-guard 里解释一遍,
  不在组件里拼第二份结果。
2026-10-19 19:16:52 +08:00
huangzd1997 d22a9e2164 fix(采集数据): 终态卡片把关键词缺口写出来,而不是把进度条画满
task 31253 的「已完成 + 总进度 25%」被当成显示 bug 报上来,实际那根条是卡片上
唯一说真话的一格:8 个关键词只处理了 2 个。强制 SUCCESS 显示 100% 会把提前结束
抹平,所以这里反过来——终态却没跑完时在卡片上补一行关键词缺口。

判据单独放 src/shared/utils/task-progress-readout.ts:.vue 在本套件挂不起来,
留在组件里就没法真测。终态词表复用 task-terminal 那份,不自建第二套
(tests/task-terminal-set-single-source.test.ts 抓到过一次)。
2026-10-18 16:56:41 +08:00
huangzd1997 3e797ab159 feat(用户端): 摘掉跟价/查ASIN 勾选区的「清除勾选记忆」入口
代收在飞件落地(原作者那一路已不在跑,内容一字未改)。记忆的唯一出口改回"取消勾选本身"——
onSelectionChange 按当前窗口重算并写回 localStorage,红字清除按钮是第二条出口、两条会打架。
尺子随之从"必须有清除入口"反向钉成"勾选区不留清除入口与那段文案"。

⚠ 这条改动其实已随 app-web-20261017-161525 上线(迭代蓝图 §6 记的"整棵上线"带上的未提交件),
本笔只是把提交坐标补到现网实际行为之后,不是新发布。验证依据=同一轮闸门用户端 20 格全绿。
2026-10-18 09:52:54 +08:00
huangzd1997 e41ede74c3 fix(用户端): 相似同款列表不再拿结果行的 success 位当已完成
代收在飞件落地(原作者那一路已不在跑,内容一字未改)。`biz_file_result.success` 是
NOT NULL DEFAULT 1 的列——解析建行那一刻就是 1,只有正常收尾才回写;通用兜底判死只 UPDATE
biz_file_task、不碰这一列,于是被心跳超时判死的任务在前台仍显示「已完成」(2026-10-16 任务 31060:
客户端只回传 51/510 分片、结果文件从未生成)。改法=状态文案与颜色一律先认 FAILED 与
resultBuildFailed,完成判定走新增的 isCompletedTask(status)(SUCCESS/COMPLETED),不再看 item.success。

验证依据=闸门 ts=2026-10-18T09:49:23 用户端 20 格全绿(含 npm test 整量);新用例
similar-asin-fake-completed.test.ts 随本笔入库。
2026-10-18 09:52:54 +08:00
huangzd1997 53f302ea6d fix(跟价勾选): 兜底只喂载荷不许锁界面——在售必须能被取消
上线当天用户当场指出::checked 绑到了兜底值上,于是「先取消在售、再勾自己要的状态」
这条最自然的路劲走不通(取消最后一格立刻弹回在售)。改为勾选框只认原始勾选,
空勾选的在售兜底留在提交期(载荷/建单/摘要三处不变),界面不再替用户做主。
摘要在空勾选时明写「在售」的(一个状态都没勾=按默认的在售跑),显示与实跑一字不差。

新增用例钉住这两条:isListingStatusSelected 必须读原始勾选、不许再往事件目标写回 checked。
验证:price-track-listing-statuses 10/10、用户端整量 865 passed、vue-tsc 干净。
同文件另一路「移除清除勾选记忆」的在飞 diff 仍按 hunk 留在工作区未卷。
2026-10-17 17:35:28 +08:00
huangzd1997 a881aa3208 feat(跟价勾选): 默认只勾在售、一个都不勾=按在售跑不再拦启动、续跑先选在跑的那份循环
用户 2026-10-17 定口径。三件事:
1) 默认只勾在售、另两项不默认勾——本来就是现状,没动,只在用例里钉住;
2) 取消「一个状态都没勾就拦住启动」:不勾的语义就是上线前的「只跑在售」,拦它只会让用户
   以为跑不了。改为提交前经 withDefaultListingStatuses 兜底回在售,与客户端
   price_match_new.resolve_listing_statuses 同一口径,两边不许分叉。顺手补掉一个 Vue 坑:
   取消最后一格时 :checked 新旧值都是 true、Vue 不回写 DOM,不手动复位就会出现
   「框看着没勾、实际按在售在跑」的错位,故在 onListingStatusToggle 里显式复位。
3) 「会先选在跑的」:setLoopRun 首次拿到在跑循环时用其落库 listingStatuses 预填勾选,
   只在「之前没有循环在位」时填(免得轮询冲掉正在改的勾选),asin-only 循环与空清单不填。

orderListingStatuses/withDefaultListingStatuses 从组件里提到 listingFilters.ts 变成可直接
断言的纯函数,不再只靠源码正则。验证:price-track-listing-statuses 9/9、用户端整量
npm test 864 passed、vue-tsc --noEmit 干净。

本提交只含上述改动:同文件里另一路「移除清除勾选记忆入口」的在飞 diff 按 §1 铁律 4
留在工作区,没卷进来。
2026-10-17 15:59:20 +08:00
huangzd1997 e139978f04 feat(用户端顶栏): 右上角去掉所属公司名显示
按需求摘掉 AmazonTopBar 的公司名胶囊,连带清掉随之死掉的
readCompanyIdentity import / companyName ref / onMounted 赋值与 .company-name
样式(留着会被 tests/dead-code-cleanup.test.ts 的 vue-tsc --noEmit 判红)。
公司身份机制与 companyName 载荷一律不动——那仍是登录/多租户判断的输入,
只是不再在顶栏显示。

补 tests/mount/amazon-topbar-no-company.mount.test.ts 三条真挂载用例:
公司名不进 DOM、同框用户名照旧出现(防"挂载失败"冒充"已摘掉")、
readCompanyIdentity 仍读得到。已做反向证伪:把胶囊塞回去第一条即红。

用户端实测:npm test 862 例 0 红;npx vitest run 19 例 0 红;vue-tsc --noEmit rc=0。
2026-10-17 10:35:26 +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 11ad68eea4 feat(phase-4/5 用户端): 恢复巡店删除与指定删除ASIN两个功能页与全部表件
用户口径:这两个功能是随 fdaae3c5 连带删错(该退役的只有紫鸟新版/旧版选项控件),
本次按历史逐字找回并摘掉紫鸟引用。

- 页面:BrandDeleteBrandTab.vue(1740行) / BrandPatrolDeleteTab.vue(1370行) 从 fdaae3c5~1 找回,
  两页各摘 5 处 ZiniaoVersionSetting/useZiniaoVersion 引用与 1 个 ziniao_version 载荷字段
  (checkQueuePayload 只钉 taskId,摘掉不触闸;全树其余读点 0 处)
- 表件:router 两条路由、tool-catalog 18→20 工具与四条图标/详情、BrandTopBar 导航两条、
  endpoints 两块(deleteBrand 10 键 / patrolDelete 16 键)、progress-light 10→12、
  java-modules re-export、module-templates 联合、withdraw.ts 巡店段整文件找回(513 行,
  含两个 ProductRisk*Vo import)
- 测试面:9 支退役时改过的用例从 fdaae3c5~1 逐字找回(含 modules-delete-brand.test.ts 167 行/11 例)
- 自证:npm test 854/854 绿(基线 840+找回 14 例)、vue-tsc --noEmit 与 vite build 通过
- 未触碰他人在飞件:BrandSimilarAsinTab.vue / task-status-text.ts / similar-asin-fake-completed.test.ts

注:恢复后的三支大文件将顶破 ops 侧 readability 棘轮,基线随本轮在 ops 仓重锚并登记。
2026-10-16 20:04:40 +08:00
huangzd1997 fdaae3c560 frontend-vue 退役:删新版/旧版选项控件与删除品牌/巡店删除入口,用例族随实况收敛
- 删 ZiniaoVersionSetting.vue / ziniao-version.ts;9 个 Tab 摘 ziniao_version 载荷
- 删 BrandDeleteBrandTab.vue / BrandPatrolDeleteTab.vue 与 delete-brand 类型模块;
  路由、工具目录(20→18)、端点表、progress-light 模块(12→10)、withdraw.ts 巡店段、
  java-modules re-export 同步摘除
- 测试面:node --test 17 处红按实况收敛(端点冻结快照摘两组、适配器 16→14、窄集合台账
  摘两页、六页→五页、reexport/快照随实况),modules-delete-brand.test.ts 整文件删
- vue-tsc+vite build 通过;node --test 837/837 绿
2026-10-15 22:30:06 +08:00
huangzd1997 fa11db59ee feat(用户端): 低于 4.0.52 的桌面装机进强制升级遮罩——存量装机只有线上 Web 这一条覆盖通道
后端那个版本地板闸门只会把请求挡成 code 4012,客户端业务代码里没有任何 4012 分支:只拦、不推;
而桌面窗口直载 app-web(APP_URL = config.WEB_HOME_URL),做在页面上才吃得到已经装出去的机器。

判定落在 shared/client-force-update.ts(纯函数,17 例含"换地板结论就翻面"的反例):判不出来一律不拦
(浏览器形态、读不到本机版本、版本串解析不出数字、没有可下的包、线上包并不比本机新)。
遮罩挂 App.vue 根=登录页与首页一起覆盖,自动开始下载,失败只给"重试(断点续传)",不再等第二次确认。
2026-10-13 21:37:08 +08:00
huangzd1997 f68d1afecf refactor(通知): 铃铛面板状态机从 SFC 拆成独立一层——是上一笔把两个组件顶到可读棘轮 800 行上限的账,不是新功能
上一笔(5d2a1c69 通知聚合)推 origin 时被四面闸门连拒两次,两次都不是回归:
第一次是负载把 score_ratchet 的 py_case 挤成负数超时(单跑那格 18 秒绿,带 capture_output 复跑 24 秒 rc=0,
管道阻塞这条已排除);第二次读数清楚——后管 10 格红、客户端 48 格红,红的都是我这笔造成的:
① 可读棘轮按对象点名:后管 NotificationBell.vue 700→877 是"新增超长文件",用户端 1318→1439 是"比基线更长";
② 后管还有一把 vitest 挂载尺子(tests/mount/**,npm test 那个 glob 不递归 ⇒ 上一笔我漏跑了),
   它 mock 的还是单层列表接口,两级改造后 2 条判红——这条是我上一轮汇报里说"后管全绿"的假话,先认。

拆法按尺子自己给的那条路("要么拆,要么逐条点名改基线并写清是谁的哪一笔"):放宽基线要人拍板,所以拆。
只搬 script,样式一行没动——搬模板会把 scoped 样式的后代选择器甩在父作用域外,那是会改画面的拆法。
新层是纯 TS + 一个 composable:后管 src/layout/notification-bell-panel.ts、用户端 src/shared/composables/useNotificationBellPanel.ts,
组件只留面板开合、fixed 定位、外部点击关闭、60s 轮询定时器;行数 后管 877→652、用户端 1439→1213(台账点名的基线是 1318)。

这一层是纯函数,于是判据从"源码里有没有那行字"升级成"喂数据看返回值":
新增 tests/pure/notification-bell-panel.test.ts 两支(后管 9 例 / 用户端 8 例,走 vitest——这层要解析 @ 别名与 vue,
进不了零依赖的 node --test,两面 vitest.config 的 include 因此多收一格,注释同步改掉)。
覆盖:红点按组数、组内没读完不许减组数、下钻三维(主体为空改 IS NULL 旗标)、日期倒挂交换、
聚合页缺字段时的回落、换天才挂日期头、级别兜底、水位只在首页有数据时推进。
变异自证 6 条全 KILLED(A1 组数提前掉/A2 下钻丢主体/A3 天天挂头/D1 组数提前掉/D2 丢 IS NULL 旗标/D3 日期不交换),
还原按注入前内存字节写回并比过(admin 13790 / desktop 13115)。

三处台账跟着实况走,没有一处是放宽:
① 用户端 catch 棘轮 perFile:组件 3→0、新记 useNotificationBellPanel.ts=2,silent 总数 84→83(尺子的注释要求降了就一起改小);
   blocks 仍 299(搬动不改分母)。
② 后管 source-pin 台账:notification-bell-failure.test.ts 的钉子从 SFC 复指到新层,
   readSource 读点数不变(中途加过一枚"组件确实在用这层"的钉子,实测会把台账读点数抬上去,
   而这条已由挂载用例在运行时证 ⇒ 撤掉,不往只许减的台账里添)。
③ 后管挂载用例 4→6 例(补"点聚合行只展开不标已读""红点按组数""下钻带主体")。

验证=后管 node --test 1819/1819、vitest 21/21(12 挂载 + 9 纯函数)、真浏览器 e2e 10/10、vue-tsc rc=0;
用户端 node --test 834/834、vitest 16/16(8 挂载 + 8 纯函数)、vue-tsc rc=0;
ops 侧 test_readability_ratchet 9/9 绿(这条是上一笔红的因,现已解)。
⚠ scripts/tests 整量此刻仍 1 格红,红的不是本笔:scripts/tests/test_无声台账放宽闸.py 于 10-13 09:56 被另一路会话
扩写进 RD2 三记反例(3f55f3b),而配套 app_client/scripts/gen_silent_ledger.py 的 --check 还只判总数轴(那份 10-12 23:12 起没动)
⇒ 逐文件那一条轴此刻必然判不到,本笔不动别人的尺子也不替别人抬基线。
2026-10-13 10:38:34 +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 3d12689349 前端(任务卡进度条): 10 页接上实时进度,3 页没分母的显式写 null
后端已把心跳里的 current/total 透到 progress/light,但 TaskItemView.progress 是可空字段:
页面少写一行不会报错也不会红,界面上就是安静地没有进度条——11 类客户端任务里 7 类正是这样。

- 新增 src/shared/api/task-progress-live.ts:进度走独立通道,模块级缓存 + 60s 新鲜窗口
  为什么不并进任务对象:各页 {...prev.task, ...detail.task} 合并里有 5 处带「变更签名」守卫
  (rowsVersion|status|fileStatus|fileReady)。进度每轮都在动,而签名在「正在翻页、还没攒够一批
  回传」的时段不变——照那条路走,进度条会一路停在上一次回传的数字上,看着像卡死
- 写入点挂在 light 出口(progress-light.ts)而不是聚合层:4 个页面直接调 getModuleProgressLight
  不经过 getPollingProgressBatch,挂聚合层它们永远拿不到;命中缓存也要刷一遍读数,
  否则进度会在缓存窗口里被自己的新鲜判定踢掉、凭空消失
- toBatchItems 与 LightPollingItem 补三字段:这里的键集是逐字段挑的,少挑一个就把后端给的数丢掉
- 10 页接 liveProgress:解决风控、跟价、定时匹配、状态查询、提款、巡店删除、商品管理采集等
- Convert/Dedupe/Split 三页写死 progress: null 并说明原因:它们卡列的是完成记录、没有可数的分母。
  显式 null 与省略字段在代码里必须长得不一样,否则下一个人无法区分「没得画」和「忘了接」
- 新增 tests/task-progress-view-wiring.test.ts:适配器清单由文件系统给出、总数硬钉 16,
  判据同时认 `progress:` 与 ES6 简写 `progress,`(只认冒号把 BrandBrandTab 误报成缺口,
  而误报的尺子会被人当噪音绕过去);变异自证三处全 KILLED——抽掉跟价页的接线、
  摘掉批次白名单的 progressTotal、去掉分母塌 0 时的旧读数清理,还原后字节哈希一致
- tests/task-progress-polling.test.ts 的整份形状断言同步加三字段(它本来就该在我改白名单时红)
2026-10-10 21:00:01 +08:00
huangzd1997 3987b8d7fe 用户端(四面9分批次): 三条全局错误出口、URL 白名单收口、令牌键单点、uid 短路进门禁
- 此前全树 0 处全局错误处理器:装 app.config.errorHandler + window error + unhandledrejection,
  每条都留可诊断记录、界面只出中文、处理器自身异常不重抛也不白屏(9 例判据)。
- safeHttpUrl 未覆盖的 3 处(两个品牌 Tab 与 useVersionUpdate 直装服务端 file_url)收口;
  令牌键 aiimage_auth_token 由 4 处各自定义 + 2 处内联收成唯一定义点。
- 「localStorage 有 uid 就免校验」改走 auth-gate 单点,剩余例外台账化且同口径必须能抓到
  评审点名的原写法(6 例);卸载配对 3 处补齐 + 全树判据(7 例)。
- task-status-text 把 CANCELLED 显示成"执行中"改对,CANCELED/CANCELLED 两拼写都映射(4 例)。
- 主审计补的四处修复:新判据里两处拿数组和 0 比(怎么写都红);静默 catch 的"用户可见出口"
  符号表认不出本仓 userNotice 与注入式 notify,把真报了用户的 catch 判成静默;
  新错误出口带来的 2 个 try/catch 按棘轮合同写理由进基线(296→298,silent 一格没涨)。
- 验收:node --test 820 例 0 红、npx vue-tsc --noEmit rc=0。
2026-10-09 23:09:37 +08:00
huangzd1997 282ad7be9f fix(界面文案): 前端两棵树加 userNotice 闸——非中文提示语一律换成中文句
后端仍有出口把底层异常原文写进 error_message / fileError / 匹配原因 / 响应 message,逐条翻译
跟不上新增;用户 2026-10-09 要求整个项目的提示语都用中文,所以把规矩做进界面出口。

规则:原文含中文照原样透出;整条无中文换成中文兜底句;**含中文但冒号后是纯英文尾巴的剥掉尾巴**
("转换结果打包失败: No space left on device" 只留主干)。被隐去的原文进 console 供核对日志。

闸口:用户端 http.ts 的 extractErrorMessage 五条返回路径与 unwrapJavaResponse、后台 envelope 的
textOf/errorTextOf、13 处任务卡 `错误:${item.error}`、2 处 fileError 兜底句、发布页文件错误与
匹配原因函数、dispatch-guard 的解析失败原因清单、22 处 ElMessage.error(result.error) 型展示、
后台看板与数字人详情页两处模板。

尺子:frontend-vue/tests/user-notice-chinese-only-guard.test.ts、admin-frontend-vue/tests/user-notice-chinese-only.test.ts
(分母硬钉+内存造违例自证+摘壳写法仍计入分母);source-pin 台账只登记本轮新增那一个文件,
别人的在飞格子没重算。node --test 用户端 782/782、后台 1782/1782,两棵树 vue-tsc 均 rc=0。
2026-10-09 19:34:54 +08:00
huangzd1997 974d0c77d0 fix(结果文件): 文件可下载就不判"结果生成失败"——两页共用一条判据
货源查询任务 30456 结果文件已生成、下载按钮可用,但徽标仍按 fileStatus=FAILED
判红。前端加一条:能下载就不算生成失败。判据抽到 task-status-text.resultBuildFailed,
货源查询与外观专利两个 tab 同用一个出口,外观专利 statusText 里"整体失败优先于
生成失败"的 carve-out 由用例盯住不得回流。
2026-10-09 17:52:08 +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 84ae94b6c6 feat(用户端护栏): 首批组件挂载测试 + 铃铛标已读失败改可见(§2「0 挂载测试」那一半句闭掉)
- vitest.config.ts 与 vite.config.ts 分家:只服务 tests/mount/**,不进 tsconfig include,npm run build 产物不受影响(vue-tsc --noEmit rc=0 实测)
- tests/mount/notification-bell-failure.mount.test.ts 三支:标已读失败必须给带原因的错误提示且不许把行冒充成已读;成功时不产生提示且行真转已读;列表失败文案进面板本身而不弹全局消息
- NotificationBell.vue 的 onItemClick 改前只 console.warn(点了通知没反应、行也不转已读),现与 readAll 同走 ElMessage.error;反证:摘掉这行出口 ⇒ 挂载例判红(实测 1 failed 2 passed)
- 依赖只加 devDependencies(vitest/@vue/test-utils/happy-dom),运行时四项 lock 版本与 HEAD 逐一对等 ⇒ 生产构建输入未变
- 面板是 Teleport 到 body:wrapper.find 看不见里面的行,改从 document 取节点用原生 click 触发(实测踩过)
- npm test 那支不递归的 glob 仍 762 例 0 红,两套 runner 互不抓取
2026-10-09 11:21:47 +08:00
huangzd1997 981221c884 fix(用户端护栏): 摘掉两处挡"不可能发生"的兜底 catch,棘轮基线只 +1 并记名
把用户端全量套件并进实跑分母时跑出 1 红:`catch-silence-ratchet` 的 catch 块总数从 295
涨到 298,逐文件台账又点名 kick-handler.ts 从 4 涨到 5。三笔新增都来自 a24d7b9b
(19:04 那批"登录态失效前端会真退出"),逐处看过之后分两类处理,而不是把基线一次抬 3:

 * kick-handler.ts:`window.addEventListener('pywebviewready', …)` 外面那层 try/catch 摘掉——
   这个调用在任何受支持浏览器里都不抛,真正的失败面(桥尚未就绪)已经由内层 apply() 的
   try/catch 兜住;
 * DesktopLoginPage.vue:`isSessionExpiredNav()` 的外层 try/catch 摘掉——`URLSearchParams`
   对字符串永不抛,而它调用的 `lsGet()` 自己已经带兜底,这层是第二份对同一件事的防御;
 * 保留 `setAuthNotice()`:`localStorage.setItem/removeItem` 在隐私模式与配额满时**真会抛**,
   兜法是"这条提示不落",是可接受降级而不是吞错——这一处记进 blocks 基线(295→296)并写明出处。

静默数(空块或首条 console.* 且无 throw/ElMessage)一格没动,仍 ≤84;逐文件台账对平。
验证:node --test tests/catch-silence-ratchet.test.ts ⇒ 4/4 绿;
npm test(93 个文件)⇒ tests 762, pass 762, fail 0(改前是 761 pass / 1 fail)。

纯前端源码,未重新构建发布 ⇒ 现网零影响;改的都是 HEAD 已提交内容,不涉及并行会话在飞文件。
2026-10-09 00:41:21 +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 de526f51c6 fix(终态词表): 实时看板的第三处窄集合也并到共用谓词,COMPLETED 不再空转
useLiveTaskBoard.ts:444 原来是 task.status === 'SUCCESS' || 'FAILED' —— 共用词表里第三个值
COMPLETED 不在这一对里,命中它的任务不会 removePollingTask,看板会一直轮询到预算耗尽。
这是四面9分任务书点的"第二套终态词表"的又一处实例(任务书只点了 useTaskProgressLoop 与
BrandShopMatchTab,那两处上一轮已并掉;这一处是本轮新尺子从台账里翻出来的)。
台账 useLiveTaskBoard 从 3 处下调到 2 处:剩下的 2 处是 item.fileStatus 维度(结果文件
成功/失败),跟的是文件链路而不是任务终态,还没跟后端对账,故意不动。

证据:node --test tests/task-terminal-set-single-source.test.ts
tests/task-terminal-completed-behavior.test.ts ⇒ 19/19 绿;全量 762 例 761 绿,
唯一红是 src/shared/auth/kick-handler.ts 的 catch 棘轮(4→5 处),那是并行会话还没提交的
鉴权在飞改动被尺子拦下,不是本笔引入——留给他们自己把台账下调或把 catch 收口。
2026-10-08 18:50:41 +08:00
huangzd1997 aea5614a8b fix(终态): 消掉第二套任务终态词表,并把判据从正则换成 AST
useTaskProgressLoop 的 DEFAULT_TERMINAL 只认 SUCCESS|FAILED,而 COMPLETED≡SUCCESS
(task-status-text 把两者都映射成「已完成」,看板 SUCCESS_STATUSES_ORDERED 也含两者)。
收到 COMPLETED 不退出的轮询会一直空转到瞬断预算耗尽——这形状先前在跟价与风控两页踩过。
唯一被这次改宽影响的页面是 BrandCollectDataTab(它不传 isTerminal);BrandPublishTab
传自己那份含 COMPLETED+CANCELLED 的判定,行为不变,已用单独一条钉子钉住。

判据原先是"变量名恰为 status"的源码正则,同形异名全 src 有 16 处抓不到,等于恒绿;
现在用 typescript(node_modules 里已有)做 AST 尺子,并把"旧正则对三条反例失明"写进断言。
ShopMatch 的 waitForScheduledTaskStageExit 等的是阶段不是任务终态,为此给骨架加了可选
exitOn,保住它原有语义、未知状态不会挂死。

口径更正:窄集合"全 src 应为 0"不成立——实测 20 处/8 文件是 fileStatus(结果文件维度)、
loop-run 带 STOPPED 的词表、显示与下载判定,不同维度不该混进一本账;改成迁移面硬 0 +
逐文件台账只许减。catch 同理:grep 'catch (' 的 292 数不到无绑定 catch {,AST 口径 295/84。
2026-10-08 17:36:47 +08:00
huangzd1997 207225eb86 feat(护栏三面): 鉴权盲区启动自检 + SQL 分层口径落码 + 六页等待循环合一
后端
- AdminApiGuardFilter 增 guardedPrefixes()/matchesPrefix() 公开入口(原 private,
  自检抄一份清单迟早与守卫脱钩);行为零变化
- 新增 ApiGuardCoverageAuditor:启动期把"已映射端点既不在守卫前缀名单、也不在
  公开/待收清单里"打成 API_GUARD_UNCOVERED 一行 WARN,供现网巡检 grep;
  PUBLIC_BY_DESIGN 与 PENDING_CONVERGENCE 两张清单逐条写理由(只读不拦)
- SQL 分层按新口径落码:AsinResultCacheMapper 的两条动态 SQL(<foreach> 批量 +
  ON DUPLICATE KEY UPDATE + 逐列 COALESCE)迁到 resources/mapper/asincache/,
  注解摘干净(注解+XML 同名会让启动期抛重复语句)
- 判据:SqlLayeringConventionTest(注解写 SQL 基线 16 接口/29 条只减不增、
  @Select 65 条/16 文件、wrapper 夹带函数级 SQL 4 文件/15 条,last("LIMIT n")
  205 处显式豁免并反向钉住豁免面)、ApiGuardCoverageAuditorTest(含清单腐烂与
  欠账/名单重叠两类反向失明)、AsinResultCacheMapperXmlTest(真解析 XML 向
  BoundSql 断言 28 个占位符与 5 个 COALESCE 列)

用户端 frontend-vue
- 终态集合合一:实测六页里 PriceTrack/ProductRisk 只认 SUCCESS|FAILED,
  而 COMPLETED≡SUCCESS 早有出处(task-status-text 两者都译「已完成」,
  后端 TaskCenterQueryMapper SUCCESS_STATUSES_ORDERED 也含 COMPLETED)
  ⇒ 窄集合页收到 COMPLETED 会空转到瞬断预算耗尽,PriceTrack 的轮询摘除路径
  同样窄 ⇒ 任务永不退出轮询、列表卡在"执行中"
- 新增 shared/utils/task-terminal.ts 循环骨架(disposed/瞬断预算/恢复提示/
  每轮 sleep/非瞬断上抛),六页全部接上;取数、文案、快照合并、DELETED 语义
  留在各页回调,没有顺手统一
- 判据两支:骨架 8 例契约 + 六页源码窄集合回归钉(含"判据自己先自证"一例,
  loop-run 的 STOPPED 词表不误报)
2026-10-08 09:20:41 +08:00
huangzd1997 ab2605d1d1 fix(前端): 店铺数据抓取派发即裁剪,五页共用同一守卫
代理按提取次数计费:这页把整批匹配行合进 pendingQueue 后从不清空匹配表,再点一次
「启动」就把同一批店铺再抓一遍——真花钱。查 ASIN/跟价/删除品牌/提款在 10-04 已按同一形
修过,这页当时漏了。

- BrandShopDataCrawlTab.startQueue 走共享的 pruneRows:匹配表换成 remaining、
  removed 进 pendingQueue、随即 saveMatched()+saveQueueState(),并把提示统一成
  dispatchedPruneNotice(说清"再点启动只跑剩余");
- 新增 tests/dispatch-loop-must-prune.test.ts:按函数体判「有自动接续开关 + 有派发」
  的页面是否裁行,五页全覆盖,另配三份合成夹具(裸奔必须被判不安全、只有人工删行的
  不许算合规、接好线的必须绿),判据自身不会恒绿。

「派发循环整体下沉服务端」这条前提经核不成立:拉取开关默认关是设计使然,且每轮派发参数
(紫鸟版本/国家序列/定时点)从不落库,服务端自行重派会花掉用户的次数,故留在客户端。
前端 node --test 全量 414 例 / 42 红:本批新增的 dispatch-loop-must-prune.test.ts 单跑 4 例全绿;
那 42 红是本机 node_modules 为空(缺 axios/vue),在干净 HEAD 上同样红。
2026-10-07 20:01:31 +08:00
huangzd1997 7887e7ee37 fix(通知): 麦象不可读不再折叠成「无异常」、探活 4xx 不冒充正常、交付不完整独立成 scene,前端入队拒绝按机器码决定重试
- MaixiangConsoleClient 新增 probeReadable/classifyReadout,把四种「读不出来」的形状与
  「确实无异常」分开;MaixiangAnomalyScanner 在六项扫描前先过这道闸,读不通就喊一条
  天级去重的管理员异常并退出本轮——此前后台挂掉时六项一致报「无异常」,服务探测还是绿的。
- NotificationScanScheduler 的探活改三态 ALIVE/UNVERIFIED/DOWN:401/403/404 说明请求被
  挡在业务之外,拿不到健康证据,不能再按 <500 判成「服务正常」。
- task_partial(交付不完整)从 task_failed 里拆出来独立成 scene,仍归任务异常大类;
  NotificationDispatchService 的管理员行改用 SCENE_TASK_PARTIAL。
- 前端 dispatch-guard 用机器码 shop_busy/queue_full 判定「等一会儿再推就会成」,
  暂缓 20s×15 封顶;此前页面靠 includes('当前店铺正在执行中') 匹配中文,而文案中间
  插了店铺名,永远匹配不到⇒同店互斥被写成任务失败。

护栏:后端 notification 六支用例(含 MaixiangConsoleClientTest 15 例、
MaixiangAnomalyScannerTest 24 例)、前端 dispatch-guard 与 enqueue-rejection-wiring 两支;
后端全量 3827 例 0 红、前端 717 例 0 失败;变异 M1-M7、M12-M14 共 10/10 杀。
2026-10-06 11:46:54 +08:00
huangzd1997 eea617b3e6 feat(采集页省钱线): 派发即裁剪已匹配行、候选勾选记忆、摘掉跟价旧逐行派发
代理按「提取次数」计费而不是按流量,所以把同一批店铺重复派发一次就是真花钱。三处改动的
共同口径是「用户多点一次启动,不再多买一轮」。纯逻辑各抽成一个可单测的模块,页面只接线。

- dispatch-row-prune:查 ASIN 页匹配好的店铺交给后台执行后从结果表里移除。删行本身一句 filter,
  两个坑要钉住——行键口径必须与该页 rowKeyForMatch 一致(名字带两端空格的行删不掉,就留着
  下次再买一轮);历史行明细靠本地匹配表回退(withQueryAsinFallback 读 matchedItems),直接删行
  等于把已派发店铺的历史明细一起删掉 ⇒ 移除的行进一份上限 50 的归档,继续当回退数据源。
- candidate-selection-memory:候选店铺每天重拉时保住勾选。记的是店铺名不是行 id(候选行会被
  删了再加、id 会变,店铺名才是人眼认的那个身份);键按 uid + 页签隔离;selection-change 只带
  当前渲染窗口里的行,整份覆盖会把别的页刚记住的勾选一起抹掉 ⇒ 只按本窗口可见行重算;
  店铺已被删除时不得恢复勾选(否则匹配的是不存在的店)。
- 跟价页摘掉 processMatchedQueue 这条旧逐行派发路径:入口只有 if (autoQueueEnabled),而本页
  从来没把它置 true ⇒ 永远进不去。留着不是无害死代码——它是一套能重复买提取的并行派发路径,
  谁接错一次就再花钱。用例反向钉「不得回流」,不给死代码补测试。

验证:frontend-vue 定向 29/0(dispatch-row-prune 7、candidate-selection-memory 5、
wiring 10、query-asin-dispatch-prune 5、price-track-dead-queue-removed 反向钉 2),
全量 710/0(含本会话另加的到期弹窗 9 支,那 9 支随上一笔走)。接线由 wiring 用例钉住
"纯模块真被这两个页面 import",不是只测纯函数。
2026-10-05 11:51:53 +08:00
huangzd1997 95e2318c42 feat(账号到期+公司超管): 级联过期判定、过期停任务巡检与两端续费提醒弹窗
需求两条:站点超管可开设其他公司的超级管理员(站点超管看全站、公司超管只看本公司、
组内管理员仍只看本组);账号要有过期时间,管理员过期后名下普通账户一并停用、
正在跑的任务也要停掉。落库只有 users.expires_at(V146,NULL=永不过期),级联一律现算,
不写"上级过期就把下级置成过期"那种续费也救不回来的数据。

- AccountExpiryService:生效到期 = min(自身, 本公司公司超管, 成员表组长, 创建人)。
  登录拦 403(文案给续费提示)、每次请求鉴权拦 401(前端按下线踢回登录页),super_admin
  永不适用。级联口径与数据可见范围同源(成员表基本未用、实际按 created_by_id 派生)。
- ExpiredAccountTaskStopService:每分钟把过期账号(含级联成员)名下 biz_file_task
  PENDING/SCHEDULED/RUNNING → FAILED,含未领取的 PENDING(防内部通道继续派发)。原因文案
  刻意不以「客户端异常中断」开头,否则会被 TaskResumeService 自动复活。品牌采集与跟价循环
  不在那张表上,经 ExpiredAccountTaskStopSpi 由各自模块停:品牌 pending/running→cancelled
  且 UPDATE 的 WHERE 二次核对状态(抢到行后被客户端推进成完成的行不得误杀),跟价循环只置
  stop_requested=1、沿用用户点「停止循环」那条收尾路径,绝不动 status。任务心跳接口保持匿名
  不走 requireUser,所以过期账号的客户端仍能拿到 alive=false 协作停止。
- 角色 company_super_admin:由站点超管开设(唯一要显式选公司的建号场景),建号/授菜单/改用户/
  看数据四条链路都按"本公司"收口;公司超管之间、以及公司超管与站点超管互相碰不得。
- 续费提醒:剩余 <5 天在数富后台与用户端弹窗,只能收起不能关闭(无关闭按钮,收起态是右下角
  浮标),续费到 ≥5 天自动消失。后台读 /api/admin/current-user 的 expiresAt/daysToExpire;
  用户端无 Pinia,走 localStorage 的 account_expires_at(登录/check_login 落键、被顶下线清键,
  换账号不残留)。只反映账号自身到期,弹窗不做任何级联推断。
- V146 撞掉了 V145 那批的一条护栏:它按"db/ 里不许出现 V146__ 前缀"编死号位,被一条正常的
  前向迁移占用就红。改成钉动作——剥注释后的可执行 SQL 不得写 flyway_schema_history(回滚
  一律是扫描路径外的人工补丁),并把盘点文档改 V146 时丢掉的 V145 文件名补回去。

验证(本会话亲跑,不是转述):后端定向 14 类 123/0(同一轮 mvn 里连批次③的 4 类 53 例、以及既有 ShopDataCrawl/SimilarAsin 两条回归对照 21 例一起跑,合计 197 例 0 红);admin-frontend-vue 本批定向 44/0(弹窗 7 +
公司建号/列表/入口/日期默认 21 + 角色 task-48/task-251 16),全量 1726 例里那 1 支红是另一条
会话刻意留的「公司 tab 接线缺口」尺子(点名 admin_task_center 等 6 页,与本批无关);
frontend-vue 弹窗 9/0、全量 710/0。变异自证两批共 34 点:弹窗语义 16 点全杀(阈值 5、只能收起
不能关闭、挂载点含"注释掉挂载"、落键/清键链路),本批 SPI+迁移护栏 17 点全杀(含 G2 反向:
前向迁移只在注释里提 flyway_schema_history 必须照样绿),注入文件还原 dirty=0、探针残留 0。
2026-10-05 11:51:33 +08:00