Commit Graph

338 Commits

Author SHA1 Message Date
huangzd1997 34113aff8b fix(鉴权): 到期级联改标量聚合,后台入口按菜单授权放开
三件事同源于 10-06「非默认公司账号进不了数富后台」这条事故链,四种死法在界面上长得一样。

1) AccountExpiryService 读本公司公司超管的 expires_at 时把单列投影成实体列表再遍历——
   MyBatis 对所选列全为 NULL 的行交出的是 null 元素,而"没设到期"是绝大多数公司的常态,
   于是只要有一个永不过期的公司超管,该公司所有账号的登录与每个鉴权请求全部 500。
   改成 mapper 侧一条 MIN(expires_at) 标量聚合;AuthChainQueryShapeTest 扫鉴权链路的
   "单列投影"形状——这个判据落在 mock 边界外,单测挡不住,只能做源码扫描。

2) 后台入口放开:requireConsoleOperator = 管理员角色链 或 本公司树里 >=1 条后台菜单授权
   (探针是带 company_id 条件的标量 COUNT,与下发口径一致,否则进得来而菜单树是空的)。
   逐页另设 requireConsolePageAccess 锚住本页 key,勾父分组覆盖后代的既有语义照旧。
   管理类 10 支控制器继续 requireAdmin,并且出口 2 不再把这些页下发给普通账号——
   下发出去就是一排点了必 403 的死链。内部令牌通道绕过到期与会话校验,不随入口放宽。
   护栏 ConsoleWideningGuardrailTest 双向钉:管理页不得被授权打开、入口落点恰好那 13 支。

3) 前端:后端失败一律 HTTP 200 + success=false,登录页从未解包,所以"什么都不提示"。
   补 login-feedback 归一文案(技术串不外露、兜底不再伪装成用户名或密码错误),
   并修 isLoginLocation 拿路由内路径比 location.pathname——生产实际是 /admin-vue/login,
   那条"已在登录页就别整页重刷"的守卫一次都没生效过。

验证:后端 mvn -o -B test 3924 例 0 红(457 支类);前端 node --test 1738 例 0 红;
vue-tsc --noEmit rc=0;入口探针 SQL 已在生产库只读三档空跑(本公司 1 / 错公司 0 / 无授权 0)。
2026-10-07 00:18:35 +08:00
huangzd1997 b0444f0903 docs(菜单权限): 上线复验记录,并改掉两处与实现不符的注释
§11 记下 17:3x 的实跑读数(jar 08b79b33… / Flyway 到 151 / 库侧三条残留为 0 /
两台逐行一致的行为侧 E2E / admin-vue 聚合摘要对平 / 巡检 3 条告警的归因)。

两处注释是复验当场证伪的:menu-manage-api.ts 与 company-scope.ts 都写着
"超管不带 company_id 拿到的是全部公司的行(两排同名菜单)",实测拿到的是本公司那 26 行
—— resolveScopeCompanyId 在参数为空时对超管也返回操作者本公司。留着这句话,
下一个人会以为不传参也能看到别家,从而把 tab 的显式传参当成多余的。

不改行为:后端这道门本就该默认锁本公司。
2026-10-06 17:46:32 +08:00
huangzd1997 b7acfc0eef feat(菜单权限): 每家公司一套菜单树(V149)+ 公司 tab 只在注册表页渲染
本批两件事,加上随本批一起入仓的并行会话在制品:

一、菜单权限按公司隔离(批次 6)
- V149 给 columns 加 company_id:先可空加列(末位、ALGORITHM=INSTANT)→ 回填公司 1 →
  MODIFY 收紧 NOT NULL;三段式缺一即撞 1048。同时建 (company_id, column_key) 复合键、
  把公司 2 的 16 笔授权按 column_key 改指向它自己的副本,三类 menu_type 全复制,
  admin_companies 作为角色内生闸门行不复制(D3)。
- 第三道归属门 PermissionMenuService.resolveScopeCompanyId:站点超管可带 company_id
  读写任意公司,非超管锁本公司、越界 403。它注册进 CompanyIdParamGoesThroughReadScopeTest
  的 SCOPE_DOORS,四条判据与 readScope / readCompanyIdOrOwn 共用——护栏在代码出口,不靠清单。
- 旁路种子 PermissionMenuSchemaInitializer 只种公司 1:31 段种子逐条钉公司,
  按 column_key 点查的 14 段全部带 company_id,否则摘了 DEFAULT 就是跨公司串写。
- CompanyService.create 同一次写入里给新公司复制模板树(D4)。

二、公司 tab 收口(批次 b)
tab 条挂在壳层,对 22 页全画;改为按正列表 companyTabAppliesTo(menuKey) 判定,
只有注册表页渲染。护栏钉在用户看见的那个出口。

三、并行会话在制品(控制方「全部提交」,未单独拆分——见下)
- V150 店铺密钥 biz_shop_key 按公司(readCompanyIdOrOwn + writeCompanyId 两道门)
- V151 品牌库/商品类目推翻为全平台共享:只退唯一键、company_id DEFAULT 保留为
  NOT NULL 承重约束(摘了每条 1364);删掉 ProductCategoryControllerCompanyScopeTest
  那支"按公司隔离"的旧护栏,readCompanyId 方法一并移除
- invalidasin 字段与外观专利合批的连带改动

为什么不拆笔:后端 3891 例 / 0 红、前端 1731 例 / 0 红这两个读数是"合起来的树"的读数,
拆成多笔会让每一笔落到从未一起验过的组合上,而这一版要直接上两台。

回滚脚本在 backend-java/docs/rollback-V149/V150/V151-*.sql,不放进 Flyway 扫描路径。
设计记录:docs/ops/menu-company-tree-design-2026-10-06.md
2026-10-06 17:17:14 +08:00
huangzd1997 e635fa8dcd chore(清理): 删除 10 个零引用文件并裁剪钉住它们的护栏断言
admin-frontend-vue:AdminConfirm.vue 只是 openAdminConfirm 的空壳包装(调用方走
imperative 入口);StatusPill/ModalShell/DrawerShell 与各自的 status-pill-model、
modal-model 构成孤儿岛,无任何页面 import;MaskReveal.vue 无引用点(掩码语义仍由
店铺侧 secret-mask 承担);duplicate-api.ts 是被 duplicate-console-api.ts 取代的
平行实现,DuplicateCheckPage 只用后者。frontend-vue:shared/utils/bootstrap.ts 全仓零命中。

护栏随之收口:task-248.test.ts 整支删除(8 个用例全在钉 modal-model 与两个 Shell),
task-247 去掉 status-pill-model 的 6 个用例与三个组件的钉(保留 CopyText/copy-model),
task-245 去掉 AdminConfirm.vue 的两行,task-115/117/118 去掉 duplicate-api.ts 的端点钉。
2026-10-06 13:44:41 +08:00
huangzd1997 16583f578d feat(公司tab): 批次 2/3/4 再接 8 页,注册表收到 16 页——用户页回流 company_id 按新边界改写反向钉
「切 tab 数据还一样」的根因一直是分母小于现实:批次 1 只登记 8 页,本轮按控制方
三次点名扩到 16 页(company-scope.ts 是唯一清单,routes.ts 的 companyScoped 逐页对平)。

批次 2(五页 ASIN 中心):去重总数据 / 不符合ASIN / 查询ASIN / 最低价ASIN / 商品类目。
批次 3(两页店铺中心):撞款监控、店铺数据记录。这两页没有归属列可筛,归属口径是
「本公司账号名下的店铺」——后端由 DataReadScope 推公司 → 成员账号 → biz_shop_manage.
created_by_id,前端只把 activeId 当 company_id 送下去。空成员集必须交空集合,绝不能
退化成 null(null 在这里=全量,那样第二家会看到全部数据)。
批次 4(用户管理):后端早就认 company_id(只对站点超管生效,公司超管恒锁本公司),
断的是前端——UserListQuery 里连这个字段都没有,三家 tab 看的是同一份全量列表。

三处口径改动,逐条说明:
1)company-user-list.test.ts 的反向钉被改写。2026-10-04 定案把公司维度从用户页整体摘掉,
   那条钉的原文是「列表查询/筛选/行渲染不允许出现公司维度」。控制方 2026-10-05 明确要
   用户管理区分公司 tab,所以钉的边界收窄成两半:渲染层(行级公司列、「所属公司」标签、
   筛选状态、顶栏公司名)仍不得回流;请求层的 company_id 是这次加回来的,尺子换成
   「取值口唯一」——页面每处 companyId 都必须等于 companyTab.requestCompanyId,且
   normalizeUserPageParams/toUserListQuery 两只白名单构造器体内不许出现公司值。
   新增一支行为钉:往归一化里传 companyId 必须被丢掉,这是 users.ts 读原始入参的全部理由
   (写成 normalized.companyId 时 TS 照样绿、运行时恒 undefined)。
2)align-dup-console 那条 watch 看守的 token 扩到含 reload。变异自证里「删掉 void
   loadConsole()」当场全绿:体里的清筛选项守住了,重新取数那半没人守。批次 3/4 三对
   token 一起写到 reload 为止(批次 1/2 的老条目不动)。
3)公司管理页补正/反向两把尺子:company-config-entry-super-only 新增「吃公司 tab 的页面
   集合恰好等于 COMPANY_SCOPED_PAGES 的 pageFiles」——按代码真值比,不按清单比,所以
   清单不改一字而往 CompaniesPage.vue 里塞 store 也会红。谓词带括号,否则 import 行也算消费者。

菜单权限(admin_columns)本轮不动:MenusPage 只消费 /api/admin/permission-menus 这一份全局
菜单字典,切 tab 一样是数据本身全局,不是筛选坏了。真问题在写侧——PermissionMenuService
create/update/delete 只有 ensureAdminOperatorIfPresent(isAdmin 即放行),公司管理员改的是
全平台的菜单行。收窄为仅站点超管 vs 给 permission_menu 加归属列,两种改法代价差一个量级,
留给控制方定档。

护栏:G1 发送口 22 个 / 页面分组 17、watch 体看守 10 对、operation-guide 的 tab 文案 15 页
(撞款监控是显式豁免,另有一条自检盯「豁免落空」)。
变异自证 12/12 全杀(前端 10 + 公司管理反向钉 2),分母钉死在 27 例。
门禁:后端全量 3823 例 / 0 失败 / 0 错误 / 7 skipped,BUILD SUCCESS;admin-frontend-vue
1741 例 / 0 红;vue-tsc rc=0。首轮后端 4 红是另一路 task_partial 改动与本轮编译抢跑,
单跑 13 例已绿,本笔不含他们的任何文件。

未上线:jar 与 admin-vue 都没出包,V147 未在生产执行。
2026-10-06 02:32:59 +08:00
huangzd1997 764ac21d30 test(公司tab): Task 13 变异自证收尾——前端 11/11、后端 15/15 全杀,并记下这份台账没证明的东西
BG3-a 首轮存活(不是注入没跑到):adminPassingForeignCompanyGetsEmptyNot403 从没桩
memberUserIds(2L),而 Mockito 对未桩、返回 List 的方法默认交空表 ⇒「删掉 foreign 分支、
按本公司重算」这条注入交出的也是空集,isEmpty() 会因为错误的理由通过。本公司两列都桩成
非空后复跑:R0 先绿(tests=63 rc=0,DataReadScopeTest=7/0/0)⇒ BG3-a KILLED ⇒ BG3-b 仍 KILLED。

新增 G1 守卫「发送口的第二实参」(1b ④):task-center 五处 http.get 必须把 query 交给带
params 的第二实参——G1 原来按文件文本查 company_id = companyId,看不见"参数收下却没发出去、
接口照样 200"这一形。

backend-java/docs/mutation-company-tab.md:26 支注入(前端 11 + 后端 15)、被作废的那一整轮
(15 支全 tests=None=解析没抓到本轮 XML,而控制轮照样报 GREEN)、1b⑤ 的 @Test↔surefire 逐类
对平(2+7+7+3+9+3+13+19=63=分母),以及这份台账明确没证明的东西(另一路的第二道门 readCompanyId
的变异、八条人工实跑、live E2E)。

设计文档补一段线上现状:8e80dfc2..HEAD 唯一未上线的功能提交是 965e9690(看板五端点按公司筛,
2 支 src/main),区间新增迁移 0 支 ⇒ 下一版 jar 不动 Flyway 版本。

门禁:后端全量 3760 例 / 0 失败 / 0 错误 / 7 skipped、BUILD SUCCESS(450 个本轮 surefire XML
独立复算同数);admin-frontend-vue 1739/1739/0、vue-tsc rc=0。

本笔刻意**不含** DataReadScopeTest 里那 3 支 readCompanyId 用例——它们要的实现在另一路的未提交
改动里,一起提交会让别人 checkout 到这支提交时编译不过。
2026-10-06 00:15:58 +08:00
huangzd1997 0e6e844929 fix(角色叫法): 管理员就叫管理员、normal 档统一「普通账号」
同一角色此前有两套叫法:admin 档在界面叫「管理员」、在后端 6 条 403 与 Swagger 说明里叫
「普通管理员」;normal 档在界面叫「普通用户」。清到第四轮才清净,所以把口径做进源码出口:
新增 task-048 的旧词扫描用例,两棵源码树(admin-frontend-vue/src 216 文件、
backend-java/src 1415 java 文件)里出现「普通管理员」「普通用户」即红,分母与出口文件成员
一起钉死,防"扫了个空集合"式假绿。

- 后端 6 条用户可见文案:PermissionMenuService 两判、ShopManageGroupService 一判、
  ShopManageController 三条 @Operation 说明
- company_menu_grant_gate_mutation.py 的 DENIED_THROW 锚同步改,16 条锚命中数逐条复算=1
- 注释与 javadoc 同批收口(等长替换不动排版);NotificationControllerTest 那句讲的是
  非后台账号,按本意改写而不是套「普通账号」
2026-10-05 23:15:57 +08:00
huangzd1997 7ef328c46c fix(账号文案): normal 的中文口径四出口对平为「普通账号」,并加对平护栏
「编辑用户」弹窗写「普通账号」,而同一页的角色列/顶部栏(roleLabel)、新建下拉
(USER_ROLE_OPTIONS)、roleDomainLabel 三份映射写「普通用户」——同一页自相矛盾,且
没有任何尺子拦得住(各写各的,改一处不会让别处红)。口径按 2026-10-05 定为「普通账号」。

改三处 src:types/admin.ts roleLabel('normal')、user-role-map.ts 的 USER_ROLE_OPTIONS
与 ROLE_DOMAIN_LABELS。EditUserDialog 的两个角色按钮本来就写「普通账号」,一字未动。

新增 test_task_048_normal_role_wording_agrees_across_all_exits 把四出口对平:三份映射表
按值断言,弹窗那侧钉模板形状(<el-radio-button value="xxx">文案< 逐条 deepEqual),
不钉 token——只出现过"普通账号"四个字是判不出按钮丢没丢的。

变异自证 3 发全杀:① roleLabel('normal') 退回「普通用户」⇒ 红;② 弹窗按钮文案改成
「普通用户」⇒ 红,且报出 actual [['normal','普通用户'],['admin','管理员']];
③ 弹窗按钮写法换成 :value="'normal'"(正则抓不到那一条)⇒ 红,actual 只剩 admin 一条
——这一发是证明它不是恒绿:形状对不上时缺的那条会以"少一条"现形,而不是静默通过。
三次注入均按原字节还原,EditUserDialog.vue 的 git diff 为空。

验证:node --test 全量 1738 例 0 红、vue-tsc --noEmit rc=0、浏览器实测三处可见出口
(列表角色列 / 新建下拉 / 编辑弹窗)均显示「普通账号」。
2026-10-05 22:44:21 +08:00
huangzd1997 2dc13d0274 fix(按需注册): 「编辑用户→角色」渲染成一行裸文本——radio 子组件是 withNoopInstall,要 use 父组件
根因不在样式也不在文案,在注册表:src/plugins/element.ts 登记的是 ElRadioButton /
ElRadioGroup,而 EP 里子组件由 withNoopInstall 造(component.install = NOOP),
app.use 它们注册不出任何东西;只有父组件 ElRadio 的 withInstall(radio, {RadioButton,
RadioGroup}) 才会把三个名字一起 app.component 出去。于是模板里的 <el-radio-group> /
<el-radio-button> 解析失败,被当成未知自定义元素渲染成裸标签,两个按钮文案连成一行
「普通账号管理员」。全站 30 条注册项只注册出 33 个名字,缺的就是这两个;
ElFormItem / ElTableColumn / ElOption 等同为 no-op 的子组件都因父组件在表里而正常注册。

取证四路:像素扫描(角色栏 y=174-184 只有字形反锯齿点,同页三个输入框在 y=104/204/404
都是 723px 宽的完整边框)→ DOM(.el-radio-group 为 null,innerHTML 是原样标签)→
控制台(Failed to resolve component: el-radio-group / el-radio-button 各 2 条)→
运行期 app._context.components 键集合(无 ElRadioGroup/ElRadioButton)。

护栏原本 7/7 全绿而页面是坏的:perf_ep_registry_covers_every_used_tag 只比对注册数组的
文本里有没有那个名字——"登记过"被当成了"生效过"。改成对每个条目真跑 install(假 app)、
拿运行期注册出来的名字集合比对;修前红且红的正好是这两条。同时给
perf_ep_registry_has_no_dead_entries 补父组件豁免,否则正确修法(加 ElRadio,它自己没有
标签)反会被那条判成死条目——旧尺子会把人往错方向推。

验证:node --test 全量 1738 例 0 红、vue-tsc --noEmit rc=0、浏览器实测角色已渲染成分段
按钮("普通账号"高亮)且无解析告警。未提交未发布,现网 admin-vue 仍是 20261005-182523。
2026-10-05 22:29:53 +08:00
huangzd1997 8c2c11b8f7 docs(护栏): 说清「红在哪条」——拆条 shape 与对平闸门的分工(Task 10 复评 N-1/N-2/N-3)
N-1:shape 不匹配只往 gaps 里记,要等用例末尾的 deepEqual(problems) 才喊,而逐文件对平
闸门在同一 test 体内先执行 ⇒「删源码里的塞键那一行」(变异自证 M1–M5)实际报的是对平
消息。顺序不倒(取样自检与闸门先跑,判据坏了要先说"判据坏了"),改的是三处把红因许给
shape 的措辞——注释与 note 字符串一字未改判据。
N-2:length 比对按构造恒真(登记表就是 SEND_POINTS.map(...)),注释改为只声明它防
「.map() 换成手写 pin」这一形,并点名「删表一行」的真红处。
N-3:举证补齐判据实际求值的那份文本(stripComments)与预算起算点(`function <fn>(` 的
括号后)两组数,实测余量 118 字符;负样本探针会跟着窗口自动缩放,证明不了余量还在。
2026-10-05 21:48:35 +08:00
huangzd1997 9b857689eb test(公司tab): Task 10 修复轮 1——G1 把"5 处发送口"拆成 5 条钉,订正两处"声称保护而不保护"的注释
评审 I-1:G1 原本用 2 条文件级 shape 钉这一页的 5 处发送口,而判据是整文件 RegExp.test、不数次数 ⇒
删掉任何一处(含 brief 点名的 `fetchTaskCenterTaskDetail` 少带 `company_id`)双双仍为 true。
`vue-tsc` 也救不了:tsconfig 只开 strict、没开 noUnusedParameters ⇒ 删一行留个没人用的形参,编译器不响。
现按 `admin_shop_manage` 的先例拆成 5 条"一函数一钉"(`function <fn>(…)` 锚 + 320 字符实测有界窗口),
另按路线 ② 补一条"逐文件钉数 == 发送口条数"闸门(api=3 / model=2,用 `occurrences()`)⇒ 加第六处发送口而没钉也红。
M-2:watch 体看守原把锚写死在 `ShopManagePage.vue` 的 `filter.groupId = null` 上,同形不同页 ⇒
抽成 (file, token) 两对,本任务加的 `TaskCenterBoardPage.vue` 那条 `filter.shop = ''` 从此有尺子。
页码复位刻意没钉(判据收在能钉住的那一档,取舍写在 :309-312)。

I-2:`AdminTaskCenterController:38-44` 的类 javadoc 原话"抽走出口行即 A/C/D 三只都红"被它自己的 MUT-A 读数否证:
真相是 1 红 2 不响(A 红且 fail-fast 只点名 /overview;C 的门槛 :485 因体内不再出现 readScope( 而根本不评估;
D 因 hasScopeCall() 认 resolveScope( 且 companyId 在其实参表里而绿)。改成实测口径,代码结构零改动。
I-3:`legacySuperAdminIsNotLeftUnfiltered` 的 .as 消息许了"两把尺子单边改了红这条",但它只碰 service 侧 ⇒
对同一 fixture 补一行 `DeviceSessionPolicy.resolveRole(...)` 断言,两把尺子同框(既有 8 支单参用例方向未动)。
M-4:一参委托 `resolve(Long operatorId)` 补一行 javadoc 点名它背后挂着的 8 个测试调用点(裁决 3 保留,没删)。

变异自证(worktree D:/tmp-wt-t10f @aef79069):前端 12 轮——两轮不注入对照 7/7 rc=0,M1–M5 各删一处发送口全 KILLED
(红消息点名"发送口 N/5"),M6/M7 各红 1 条落在 watch 体那对,M8/M9 用 `shop-manage-api.ts` 补的第三支文件各红 2 条,
M10 删表一行红在补集闸门;`vue-tsc --noEmit` rc=0。后端 4 轮——B0 15/0 rc=0;B1-mutA guard 2/1 红在 A、service 13/0;
B2-mutL1 service 13/2;B3-mutL2 13/1 只红在新补那行、guard 2/0。每轮注入前读进内存的字节原样写回并核 md5。
两支 .java 的改动逐行验过是非注释行零改动(git diff -U0 滤注释后为空)。
2026-10-05 21:07:11 +08:00
huangzd1997 965e969076 feat(公司tab): 任务看板五个端点按公司筛(一处 resolve 收窄,detail 靠 scope.visible 同宽) 2026-10-05 19:14:51 +08:00
huangzd1997 8e80dfc274 docs(公司tab): 订正 G1 登记表那条过期注释——null 由发送口自己丢,不再依赖 axios 2026-10-05 17:47:58 +08:00
huangzd1997 c772a07fbe feat(公司tab): 日志管理列表按 uid 成员集筛,麦象行走 OR 不被筛掉
生产只读取证(2026-10-05 15:1x,主机 A 业务库只读):device_log_file COUNT(*)=1028,
GROUP BY source = client 831 / maixiang 197 ⇒ 客户端占多数 ⇒ 这页留在批次 1、照声明
companyScoped(若麦象占多数,公司 tab 只会筛掉小半边,就该把这页摘出清单)。

22 行 source='client' 且 uid IS NULL 的匿名客户端日志的处置:选了公司后接受它们从
每一个 tab 里消失(条件定成 (source='maixiang' OR uid IN (成员集)),不加 uid IS NULL
那条腿)。理由是那 197 行麦象能进每一个 tab,是因为它是平台自己的采集机(基础设施),
而这 22 行只是「没登录的桌面端」——一家没有归属的行在每一家各冒充一份,既错归属也让
「这家有多少日志」这个数失去意义;tab 只是超管的视图过滤器(这页 9 个端点全在
requireSuperAdmin 之后,无非超管调用方),全量仍可由不带 company_id 的请求拿到
(readScope(operator, null) ⇒ unfiltered ⇒ memberUids=null ⇒ 一条条件都不叠)。
代价与定案写进 DeviceLogServiceTest 的 @DisplayName
「定案:那 22 行 source=client 且 uid IS NULL 的匿名客户端日志——选了公司就接受它们消失」。

接线口径:controller 收 @RequestParam(name = "company_id", required = false) 并在 handler
体内算 dataReadScope.readScope(...).userIdsOr(null) 当实参交给 service(G2 断言 C 认的形状);
条件加在 wrapperBuilder 闭包内部,selectCount 与 selectList 共用同一把尺子;空成员集退化
成 eq(source,'maixiang') 而不是不叠条件;content/download/delete/devices 与三个写端点刻意
不收 company_id,由两支 SourceScan 用例钉住。
2026-10-05 17:20:57 +08:00
huangzd1997 d04bf6c3d1 feat(账号到期): 普通账号不再带自己的到期时间,入口与接口一起收窄
口径(2026-10-05 用户定):到期时间只需要设在管理员/公司超管身上,普通账号的停用
由上级级联决定(组长 + 创建人 + 本公司公司超管,见 AccountExpiryService)。
此前这条只存在于约定里,任何调用方都能给普通账号写 expires_at。

- 后端 AdminUserService:建号/编辑两道 400(绕过界面直接打接口传值就拒),
  把管理员改成普通账号时同批把 expires_at 置 null;判据 mayCarryOwnExpiry
  = admin|company_super_admin。
- 前端:user-create-model 导出同名判据(一支跨端用例逐字钉两端集合相等),
  toCreateUserRequest 对 normal 不下发;toEditUserUpdateRequest 按"改完之后
  的角色"决定,不能带就发空串=清空,公司超管目标因请求不带 role 而保留原值;
  两个对话框的「到期时间」项加 v-if="expiryEditable"。
- 用例:后端新增 4 支(含一条「普通账号仍可传空串清除」控制组,14 例绿);
  前端新增 9 支;旧 company-user-create 那条编码旧口径的断言改 role=admin。
2026-10-05 17:00:18 +08:00
huangzd1997 4c7d21eb52 test(公司tab): 补分组 wrapper 用例,反向钉改绑到参数绑定本身
评审两处咬不住的地方:分组侧 list() 那条 created_by_id=? OR user_id=? 被公司条件
平铺时,MySQL 的 AND 优先会让前半个 OR 整块逃出筛选(多放行、接口照样 200),而这
一Shape 全仓没有用例捕;读入口的反向钉只断 contains("company_id"),而 @Operation
的描述里就写着这个词,删掉绑定也不会红。

顺带删掉没人调的 list(Long) 重载,并把"空成员集"两支落到 id=-1 哨兵上(IN () 是
MySQL 语法错,退化成不加条件则是把全量放出来)。
2026-10-05 16:57:32 +08:00
huangzd1997 41dbcad1ac feat(公司tab): 店铺管理与数据权限分组按成员集筛, 凭据按 id 补读闸门
Task 11: ShopManageController.page / listGroups 接 DataReadScope.readScope,
把 company_id 算出的成员集当参数传给 service(controller 层收口, service 手上
只有 operatorId+布尔); ShopManageGroupService.list 增加 companyMemberIds 腿。

凭据 getCredentialById 的闸门用与 page() 同形的尺子(created_by_id IN creators
OR group_id IN groups),不是账号集合 —— 后者表达不了分组那一腿, 会把列表看得见
的行读凭据时 403 掉, 那是把正当访问静默删掉。

新增 testutil/SourceScan 供源码扫描式护栏取文(找不到方法必须抛, 不许返回空串恒绿)。

前端两页接 tab: companyId 取 companyTab.requestCompanyId, 并 watch activeId 重载;
G1 登记表给 admin_shop_manage 钉两条发送点(白名单 builder 故意不收 companyId)。
写侧入口一律不收 company_id, 由 ShopManageServiceTest 逐方法反向钉住。
2026-10-05 16:25:24 +08:00
huangzd1997 01c0d28076 test(公司tab): 补「超管选了公司但没选分组」这条水路的用例,并订正缺口清单的任务号
变异目录第 8 轮(ReadScope.userIdsOr 的 base==null 腿退化成空集)第一轮**存活**,
66 支一支不红。不是变异点在 mock 外面,而是这一轮两页都没测这条路径——而 tab
默认选中第一家,超管开页走的恰恰就是它(base=null + 公司集 ⇒ 本应交出公司成员集,
被 Mutation 打成空页时无人报警)。两页各补一条同形用例后重放:C0' 68 全绿、
M8 RED 2,红的正是这两条 ⇒ 变异 9/9。

顺带订正登记表里两条会误导人的任务号(按 docs/plans/19-company-tab.md 的任务标题):
admin_task_center 归 Task 10、admin_device_logs 归 Task 12(原先写成 9/10,差一笔)。

验证(验证树 D:/tmp-wt-19ct,基线 = 当前 HEAD 3724e1e4 + 我这 3 支文件):
- 后端全量 3732 / 0 failures / 0 errors / 7 skipped,BUILD SUCCESS。
- 计时用例 HttpClientTimeoutEffectiveTest 上一轮全量里红过一次
  (根因读到 "connection closed locally" 而非超时),单跑 8/8 绿、本轮全量 8/8 绿
  ⇒ 判为并发负载下的假红,不在我的差分里(我的改动只碰 usersecret 的两支测试与一份登记表注释)。
- 前端 1726 例 / 1725 绿 / 1 红 = 缺口尺子本身(还剩 4 页未接线,设计内);vue-tsc rc=0。
2026-10-05 14:39:20 +08:00
huangzd1997 3724e1e4cd test(到期提醒): 补生产 E2E——daysToExpire 生命周期、续费解除与到期拦截
弹窗的唯一判据是 /api/admin/current-user 的 daysToExpire,之前只有前端渲染层的桩用例,
"临期→续费→过期"这条真链路在产线上从没跑过。这支用例走完整生命周期并在 finally 删号:
建临期号(+2 天) → 登录取 current-user 断言天数落在 [0,5) → 续费到 10 天断言 >=5(弹窗消失的
判据)→ 手工置为过去时间 → 登录应 403 且文案指向续费 → 既有会话应 401。

两处刻意的设计,别当成随手写的:
1) 临时号口令用 randomBytes 现场生成,不落盘不进仓库——写死一个弱口令等于在产线上留后门;
2) 超管那半支先按 role 门控再断言(凭据角色不是 super_admin 就 skip)。
   上一版直接断言 daysToExpire===null,用 ceshi001(normal)跑出来是红的,看着像功能坏了,
   其实是环境缺后台凭据——缺凭据不等于有 bug,尺子要能把这两件事分开说。

只在带 AIIMAGE_LIVE_USER/PASS 时运行;tests/live 不在 node --test 的 glob 分母里,
所以它既不进全量例数,也不会被 CI 顺手跑掉(跑它=在产线建删真实管理员,必须显式授权)。
2026-10-05 13:53:03 +08:00
huangzd1997 1b8b62fd14 test(公司tab): 把两条「筛空」日志分支钉进用例,并订正 company_id 口径
baf8baef 给密钥管理与用量统计接了公司 tab,但"筛空早退"那两支日志一直没人看守:
主管的文案写的是「主管名下无子账户」,可这条分支真正的成因几乎只可能是 company_id
越界(主管的 base 恒含本人,UserDataScopeSupport:55/:78)——排障时会把人往错的方向指。
现在两支分别带 companyScope 宽度,并各钉一条 ListAppender 用例互不放过:
超管只许吐「公司或分组筛后」,主管只许吐「交集为空(多为越界 company_id)」。
分母 UserApiSecretServiceTest 50 例、UserSecretUsageServiceTest 12 例,Failures/Errors 均 0。

同批订正三处会漂的口径:两个 api 模块的注释原写「company_id=0 会让后端 requireCompanyId
直接抛」,实际 DataReadScope.readScope 第一行把 <=0 归一成「没选公司」,0 与缺失等价;
company-tab-wiring 的取值口注释去掉行号(api 文件一改就漂);两支接口的 OpenAPI 描述
补上「company_id 只收窄不放大、跨公司查看仅超管」。
docs/plans/19-company-tab.md 记一条评审未修项(Task 9 I-1):同一页里
POST /user-secrets/{userId}/check 与 DELETE /{userId} 一期就没有归属闸门,本轮把读接进
公司 tab 后它成了唯一还开着的越权写点,补校验是会 403 的行为变更 ⇒ 单独一张工单。
2026-10-05 13:52:33 +08:00
huangzd1997 baf8baef0b feat(公司tab): 接线 密钥管理与用量统计——分组∩公司取交集,空集不退化
两页都从 controller 这一个唯一出口算范围:收了 company_id 的 handler 自己调
dataReadScope.readScope(operator, companyId),把算好的 ReadScope 交给 service;
service 里 scopedUserIds() 只做 companyScope.userIdsOr(base),不再出现第二个判公司的 if。
readScope 落在 controller 而非计划原文写的 service,是因为 Task 8 补的 G2 尺子
CompanyIdParamGoesThroughReadScopeTest 逐 controller 断言"收参数就得自己调出口并把结果当实参交出去"。

空集一律早退(交给 in(...) 会渲染成 IN () → 500),且两条"筛空"日志按超管/主管分开,
排障时看得出是筛空还是查空;非超管空页仍返回带分组下拉的空页,下拉不缩水。

新增 6 条行为用例(超管 group_id∩公司成员集、交集空早退且不查库、不传公司保持不筛、
主管锁定集只被收窄不放大)。分母 3716 → 3722,Failures/Errors 均 0。
FE 侧两页带 company_id 并把 company-tab-wiring 缺口清单从 6 页收到 4 页。
2026-10-05 12:18:18 +08:00
huangzd1997 df03dce9c1 fix(看板): 任务状态收成三态,外观专利终态进度带真实状态落库
两次定案方向相反,所以分开钉:主看板只要 执行中/成功/失败 三态(其他状态不再当筛选项);
变体采集那页反过来——撤掉「在跑=0∪1 合并」口径,直接显示 待执行/处理中/成功/失败,
历史终态也要能看到。

- 后端 statusFilter 做同义词展开:成功 = SUCCESS∪COMPLETED,失败 = FAILED∪ERROR∪CANCELLED
  (取消=没成功也不在跑,并入失败),展开只住这一处,页面模型不再各自 if。前端筛选项随之
  收成 全部/执行中/成功/失败 四项(原 待执行/执行中/已排期/已完成/已取消 那一排撤掉)。
- 变体采集:不传 status = 全部状态,后端原样直查麦象(含历史终态),不再有 0∪1 合并哨兵;
  前端选项与 label 同步改。上线顺序仍是先 jar 后前端——新前端发 ACTIVE 打旧 jar 会整页空。
- AppearancePatentTaskService.saveFileBuildProgress 的终态必须带任务真实状态落库:save() 只对
  终态豁免 500ms 节流,而收尾三连写(组装/上传/完成)都在同一次调用里,若全按 RUNNING 写
  就只有第一条落地,满格「结果文件已生成」必被吞——2026-10-04 生产实测的「已完成 0/130、
  57/59」就是这么来的。对齐货源查询侧的 isTerminalFileBuildProgress。
- 节流侧补一条用例钉住"终态不受节流",模块侧补一条钉住"终态写的是任务状态而不是 RUNNING"——
  这两条分别在 service 与 mapper 出口,任一处回退都会红。

验证:后端定向 4 类 53/0(外观终态快照 4、进度节流 9、看板查询 34、变体采集 6;与批次①同一轮 mvn 197 例 0 红);admin-frontend-vue 定向 task-center-board 25/0(含三态选项、默认视图、
汇总卡口径)、全量 1726 例中本批 0 红。
2026-10-05 11:52:07 +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
huangzd1997 265f31681f test(公司tab): 两把尺子补洞——范围"算过"要"用出去",company_id 要写明取值口
评审用变异证明现有护栏各有半个洞,而这两个洞接下来会被 Task 9–12 六页照抄,
所以在本任务收口,不留到批次尾。

- G2 断言 C:handler 里 `readScope(` 的结果必须先赋给变量、再出现在另一条方法调用的
  实参列表里。原来只断"体内出现了 readScope(",于是 `listHistory(…, scoped)` 改成
  `listHistory(…, null)` 时 20 支用例一支不红(控制方实测 rc=0)——范围算了又丢掉,
  页面照样看全量。`if (scoped != null) throw` 这类装饰不算接住。带 2 支负探针 + 1 支
  正探针 + 第二形探针,分母三条自检(取样集非空 / 走完两步的支数为正 / 射程必须覆盖
  已接线的两页),不许恒绿也不许恒红。
- G1 取值口登记表:`/company_id\s*[:=]/` 对"右半边从哪个对象读"是瞎的,
  `= normalized.companyId` 与 baseline 缺口清单逐字相同(normalizeHistoryParams 是
  白名单构造,运行时恒 undefined)。每页登记该页 api 函数自己的入参形状;8 页全覆盖、
  缺条目红、接了线没登记同样红——没有"未登记就退回宽松判据"的默认分支。
- helpers.readSource 归一行尾:仓库 autocrlf=true,新检出是 CRLF 而源码 blob 是 LF,
  `[\s\S]{0,N}` 这类有界窗口会被多出来的 `\r` 挤红——同一份 company-tab store
  (LF 3565B / CRLF 3629B,内容等价)在干净检出树上多红一条无关用例。归一后实测
  CRLF 树回到 6/5/1(只剩批次那条刻意留红)。

读数:后端全量 3663/0/0 Skipped 7 BUILD SUCCESS(最终字节亲跑);定向 9/0,变异
`scoped`→`null` 后 1 Failures 红在 CompanyIdParamGoesThroughReadScopeTest:393;
前端全量 1726/1725/1、`vue-tsc` rc=0;`= normalized.companyId`(连守卫一起换的静默变体)
实测红且点名 admin_history。产品码一支未动。
2026-10-05 10:11:08 +08:00
huangzd1997 83a444def6 feat(公司tab): 接线 生成记录——company_id 走 DataReadScope,空成员集一律空页
「tab 画出来了、请求真带了 company_id、后端读都不读」是撒谎窗口,比不接更坏:
页面标题写某公司、数据仍是全量。所以后半页必须同时落地读侧与前端。

- controller 收显式 company_id,菜单闸门仍在算范围之前;范围只在 DataReadScope
  一处出口(不再有第二个 if)。DELETE /history 与 clearAllHistory 一字未动:
  写操作不吃 company_id。
- service 的总数与行集共用同一个 filterOf,"同范围"由结构保证;空成员集在
  分页归一之后早退,绝不把 [] 交给 in()(渲染成 IN () 就是 500)。
- 前端从原始 params 读 companyId——normalizeHistoryParams 是白名单构造,从
  normalized 读会静默拿到 undefined,编译绿、请求里没有参数。

验证:ImageHistoryServiceTest 7/0,后端全量 3663 例 0 红;G1 缺口清单 7 页 →
6 页(admin_history 消失);前端 1726/1725/1(那条红是刻意留的接线缺口尺子)、
vue-tsc rc=0。变异 M-A(删 filter.in)与 M-B(早退改永假)各杀 2 支。
2026-10-05 08:32:40 +08:00
huangzd1997 4a8c05329a feat(公司tab): 接线 视频任务记录——company_id 走 DataReadScope,detail/zip 用同一把 ReadScope 门住
Task 8 的前半页(生成记录那半页 BLOCKED,见账本裁定)。
- controller 接住 requireAdminOrInternal 的返回值算范围,page 侧 readScope(operator, companyId)
  .userIdsOr(base):显式 user_id 与公司 tab 是交集,不是替换。
- mapper 的 userId 单值条件保留、并列 userIds IN <foreach>;null=不筛,空集在 service 首行早退,
  绝不把 [] 交给 mapper(渲染成 IN () 是 500)。
- selectAdminZipRows 补 t.user_id:download-zip 的闸门要不越权就得先拿得到行主人。
- detail 的 404 文案拆开:404 只留给"真查不到行",越权是 403。zip 整单任一条越界 ⇒ 403,
  不借 X-Archive-Error-Count 的"部分失败"语义盖越权。
- 前端 company_id 落在 builder 之后、发请求之前的唯一一处(normalizeHistoryParams 那类白名单
  构造会把键静默丢掉);页面 watch(activeId) + 读 requestCompanyId。

验证(我自己复跑,不是转述):干净树定向 7/0(新 5 支 + G2 2 支)、全量前端 1726/1725/1
(G1 缺口清单 8 页→7 页,admin_image_video_tasks 已消失)、vue-tsc rc=0。
2026-10-05 07:51:19 +08:00
huangzd1997 3e95ea9b3f test(前端): 接线尺子补两处盲区——SFC 注释假接线与 tab 失败路径
(a) stripComments 增剥 <!-- -->:往页面追加两行 HTML 注释就能同时骗过
    「watch activeId」与「读 requestCompanyId」两条断言,实测缺口现在仍在列。
(c) I5 失败路径三支钉子:store 必须 catch 出 error 再 rethrow(口径照
    admin-session.ts:37-39)、模板不得出现 tab.error(提示条不在已批的两处
    界面暴露里)、组件必须 .catch 接住 rethrow。变异取证 M1/M2/M3 各判红
    6/4/2,对照轮 6/5/1(唯一红仍是计划明令的接线正向半支)。

全量前端 1726/1725/1、vue-tsc rc=0。
2026-10-05 07:06:09 +08:00
huangzd1997 0002e4eb36 fix(前端): 公司 tab 五处"声称保护但不保护"的钉子补上牙齿
Task 7 评审回文判定 Needs fixes,逐条关掉:
- wiring 正向半支的 api 断言从裸 token 改成 /company_id[:=]/,page 侧再钉
  companyTab.requestCompanyId(页面取公司值的唯一出口),且 api/page 两侧
  都先 stripComments——注释里出现字面量不算接线。
- 同一个双层循环改成收集 problems 后 deepEqual([]):Task 8-12 共用这把尺子,
  fail-fast 会让做完自己那页的人只看到指向别人页的红。现在一次列全 8 页缺口。
- guide 文案补"一页不多"半边:按两个已存在的判别子串反钉 key 全集,外加
  两句都不许进 OPERATION_GUIDE_FALLBACK。删掉模板里的 <OperationGuide />
  这类"留着 import 就绿"的写法一并改掉(wiring 与 align-guide 两处同形)。
- GET /companies 失败原本零痕迹:store catch 出 error 后再抛(口径照
  admin-session.ts),组件侧 .catch + console.warn,loaded 不翻转 => fail-closed
  不画 tab 条。没加任何用户可见文字/提示条。

取证在独立 worktree D:/tmp-wt-19fe 做:注释假接线 2 条、删挂载点 1 条,
HEAD 版用例分别复现盲区(fail 0 / 不列该页),新版全红;对照轮 0 注入
guide 10/10、wiring 6 支 1 红;注入文件逐份 cmp 字节一致,scratch git status 空。

已知一条刻意红灯仍在:company-tab-wiring.test.ts 的正向半支,Task 8-12 接线
完成后由收敛它的那笔提交销账。全量 1726/1725/1,vue-tsc rc=0。
2026-10-05 06:46:23 +08:00
huangzd1997 ca78bd27e9 feat(前端): 公司 tab(store+组件+G1 双向对账)+ §9.3 引导文案承载
批次 1 的 tab 机制半边:默认选中 id 最小的启用公司、不允许「全部」;「该不该画
tab 条」只住 store 一处(组件里再数一遍 length 就是第二把尺子);两家全停用时
activeId 为 null ⇒ 整条不渲染,不画出按钮为零的空 tab 条。

G1 双向对账 + 跨端常量钉子(后端 SUPER_ADMIN_ONLY_KEYS ↔ 前端
SUPER_ADMIN_ONLY_MENU_KEYS 由代码执行地相等,读不到/抽不到/空集三种都判红)
+ pageFiles↔routes.ts load() 对账,把 Task 8-12 的接线欠债钉成会红的尺子。

§9.3 的「行数会随 tab 变」由既有引导文案承载(8 页 + C 类 2 页各一句,句子抽成
常量防手抄差异),不新做页头控件/提示条。

已知一条刻意红灯:company-tab-wiring.test.ts 的正向半支在 Task 12 接线完成前必红
(plan 19 Step 8 明令),下一条补齐接线的提交收敛它。全量 1726 例仅此 1 红,
vue-tsc --noEmit 通过。

AdminLayout.vue / operation-guides.ts / company-config-entry-super-only.test.ts
三支文件此刻同时带着另一路会话的未提交改动,本提交按 hunk 逐行只入自己的部分。
2026-10-05 06:06:42 +08:00
huangzd1997 8750f3dd83 feat(前端): 公司配置入口按角色剪枝;核对 ce69fa21 已摘掉的公司维度并反向钉住
现网取证(Step 4,决定批次 0 顺序,Task 3 开工前必读):
抓 admin-vue 20261004-135428 的整棵产物图(入口 index-cieBmv8-.js 1,129,621 B / HTTP 200
+ 由 vite preload manifest 展开全部 34 个 chunk,逐个只读 GET 全 200)。
判据串 /api/admin/companies 命中 3 处,全在 companies-DdzTeTnG.js(GET/POST/PUT 三条);
非零对照 /api/admin/users 命中 2 处(users-CUWUXHVU.js、history-api-DA7YNc4O.js)证明抓到的
是真在跑的产物,不是空文件。入口 chunk 单查两个串都是 0 命中——字面量在共享 api chunk 里,
只按 brief 的"入口 chunk"抓会得到假的"未命中"结论。
决定性一条:UsersPage-Cv8vbewQ.js 静态 import 了 companies chunk,且里面有 `await $e()`
($e 即 fetchCompanies)⇒ 现网的「用户管理」页仍会打 GET /api/admin/companies。
⇒ 命中:批次 0 的 admin-vue 必须先发,Task 3 的 jar(listVisible 非超管一律 403)才能上,
否则 15 个公司内管理员一开用户管理就撞 403 → 被前端拦截器踢回登录页(2026-10-04 12:3x 形状)。
附带:现网全树 0 处 superAdminOnly ⇒ Task 1 那道入口剪枝尚未上线。

本笔无生产代码改动(Task 1 的注册表就是这半边唯一实现):新增
tests/company-config-entry-super-only.test.ts 三支(注册表认领 / fetchCompanies 消费者
集合恰好两处 / loadCompanies 读路径不许出现 canManage),三支各做一轮注入变异自证
⇒ 全轮 3/3 咬红、还原后字节一致并复跑回绿;既有两支反向钉只各加一句注释、
未动断言与取样。全量 1704 pass / 0 fail(基线 1701 + 新增 3),vue-tsc 与 build 均 rc=0。
2026-10-04 19:03:38 +08:00
huangzd1997 ca910c582f test(前端): 补 routeOf meta 抄送与 companyScoped 双向对账(闸门②原来是零约束)
F1 闸门②行为用例: routeOf() 实跑 producer, 取样自 adminPages.superAdminOnly(不写死 menuKey),
   含取样非空自检与"普通页 meta 不许出现 superAdminOnly"的反向自检。
F2 守卫断言从松散 /superAdminOnly/ 收紧为锚在 `if (to.meta.superAdminOnly && !session.isSuperAdmin)`
   真实语句上; 原 /isSuperAdmin/ 那条已被锚定式覆盖且被 index.ts:57 预先满足, 不再单列。
F3 新增 companyScoped ↔ COMPANY_SCOPED_PAGES 双向对账(>=8 页自检)与 17 条声明路径存在性
   (existsSync 作断言不作守卫, >=17 自检)——Task 7 护栏 G1 的分母掉一行不再无人报警。
F4 src/types/vue-router.d.ts 补 superAdminOnly?: boolean, producer/consumer 的键从字符串约定
   变为编译期契约(控制方已追认, 与 task-29.test.ts 那条同批)。
F5 剪枝的角色实参改用 store 自己的 isSuperAdmin getter, 与守卫同一谓词; task-29 正则未受影响。

变异自证 4 轮 + 3 轮加强(注入→红→从原始字节还原并 sha256 复核): routeOf 删抄送行→F1 红;
去一个 companyScoped: true→F3 对账红(含分母保持 8 的方向一/虚增一行的方向二);
清单路径改名→F3 存在性红; 守卫条件改名→F2 红(且"删语句只留注释 token"这一形状旧断言恒绿、新断言红)。
node --test 聚焦 6 文件 37/37; vue-tsc --noEmit rc=0; npm test 1701/1701(基线 1698 + 新增 3 支)。
2026-10-04 18:48:03 +08:00
huangzd1997 5111858346 perf(后台首屏): Element Plus 改按需注册,入口 JS 1,129,783→737,303 B
同一棵树只翻 main.ts/App.vue 做 A/B(其余文件两轮一致,差值可整份归给这条):
入口 JS −34.7%、CSS −45.6%、dist 整树 −567,203 B;A 组跑两次字节与哈希完全相同。

新增 src/plugins/element.ts 显式注册表。没走用户端那套 ElementPlusResolver:
自动引入会把"到底注册了哪些组件"藏进产物,而按需注册的失败模式恰恰是
"漏一个组件不报错、页面渲染成裸标签",只有显式清单才能让护栏从源码推标签
做双向比对。语言包随之换到 App.vue 的 el-config-provider。

顺带摘掉两处重复请求:去重页 reAnalyze 白拉又丢返回值的那次整集 console、
看板 30s 心跳里无条件重拉的店铺候选(后端 SELECT DISTINCT 无缓存的字典数据)。

护栏 10 例(标签清单由 .vue 源码推导,不是手写名单)+ 变异自证 9/9 全杀;
前端全量 node --test 1698 例 0 红。只欠逐页浏览器视觉验证 —— 按需引入最坏的
那类回归不会让构建变红。
2026-10-04 18:38:14 +08:00
huangzd1997 1f23369629 feat(前端): 公司管理加角色内在闸门(注册表+守卫+剪枝)
- 新建 src/config/company-scope.ts:SUPER_ADMIN_ONLY_MENU_KEYS=['admin_companies']
  与 COMPANY_SCOPED_PAGES(批次 1 的 8 页口径清单,后续任务的唯一分母)
- routes.ts:AdminPageDef 加 superAdminOnly/companyScoped;公司管理标 superAdminOnly: true,
  8 个 A 类页标 companyScoped: true,C 类两页显式写 false(声明而非留空)
- helpers.ts:pruneSuperAdminOnly 纯函数(超管原样返回,非超管递归剪掉专属节点)
- router/index.ts:菜单授权之外补一条与菜单树无关的角色判定
- admin-session.ts:菜单树唯一写点内接剪枝(顺序仍在 fetchCurrentUser 之后)
- 新增 tests/company-super-admin-only.test.ts 5 支护栏
- task-29 的主路径断言随唯一写点改写(原断言只认 canonicalize 裸赋值,
  剪枝并入同一写点后必然失配;改为同时要求 prune + canonicalize,意图不降反强)
2026-10-04 18:28:43 +08:00
huangzd1997 ce69fa217c fix(前端): 后台摘掉公司这一维度——列表列/筛选/建号选择/顶栏旁白全部去掉
用户定案:隔离该由数据和后端自己做,不该把"公司"摆到操作员眼前多一个选错的机会。
于是原计划里给品牌库/去重库两页加公司列(Task 9)反向执行,顺带把一期已上线的展示也收掉。

建号归属改为请求体不带 company_id,由后端 resolveTargetCompanyId 落操作者自己的公司。
这条前端删下拉的安全依据完全靠后端那两条分支撑着,所以用跨仓读 Java 源码的方式钉成可执行断言:
谁把那边改成"必填公司"或删掉任一分支,这边立刻红。
副作用要说清——超管建的号一律归公司 1,给第 2 家建号得用那家公司自己的管理员登录。

「公司管理」页的引导语原写"建号时选哪家公司",下拉没了就成了错的承诺;
"停用后不能再用于新建账号"也不再成立(requireActive 两个调用点都要求显式传 company_id,
而页面现在一律不传)。文案改成真实口径,并断言这三句失效说法不得回流。

1683 例 / 0 红,vue-tsc 干净,变异 6/6 被杀。
2026-10-04 16:15:13 +08:00
huangzd1997 fa0cde0706 fix(前端): 三张任务记录列表页日期初值留空,不再默认锁当天
店铺数据记录 / 视频任务记录 / 生成记录同因:任务按创建·提交时间落在过去某天,
默认当天把首屏收成「只有今天」,用户见到「店铺数据记录」首屏空列表后定案撤掉。
「重置」目标同步改为留空,todayDateTimeRange 的 import 一并摘掉。

护栏 date-filter-default-today 把单张豁免名单拆成两张互斥名单(仍默认当天 3 处:
通知铃铛 / 密钥用量统计 / 设备日志;有意留空 6 页),新增补集断言——带日期控件的页
两张名单都没登记就红,同一页写进两张名单也红。清回空值的识别补上 `['', '']` 形态,
否则将来某页移出豁免名单时该断言会恒绿。

前端全量 1688 例 0 红、vue-tsc 干净;三条变异(摘豁免 / 两名单重叠 / 初值偷偷改回
默认当天)全部被杀。
2026-10-04 15:33:47 +08:00
huangzd1997 c9d5cb6c2d test(多公司): task-043 断言补 companyId,消掉 V143 之后唯一那条红
users-filter 自多公司一期起把 companyId 当筛选状态的一等字段返回(未选时为 null),
这条断言还停在旧形状 ⇒ 干净树 npm test 恒 1 红。断言对齐现形状,是否真下发由
company-user-list.test.ts 那支管。
2026-10-04 13:51:34 +08:00
huangzd1997 ab1462af7a fix(前端): 去重台账页日期初值留空,落实 date-filter-default-today 的豁免名单
护栏把 DedupeRegistryPage 列进了 EXEMPT(累计台账默认当天只剩今天新增的 ASIN),
但豁免只是"不拦",页面自己还写着 startDate/endDate = todayDateInput() ——
名单与实现各说各话,首屏照旧少数据。这一笔把初值去掉,让页面与名单一致。
2026-10-04 13:51:33 +08:00
huangzd1997 13bc334d51 fix(看板): 默认视图不再锁当天创建时间,与「进行中任务」卡片同数
卡片 countRunningTasks 的 SQL 不带创建时间窗,列表默认锁当天必然少一截:
10-04 生产实测卡片 39 / 列表 21,差的 18 个是 10-01~10-03 创建、updated_at 仍在
推进的跨天在跑任务(此刻全部 RUNNING,与状态合并、品牌口径都无关)。
时间控件保留、只是初值为空;页头说明改口。

顺带把仓库级护栏 date-filter-default-today 的分母与阈值一起改准:
带日期控件 9 个文件、豁免 3 个 ⇒ managed 6,阈值降到 5 保留一档余量。
2026-10-04 13:31:17 +08:00
huangzd1997 2b55f71610 fix(后台): 403 不再一律当未登录整页踢回登录页
拦截器把 body.code 401 和 403 并成一支,任何一个业务端点的授权缺口都会表现为
"登录坏了":整页 assign 到 /login,当前页连人带未提交的表单一起没了,下一次同类
缺口还得重新做一次归因。收窄成只有会话引导端点(current-user、current-user/menus)
的 403 才跳登录页 —— 那里 403 才真的等于"这个账号进不了后台"(如拿客户端 token 打开后台)。
业务端点的 403 交回页面自己报错,UsersPage 那句"拉失败时列表照常显示、但要把原因说出来"
从此才成立。

判定做成 envelope.ts 的纯函数 shouldRedirectForbidden,两支拦截器都过它;用例同时钉
正反两向(业务端点不跳、引导端点照跳、前缀相似不算)并断言扫描集非空。
2026-10-04 12:57:56 +08:00
huangzd1997 48aad3f2fd feat(看板): 删净在跑店铺看板,进度文案对齐客户端,加国家列,默认筛「在跑」
- 店铺看板整条移除(面板/`/shops`/`shops()`/`TaskCenterShopVo`),汇总卡「在跑店铺」保留;
- 采集数据行进度改成客户端那句「关键词进度:第 N/总 个」(只改文字,数字口径与夹取不变),
  其余无进度条的模块仍显示「—」;
- 列表加「国家」列:值来自 request_json 的 7 条路径(线上实测顺序与覆盖 315/451=69.8%),
  按页内主键点查、不进列表 UNION,以免把大 JSON 列拉回已知慢查询;品牌行不发查询;
  只展示不筛选,无迁移;
- 状态默认「在跑」= PENDING∪RUNNING∪SCHEDULED,前端下发 ACTIVE 哨兵、只在服务层 statusFilter
  一处展开,成员与 ACTIVE_STATUS_SET/ACTIVE_STATUSES 同源钉死;
- 护栏:后端 task-center 77 例(新增状态 IN 渲染、7 路径顺序、归一两形态、品牌不查国家等)、
  前端 21 例;4 个变异点(路径顺序/哨兵不展开/归一截断/文案分支)全部被抓到并字节级还原。
2026-10-04 12:48:18 +08:00
huangzd1997 e832418f4b feat(看板): 变体采集只看在跑,进度列改客户端同源口径
两件事,都是用户当场指出的读数误导:

1. 变体采集页签徽章 106 是麦象历史全量。console 代理一次只接受一个 status,
   故 status 缺省时服务端合并 0(等待)∪1(处理中),按 createTime 倒序后内存切片;
   单状态各拉 200 条,触顶打 warn。前端状态下拉去掉「已完成/处理失败」两个入口。

2. 进度列的「已完成 0 / 总 1」来自 source_file_count(采集/跟价都是单文件任务),
   与客户端进度条不同源。改为按模块分档:COLLECT_DATA 取 result_json 的
   $.totalRows/$.processedRows(与客户端「关键词进度:第 X/N 个」同一对数),
   PRICE_TRACK/SHOP_MATCH 这类客户端本来没有进度条的返回 0,前端 progressTotal<=0
   显示「—」且不再画 0% 进度轨;PUBLISH/DELETE_BRAND/品牌行保持文件数/品牌行数。

护栏:Mapper SQL 渲染 26 例、QueryService 34 例、VariantService 8 例、
ScopeService 7 例;前端 node:test 1653 例。docs/specs/16-client-task-console.md
的「进度口径」一节按新规则重写。
2026-10-04 10:27:09 +08:00
huangzd1997 076b0cd531 feat(多公司): 两端接上公司身份 —— 后台公司目录页、建号必选公司、顶栏显示所属公司
- 新后台新增「公司管理」页(列/新建/改名/启停,不提供删除),路由 menuKey 与
  columns 表的 admin_companies 逐字一致,由用例钉住;操作指引补该菜单一条。
- 建号弹窗对超管必须显式选一家(后端对"不传"仍落操作者自己公司,是给旧后台兜底);
  admin 只能落自己公司,越权直接 403。账号列表显示 company_name,可按公司筛。
- 客户端登录后把 companyId/companyName 落到 localStorage 并在顶栏显示;
  两个登出出口(handleKicked 与切号/登出)连公司名一起清 —— 残留会把上一个账号
  的归属显示给下一个账号。
- 契约分层:列表端点用 snake_case(company_id/company_name),current-user 与登录
  回包用 camelCase;解析器读到另一套写法必须忽略,防止前后端各猜一套。

admin-frontend-vue 1678/1678、frontend-vue 672/672,两边 build(含 vue-tsc --noEmit)干净。
2026-10-04 07:11:47 +08:00
huangzd1997 ea1b1909b2 feat(日志管理): 列表改按上报用户精确筛选,去掉设备/文件名模糊搜索与设备列
- /api/admin/device-logs/files 的 keyword LIKE 换成 uid 等值过滤:device_log_file 只有 uid 没有
  username,模糊匹配设备名会跨用户串结果,而下拉里选中的用户必须是精确命中。
- 采集配置弹窗的 keyword(终端覆盖搜索)与查看器标题里的设备名保留:那是设备维度唯一还有用的地方。
- 新增护栏 tests/device-logs-user-filter.test.ts(5 例,变异自证 5/5 转红):表头回出现「设备」、
  占位行 colspan 与列数不符、接口带回 keyword、下拉没绑上、用户选项没在 onMounted 加载,都会红。
- 上一笔提交里 DeviceLogsPage 已按 uid 传参,本笔补齐 api 层与后端,故单独 checkout 上一笔时 vue-tsc 不过。
2026-10-04 01:19:55 +08:00
huangzd1997 4a6e139ae9 feat(后台): 日期筛选统一默认当天(7 页 + 告警铃铛),并带上看板列改造的在途改动
- utils/datetime 新增 todayDateInput()/todayDateTimeRange(),8 处日期筛选的初值与「重置」都锁当天;
  撞款监控按口径排除(该页日期是 ASIN 上架时间,默认当天会让首屏几乎为空)。
- NotificationBell 的 hasFilter 不再把日期计入:日期恒有值是默认视图,计入会让
  「无筛选才记录已提醒 id」那条分支永久失效。
- 新增护栏 tests/date-filter-default-today.test.ts(6 例,变异自证 3/3 转红):
  凡带日期控件的页面没接入当天默认就红,不等人工发现首屏是空的。
- 同批带上另一路会话的看板在途改动(task-center-model 的 tabCount/完成数口径、
  TaskCenterBoardPage 列改造与对应用例):它与本页的日期默认改动落在同一文件,
  拆开会让单次提交编译不过,故按现状一起上。
2026-10-04 01:19:28 +08:00
huangzd1997 e1f1aa8b16 feat(看板): 客户端任务管理从设备维度改为店铺维度全局在跑看板
原「在线设备」卡按日志上报窗口统计,把 89 台算成在线,与实际在跑的客户端数差一个
量级,且设备维度并不能回答"哪台机器上有任务卡住"。改为:

- 汇总卡:总店铺 / 在跑店铺 / 进行中任务 / 今日完成 / 疑似卡住
- 新增「在跑店铺看板」:当前所有进行中任务按店铺归组(在跑数、卡住数、业务分布、
  最近上报),点店铺行下筛该店铺任务;不落店铺的任务归「不挂店铺」桶
- 卡片与面板同源(同一个 aggregateShops),杜绝口径分裂
- 店铺只认两个真来源:上架结果文件 + 逐店落行的结果文件名;
  biz_task_progress_snapshot.current_scope_key 是实例锁不是店铺,已从口径中剔除
- 设备号退为详情附注,花名册 /devices 与在线判定整条链删除
- 上报口径只留一个 10 分钟窗口(进行中且超 10 分钟无上报 = 疑似卡住)

后端 3487 例全绿;新增反射护栏断言设备维度查询与快照当店铺的来源已彻底移除。
2026-10-03 22:41:29 +08:00
huangzd1997 52ef172803 feat(taskcenter): 任务列表移除设备列
设备维度保留在设备条、设备筛选与详情抽屉;同步更新设计文档 16 的列表字段。
2026-09-29 00:45:52 +08:00
huangzd1997 3a8f6968ff feat(taskcenter): 前端看板页面(页签/筛选/汇总卡/设备条/详情抽屉)
- 路由 task-center/board(menuKey admin_task_center)+ guides 文案,both 由既有门禁守
- api 层 5 个只读接口;详情接口把后端 data:null 归一为 null(unwrap 对 null data 回传信封)
- 页签一:5 项汇总卡 + 设备卡条(点击按设备筛选/再点取消)+ 10 列任务表(stuck/网页/失败角标、进度条)+ 详情抽屉(分组明细)
- 页签二:变体采集专列(不显示设备与店铺),展示麦象 res_mes 与任务参数
- 30s 轮询:页面隐藏跳过、回前台立即刷新、卸载清理;另有手动刷新
- 顺带补 admin_device_logs 缺失的 guide(a7f244f9 登记路由时漏补,align-operation-guide 一直红)

Tests run: 1634, Failures: 0(node --test 全量)+ vue-tsc 无错误 + vite build 通过,
浏览器真跑:页签切换、设备卡筛选、详情抽屉均正常,控制台无报错
2026-09-28 23:35:54 +08:00
huangzd1997 8b4425dcbf feat(密钥管理): 后台可代填并锁定用户代理设置,客户端只读并回填本地配置
代理是选配、不进 items 也不参与门禁,但客户端各任务链读的是本地 app.json 的
proxy_url,用户自填值与后台不一致时排查成本高。改法:

- 后台 PUT/DELETE /api/admin/user-secrets/{userId}/modules/{moduleKey} 代填/解锁,
  写入后该行 source=admin;数据权限走 resolveVisibleUserIds,超管不限;
- 客户端 save/clear 命中锁定行时服务端直接拒绝并给出原因(只置灰挡不住直接调接口);
- 密钥包把代理单独放 proxy 字段下发(仍不进 items、不影响 complete 判定),
  锁定时带 full 明文,客户端据此幂等地对齐本地配置;解锁 = 删除该行。

只开放代理代填:密钥模块要客户端提交任务时携带本地明文,代填会把用户卡死。
2026-09-28 19:39:08 +08:00
huangzd1997 2c47b27746 feat(用户授权): 非超管授权树只下发自己可授予的菜单,保存按操作者范围替换
- 授权树读接口新增 grantableOnly:非超管只返回自己已持有的菜单,可授予项的
  祖先分组随行但置灰不可勾;否则勾父会连带授予树上未下发的范围外后代
- 保存的整树替换把删除范围收窄到操作者可授予集,范围外既有授权(超管直接
  分配的)原样保留——隐藏项不在提交里,全类型删除会把它们静默清掉
- 前端提交剔除置灰分组的派生勾选;菜单权限配置页仍走全量目录
2026-09-23 15:56:50 +08:00
huangzd1997 892d88ed1e feat(后台管理): 实体管理列表统一展示创建时间/更新时间
用户管理、菜单管理、不符合ASIN、数据去重总数据、查询ASIN、最低价ASIN、
商品类目、密钥管理共 8 个实体管理列表补齐两列。分组管理/店铺密钥/店铺管理
此前已带创建+修改时间,任务列表与统计报表(撞款监控、密钥用量、日志、
记录与版本)不含实体更新语义,均未改动。

关键点——时间列必须由数据库维护,否则新列是假的:
这些表的更新走 selectById → 改字段 → updateById,实体带着读出的旧
updated_at 一起写回。MySQL 规则是「UPDATE 显式给某列赋值时不触发该列的
ON UPDATE 自动更新」,不禁写就会把旧值写回去,更新时间永远冻结在首次写入
时刻。按 V125(biz_file_result)既有样板,给 7 个实体标注
@TableField(insertStrategy=NEVER, updateStrategy=NEVER)。

- V131:users / columns 补 updated_at(幂等 ADD COLUMN,仿 V125 写法)。
  存量行被回填为迁移执行时刻,非真实历史变更时间(历史上无记录,无法还原)
- 实体/VO:AdminUserEntity、PermissionMenuEntity、InvalidAsinDataEntity、
  DedupeTotalDataEntity、ProductCategoryEntity、QueryAsinEntity、
  SkipPriceAsinEntity 加/改写 updatedAt;AdminUserItemVo、PermissionMenuItemVo、
  InvalidAsinDataItemVo、DedupeTotalDataItemVo 补 updatedAt;
  AdminUserSecretRowVo 补 createdAt(行级首次配置时间 = 三模块最早)
- 查询ASIN/最低价ASIN 后端 VO 与前端 model 本就有两字段,仅补渲染
- 前端 8 页表格加列,同步修正空态/加载行的 colspan(手写表格,不同步会错位)
- 测试:align-query-asin / align-skip-price 原断言「不允许有更新时间列」
  (像素复刻旧版),按新需求改为断言两列存在;新增 e2e list-time-columns
  覆盖 8 页表头与真实时间值渲染
2026-09-19 15:53:01 +08:00