Compare commits

...

153 Commits

Author SHA1 Message Date
huangzd1997 ed644384cc feat(jd): 分类状态快筛 backend-only pick(d25c91f6 的 backend-java 差集打在 ee613db0 上;jar 不含 V209——20ee7334 留原窗随其配套前端发;后管面从主树 HEAD 单独出包) 2026-11-17 17:14:29 +08:00
huangzd1997 ee613db05b feat(admin): 公司tab条按平台分侧+京东分组作用域只认jd档(2026-11-17 用户口径「亚马逊侧别挂京东-团队,同理京东那边也是」)
- company-tab store:目录按当前平台 tab 拉(loadedPlatform 对撞早退),切台重拉;旧选中仍在新清单则保住,不在回落 id 最小启用公司;新增 refresh() 强制档(公司翻档/启停后 18 页 tab 条同步)
2026-11-17 11:50:13 +08:00
huangzd1997 dc3e7f3b37 test(company): CompanyVoTest 夹具补 platform 列——5c7a310e(V206 平台分侧)给 CompanyVo 加字段时漏更期望列集,本窗发版整量 mvn -o test 抓到(5630 例 1 红),补齐后复跑绿 2026-11-17 09:46:06 +08:00
huangzd1997 db71803430 feat(admin): 京东分类管理并入京东数据库页「分类管理」对话框+删「清除勾选」按钮(V208) 2026-11-17 09:32:24 +08:00
huangzd1997 848fef3b03 test(phase-0): v1.5 京东发布契约预置(后端+用户端)——AC-9 分类口唯一绊线立即绿(后端全仓扫+前端全src扫);Pending Phase 2 后端7支@Disabled(AC-1建单/明细表V208+、AC-2派发三件套、AC-8配额闸)+Pending Phase 4 用户端5支skip(Tab形状/建单体/endpoints/占位卡转正式) 2026-11-17 09:30:44 +08:00
huangzd1997 5c7a310ee7 feat(admin): 账号域三页平台分侧+京东上架额度收口(V206/V207) 2026-11-17 03:29:33 +08:00
huangzd1997 764eeb2914 fix(migration): V202 空位登记 RETIRED_HOLES——并行会话配额迁移未入库,V203/V204/V205 已按序越过 202 上线,该号只能永久让位(铁律 10 豁免机制,来源与改名要求写进注释) 2026-11-17 01:39:37 +08:00
huangzd1997 0f8b37e279 fix(backend): 补记 selectAllGroups 补列进迁移等价账本——47fc0e08 平台超管 500 热修给 XML 补 g.company_id,注解时代原文没有这列,fast 档发版没点本支漏记,本窗 full 闸门抓到;按 selectTaskPage/V188 先例整行摘出账本、点名 NOT_MIGRATED(LEDGER_ROWS 83→82/SELECTS 59→58),复跑 3/3 绿 2026-11-17 01:28:46 +08:00
huangzd1997 71b19e4f69 refactor(evidence): 任务证据特性整体下线(2026-11-17 用户拍板)
删 modules/evidence 10 件+EvidenceProperties 注册+application*.yml evidence 块+V205 迁移(DELETE 菜单行+DROP biz_task_evidence);后管 TaskEvidencePage/task-evidence/路由/菜单键/操作指南同步摘除;chunk 分片通道、崩溃记录器本体与设备日志链保留(BACKLOG B115)。
2026-11-17 01:18:49 +08:00
huangzd1997 aff6c88a7d feat(jd): 店铺分类弹窗下线——工具栏改「批量编辑分类」(勾选跨页记忆)+「京东分类管理」子菜单页 CRUD(V204) 2026-11-17 00:50:42 +08:00
huangzd1997 3279b779e6 feat(admin): 侧边栏顶部加亚马逊/京东平台tab切换(2026-11-16 用户定案「不混一起」) 2026-11-17 00:01:19 +08:00
huangzd1997 9d7da26c26 style(jd): 分组下拉上移进筛选行做成带标签表单控件(2026-11-16 用户口径「做成分组」)——工具栏裸下拉与锁定芯片整体搬进筛选行 form-group(label「分组」+select/锁定芯片同壳同圆角,与其他筛选一致);分组仍是作用域非筛选条件,「重置」不清它(新增挂载用例钉住);锁定芯片只放组名(「分组」二字在标签),超宽省略号收口。判据:vue-tsc rc=0;jd 页挂载 36/36(含新钉形状+重置语义两格);jd 纯逻辑 8/8;ops 快检 overall=pass(裸 cmd 壳后端两格环境假红已按 AGENTS.md 前置 Git PATH 复跑转绿) 2026-11-16 23:10:00 +08:00
huangzd1997 47fc0e0850 fix(jd): selectAllGroups 补 company_id——平台超管 500 的真因在这里
上一笔(7067d538)按堆栈把 NPE 挡在 assemble 里,但那一层只是表象。真因是这条查询:
`SELECT g.id AS id, g.group_name AS groupName` 没投影 `company_id`,于是平台超管这条路上
每一行的 `companyId` 都是 null ⇒ `companyNames()` 收到空集合返回 `Map.of()` ⇒ 不可变空 Map
取 null 键抛 NullPointerException。现网 21 个分组里 19 个其实有归属公司(company_id=1),
是我们自己的投影把它们读成了空——这也解释了为什么「非超管一切正常、只有超管整页 500」。

- SQL 补 `g.company_id AS companyId`;
- 公司前缀改为**只在可见组跨不止一家公司时**才加:现网就一家公司,给每个组都挂同一个公司名
  只是噪声;单公司/缺归属一律只显示组名(顺带保证不会再对空 Map 取 null 键);
- 新增 `ShopManageGroupScopeSqlTest` 钉投影(这是「组归属公司」的唯一来源,少了就复发);
  `JdCategoryScopeServiceTest` 按新规则补「单公司不加前缀」「跨公司带前缀且缺归属只显示组名」。
2026-11-16 22:22:21 +08:00
huangzd1997 cac5b8ae7d style(jd): 工具栏下拉与按钮统一 42px 控件外壳
用户口径「很丑,样式要统一一下」:这一行原先只有 `.btn` 有壳,两个原生 `<select>`
落成 28px 灰框、字号也不跟,与旁边 42px 按钮同排时高矮不齐;「只有一个分组」时的
锁名又是个裸文字,与「多组下拉」两种形态占位不同高。

- `.jd-toolbar select`:套用与 `.form-group select` / `.btn` 同一套数值(42px 高、
  9px 圆角、#cbd9e6 描边、#f8fbfd 底、13.5px 字),箭头用内联 SVG 自绘
  (`appearance:none` 后补 padding-right 给箭头留位),hover/focus 与表单控件同色。
- `.jd-group-locked`:做成同高静态芯片(浅底 + 细边),一组锁定与多组下拉占位一致。
- 删除勾选 `margin-left:auto` 推到行尾(原先挨着「店铺分类/分类筛选」,会被读成同一组动作);
  顺手删掉早先遗留、已无人使用的 `.jd-remove-btn` 规则。
2026-11-16 22:06:50 +08:00
huangzd1997 7067d5380d fix(jd): 平台超管在「组归属公司全为 NULL」时整个京东数据库 500
线上实录(2026-11-16 22:00):`JdCategoryScopeService.assemble` 抛 NullPointerException,
`/api/admin/jd-products`(列表)、`/api/admin/jd-product-groups`(分类列表)、
`/api/admin/jd-product-groups/scope` 三个端点同时 500,页面提示「京东商品列表加载失败:
服务器内部错误」,分类下拉与「店铺分类」弹窗全空。

真因不是 V203 的 SQL,而是「不可变空 Map 上取 null 键」:`companyNames()` 在
「一个公司 id 都取不到」时返回 `Map.of()`,而 `biz_shop_manage_group.company_id` 按 V153
口径允许为 NULL(组长账号已不存在、归属无从追溯),于是 `Map.of().get(null)` 抛 NPE。
平台超管(跨公司视角)是唯一会读这张映射的档位,所以只有超管看到整页炸。

改法:组归属公司为空/非正时直接不取映射,只显示组名(有归属的照旧带「公司 / 组」前缀)。

新增 2 支判据:`平台超管_组归属公司全为NULL时不炸且组名不带前缀`(复现线上形状,
并断言不去查公司表)、`平台超管_组归属公司部分为NULL时只给有归属的加前缀`。
2026-11-16 22:06:46 +08:00
huangzd1997 61ab844e5d feat(jd): 京东店铺分类按数据权限分组隔离(V203)
用户口径:不同组不能看到跨组的分类;当前组只管理员可以编辑分类,同组普通号可以进弹窗看但不能增删;
平台超管全量可见可编辑,公司超管管本公司全部组;归类也按组隔离且不再置人工编辑锁。

数据模型:biz_jd_product_group 加 owner_group_id(NOT NULL DEFAULT 0,
uk_company_owner_name(company_id, owner_group_id, name));新增 biz_jd_product_group_assign
(product_id, owner_group_id, category_id, uk_product_owner) 承接归类,同一商品各组可各自归类;
biz_jd_product.group_id 保留但零读零写。

权限:新增 JdCategoryScopeService(GET /api/admin/jd-product-groups/scope 回可见组 + 每组 editable)
四档矩阵;分类增删改与归类走 requireWritableGroup 403;商品行写(编辑/删除)仍只平台超管。

读面:列表/筛选/详情/归类一律按 owner_group_id,分类筛选 group_id 走归属表 EXISTS 下推
(不在 Java 侧 filter);用户端 /api/jd-collect/groups 按登录用户可见组收窄。

前端:工具栏「分组」下拉(多组才渲染,单组锁定显示);店铺分类弹窗对所有有该页菜单权限的人可见,
但按 editable 隐藏新建/改名/删除/勾选/归入移出;编辑抽屉「分类」下拉下线;只读提示改为
「只读:编辑/删除仅超级管理员可用;分类由本组管理员维护」。

验证:后端 mvn -o test 整量 5610 例 0 失败 19 skip;后管 npx vue-tsc 绿 / node --test 1919 绿 /
vitest 132 绿;用户端 vue-tsc 绿;python scripts/_push_gate.py --fast overall=pass。
迁移实跑与真机页面验收留发版窗口(本机无 MySQL/OSS);V203 需与另一路 V202 同窗口发布。
2026-11-16 21:09:44 +08:00
huangzd1997 e621deea58 feat(jd-collect): 建单页按京麦店内分类多选采集
客户口径「类目不需要只要分类」「做成多选的」:采集建单页下线类目级联与平台分组,
换京麦「店内分类」快照多选(getShopCategoryList 2026-11-16 取证 9 个,见
ops docs/jd-collect-api-contract.md §2.6)。建单请求体/页面推送/兜底拉取三处同键
shopCategoryNames+shopCategoryIds(label+id 双键,行级填充形状未取证,客户端任一
命中即命中);categoryPaths 标 @Deprecated 仅历史行兼容。超长归一化文案泛化为
normalizeStringSelection;历史行 VO 带回双键供重试/继续同源。
删除建单页唯一消费方的死件:JdCategoryCascader.vue/jd-category-tree.ts/其测试
(后管另有在用副本,不受影响)。

判据:JdCollectTaskServiceTest 三例(双键归一化/空白归 null/51 个拒)+
JdTaskPullSpiImplTest 七键载荷透传;前端 jd-collect-tab/jd-shop-category/mount
三支(快照消费、双键同链、绊线:级联组件与分组接口不得回流建单页)。
可读棘轮:JdCollectTab.vue 804→786 行(同款返回按钮 CSS 合并、死 .download 类删除)。
客户端侧(app_client jd_base 行级过滤)同窗另一仓提交。
2026-11-16 20:14:40 +08:00
huangzd1997 61c361222d fix(user-secret): 龙抬头渠道模型从 gm-3.5-flash-lite 改回 gm-3.1-flash-lite(2026-11-16 用户拍板;贞贞不变,检测/外观专利/相似ASIN 映射与注释同步) 2026-11-16 19:45:59 +08:00
huangzd1997 8413cd335e feat(jd-database): 京东数据库写权限收窄到平台超管(编辑/删除/归类/分类管理)
2026-11-16 用户口径「京东数据库只有超管有编辑删除权限」:读(列表/类目/详情/分类列表)仍按 admin_jd_database 菜单权限放行;写(编辑、上传/替换图片、单行删除、批量删除、批量归类、分类新建/改名/删除)在菜单权限之上再要求平台超管(DeviceSessionPolicy#isSuper 只认站点 super_admin,company_super_admin 不在内),非超管 403。后端照 BrandGatingController#requirePlatformSuperAdmin / AdminDeviceLogController#requireSuperAdmin 同一判据;前端非超管隐藏勾选列/操作列/删除勾选/店铺分类入口并显示只读提示,列表/筛选/详情照常可用。判据:AdminJdProductControllerTest 新增读写分档结构钉+非超管 403 行为钉(商品五条写路由+分类三条写路由),挂载契约新增非超管只读/超管写入口两条。
2026-11-16 18:54:26 +08:00
huangzd1997 5aab38cfa9 fix(jd): 恢复店铺分类管理与类目筛选 2026-11-16 18:27:12 +08:00
huangzd1997 8c81546aa7 feat(jd): 整合自定义分类并保护商品数据 2026-11-16 16:12:04 +08:00
huangzd1997 79eb7a7f16 fix(jd): 类目面板超视窗定位钳制(B114 尾件入库)——面板打开/栏数与搜索态变化后按真实 rect 重算 left 偏移,右缘贴齐视口后下钻向左生长,末栏不再被窗缘裁掉;钳制数学抽纯函数 jd-category-cascader-position.ts+4 例纯逻辑测试 2026-11-16 14:02:54 +08:00
huangzd1997 a5e390750b refactor(slim-r3): 删除零引用死模块——keywordshare/debug/PublicWorkbenchClientVersion 三线 40 件
Project-Slimming 第三轮收尾执行(用户拍板「零引用的也都要删除」):
定谳依据=6.4 天生产访问日志零流量(970 万行单遍对撞,26 UNIQUE 前缀防撞车)
+四树代码零引用(后端类名/包名/字符串、admin、用户端、app_client 全扫)
+V163 建菜单→V165 撤菜单的历史链(功能入口 10 月底已下线,Controller 成孤儿)。

删除(40 件):
- modules/keywordshare 整模块 31 类+4 mapper XML+KeywordShareServiceTest
  (后管 V165 已撤菜单、app_client 同步链 kw_share_api 亦无调用方;
  biz_keyword_share 等表按「已应用迁移不可回改」保留在库)
- modules/debug 2 支控制器(/debug/request-info、/debug/task-recovery/*)
- workbenchclient/controller/PublicWorkbenchClientVersionController
  (/api/workbench-client/version/latest:app_client 实际走 /api/version/latest,
  admin 侧仅文案引用,无任何真实调用方)
- config/KeywordShareSyncProperties(唯一消费方 KeywordShareService 同批删)

同步编辑:
- AdminApiGuardFilter:摘 DEBUG_PREFIX 前缀(常量/javadoc/审计日志块/requiresCredential/
  guardedPrefixes 五处);ApiGuardCoverageAuditor:METHOD_GUARDED_PATHS 摘 /api/keyword-share
- PropertiesConfig 摘 KeywordShareSyncProperties.class;application.yml 与
  application-local.example.yml 摘 keyword-share-sync 段与两个 env
- 台账两处扣减:XML_SELECT_TOTAL 114→103(11 select)、XML_STATEMENT_TOTAL 164→147
  (11 select+4 insert+1 delete);MigratedSqlEquivalenceTest.NOT_MIGRATED 摘 12 条点名
  (tsv 基准账本零 KeywordShare 行,LEDGER_ROWS/LEDGER_SELECTS 不动)
- PendingPhase5ReadPathTest 摘 P1-B2(RAND 断言随 XML 删);ApiGuardCoverageAuditorTest
  前缀总数 25→24;AdminApiGuardFilterTest 摘 4 支 /debug 用例与 2 条边界 URI
- admin:workbench-client-api 死常量、页面头注释与 page-hint、operation-guides 指南文案
  摘被删端点字样;align-workbench-client.test 摘 3 条对应断言

零行为影响:全部删除件在 6.4 天窗口内零流量;守卫过滤器行为对现存前缀不变
(/api/admin、用户态、自助清单原样)。
2026-11-16 12:18:05 +08:00
huangzd1997 c9ecae6e6d feat(jd): 京东数据库与建单页类目面板换京麦授权类目真树(2026-11-16 客户拍板「京麦类目是这些 我们后台的现在的不对」+「你直接爬」)
真机取证京麦首屏接口 getVenderLicenseCategory(62KB:一级就 3 个=该店铺授权经营类目 服饰内衣1315/母婴1319/运动户外1318,250 个末级,最深 4 级;落库末级名样本「艺考形体服/啦啦队服/拉丁舞服」都在树内 level 3=category_path 等值过滤契约成立;4 组末级同名跨支如实登记,取证件 D:/tmp/jd_cat_probe/)。两份 jd-category-tree.ts 正本同轮重写;JdCategoryCascader 重做京麦同款逐级下钻+末级选中(admin 单选过滤/建单页多选 categoryPaths),搜索搜树内末级(行 title 带路径)+树外兜底段(京麦树已无的历史名仍可选);建单页 hint 文案随真树口径更新。判据:vue-tsc×2 rc=0;node --test 树测试 6/6×2+jd-collect-tab 9/9;vitest admin mount 28/28、用户端 mount 78/78(「勾选类目」用例改真树下钻 运动户外>舞蹈体操鞋服/装备>艺考形体服);fast 闸门 overall=pass 四面绿
2026-11-16 12:16:18 +08:00
huangzd1997 7b853a605e fix(jd): 京东数据库摘除公司 tab(2026-11-16 用户定案「删除掉公司 tab 参考品牌数据库」=品牌库 2026-10-06 先例同形:摘的不只是 tab)——前端 admin_jd_database 退出 COMPANY_SCOPED_PAGES 注册表(定案注释+「公司维度不得回流」SHARED 清单钉住)+routes companyScoped:false+页面卸 companyTab watch 与两处 companyId 发送口(列表 params/类目下拉 fetchJdProductCategories 无参化,JdProductAssignPane 取数同形);后端读侧同窗摘:XML productConds 与 selectProductCategories 的公司维谓词删除(行 company_id 列保留=同步来源标记,JdSchemaContractTest 契约不动)、JdProductMapper.countProducts/selectProductPage 8 参、selectProductCategories() 无参、JdProductQueryService.page 10 参+Filter 去 companyId、AdminJdProductController.page 10 参数+categories(request) 去 superAdminScopedCompanyId 与 DataReadScope 注入、JdCollectController.categories() 调用方同步。判据:vue-tsc rc=0;node --test 9 文件 56/56(wiring SEND_POINTS 27→25、分组 21→19、watch 分母 12→11;menu-route 钉 companyScoped=false;jd-page 钉退出注册表);vitest mount 28/28(删「切公司 Tab 重取」用例,companyId 发送口全改 not.toHaveProperty);mvn -o test-compile rc=0;mvn -o test jd 模块全绿(AdminJdProductControllerTest 20/20:结构判据改「读侧零公司维度_公司tab口径整批摘除」反向钉 company_id/superAdminScopedCompanyId/DataReadScope 不得回潜,行为样本改 requireJdAccess 正门装 200 信封) 2026-11-16 12:05:18 +08:00
huangzd1997 3bccc97698 feat(jd): 普通账号在京东侧可见管理员店铺分类(2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」)——服务端新增 GET /api/jd-collect/groups 只读端点(复用 JdProductGroupService.list,requireOwnershipUserId fail-closed,与 categories 同形,无公司维度:分类是平台级全集);用户端「获取店铺数据」页加载即拉取,只读 chips 展示分类名+商品数(title 带明细),空态点名「管理员在京东数据库→店铺分类建」,拉取失败 warning 不阻塞采集主路(catch 棘轮 318→319 逐条点名);endpoints 冻结快照随带 dated 追加。判据:mvn -o test JdCollectGroupsEndpointTest 2/2;vue-tsc rc=0;node --test 定向 21/21;vitest mount 11/11(+2:chips 渲染带 count/空态提示);fast 闸门 overall=pass 四面绿;JdCollectTab.vue 791<800 棘轮线。商品上架侧落地时消费同一端点(欠账入 ops BACKLOG B113) 2026-11-16 03:18:42 +08:00
huangzd1997 9b6f00a2dc feat(jd): 京东数据库工具栏加「移除分类」批量按钮(2026-11-16 用户截图反馈)——走 batch-assign-group 的 groupId=null 出口(与店铺分类弹窗「移出分类」同一后端语义,同置人工编辑锁);勾选里只算已分类行(未分类行没有分类可移,不白吃人工锁),按钮常显、全未分类时置灰带提示;确认弹窗点名数量与人工锁后果、danger:false(可恢复动作);删除/移除两流程互斥(deleting/removingGroup 交叉闸)。纯逻辑抽 jd-group-remove.ts(removableGroupPicks/removeGroupConfirmMessage,node --test 可直测)保 JdDatabasePage.vue 798<800 可读棘轮线。判据:vue-tsc 零错、vitest 京东页 29 例全绿(+3:计数只算已分类/取消不发/失败文案透出+danger:false 钉)、node --test 8 例全绿(+2)、confirm-exit-ledger 5/5(danger 键显式)、可读棘轮 10 passed、fast 闸门 overall=pass 四面绿 2026-11-16 02:44:27 +08:00
huangzd1997 301e3c5ecb fix(jd-collect): 建单页类目级联改 fixed 浮层——2026-11-16 形态核对实录(vite 5173 真页验收):建单页侧栏仅 ~370px,原 absolute+left:0/right:0 把三栏压到每栏 ~120px(一级名截成「服饰…」);首改容器溢出展开虽舒展,却把文档撑出横向滚动条(absolute 溢出必然进 scrollWidth)。终版按京麦本尊浮层形态:面板 fixed + toggle() 打开瞬间按触发框 getBoundingClientRect 定位(top=bottom+4、left 钳进视口,宽 min(652px, 100vw-16px),三栏 200+200+250 刚好舒展),fixed 不撑文档横向滚动——真页实测 docHScroll=false、面板 20/219/652、勾选 2 类目触发框「已选 2 个类目」+按钮「获取选中类目数据」、清空/搜索/空态文案全过。测试环境(happy-dom)rect 全 0,panelPos 落视口原点不影响 mount 断言。判据:npx vue-tsc --noEmit rc=0;catch-silence/endpoints/jd-collect-tab/jd-category-tree 22 绿;mount 9 绿 2026-11-16 02:38:31 +08:00
huangzd1997 d680a0beca refactor(jd): 图片区拆出 JdProductImageManager 子组件——编辑抽屉 856 行超后管 800 报警线(超长棘轮清单只许减) 2026-11-16 02:29:43 +08:00
huangzd1997 2a4598216a feat(jd): 编辑抽屉图片区(×右上角+替换/新增本地图)+详情抽屉改京麦左图右信息布局(B109-01 落地) 2026-11-16 02:20:17 +08:00
huangzd1997 dca5d6f554 fix(jd): 京东数据库创建/修改两列下线(2026-11-16 客户口径「也可以不要采集」,同状态列口径:jd_created_at/jd_updated_at 仍收详情抽屉,列表时间列只剩同步时间收尾)——表格 9→7 列,mount 列序断言重排(td[8]→td[6]、表头 gone 名单+创建时间/修改时间)。判据:vue-tsc rc=0、vitest 京东页 26 例全绿 2026-11-16 02:17:58 +08:00
huangzd1997 3cbaf06583 fix(jd): 京东数据库列序三笔(2026-11-16 客户口径)——①「上架时间 / 商品状态」合并列整列下线(「不需要采集」,jd_online_at/sale_status 仍收详情抽屉,jd-sale-* CSS 随删);②操作列置末(编辑/删除)并修删除不可见真因:列宽 120px<实测 138px(ops-cell-must-wrap 双按钮口径),压线溢出被 td overflow:hidden 裁成「编辑+…」形状,改 138px+.jd-ops-cell overflow:visible/nowrap 兜底;③批量删除常显(「不要勾选后才显示」:去 v-if,勾选 0 置灰)。mount 测试列序断言 10→9 列重排、td[6]→td[8]、批量删除常显/置灰三态断言。判据:vue-tsc rc=0、vitest 京东页 26 例全绿、node --test 相关静态面 37 例全绿;fast 闸门唯一红格=他人在飞件 JdProductEditDrawer.vue(857行) 超长棘轮(562e81df 已预告,归属不在本笔) 2026-11-16 02:08:58 +08:00
huangzd1997 562e81df81 fix(jd): 三把尺子对类目多选笔的收口——① JdCollectTab loadCategoryOptions 失败分支补 ElMessage.warning(原只 console=静默 catch 棘轮逐文件台账红;口径 console+用户可见出口),catch-silence 基线 blocks 317→318 逐条点名登记(非静默只进 blocks,silent 82 不动);② endpoints 冻结快照显式追加 jdCollect.categories(快照测试在 node --test 全量档红);③ jd-collect-progress 挂载用例夹具同步 4 参建单与带 categoryPaths 的推送载荷,并新增「勾选类目→建单/推队列同链下发」用例(级联面板点选→请求体 ['女装']→payload.data.categoryPaths ['女装'])。判据:node --test 1061/1061、vitest 85/85、vue-tsc 零错、catch-silence 4/4。可读棘轮的 JdProductEditDrawer.vue(857行) 红是他人在飞件(后管编辑抽屉,未提交),归属不在本笔 2026-11-16 01:54:25 +08:00
huangzd1997 9e3f28079b feat(jd): 建单页加京东类目多选级联(客户端窗口同页面,选类目去采集同步后台)——JdCategoryCascader.vue+jd-category-tree.ts 从后管复制改多选(第三栏已落库末级全集+搜索点选 toggle,方点 checkbox,全部类目=清空=全店采集;触发框暗色主题适配,「已选 N 个类目」;选项空态不阻塞建单);JdCollectTab 左面板加「采集类目(可选,多选)」,startCollect/pushToClientQueue/retryTaskRecord 三处全链带 categoryPaths(重试从历史行同源带回,推送载荷与建单请求体、兜底拉取三处同键);jd-collect.ts 加 fetchJdCollectCategories/createJdCollectTask 第4参/JdCollectHistoryItemVo.categoryPaths;endpoints 注册 /api/jd-collect/categories。判据:jd-collect-tab.test +3 源码绊线(payload 带 categoryPaths/建单传参/重试带回)+categories 端点注册,jd-category-tree.test 与后管同判据两份正本同形;vue-tsc 零错、node --test 10 例全绿。客户端读参过滤另笔(多仓边界) 2026-11-16 01:17:37 +08:00
huangzd1997 8b4f7a3a6b feat(jd): 采集建单支持按京东类目圈范围(多选末级类目,客户端按 categoryPath 等值过滤)——JdCollectTaskCreateRequest 加 categoryPaths(null/空=全店采集,现行为不变),validate 归一化写回请求体再进 request_json(trim/去空/保序去重,上限 50 个/单名 100 字,超限当场点名拒);JdTaskPullSpiImpl.buildQueuePayload 载荷加 categoryPaths 键(缺省空列表,键集稳定,兜底拉取与页面推送同源);JdCollectBoardService 历史行同源带回 categoryPaths(重试/继续从历史行重建推送载荷不丢类目);JdCollectController 新增 GET /api/jd-collect/categories 用户域类目下拉端点(requireOwnershipUserId fail-closed,复用 JdProductQueryService.categories(null) 公共库全量口径,SQL 零新增;从未采集的店铺类目不在集内,先全店采一次即有)。判据:JdCollectTaskServiceTest +3(归一化落 requestJson/超上限拒/全空白视为不过滤)、JdTaskPullSpiImplTest 键集断言加 categoryPaths+透传用例、JdCollectBoardServiceTest 历史行带回断言;三支测试类 16 例全绿,mvn -o test-compile 零错。客户端读参/过滤与用户端建单页另笔(多仓边界) 2026-11-16 01:10:56 +08:00
huangzd1997 9f869b2e81 test(jd): jd-product-group 价格断言同步 decimalText 去尾零口径(12.90→12.9,与详情 SKU 价同出口) 2026-11-16 00:40:54 +08:00
huangzd1997 46a334004a fix(jd): 京东数据库价格列恢复显示+时间三列后移(2026-11-16 客户三问) 2026-11-16 00:38:14 +08:00
huangzd1997 ee3ff6fe8c feat(jd): 类目筛选改京麦同款级联面板(一/二级静态导航+末级全集搜索点选) 2026-11-16 00:14:10 +08:00
huangzd1997 4506253989 feat(jd): 店铺分类弹窗新建收成+图标/排序输入下线;京东数据库下线店铺筛选与列(后端 shop_name 参数同窗撤) 2026-11-15 23:58:52 +08:00
huangzd1997 6818f9777b fix(test): 两处 SQL 账本补记 JdProductMapper#countByUserIds(b9b66bcb 漏记,发版前整量抓到) 2026-11-15 23:22:41 +08:00
huangzd1997 d0aa93759d feat(jd): 京东数据库筛选行加「分类状态」下拉(全部/已分类/未分类) 2026-11-15 23:00:13 +08:00
huangzd1997 e175e85973 feat(jd): 京东数据库分组改店铺分类+左右分栏弹窗人工归类 2026-11-15 21:46:26 +08:00
huangzd1997 91cf5dfaf7 feat(jd): 京东数据库公共化——数据不区分公司、分组全平台一份(2026-11-15 用户定案) 2026-11-15 20:26:55 +08:00
huangzd1997 b9b66bcb0b feat(jd): 商品上架数量上限配置(默认 5000,管理员+名下员工合计口径,2026-11-15 用户口径)——aiimage.jd.max-products-per-admin(env AIIMAGE_JD_MAX_PRODUCTS_PER_ADMIN,0=不限,yml 与 @Value 同默认、application-local.example.yml 同步)+ 新增 JdPublishQuotaService 配额原语:计数源=biz_jd_product 按 owner uid 集计行数(JdProductMapper.countByUserIds,SQL 收口 XML,空集服务侧按 0 不进 SQL);uid 集复用 UserDataScopeSupport.resolveVisibleUserIds(管理员=本人+名下员工/分组成员+created_by_id 兜底,公司超管=全公司),普通账号先锚定 created_by_id 指向的管理员(读不到回退自己);站点超管豁免(走 DeviceSessionPolicy.isSuperAdmin 单出口)。出口两个:quotaOf 只读快照(供上架界面展示余量)+ assertWithinQuota 建上架单前的配额闸(超限抛 BusinessException,文案含占用/上限数字)。⚠ 本笔无生产调用方——商品上架功能目前是用户端占位卡(建设中、后端零代码),本笔只落配置与可测配额服务,不改任何现有链路行为;上架功能落地时在其建单入口调用 assertWithinQuota。判据:JdPublishQuotaServiceTest 7 例全绿(默认 5000/0=不限不查库/锚定到管理员/边界恰好等于上限放行/站点超管豁免/空集 used=0/读不到主管回退);后端 mvn -o test 编译零错,Jd*Test 108 例 107 绿(唯一红=另一路会话在飞件 JdProductUpdateServiceTest:182 与其 Service:130 的 never() 冲突,两文件均属在飞改动、与本笔零交集,未代改);ops 配置棘轮 test_no_implicit_config_switches 7 passed 2026-11-15 20:18:27 +08:00
huangzd1997 84a4bc38b5 feat(jd): 京东数据库货号系统生成——行号即货号(2026-11-15 用户口径「系统自行生成货号,不用之前的货号;从 1 开始递增或随机数(唯一)」):新落库行 item_num 在回传落库后由 reassignItemNums 刷成行号(CONVERT(id, CHAR)——全局唯一、从 1 递增、行不变货号就不变,零并发竞争);upsertBatch 的 UPDATE 段摘掉 item_num 覆盖(重爬命中已有行不得把系统货号刷回京东原值,绊线钉住);锁定行(manual_locked=1)不刷——人工编辑过的货号优先;京东原货号仍在 attr_json 属性区留档溯源。存量行随下一次同店铺重爬刷成行号(item_num != id 命中);如需立即生效可对存量跑一次同款 UPDATE(发版窗口决定)。判据:SyncServiceTest +3(落库后刷写被调/整批被保护不刷/UPDATE 段不覆盖+刷写排除锁定行的 XML 绊线);SqlLayeringConventionTest 账本 162→163 逐笔记名。同笔修存量红:CompanyIdParamGoesThroughReadScopeTest 的 ProductCategory 子串锚剥除 JdProductCategoryVo 字样(京东商品库自己的类目下拉 VO 与全平台共享表无关,子串撞车把整个 AdminJdProductController 误拖进消费者清单;剥字样非整行排除——同行真引用 ProductCategoryEntity 照样命中,护栏意图不削弱)。后端整量 5,610 例 0 失败全绿;编辑抽屉货号 label 注明「系统生成=行号,可改」 2026-11-15 19:03:40 +08:00
huangzd1997 dea9891e19 feat(jd): 京东数据库行级编辑与删除+人工编辑锁/删除忽略保护(V199,2026-11-15 用户口径「每条数据可以编辑/删除」)——主链:PUT /api/admin/jd-products/{id} 主字段全量提交即置 manual_locked=1(采集回传 upsert/purge 对锁定行跳过,XML 侧 AND manual_locked=0 铁律 20);attrGroups 只重建 attr_json 的 tabs 段保留其它顶层键(铁律 30),原文形状不识别拒绝;skus 按 (productId,skuId) 改价改库存缺失拒绝;deleteImageIds 先删桶(共用对象保留)计数按表实数刷;删除链成功后写 biz_jd_product_ignore 防重爬复活(幂等吞 DuplicateKey);采集回传 filterProtectedRows 跳过锁定/忽略行不登记子表。后管:列表 11 列操作列(编辑/删除,@click.stop 防冒泡)+ JdProductEditDrawer(主字段/属性键值行删/SKU 价格库存/图片标删,保存提示人工维护后果),updateJdProduct 带 company_id;company-tab-wiring SEND_POINTS 26→32(补详情/删除/分组/类目/删分组/编辑六口一函数一钉对平)。判据:JdProductUpdateServiceTest 8 例+SyncServiceTest 保护闸/绊线+DeleteServiceTest 忽略登记+mount 操作列防冒泡/编辑抽屉;后端整量 5,607 例、后管 vue-tsc+1903+113 全绿。同窗交织笔(另一路会话类目下拉已收尾,文件级无法拆分一并入库):selectProductCategories/GET /categories/JdProductCategoryVo 类目筛选下拉+MigratedSqlEquivalenceTest/SqlLayeringConventionTest 适配。图片上传/替换链路记 BACKLOG B109-01;RawExceptionMessageSinkGuard/CatchSilenceRatchet 随笔抬格逐处记名 2026-11-15 18:38:27 +08:00
huangzd1997 7a117187b7 fix(frontend): 京东采集撤出亚马逊工具台(2026-11-15 用户口径:不要出现在亚马逊那边)——amazon/tool-catalog.ts 移除 jd 卡片/渐变/图标/详情四处;入口收敛到首页一级「京东」工作台(pages/jd/tool-catalog.ts 自带「获取店铺数据」卡,路由 /jd-collect 与 endpoints 不动);amazon-tool-catalog.test.ts 21→20/前端组9→8并加「京东不出现在亚马逊」绊线;jd-collect-tab.test.ts AC-1 契约改为钉京东工作台卡片形状 2026-11-15 17:20:58 +08:00
huangzd1997 5d5330d0c9 feat(jd): 后管京东数据库列表按京麦样式重排(2026-11-15 用户口径)——店铺/分组前置为第 1/2 数据列;商品信息列京麦同款合并布局(主图+图下信息分+标题两行+商品编码带一键复制+货号+SKU 数标签),品牌/价格区间/总库存/商品状态/同步时间随后;类目/上架时间/创建/修改仍收详情抽屉(B104 口径不变) 2026-11-15 12:33:49 +08:00
huangzd1997 700e7c8518 fix(frontend): 批量删除不再逐条弹框/逐条刷新,删完统一报一次总数 2026-11-15 12:31:35 +08:00
huangzd1997 1c3395869e feat(jd-collect): 采集进度卡片显示百分比——countLabel 带分母「已采集 N/M 个商品(X%)」(TaskItemCard 有 countLabel 就不显示总进度行,百分比只能随 countLabel 出;无 total 仍不编造分母) 2026-11-15 12:26:14 +08:00
huangzd1997 ab6e49b5e2 feat(jd): 京东店铺重爬覆盖旧数据——isEnd 落 SUCCESS 后清理本次没采到的旧行(SKU/图片级联,0 行不清 B94-01,在飞任务行不动) 2026-11-15 11:15:44 +08:00
huangzd1997 9c8926068d fix(jd): 后管京东数据库列表裁成部分字段(12 列),全量属性收进详情抽屉(B104) 2026-11-15 04:27:48 +08:00
huangzd1997 edc1772683 test(jd-collect): 任务面板四端点撞三处基线的合法增量逐处点名登记——身份出口写133/读67、分页台账61、catch 1097->1098(净新增一枚:BoardService 旧载荷解析兜底;scope解析是搬家不占格) 2026-11-15 03:22:06 +08:00
huangzd1997 45d0989ada feat(jd-collect): 任务面板改版——后端 dashboard/history/progress-batch/delete 四端点+前端左按钮右 TaskCenterPanel(历史/断点续传/中断/重试走通用原位复位) 2026-11-15 01:56:37 +08:00
huangzd1997 55f4f17480 fix(jd): 后端整量三处棘红闭环——catch 棘轮逐处记名放宽(1092→1097/rethrow 382/notRethrow 619/logOnly 196)、XML 总数 159→160、SKU 组合序列化 catch 挂 [silent-degrade] 锚点 2026-11-15 00:40:01 +08:00
huangzd1997 85f8ebc3c7 fix(app-web): 版本面板「已是最新」不再出更新按钮+行内动作按钮字号钉死 12px 2026-11-15 00:01:33 +08:00
huangzd1997 402447af70 feat(jd): 列表列对齐+主图投影+SKU 矩阵+删除链收口(B101/B102 服务端与后管) 2026-11-15 00:01:24 +08:00
huangzd1997 8d8c88a5f3 fix(jd-collect): 补「激活」这一步——页面先 PENDING->RUNNING 再推客户端队列,否则分片全被拒
真机 task 34399 实录:页面建完单直接推客户端,任务仍是 PENDING,JdResultIngestService 只收 RUNNING 的分片、心跳对非 RUNNING 回 alive=false,客户端第一个分片被「任务不在运行中(PENDING),回传被拒」后当场收手,采集白跑一轮。相似ASIN/货源/外观专利/数据采集四条链都有同名 activate 入口,京东这条在建单入口漏了。
2026-11-14 21:32:49 +08:00
huangzd1997 47278ee425 fix(phase-6): 后端整量两处棘轮红闭环——归属谓词改走 TaskFinalizeSupport 出口、读类身份出口分母 64->65 点名登记
整量 mvn -o test 首跑 5540 例 2 红(闸门 73 格不覆盖这两把尺,正是 AGENTS 记的「full 闸门绿 != 后端整量绿」):

1) TaskLifecycleDebtRatchetTest 15 -> 16 文件:36e110d2 的 JdCollectTaskService#queryProgress 手抄了第 17 处归属谓词。按该棘轮设计意图改走公共出口 TaskFinalizeSupport.belongsToModule(与 JdResultIngestService 同形),不是把阈值调大。

2) RequestSuppliedIdentityOutletTest boundRead 64 -> 65:36e110d2 新增 GET /api/jd-collect/tasks/{taskId}/progress(用户端进度条),@RequestParam(user_id) 先过 requireOwnershipUserId(fail-closed),属覆盖面变大,按先例(128->129->130)点名登记并写清是谁的哪一笔。

复跑:点名 7 类 44 例绿;整量 5540 例 0 失败 19 skip BUILD SUCCESS(4:43)。
2026-11-14 18:36:50 +08:00
huangzd1997 36e110d27c feat(jd): 首页一级入口「京东」+工作台两菜单,获取店铺数据一键采集带进度条
首页在亚马逊/视频右侧新增「京东」一级入口(恒显示),落地页 /jd-console 按亚马逊控制台样式做两张工具卡:获取店铺数据(可用)、商品上架(占位,点开只提示「暂未开通」)。

获取店铺数据改成一键:建单 → 推 jd-shop-collect-run 到本机队列 → 轮询服务端进度。进度只读两处真源——任务行状态 + scope 行合并写游标里的 itemsReceived/cursor.total(客户端抓列表第一页时把 total 写进游标),没有分母就退回不定态动画,不编造百分比;终态即停轮询。后端新增 GET /api/jd-collect/tasks/{taskId}/progress(按 taskId+userId 校归属)。

判据:JdCollectProgressQueryTest(5)、jd-console-tool-catalog.test.ts(5)、jd-console-pending-menu.mount(3)、jd-collect-progress.mount(6);catch 棘轮 blocks 314→315 按名登记(轮询 catch 非静默)。
2026-11-14 16:50:06 +08:00
huangzd1997 05e5c35539 fix(phase-6.1): 闸门取证修复——推送异常文案过 userNotice 闸、静默棘轮 313→314 与端点快照补 jdCollect 2026-11-14 16:14:12 +08:00
huangzd1997 796ec2130f fix(phase-6.1): CR 六项修复——派发链三件套/登记顺序/判死口凭据化/脏时间可读/UPDATE 段摘死列 2026-11-14 13:53:03 +08:00
huangzd1997 edeffc26c4 fix(phase-6): 整量回归 7 红逐条闭环——锁跳过出口/RawExceptionSink/归属出口真修+四处台账点名登记 2026-11-14 13:16:01 +08:00
huangzd1997 ff859d25bc feat(phase-5): 后管京东数据库接口与页面+用户端采集入口——v1.4 Phase 5 2026-11-14 12:47:08 +08:00
huangzd1997 6ce995f19e feat(phase-4): 京东商品图片预签名直传与登记链——服务端零图片字节 2026-11-14 11:32:47 +08:00
huangzd1997 53e176ba7c feat(phase-2): 京东采集任务域——建单/分片回传落库/判活接线 2026-11-14 09:54:04 +08:00
huangzd1997 a429191edd feat(phase-1): 京东数据库数据底座——V193~V196 迁移 + jd 模块实体/Mapper + 模块注册与 LOCAL 通道默认 + aiimage.jd 配置 2026-11-14 03:08:32 +08:00
huangzd1997 334ed2cadd fix(phase-0): 后管契约件规避 readSource 台账棘轮——页面测试改 import 断言,分组绊线挪 Phase 5 2026-11-14 02:39:12 +08:00
huangzd1997 10d73994f5 test(phase-0): v1.4 京东数据库契约预置——通道接缝黄金 3 绿 + Pending 17 例 skip 2026-11-14 02:27:34 +08:00
huangzd1997 64e94458c9 feat(credential): 凭据不可自愈 ⇒ 行失败 + 整单终态 + 用户端弹窗(服务端五面)
用户口径(2026-11-12,34061 取证后):没余额要退成失败、直接中断任务、并弹窗提示;
所有涉及代理 IP / LLM 密钥的特性都一样。范围=服务端全部特性,客户端下批。

- 判据唯一出处 common/retry/CredentialFatalClassifier(致命:LLM 欠费/密钥失效、
  代理未配置/套餐到期/余额不足/密钥无效;非致命:channel_busy、无空闲通道、冷却、
  超时、5xx、限流、出口被拒、技术性、上游不可用);落终态唯一出口
  modules/task/service/CredentialFatalTaskCloser(重读现状态、拒碰 TERMINAL、可重入)。
  外观专利与相似ASIN 原先逐字重复的 terminalizeOnFatalLlmFailure 改为委托,不留第二份。
- 五面接线:外观专利/相似ASIN、跟价 updateTaskStatusFromLatestRows、
  店铺采集 tryFinalizeTask、采集数据 submitResult。判死后回执一律回读库里状态
  (采集数据内存 task 停在 RUNNING 会让采集端继续为死路买出口 IP)。
- 行级诚实:凭据致命行不计入已判,回退路不再拿原始标题伪造「侵权/成功」。
- 用户端:credential-fatal-notice.ts(判据)+ credential-fatal-alert.ts(按 taskId:kind
  去重)+ CredentialFatalAlert.vue 挂 App.vue;轻量轮询不带文案 ⇒ 跟价/采集数据在失败
  终态补一次重型 batch,店铺 batch 补任务级 taskErrorMessage(只给 FAILED、截断 300 字)。
- 三处真死日志按巡检签名正形写「改判死」(scripts/_prod_watch.py 只认 改判死|接管判死),
  否则判死数不进账本。
- TaskFailureCategoryGuardrailTest:写点搬进收口器 ⇒ 登记 CredentialFatalTaskCloser,
  下限 47→46、updateById 总量 160→159(搬点,不是新增写法)。

判据:CredentialFatalClassifierTest(16)、CollectDataCredentialFatalTest(3)、
PriceTrackTaskServiceTest(8)、ShopDataCrawlScopeMergeTest(11)、
ShopDataCrawlProgressQueryTest(9)、credential-fatal-notice.test.ts(9)、
credential-fatal-alert.test.ts(6)。后端整量 5,464 例 / 0 失败 / 19 skipped。

未纳入本笔:BrandAppearancePatentTab.vue、BrandSimilarAsinTab.vue、TaskItemCard.vue
与两个 Tab 里的按钮/徽章 CSS —— 另一路会话在飞改动,按并发纪律不卷进来。
2026-11-12 18:10:10 +08:00
huangzd1997 f5f40cd2ea fix(appearance-patent): 外观维把「没跑」写成「外观识别异常」且原因列空白(B96-09)
34061 交付件实测:1000 行里 987 行外观维=外观识别异常、外观原因/专利原因只有 21 行有字,而零行真的跑过外观。根因是 LLM 上游 01:01-01:06 全程 403 欠费(用户[155933] 剩 0.0305 < 单次 0.0324)→ 标题维先失败 → 跳过外观那一步,跳过分支把标签写死成外观识别异常、原因留空。

改:新增 APPEARANCE_NOT_RUN(未执行外观检测)+ 两条原因文案(无标题/无图、商标维先失败带原话),专利原因同步;APPEARANCE_ANOMALY 只留给发了请求没答上的行。顺带修原因 sheet 每行自增两次(1000 ASIN 占 2000 行)。

门禁:外观专利包 364 例全绿;后端整量 mvn -o test 5435 例/0 失败/0 错误/19 skip/BUILD SUCCESS(7:50)。
2026-11-12 15:53:35 +08:00
huangzd1997 ad33b7d54c fix(task-retry): 已交付代点重试不再空转(B96-08) 2026-11-12 15:18:34 +08:00
huangzd1997 a940cd227f fix(admin-vue): 外观专利数据库「同步时间」列宽 150→170 并同步表 min-width,防十九字符被 ellipsis 截断(客户 2026-11-12 反馈) 2026-11-12 14:32:53 +08:00
huangzd1997 4d008608b1 fix(appearance-patent): 重试不再整单重采——派活前裁掉已采到的行+跨代切分片 scope(B96-07)
33898/33883/33885 这类单重试一次就是 4000 组从头再抓一遍(1.3-1.5 小时+按次买出口 IP),根因两条:① 重排派给客户端的仍是解析载荷的全量 groups;② ap_worker 的 chunkIndex 是相对本载荷的序号且每片都带 submissionId=str(task_id),裁剪后从 1 重新编号会与上一代同号分片撞 (task_id, module_type, scope_hash, chunk_index),落进 duplicate chunk ignored 却照旧回 ok —— 客户端以为传成功、服务端一行没收。

A:AppearancePatentResumeTrimSupport(纯裁剪)/AppearancePatentDispatchTrimSupport(下发口编排)。两条下发口(兜底拉取、页面推本机)都过 trim;已收判据不是「行存在」而是「行上有标题或图片」(失败行也会落库,按行存在裁会把 404 行整批裁掉、坏行永不重采);载荷对象已不在的分片不算已收。跨代 scope=<caller submissionId>:gen:<resumeAttempt>(首代原样,幂等),新一代开跑前清上一代输入面 completed,否则本代第一个分片就被当成「已交完」拿半批行去组装(33924 同形)。

B:裁到一组不剩时不再派活——先标完成再收口出表;已出过表(result_file_url 有值)或状态非 PENDING/RUNNING 不动,避免直链被清空再重排。SPI 对「解析期无分组」与「已收全被裁光」分两侧:后者返回空 groups 载荷而不是 null,否则认领侧会把刚收口的任务改判「任务数据不完整」FAILED。

门禁:mvn -o test 整量 5,430 例/0 失败/19 skipped BUILD SUCCESS;新增用例 14 支(裁剪 9、scope 5);TaskLifecycleDebtRatchetTest 130 遍/15 文件不变(归属谓词改走 TaskFinalizeSupport.belongsToModule);SourceScanTest 台账 57→59、support 22→24;_push_gate.py --fast overall=pass(9.5/8.8/10.0/9.6)。
2026-11-12 13:55:15 +08:00
huangzd1997 f7b206474d test(外观专利): 模块支数台账 56→57、support 21→22(3A 拆薄第十四笔)
AppearancePatentDeliveredRearmSupport 落进 service/support 后,SourceScanTest 两格
(整模块支数、support 支数)按设计报红。按既有口径逐条点名更新,不整份放宽:
新件同时进「必须被逐枚点名扫到」清单,避免只把分母数字改大。

整量 mvn -o test 此前只红这两格(5,416 例 / 2 失败 / 19 skipped),改后 40/40 绿。
2026-11-12 10:49:43 +08:00
huangzd1997 faa08a6138 fix(appearance-patent): 续跑新一代交完后复位上一代已交付的出表作业并清直链
现网 33924(专利4.xlsx,200 行,11-10 17:42 → 11-11 04:08 判死「客户端已上传完全部
结果,但结果文件未能生成」)的链路,按 B 机 java 日志逐条对上:

  00:45 首轮交完 → 01:18 原任务复位重试(代数 3)摘掉已交付的 SUCCESS 作业,但
  biz_file_result.result_file_url 仍在 → 01:18:04 出表侧「结果文件已交付,跳过重复组装」
  把作业标回 SUCCESS → 02:19 客户端重新认领 → 03:33–03:37 全 200 组重采完
  (completed=true, llmDone=false)→ enqueueAssembleResult 原样返回 01:18 那份 SUCCESS,
  scheduleLlmPipelineForSubmittedChunk 一句话都不打地 return ⇒ 检测与出表一步没走,
  心跳停 30 分钟被判死。

两处修:
- AppearancePatentDeliveredRearmSupport(新,3A 拆薄第十四笔):摘作业时同时把结果行的
  result_file_url / result_file_size 清空(文件本体仍留在对象存储),「是否已交付」这一个
  判定由恢复探针与「继续」复位共用
- AppearancePatentLlmSubmissionSupport:拿回的作业是 SUCCESS 时不再静默返回——若本代
  分片已交完(submissionComplete)就先复位上一代再重新 enqueue;半批不复位(半批复位会让
  组装读到半批行,覆盖率闸门反过来把这轮出表判死)
- 主类只留委派,行数 893→871(可读棘轮只许减)

用例:AppearancePatentRearmDeliveredJobTest(2,清直链/无交付作业不动结果行)、
AppearancePatentResumedRoundRearmTest(3,交完才复位、半批不复位、首轮 PENDING 不受影响)。
四支相关套件 25 例全绿;快检闸门 overall=pass。
2026-11-12 10:27:24 +08:00
huangzd1997 5390503f7a test(外观专利): 模块支数棘轮 55→56(B95-02 新增 client/AppearancePatentBrandFailureText)
整量 `mvn -o test` 抓到 `SourceScanTest.moduleSources_appearancepatent登记数与真实文件同号` 红:
新增的文案分档类落在 modules/appearancepatent/client,模块支数 55→56。

棘轮按口径显式改数并写清是谁的哪一笔(同文件既有做法),不放宽断言形状。
2026-11-11 20:29:23 +08:00
huangzd1997 ef78608a64 fix(外观专利): 整批失败文案带上游那句真因作样例(BK B95-02 判据收口)
上一条只做到「分类」:交付列写「服务侧解密链路故障」,但到底是 UTF-8 解不开、密钥不对
还是压缩坏了,只有上游那句 reason 知道——B95-02 的判据要求「能回读到是哪一步失败」。

- AppearancePatentBrandFailureText.describe:分类文案 + 一句样例(压单行、截 80 字、超出以 …
  收尾),没给原因时退回纯分类文案,不凭空补。
- aggregate 改用 describe(分类口径与保守判定一字未动)。
- 用例:e2e 改成「保前缀 + 带 Malformed UTF-8 样例」;新增样例单行/截断/空原因三格(共 21 支)。
2026-11-11 20:14:44 +08:00
huangzd1997 a17d8edc9e fix(外观专利): 整批品牌查询失败的文案按真因分档(BK B95-02)
现网 16890 侧成片刷「解密失败: Malformed UTF-8 data」,交付表却一律写
「品牌库上游整体不可用」——上游其实有应答,坏的是应答体解密,
运维照「上游挂了」去查永远查不到东西。

- 新增 AppearancePatentBrandFailureText:批内 reason 全同形才分档
  (全解密→解密链路故障、全不可达→服务不可达、混形/空→通用文案),
  三条文案都保留「商标查询失败」前缀(状态列与 isBrandQueryFailed 靠它判失败)。
- AppearancePatentLlmClient 的 brandAggregateFailure 收成一行委派;
  删掉只被测试调用的 boolean buildTitleRisk 重载(String 版保留兼容)。
- 用例 +5:整批解密/整批不可达/混形与空 reason/三条文案互不相同且同前缀。
2026-11-11 20:01:36 +08:00
huangzd1997 691b29da7e fix(llm): 识别钱包型欠费 insufficient_funds,欠费不再落回未完成检测 2026-11-11 18:15:41 +08:00
huangzd1997 7a69210967 feat(appearance-patent): 后管页恢复明细表+管理员列+导出,撤一主管一卡与删除入口(2026-11-11 客户「不是这种格式 你就按照昨天那个格式」) 2026-11-11 16:29:35 +08:00
huangzd1997 c00f8c6e1c feat(appearance-patent): 无侵权明细改按 ASIN 累计(V192 唯一键+同步链 upsert-only,永不删行) 2026-11-11 16:29:14 +08:00
huangzd1997 bfd8ceac52 fix(appearance-patent): 删除确认改成单行 danger 形态,命中「危险确认必须是 danger 形态」守卫(confirm-exit-ledger 的判据锚在 openAdminConfirm({ 那一行,拆行会判红)
纯前端一行形态修正:文案抽到 confirmText,调用写成 openAdminConfirm({ message: confirmText, danger: true });行为不变(仍先确认、danger、点名主管与条数)。vue-tsc rc=0、mount 16/16、confirm-exit-ledger 5/5 绿。
2026-11-11 13:53:16 +08:00
huangzd1997 3dec8d41ed feat(appearance-patent): 顶部全量「导出」摘掉+每张主管卡加「删除」(2026-11-11 客户「这个可以不要 有下载就行了」「也要加个删除按钮」)
删除走新 DELETE /api/admin/appearance-patent-clean-items/supervisors?supervisor_user_id=…:谓词与卡片「下载」逐字同源(共享 cleanItemConds + supervisorScopeConds,Same SQL 下推),所见即所删;supervisor_user_id 必填、服务侧先挡空值(缺值会让 <if> 不生效=退化成整表删除),日期倒挂同全站口径拒;同一 requireCleanItemsAccess+readCompanyIdOrOwn 正门(非超管只能删本公司行),并打一条带 operatorId/主管/过滤面/删除行数的日志留痕;只删快照明细,不碰结果文件与任务记录。前端破坏性动作先 openAdminConfirm(点名主管与条数、danger),删完回读并在删掉本页最后一张卡时回退页;读不到主管的卡两钮都禁用。护栏:XML_STATEMENT_TOTAL 155→156、NOT_MIGRATED 登记 deleteSupervisorItems、controller 只读判据改为「无 POST/PUT+DELETE 必须在位」、wiring 新增第 4 个发送口(26 处/19 组)。
2026-11-11 13:39:17 +08:00
huangzd1997 e1767faff5 feat(appearance-patent): 外观专利数据库改为按主管划分的一主管一卡(2026-11-11 客户「应该是只显示一个卡片的才对」「获取店铺那边是按店铺做成卡片 我们这边就是按主管划分」)——后端新增 GET /supervisors 主管聚合(组键=与「所属主管」列同源的归属表达式:主管本人取自己、普通账户取创建人、读不到归同一 NULL 组;返回条数/任务数/最近任务号/最近同步/国家集,total 是主管数),卡片[下载]走 /export 新增 supervisor_user_id 按同一表达式收窄(不近似成 user_id OR created_by_id);共享 cleanItemConds 前移到 i. 前缀并复用(铁律 20 SQL 下推);后管页面由「每明细一卡」改为「一主管一卡」(卡头主管名/条数/任务/国家/最新 + 下载,对齐店铺数据记录一店一卡),明细分页卡片下架(3488 条铺成几千张卡是客户不要的形态),明细仍走 /export 表格看;护栏台账同轮更新(XML_SELECT_TOTAL 105→109、XML_STATEMENT_TOTAL 151→155、PageDefaults 56→58、SourceScan 52→55/vo 11→14、wiring 新增 /supervisors 发送口);后端 test-compile rc=0、controller 22 例绿+6 支护栏绿,前端 vue-tsc rc=0、mount 13/13、三支 node --test 21/21 2026-11-11 12:31:28 +08:00
huangzd1997 2a2e276c32 feat(appearance-patent): 外观专利数据库分组(主管)下拉选中即查——2026-11-11 客户反馈「选了主管应该只显示这一个主管的才对」,原交互选完还要点查询、未点时总数仍显示全量 1725 引发误解;改为选完立刻按该主管过滤刷新(回第一页,group_id 同一过滤面 SQL 下推组长+名下整集),国家/时间仍走查询按钮;挂载测试钉选中即查契约(setValue 后立刻重查+page=1,查询按钮语义不变 13/13 绿,vue-tsc rc=0,扫本文件三支护栏 21/21 绿) 2026-11-11 11:55:32 +08:00
huangzd1997 3cfca462ce feat(appearance-patent): 外观专利数据库卡片按所属主管分组显示+字段精简(2026-11-11 客户拍板「要按主管分组显示」「价格 asin 无侵权 这些都不需要展示的」「到时候能下载表格看就行」)——卡片按主管连续切段,组头=主管名+本页条数(保持服务端 synced_at DESC 行序、不跨页聚合、不按名重排;同名主管被隔开按行序出多个同名组头,只看单人走既有分组下拉);卡片字段精简为 标题(卡头替下 ASIN)/任务/国家/品牌/SKU/同步,价格、ASIN、结论徽章(无侵权)、所属主管行全部下卡(主管由组头表达,全量明细含价格/ASIN/结论/主管列仍走 /export xlsx);退役 cleanItemReasonTooltip(唯一消费者=结论徽章悬停);取数/过滤面/导出/公司tab契约一字未动(company-tab-wiring watch token 与 date-filter 豁免照旧);挂载测试 11→13 例适配(分组切段+组头计数/连续切段不重排/空主管 - 三用例新钉,ASIN/价格/徽章反断言),vue-tsc rc=0、vitest 13 绿、扫本文件三支 node --test 21 绿 2026-11-11 11:27:57 +08:00
huangzd1997 f218766a55 feat(appearance-patent): 外观专利数据库筛选面精简为 分组/国家/同步起止(2026-11-11 客户拍板「筛选条件和获取店铺一样」「按账号对应的主管吧 不需要店铺」)——任务号/ASIN 输入框下架,分组(主管=组长)提到国家前对齐获取店铺页字段顺序;主管维度沿用今晨已上线的分组整集下推(选组长=按「组长本人+名下子账户」过滤,卡片显示所属主管);后端 §3.2 参数契约与前端过滤模块逐字对撞护栏原样保留(UI 不再暴露 task_id/asin),company-tab watch 清栏 token 不动(wiring 护栏照旧);挂载测试四用例适配新筛选面(11/11 绿) 2026-11-11 09:49:26 +08:00
huangzd1997 a5bd4011e2 feat(appearance-patent): 后管外观专利数据库改卡片宫格样式(2026-11-11 客户需求:像店铺数据记录那样卡片展示+下载导出)——参照 ShopDataTasksPage 像素复刻:form-box 筛选条件(任务号/ASIN/国家/分组/同步起止+查询/重置)+ panel-box 工具条[导出(带当前过滤面与公司tab)+共N条汇总] + 每明细一卡(ASIN头/任务号/结论徽章含三因悬停/所属主管/国家chip/品牌/SKU/价格/标题/同步时间,4-3-2-1响应式)+ OldPagination 服务端分页;推翻 2026-11-10「自绘 table 不做卡片宫格」旧拍板并同步挂载测试契约(先红后绿 3 用例改卡片断言),取数/过滤面/导出/公司tab契约一字未动(company-tab-wiring watch token 与 date-filter 豁免照旧),本页仍零写操作、单卡无下载按钮(明细无文件,下载统一走 /export) 2026-11-11 09:30:59 +08:00
huangzd1997 6f85f17c58 feat(appearance-patent): 外观专利数据库主管列+导出+分组筛选——后管只读页补「所属主管」读侧现算列(owner 是主管取自己、普通账户取创建人,铁律 30 读不到不猜名)、GET /export 与分页共用同一过滤面与正门出 xlsx(SXSSF,上限 5 万行超限拒)、分组筛选 group_id 按 selectUserIdsByGroupId 解析「组长本人+名下子账户」整集 SQL 下推(铁律 20,选项复用既有 GET /shop-manages/groups 不下新端点);前端加主管列/分组下拉/导出按钮(blob 落盘+业务错误信封解包),wiring 护栏补导出发送口钉与 watch token(25 处发送口);棘轮 1073→1074 一枚记名,「无侵权」白名单登记导出上限文案 2026-11-11 02:03:25 +08:00
huangzd1997 9b4404d027 test(护栏): 整量回归消两红——超管出口调用点 19→20、clean_item 品牌按 payload 原样投影点名
2026-11-10 发版前手点 mvn -o test 整量(5391 例)抓到两处红,都是 v1.3 新增代码没在尺子上登记(闸门按类点名的格子册没扫到它们,full 绿掩盖了这两格):
2026-11-10 12:18:50 +08:00
huangzd1997 cec863af89 fix(llm渠道): 龙抬头模型 id 切 gm-3.5-flash-lite——贞贞仍留 3.1,映射仍走 LlmChannel 单出口
2026-11-09 用户口径:龙抬头那家中转把同款模型统一叫 gm-3.5-flash-lite(旧值 gemini-3.1-flash-lite 已不存在)。业务配置里写的仍是贞贞的 gemini-3.1-flash-lite-preview-thinking-medium,渠道映射表改一处,三条取用点(外观专利/相似ASIN/密钥检测)与示例配置注释同步;切渠道不映射就会 model_not_found。判据 LlmChannelProxyProviderTest 两支断言随改。
2026-11-10 12:18:46 +08:00
huangzd1997 bd0c0a0810 fix(task): 失败重试也复位已交付出表作业,判死文案按「客户端是否交完」分档 2026-11-10 11:49:43 +08:00
huangzd1997 7ce6ff64cc test(appearance-patent): 出表成功→同步落表→后管可查 全链 mock 回环——mapper mock 成按 XML 真实语义的内存假表,真实同步/查询两服务跑通:未出表不写行、严格口径只落无侵权、覆盖式重写零重复、分公司隔离、任务号/ASIN 前缀/日期窗筛选 2026-11-10 10:41:59 +08:00
huangzd1997 9acb221152 feat: 后管菜单更名「外观专利数据库」——V191 改 columns.name(V190 已上产不可回改);routes 标题/页头 h3/403 文案同步;挂载测试断言随改 2026-11-10 10:31:06 +08:00
huangzd1997 264db52b84 fix(phase-4): catch 静默棘轮补 v1.3 四枚逐处记名(1069→1073,full 档红格消项) 2026-11-10 03:06:20 +08:00
huangzd1997 83f1ecf952 feat(phase-3): 后管无侵权只读页——私有鉴权闸+readCompanyIdOrOwn 公司隔离+分页钳制;前端自绘表格页与路由/操作提示/五护栏同轮记账
后端:AdminAppearancePatentCleanItemsController(GET /api/admin/appearance-patent-clean-items,requireCleanItemsAccess 照去重页形状)+ AppearancePatentCleanItemQueryService(page≤10000/size≤100 钳制防 (page-1)*page_size 溢出)+两 VO;PageDefaults 第五种 page_size=10 显式登记。前端:AppearancePatentCleanItemsPage(自绘 table+OldPagination,companyScoped)+api/filter/model 拆件;routes/company-scope/operation-guides 收口。护栏:company-tab-wiring 24 处发送口、date-range-order 分母 21 实例/9 对、date-guard EXEMPT、ChunkRow 无侵权白名单四件(LlmClient 仍是唯一结论值来源)、SourceScan 52 支、G2 WIRED_PAGE_KEYS 第七支。判据修正:columnKey→getColumnKey 对齐代码库命名。
2026-11-10 02:27:50 +08:00
huangzd1997 0512359b21 feat(phase-2): 无侵权行同步服务与出表成功点挂钩——覆盖式落表/公司归属读不出即跳过/失败只留日志不阻断 2026-11-10 01:49:35 +08:00
huangzd1997 434e4bf037 feat(phase-1): 无侵权同步数据底座——V189 建表/V190 菜单(每公司V21形状)/实体与Mapper+XML,三本台账同轮记账 2026-11-10 01:10:52 +08:00
huangzd1997 a94e59d434 test(phase-0): 确认基线全绿并预置迭代验收测试契约 2026-11-10 00:47:25 +08:00
huangzd1997 7c7712e7f3 feat(密钥面板): 青果下架——供应商单选不再出现,存量青果配置照常回显
2026-11-08 用户拍板「先屏蔽掉,代码留着」:api-secret-channel.ts 加 QINGGUO_ENABLED=false+SELECTABLE_PROXY_PROVIDER_OPTIONS 过滤列表,面板 radiogroup 只渲染过滤后列表;拼链/检测/保存/标签回显(composeQingguoLink、proxyCheckValue、proxyProviderLabel)全量保留,存量已存青果账密仍按本机/服务端值回显可检测,翻回 true 即整体恢复。判据:tests/青果账密拼提取链接.test.ts 钉可选列表只剩极客+标签字典仍全量;mount 测试钉单选区只剩极客+存量配置回显。
2026-11-08 23:30:48 +08:00
huangzd1997 b36c52e4d0 feat(采集数据): 等待中卡片给出排队位;启动入口补到「当前任务」区
装机截图(任务 33462)暴露上一笔的漏改:「启动任务」只加在历史区插槽 #history-item-actions,
而等待中的单实际出现在「当前任务」卡片(走 #item-actions,那里只有重试/删除)——
于是"历史行可补点"这句话对用户真正看到的那一屏不成立。两个插槽现在都有入口。

排队位显示按本账号数:COLLECT_DATA 是各客户端 activate 后入本机队列,别人的 PENDING 不占你这台
机器。现网全表 4 支 PENDING、33462 前面 3 支,但那 3 支属于 1293/1312/1318;报一个跨账号的
「前面还有 3 个」会把人引去等一个不会来的位置。N=0 时文案直接说「这一单还没被启动」——
数字本身就是答案,并跟着给下一步(点「启动任务」)。

计算搬进 useCollectDataDispatch(组件 846 行,仍在可读棘轮基线 861 之下,未动基线)。
判据两格新增并反向验过:摘掉 #item-actions 的按钮/把排队数改成连 RUNNING 一起数,各出真红。
用户端 npm test 1024、test:mount 66、vue-tsc rc=0。
2026-11-06 14:10:38 +08:00
huangzd1997 6919108043 fix(状态词表): 别写第四份 PENDING 字面量——接进 TaskStatuses.FileTask 正本
上一笔(61ec324b)后端整量抓到一处真红:TaskStatusVocabularyRatchetTest 的手写状态标量棘轮
只许降、降法就是接进正本,我却在 StaleTaskRepairService 又加了第四个 STATUS_XXX 字面量。
既有那三个(SCHEDULED/RUNNING/FAILED)在基线里,不是我这次该顺手动它们(只把自己引入的那处接回正本)。

整量读数 5356 例/0 失败/19 skipped(19 与在册基线逐字同)。
⚠ 顺带记一笔量具教训:上一轮那条命令的 shell rc=0 是 tail 的退出码,把 mvn 的 BUILD FAILURE 吃掉了——
拿管道尾部的 rc 当绿,就会把红灯发上线。
2026-11-06 13:49:41 +08:00
huangzd1997 61ec324b2f feat(PENDING 判死): 所有模块的等待中单超 24 小时判死,原地可重试(2026-11-06 产品拍板)
起因:现网 33462(uid=1245,数据采集 文档格式.xlsx,17 行)提交后 20 小时停在「等待中」,
updated_at 与 created_at 逐字相同、零分片回传;同批 33103 已挂 6 天。ONLINE 通道没有服务端认领方
(客户端拉取 SQL 硬性要求通道为 LOCAL、内部认领端点默认关闭且从不以 COLLECT_DATA 请求),
把这一单翻成 RUNNING 的唯一动作是界面发 activate——用户没点,"等待中"就成了事实终态:
界面不报错、后台不判死、无人通知。

- StaleTaskRepairService 新增 repairFileTaskStalePending():PENDING 且 updated_at 超 24h → FAILED,
  判死文案唯一出处 PENDING_UNCLAIMED_REASON 供 markers 引用(两处各写一遍就会改一处静默失效)
- TaskRetryEligibility 新增 Category.UNCLAIMED + UNCLAIMED_MARKERS ⇒ 这一档不进自动重试:
  否则会被复位成 PENDING、再等满 24 小时,白烧一轮排队与通知,还把"没人点启动"洗成"上游坏了"
- 三处刻意形状:基准用 updated_at 不用 created_at(重试复位过的单按最后一次状态变更起算);
  UPDATE 里复验 status+updated_at(查询与写入之间用户可能刚点启动,只按 id+status 会把刚被
  领走的单判死);不调 markDeadDownstream(这一档的定义就是没被领走,无结果行无出表作业)

口径冲突如实处理:2026-10-29 那条「PENDING 一律不判死」被本笔覆盖,但它防的是阈值太短
(按 2 小时清杀排队任务并连锁自动克隆重试,现网 2026-10-28 用户 1211 两条 829 行任务),
不是"PENDING 永远不该有终态";克隆放大那条早已被铁律 26 换成本地原地重试。剩下的已知代价
(排队真久的单也会被扫到)写进类注释,靠界面「重试」接回。

判据:StaleTaskRepairServiceTest 改写 1 格+新增 2 格(8 例),MarkersSnapshot 新增
「Category 全集必须逐个登记 markers 组」(加一档不登记即红——本笔实测三支既有测试 21 例
全绿,正是那个缺口的现场)。反向验过三处:摘 CAS updated_at 复验/摘 failure_category 写点/
摘判定分支,各出真红后还原全绿(前两次因 CRLF 未落地的"假反向"已被逐行定位断言挡下)。
2026-11-06 13:27:42 +08:00
huangzd1997 48b961f0b2 test(采集数据): 判据读源码前先归一行尾——本仓 autocrlf 开着,别人机器检出是 CRLF,bodyOf 按 \n} 找闭合会在 checkout 后红(两种行尾实测各 4 绿) 2026-11-06 12:28:01 +08:00
huangzd1997 89a69d651e fix(采集数据): 提交即启动+历史「等待中」单可重启——33462 挂 20 小时的入口缺失
线上 33462(uid=1245)建单后 status 一直 PENDING、updated_at 与 created_at 逐字相同、
receivedRows=0。取证:当天 15:46:06 的 parse 请求确实到达服务端,同批相邻的 33463/33464
都在几分钟内被 activate,唯独 33462 全天零次;ONLINE 通道的 PENDING 服务端没有任何兜底
(StaleTaskRepairService 明确跳过 PENDING、finalizeStaleTasks 只扫 RUNNING、
TaskResumeService 只处理 FAILED),而把这一单翻成 RUNNING 的唯一动作是前端发 activate,
它当时绑死在「本次会话刚 parse 的 lastTaskId」上——用户点完提交不点启动,界面就再无入口。

- submitCollect 成功后自动走启动链(两步并一步)
- 历史行对 PENDING 单出「启动任务」,filters 取服务端从 request_json 回传的那份,
  不取界面当前值,否则「重新启动」会悄悄改掉这一单的采集范围
- 三条启动路收敛为单一出口 useCollectDataDispatch(共用前置校验与入队失败回滚)
- 缺桌面壳不再静默 return;回滚失败并进同一句报错,消掉搬文件带来的新增静默 catch

判据 tests/collect-data-提交即启动.test.ts(4 格,反向验过:改回旧形状 3 红)
组件 861→842 行(可读棘轮按对象点名只许减,未动基线)
2026-11-06 12:27:18 +08:00
huangzd1997 62e92003f2 fix(b82-01): 第三批——七面实体式终态写点接上 ledger(风险/店铺匹配/查ASIN/提现/巡删/店铺采集/巡删品牌)
现网读数(2026-11-05 只读探针)把缺口指得很实:9 条「文案命中 markers 而 failure_category 为空」
的 FAILED 单里,除了已接的跟价(CREDENTIAL)与外观专利(DELIVERY)两族,其余写面全部落在
名单外——B82-01 的②「抽样窗口里那些文案本来就不在值域」有一半就是"这些面根本没接线"。

本笔把 `TaskFailureCategoryGuardrailTest.ENTITY_FACE_FILES` 从四面扩到十一面(+32 处写点,
15→47),逐处 `task.setErrorMessage(...)` 紧邻下一行配对
`task.setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage()))`:

  · 风险 8/店铺匹配 5/查ASIN 3/提现 3/巡删 3 —— 这五面都是「汇总行状态 → 任务终态」那一族,
    任务级文案是店铺级原因**拼出来的**(`"李四: 会话失效且重新登录失败"` 这种),
    所以列值多数时候仍是 null,免疫力恰好在"店铺级原因命中六组 markers"那一刻买到;
  · 店铺采集 4(含 `handleResultFileJobFailure` 那处把「结果文件生成失败」写进任务行的 DELIVERY 族)
    /巡删品牌 6(含「N 个结果文件生成失败」「部分结果文件生成失败」两支 DELIVERY)。

**清错误同时清列**:`setErrorMessage(null)` 那半边一并配对,否则一行"成功/RUNNING"任务上
会挂着一个不属于它的旧判决——这正是护栏第五格场景④点名的背离。

`updateById` 一边不动(十一面用的都是全实体血统,ALWAYS 会把列真落库),
`.updateById(` 总量棘轮 160 一字未改;本笔没有新增任何 catch。

DeleteBrand 那处跨三行的三元表达式改成局部变量再 set:配对判据钉的是「下一行」,
把 set 拆成多行会让那一格看不见配对——**不放宽判据,改书写形状**。

行为半边(`ProductRiskTaskServiceTest` +1 改 1):护栏源码格只钉"下一行有配对语句",
这两格钉"值真的落在交给 mapper 的那个实体上"——`verify(fileTaskMapper).updateById(captor)`
拿到 CREDENTIAL/成功路径把陈旧 DELIVERY 清成 null。**两格都做过反向验证**:
摘掉对应配对分别报 `expected CREDENTIAL but was null` 与 `expected null but was DELIVERY`。

门禁:`mvn -o test` 整量 **5,353 例/0 失败/19 skipped(10:47,skipped 与在册基线逐字同)**。
部署口径:本笔未随任何 jar 发版 ⇒ 「写点已修」≠「线上已修」,随下一窗后端发版生效;
线上正样本至今 n=1(33418/DELIVERY),这七面接线后仍需各自的第一个 FAILED 单才算被生产验证。
2026-11-06 00:13:56 +08:00
huangzd1997 c461210b12 fix(任务进度): 剔除非归属任务时点名 taskId——那 512 条「请求 1 个 命中 0 个」以前读不出是哪一单
现网形状(2026-11-05 主机A 只读取证,43 分钟日志窗):`userId=1228` 打了 **512 条**
「进度查询剔除非归属任务 … 请求 1 个 命中 0 个」,同一账号每 5 秒轮询一支取不到结果的任务,
界面一直转圈。旧文案只有两个数,于是三种完全不同的事实共用同一行日志:

  · 拿别人的 taskId 在轮询(越权探测形状,该报警);
  · 网页端换号后仍用旧缓存(该清缓存);
  · 单已删而客户端按旧 id 空转(B21「在跑的任务列表没掉」那一族)。

读不出是哪一种,就没人能修——所以本笔只补「点名被剔的 taskId」这一件事,
判据与语义一字未动:剔除仍是安全边界,归属仍只由那一条带 `user_id` 的 SQL 决定。

刻意**不加**第二次归因查询、也**不把**归属条件挪进 Java:
① 挪条件=踩铁律 20「先取页再在 Java 里 filter」那一族(取页与过滤的先后一旦脱钩,
   饿死某一分页的缺陷会在这里重生);② 为一条日志在轮询热路径多打一次往返不划算;
③ 本仓 catch 总量棘轮 `CatchSilenceRatchetTest`(STRICT_TOTAL=1069)实测把
   「多包一层兜底 try」直接判红——第一版就是因此回炉的。
拿到 id 之后「这单存不存在、现在归谁」是一条主键查询就能定死的事,留给取证侧。

点名有上界(ATTRIBUTION_PREVIEW_LIMIT=12):一次批量轮询不许刷出一行超长日志。
三格新判据:id 必须出现在行里、干净轮询恰好一次查询且零日志、预览被截断在 12 个;
另把 `ProgressQueryOwnershipOutletTest` 的取证口径写回「一次 selectList」并注释清楚
归因只是日志、不是第二道过滤。
2026-11-06 00:13:35 +08:00
huangzd1997 cc22600a07 feat(后管): 密钥管理拆两列显示余额(LLM 人民币余额/代理余量),实时查不落库
按拍板:数据源=实时查上游不落库(⇒ 本窗零 Flyway、零 Schema);列形态=拆两列,不是一列两行——
两张货源字典本就互不相通(LLM 行为渠道 longtaitou/t8star,代理行为供应商 qingguo/jikip),合成一格
就是 11-02 那次"代理行贴出龙抬头"的串档形状重来一遍(铁律 25)。不加 v-if="isSuperAdmin":主管必须
能解释组员任务为什么挂欠费,鉴权维持 requireAdmin + DataReadScope。

- src/api/user-secrets.ts:fetchAdminSecretBalances(userIds, companyId?),POST /api/admin/user-secrets/balances,
  超时放宽到 30s(服务端整请求预算 10s,客户端必须比它长,否则拿到的是本地掐断而不是"上游未应答")。
- user-secret-model.ts:llmBalanceLines/proxyBalanceLine 纯函数——**两张字典各查各的**、跨域一律 —、
  未知渠道只出 — 不出钱;available=false 时把 message 挂进 title 而不是画成 0;同一账号两个模块归到
  同一个渠道名下只列一次钱。保持零 @/ 别名以便 node --test 直测。
- UserSecretsPage.vue:两个 <th>(LLM 余额 170px/代理余量 160px,放「更新时间」前),两个 <td> 首屏画 —/查询中,
  列表返回后异步填(不阻塞首屏);colspan 由 isSuperAdmin ? 10 : 9 改成 12 : 11(两处同改,892d88ed 的提交信息
  专门写过这句);表格 min-width 相应 +240px;「刷新余额」按钮按 BALANCE_BATCH=20 分批请求。
- 已核对 ops-cell-must-wrap.test.ts:它的 opsColDecl() 正则锚在表头文字「操作」上,新增 <th> 排在它之前不影响
  UserSecretsPage: 314 下限 ⇒ 那张表不改(实测绿)。
- mock-admin-server.mjs 补两列夹具(一条有数、一条全查不到)供 dev/e2e。

测试:tests/密钥余额列读数.test.ts 12 例(跨域不认、坏值不画 0)+
tests/mount/user-secret-balance-columns.mount.test.ts 9 例——按表头文字定位不靠列序数,并钉 <th> 数=<td> 数=
空行 colspan(超管与非超管两种形状各一遍),把"加列忘改 colspan"直接钉死。既有 status-band 挂载格的夹具 mock
补一个 fetchAdminSecretBalances 函数名(页面挂载即取余额,缺它整个模块 mock 会炸),不是判据改动。
刻意不新增 readSource 钉 ⇒ 不动 tests/baselines/source-pin-ledger.json。vue-tsc rc=0、node --test 1890 例、vitest 77 例。
2026-11-05 12:03:43 +08:00
huangzd1997 a10aa6bda3 feat(用户端): 密钥设置面板 LLM 两卡加人民币余额行,与代理余量同形
现状纠偏(写死免得下次重研):桌面壳加载的是 frontend-vue 的 Vue SPA(app_client/blueprints/main.py:52 供产物、
config.py:96 WEB_HOME_URL 直载),所谓"客户端密钥设置"不在 Python 里;而密钥明文只在后端(前端手里只有掩码),
所以余额必须由后端查、前端不自打上游——本面只消费 GET /api/user-secrets/llm-balance。

- 新建 SecretBalanceRow.vue:根元素就是 <div class="secret-meta">,保住既有挂载测试按 .secret-meta 取数的断言不破;
  LLM 卡插一行、代理卡那 8 行 div 换成同一组件 ⇒ 两卡同形自动达成。面板 763→789 行,在 800 报警线内,
  可读棘轮基线不用动(该文件本就未点名)。
- 新建 shared/utils/llm-balance-text.ts(零依赖纯函数,node --test 直测)+ shared/composables/useLlmBalance.ts
  (按 moduleKey 存 items、三态文案、available=false 原样透出后端 message)。不引任何汇率乘算:绊线
  tests/llm-balance-text.test.ts 里钉住源码不得出现 7.2/per_usd 类字样——换算只在上游 credits.per_usd 里。
- loadLlmBalance() 移出 if (props.showProxy):原形状下 LLM 卡永远空白。刷新时机=挂载、保存该模块后、清空后、
  「检测已存值」后;⚠ 刻意不在「检测输入框未保存值」后刷——checkMyApiSecret(moduleKey,value) 探的是没落库的那把
  key,而余额读服务端已存密钥,刷出来是上一把 key 的钱挂在新渠道名下=串档形状(同一格绊线盯着这条)。
- 不动 ProxyBalanceAlert.vue / utils/proxy-balance-alert.ts:没要求告警,引阈值就是自造口径。
- 复用 jikip 那套 VO 的 surplus/scope/low 语义不 borrow 给 LLM(铁律 25):types/modules/user-secret.ts 里
  新类型与 :48-59 的 jikip VO 并置但互不相通。

测试:tests/llm-balance-text.test.ts 10 例(含源码绊线:面板行数<800、useLlmBalance 无汇率乘算、检测输入值路径
不触发 loadLlmBalance)+ tests/mount/密钥面板余额显示.mount.test.ts 11 例(两 LLM 卡各有 .secret-meta;龙抬头行
含 ¥+「龙抬头」、贞贞行含「不提供余额查询」且不含 ¥;两卡夹具给不同数字并交叉断言不互串;代理余量文案未变);
endpoints.test.ts 金样加一行;两支既有挂载夹具补 fetchLlmBalanceSafely 默认值。
catch-silence 棘轮:useLlmBalance.ts 那一枚 catch 的**首条语句是界面可见出口**(清空该 moduleKey 的展示),
console.warn 留在其后——按"首条即 log 才算静默"的口径它不该入账,实测入账了就把 blocks 311→312 如实登记并写明
理由,不删那个 catch(删了就是把失败读成"没有这一项")。vue-tsc rc=0、node --test 1018 例、vitest 66 例。
2026-11-05 12:03:14 +08:00
huangzd1997 eeff73d322 fix(b82-01): 第二批——跟价面六处实体式终态写点同笔派生 failure_category(CREDENTIAL 族)
B82-01 那 9 条实锤里的 1 条 PRICE_TRACK「会话失效且重新登录失败」=CREDENTIAL 组:这句话由 Python 侧逐店
回报、在 PriceTrackTaskService 聚合进任务行的 error_message,而这一面走的是实体式写面(setErrorMessage +
updateById),上一批的 wrapper 配对判据扫不到它。⇒ 六处终态写点(markDispatchFailedRecords 无明细分支、
tryFinalizeTask 空明细分支、收尾判定的 RUNNING/SUCCESS/部分失败/全失败)每处 setErrorMessage 紧邻下一行
配对 setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage()))——判据形状是"下一行",跨行写法会漏判,
照现成先例的书写形状写。updateById 一边不动:这两面进来的都是 loadTaskForExecution 的全实体(selectById/缓存血统),
ALWAYS 策略会把列真落库,改成窄 wrapper 反而缩了写面。

护栏名单三→四面(ENTITY_FACE_FILES 加 PriceTrackTaskService.java)、写点下限 9→15(AP 4+相似ASIN 4+采集 1+跟价 6)。
反向验证:摘掉任一配对 ⇒ 该格 1 失败(实测)。没新增任何 .updateById( 调用,160 的总量棘轮不动。

AP DELIVERY 半边核明"早已接线":AppearancePatentResultJobSupport 四支 task.setErrorMessage 自 51401de2(2026-11-03,
已上线)就全配对,本批不动、也不虚构缺口。

现网只读探针把"列尚未被生产验证"归因到位(2026-11-05,本机 SSH 主机B 用容器 env 连 192.168.0.171:3306,凭据不出
服务器):全表非空仍 0(804 行)、近 7 天 FAILED 140 条全空;命中六组 markers 的 FAILED 近 7 天 82 条,但最新一条
updated_at=2026-11-01 23:14——早于接线 jar 上线(11-04 14:29)三天;接线后新增的 9 条 FAILED(8 条 AP「客户端回传
中断」=刻意排除在 DELIVERY 外那族、1 条跟价英文原文)按今天的判据本来就该是空列。⇒ 非空路径至今没有任何一笔
生产写入走过,本机只欠 MySQL 也无历史正样本可回放,本窗证不了;不得拿"列空=一致"当验证。第三批(风险/店铺匹配/
查ASIN/提现/巡删五面+ShopDataCrawl:3060/DeleteBrand:1839 的 DELIVERY 写面)已逐条登记 BACKLOG B82-01。
2026-11-05 12:02:49 +08:00
huangzd1997 609ad396a6 feat(用户密钥): 龙抬头余额按人民币口径上界面——credits 查询+用户端/后管两个读取面
上游事实(官方文档+2026-11-05 从主机B 直打实测):`GET /v1/skills/balance` 顶层 balance 是美元串("$12.345678"),
站内 ⚡=人民币口径在 credits 块(⚡ = 美元 × credits.per_usd)。要跟网页/账单对上必须取 credits,Java 里
不得出现任何汇率字面量。四条硬规则落在 LongtaitouBalanceClient:① 只认 credits.balance/available/frozen,
且 credits.unit 必须为 CREDIT、per_usd>0;② 顶层 $… 与 currency:USD 只作交叉校验(偏差 >0.5% 打 WARN),永不进展示;
③ credits 缺失/不可解析时不回落美元——把 12.34 当 ¥12.34 显示就是"美元当人民币"的假绿;④ 错误体
{error:{code,message,type}} 与 4xx/5xx 一律 available=false + message 原样透出,绝不抛、也不显示成 ¥0。
URL 由 LlmChannel.LONGTAITOU.host() 派生(配置键留空即用域名唯一正本),响应体限读 1MB。

不复用 UserApiSecretBalanceVo:那个类的 surplus/scope/low 语义全是 jikip 代理的,LLM 塞进去会让注释撒谎并
诱导下一个人在 useProxyBalance 里加分支(铁律 25「口径不得借」)。新建 UserLlmBalanceVo + 平行新建
UserLlmBalanceService(不扩 UserProxyBalanceService),缓存键 (userId,moduleKey) 5 分钟;渠道分档:t8star 不打
上游、available=false +「不提供余额查询」(贞贞有没有余额接口在册无判据,不许猜端点、更不许借龙抬头的数)。

后管走实时查、不落库(本窗零 Schema、零迁移):POST /api/admin/user-secrets/balances,requireAdmin +
DataReadScope 逐个剔除越权 userId(不信任前端给的列表)。三条护栏是这条路线不被点爆的唯一防线:单次 ≤20 行
(越限 BusinessException,不静默截断)、固定线程池 adminBalanceConcurrency=4 + 整请求 deadline 10s(到点的行
按「上游未在本轮时间预算内应答」降级并记进 timedOutUserIds 如实上报,不读成 0)、只对真能查的行打上游
(LLM 仅 longtaitou、代理仅 detectFromUrl==JIKIP;t8star/青果零 HTTP),一页 15 行通常只剩 3–8 次调用。
用户端 GET /api/user-secrets/llm-balance?moduleKey= 与既有 proxy-balance 同款 requireUser。

保存/清空密钥与后台代填/清空时代际失效两侧余额缓存:换一把钥匙还挂着上一把的钱就是串档。
配置三键同步 application.yml 与 application-local.example.yml(铁律 3)。

测试:LongtaitouBalanceClientTest 11(官方样例断言 balance=="88.888882"/surplus=="85.288882" 且 12.34/11.84/0.50/$
一律不出现;缺 credits、per_usd<=0、unit≠CREDIT、缺 available 四种坏形状各自 available=false + balance=null;
现网实测 401 missing_api_key / invalid_api_key 形状入夹具——钉的是测过的读数不是猜的错误体)、
UserLlmBalanceServiceTest 10(贞贞 never() 打上游、三态不伪装成 0、缓存命中不二次查询、两模块各回各值)、
UserSecretBalanceAdminServiceTest 7(越上限拒、越权剔、超时行 available=false 而非 0、只有可查行产生 HTTP)。
三支已登记进 ops scripts/score_ratchet.py 的 suites(不入册=闸门永远跑不到)。
catch 棘轮五枚新增全是 NOT_RETHROW(LOG_ONLY/EMPTY 一格没涨),逐处记名抬 STRICT_TOTAL 1065→1069、
notRethrow 604→608。未证事项按 BACKLOG B83-01 如实挂:真 sk- 下 credits 字段逐字核对、后管实时查的现网
并发表现、jikip find-balance 对用户自有套餐 key;本窗代码未随任何 jar 发版。
2026-11-05 12:02:33 +08:00
huangzd1997 b231a67dd7 fix(b82-01): 任务行部分字段落库改 update(null, wrapper),13 处部分实体 updateById 不再抹 failure_category
B82-01:failureCategory 标 FieldStrategy.ALWAYS(V186 让清错误分支的 null 真落库)的代价是任何 new 出来的部分实体走 updateById 都把该列无条件抹回 NULL。现网只读探针(2026-11-05,SSH 主机B)实证列全表零非空:近 7 天 194 条 FAILED 全空,9 条文案命中 CREDENTIAL/DELIVERY markers 的行列也是空。本笔只动调用点一边;注解半边由 TaskFailureCategoryMigrationV186Test 的 ALWAYS 钉守住。

写点转换(13 处 updateById,12 个条目,DedupeRunService 收尾一处两调用):convert/split/productrisk/queryasin/withdraw/similarasin/appearance-patent/pricetrack 显式两到四列;shopdatacrawl 快照+归属三列;deletebrand 终态分支 error_message 与分类同笔配对 TaskFailureLedger.categoryOf(护栏格1连线语义);dedupe FAILED 收尾同笔配对;similarasin 归属绑定(rustfs 回退)。Explore 初判 12 处漏了 withdraw/pricetrack 族——逐支验明全是 loadTaskForExecution 全实体(selectById/缓存血统),非抹列点,留痕不扩 scope;DELIVERY/CREDENTIAL 两族终态写点接 ledger 属后续批,不在本笔。

护栏 TaskFailureCategoryGuardrailTest 5→7:① ledger 对六组 markers 各出一条值非空断言(配对写恒 NULL 也绿那半堵上);② .updateById( 总量棘轮 173→160(本仓 ALWAYS 字段还有 PriceTrackLoopRun/ShopKey/SkipPriceAsin 四实体,棘轮按全量钉,新增写法必须登记复审)。测试适配:共享探针 UpdateWrapperProbe(getSqlSet 列序+MPGENVAL 精确取值+列名 snake 归一——单测 JVM 的 Lambda 列缓存可能被自动初始化成驼峰,不归一则快照取决于测试类执行顺序);4 份 golden 重钉 11 行(窄写面 status 不在写面渲染成 -);ShopDataCrawlOwnerColumnTest 假 DB 从只会 CAS 升级为按 SQL 语义应用 SET 段(whereEq 校验 id/status eq);SimilarAsinTaskServiceSubmitTest 归属断言改为录 SET 段断言零 owner_instance_id(touchJavaSideTaskActivity 本就合法走 update(null,wrapper),verify(never) 会误杀)。

门禁:受影响七支定向 50/0 失败/0 错误/3 skipped(既有 skip,零新增);mvn -o test 整量 5321/0 失败/0 错误/19 skipped BUILD SUCCESS(5:01,skip 数与在册基线逐字相同);后端无 lint/格式器如实跳过;未动 application.yml/路由/Flyway/env,门禁5不适用。
2026-11-05 01:34:00 +08:00
huangzd1997 56b916f2fe docs(交付): 纠正已交付收尾那条注释里对终态的错误承诺(纯注释、不改行为、不重新出包)
上线后现网读数打脸了上一笔留的注释:它写"是否成功仍由 statusResolver 按覆盖率判",
实际 resolveTaskExecutionStatus 只看 (waitingForAssemble, executionFailed) 两个布尔,
覆盖率那条判据住在 completeLlmFileJob 那条链上、这一格根本走不到。六单
(33111/33157/33177/33196/33208/33228)14:30 的库侧读数全是 success_file_count=0/
failed_file_count=1 ⇒ 进来的是扫描器卡死文案、不在 partialGapSalvageable 那一族,
收尾判的就是 FAILED。

注释改按真实形状写,并把"为什么 FAILED 反而是用户要的那把钥匙"记在原地:界面「重试」
前后端判据都是 FAILED/CANCELLED,33228 正是 14:30 落 FAILED → 14:32 用户点得动 → PENDING
重新排队,而 biz_file_result 的表与直链一行没动照样能下。要改成"承认已交付→SUCCESS 带
缺口注记"得先给卡死文案分档,欠账记 BACKLOG B77-01,不在这一格顺手做。

随下一支 jar 一起出,不为本笔单独发版。
2026-11-04 14:42:20 +08:00
huangzd1997 b321ea6f45 refactor(交付): 已交付判定的唯一出处搬回模块侧——底座不长新方法、复位改成摘行复用现成入队路
上一笔 847f8a22 的落点不对,这一笔把它改到位(行为等价、判据同向):

一、TaskFileJobService 回到 1233 行(−60)。可读棘轮把这支钉在 1240 行、规则是
    按对象点名只许减,拿"再开一对 hasXxx/rearmXxx"往底座加方法是跟量具讨价还价。
    该棘轮基线故意钉清单成员而非总数,正是防"A 加一条 B 减一条"整段绕过,所以
    不动基线、只让改动落在该落的地方。

二、已交付判定搬进 AppearancePatentTaskService,并同时喂给恢复探针与「继续」复位
    (deliveredAssembleJobs 一个出处)。这条同源不是洁癖:两处判的不是同一样东西时,
    刚点过继续的任务会被探针当成已交付当场收尾——33228 的死胡同换个方向再演一遍。
    读侧复用底座既有 findAssembleJobsByTaskIds(已按 jobType 过滤 ASSEMBLE_RESULT),
    比 listJobs(status,module,task,limit) 稳:后者不过滤 jobType,等第二种作业出现
    就会把别的 SUCCESS 误读成"表已出"。finalizer 因此新增一个 Predicate 注入位,
    与它既有的 submissionComplete/persistedRowsPresent 同形。

三、复位从 UPDATE SUCCESS→PENDING 改为 deleteResultJobs 摘掉作业行。结果行
    biz_file_result 与直链一行不动(读侧都取结果行),而 enqueueAssembleResult 在
    existing==null 的分支里本就建 PENDING、按当前 owner 算 scope_key 并补发派发事件
    ——走现成那条路,不在底座之外再抄一遍派发形状(抄的那份迟早和 owner 对账那条分叉)。

判据:守卫 4 支改注入式谓词仍绿;DelegationTest 补 2 支钉住复位的两个方向——已交付→删对
resultId、RUNNING→一律不删(不许摘掉正在产出表的那支)。20 例 0 失败;快检四面绿
(overall=pass,档位=快检)。
2026-11-04 13:51:18 +08:00
huangzd1997 847f8a224a fix(交付): 已交付任务不再在 Python 超时恢复里空转(现网 33228 既不失败也不完成)
机制:恢复链路每 2 分钟走到 enqueueAssembleResult,它按 TaskFileJobService 的
.ne SUCCESS 刻意原样返回那行 SUCCESS(没人要求重做时不许替换用户可能已下载的表),
调用方据此打一条 "skipped llm submission because result job unavailable" 就跳过发批。
于是作业没排上、批没发出,交付闸门永远不被评估,补检/recheckMaxRounds 预算/终态
那条有界链一步都不走;而紧随其后的 touchJavaSideTaskActivity 又刷新 updated_at,
让陈旧扫描永远看不见这一行——正是铁律 28(c) 点名的「不计任何计数还刷 updated_at」。
33228 实测:表 11-03 10:50 就出好了(job SUCCESS+biz_file_result.success=1 带直链),
activeAssembleJobs 恒 0,10 行永远"等待补检轮",而界面「重试」的判据(前后端一致的
FAILED/CANCELLED)永远拒绝它——用户被关在死胡同里。

三处改动:
- TaskFileJobService 新增 hasDeliveredAssembleJob,与既有 hasExhaustedAssembleJob 成对
  (那一格看"重试耗尽",这一格看"成品已交付",两种"恢复已经试过了"都该停止空转);
- finalizer 在 uploadComplete ∧ activeAssembleJobs=0 ∧ 已交付 时返回 false 交回收尾,
  不再 touch、不再空发批。收尾走既有 finalizeTask:它本就把部分数据缺口判成非致命
  (partialGapSalvageable),缺口由行级文案标在表里(未采集到数据/未完成检测/
  未取得检测结果是三句不同的话,处置动作不同),是否成功仍由 statusResolver 按覆盖率判;
- onTaskResumed 补第二半 rearmDeliveredAssembleJobForResume。只加上一条会引入新 bug:
  刚点过「继续」的任务同样呈"已交付+无在飞作业",会被直接收尾,剩余行永远轮不到补检。
  界面确认框本就承诺「当前已生成的部分结果文件会被替换」,这里复位那行 SUCCESS 是兑现
  承诺,不是绕过 retry() 的保护——那是给没人要求重做时的。

判据 AppearancePatentStaleTaskFinalizerDeliveredGuardTest 4 支,四个方向都钉住:已交付→
收尾且不 touch/未交付→照常恢复(保「继续」)/有在飞作业→不抢它正在产出的表/
未封口→仍走封口那条路。后端整量 5,317 例 0 失败(新增前 5,313)。
2026-11-04 13:21:40 +08:00
huangzd1997 09a34a2856 fix(用户端): 任务删除目标判定收口——失败/克隆件删得掉、缺标识不假成功
删除判定从 useLiveTaskBoard 内联三分支收成纯函数 task-delete-target:能删任务就删任务
(不再限定 RUNNING,自动克隆件没有结果行也能整条删除),没有任务才回退删结果行,
两者都没有必须显式报错——原来会静默跳过却弹「已删除」把用户挡在死胡同里。
批量入口已确认过,逐条不再二次弹框;「记录不存在」按已删除自愈处理(多标签/多端)。
2026-11-04 10:23:36 +08:00
huangzd1997 00f45cc20f feat(phase-B75): 计次上报加 source 维度(V188)——「谁在烧」一列读数,归因不再扫设备日志
- V188:biz_user_secret_usage_daily 加 source varchar(24) NOT NULL DEFAULT 'legacy'(存量行诚实落 legacy 不回填),唯一键 uk_user_module_date 扩成四元组(user/module/date/source),加列与建索引均 information_schema 判存可重跑(列按 V157 款、索引按 V184 款),八段式含验证 SQL 与人工回滚
2026-11-04 02:56:50 +08:00
huangzd1997 e71fa7fa83 fix(phase-6.1): CR-P1 撞款分页溢出钳制+B74-02 在飞登记泄漏收口
Phase 6 全量 Code Review 的后端四处(四面合计 0 个 P0 / 7 个 P1,这是其中两处,另带两处邻接纠偏):

1. `AdminShopDataDuplicateCheckController.parsePage` 补页码上限(CR-18/铁律 15 同形,
   参照 `KeywordUsageAdminService.MAX_PAGE`)。原先只钳下限:`page=11000000 / page_size=200`
   溢出成 `-2094967296`,`Math.min` 之后仍是负数,喂进 `subList(负,负)` 就是 HTTP 500——
   表里有至少一行重复数据就能打出来。这一处是 Phase 5 的 `c8cd75cf6`(B60 行窗)带进来的。
2. `ShopDataDuplicateCheckQueryService` 四处页窗统一走 `windowFrom/windowTo`:溢出发生在
   **那次乘法本身**,只钳边界的话,下一个直接调本服务的调用方(或一支新用例)能把 500
   原样请回来而没有任何尺子知道错在哪。判据 `ShopDataDuplicateCheckPageWindowTest`(5)。
   其中 `page=Integer.MIN_VALUE` 那一格是先咬到修的人自己的:草稿只在 int 上做 `page - 1`,
   MIN_VALUE 会翻成"最后一窗之后"而不是第一窗,必须先把减数升到 long。
3. `TaskResultFileJobWorker`:`markInFlight` 从 try 外挪进 try 内(心跳 executor 在容器关闭时
   `shutdownNow()`,`startJobHeartbeat` 抛 RejectedExecutionException 就跳过 finally,jobId
   永久留在在飞登记里=卡死扫描永远跳过这一行,既不失败也不完成的静默停摆)。
4. `TaskResumeService` 的双读注释纠偏:它写的是**被反向验证打回的那份草稿口径**
   ("有列读列"),留着等于把下一个人引回去把代码改成真 bug。正本口径是
   "文案判得出按文案、判不出才按列"(Phase 2 ✅ 行在册)。

尺子登记:`ShopDataDuplicateCheckPageWindowTest` 已入 ops `scripts/score_ratchet.py` 后端点名册
(不在册=闸门跑不到=等于没被执行,10-29 教训的形状)。

门禁实录:`mvn -o test-compile` rc=0;定向 `mvn -o test -Dtest=ShopDataDuplicateCheckPageWindowTest`
Tests run 5 / Failures 0 / BUILD SUCCESS;后端面无 lint、无入库格式器 ⇒ 如实登记非漏执行。

归属:本笔只圈上述 5 支文件。`modules/usersecret/**` 六支+`V188__user_secret_usage_source.sql`
+`MigratedSqlEquivalenceTest`/`migrated-statements.tsv`、以及 `useLiveTaskBoard.ts`+task-delete
三件,都是另一路会话的在飞件:未 add、未改、未评价。
2026-11-04 02:55:11 +08:00
huangzd1997 c8cd75cf6c feat(phase-5): B60 console 分页与矩阵预聚合+P1-B5/6/7/8 性能热点收口
接管另一路会话的 Phase 5 在飞件收口(5A/5C 主体由那一路落码,本笔补齐 P1-B7 与两处台账并整量验证)。

- 5A/B60:撞款 console 的行窗口在服务端真分页(响应 dup 行数 ≤ pageSize,total_dup 仍是未分页
  总数)、dupGroup 判据收归服务端单一出处(前端 dupWithinGroup 删掉,两套同名规则不再分叉)、
  排序先于切窗;后管矩阵改预聚合+列窗 40。读数(200 列 × 50 行):每行 3 店 8.4 → 5.3 → 0.7ms
  (12.4×),每行 40 店 83.7 → 18.4 → 1.8ms(45.3×)。服务端不设列窗是判断不是漏做:shops 每行
  只有 5 个标量,而矩阵的列来自已分页的行——给 shops 再加分页会把"全局指标读全集"和"列窗读本页"
  两套语义搅在一起。浏览器首屏/交互耗时本机拿不到,登记为 Phase 6 现网复量。
- P1-B6:claim 循环的父任务终态判定折成一次批量 IN(TaskFileJobBatchQueries+Mapper XML,
  铁律 1 收口在 Mapper),逐行 CAS 认领一字不动。
- P1-B5:V187 只建 idx_biz_file_task_resume_of;审计给的候选集索引**有意不建**(V184 前缀已覆盖,
  OR/IS-NULL 与 COALESCE 不可索引),判据把这条负判定钉住。真库 EXPLAIN 本机无 MySQL,顺延现网。
- P1-B8:结果载荷的对象存储删除移到 afterCommit,事务里不再做 120s 超时的网络调用。
- P1-B7:结果集读取按窗提交+收割(窗口=线程池队列容量的一半)。审计把它记成"无 limit",但截断
  是正确性错误不是性能取舍,真能收的是"整份结果集被读两遍"——一次性提交时每支 Future 把解好的
  载荷扣在自己身上直到全部收割完,峰值=结果集+另一份整副本;分窗后副本只驻留一窗。流式组装
  契约要改 4 个模块的调用方,本 Phase 未做,别读成 P1-B7 已闭环。
- SourceScanTest 台账随之登记:裸名 25 → 26、调用方 18 → 19(P1-B7 的窗口判据只能打在源码上——
  线程池只有 8 个线程,"同时开始读几行"改前改后读数相同,差异只体现在堆上,mock 数不出来)。
2026-11-03 23:00:44 +08:00
huangzd1997 fee4df5bf6 feat(phase-4): 外观专利/货源两个提交入口加建单前密钥门禁(B72-02)
服务端建单口 `UserApiSecretService#requireSubmitSecret` 已经拒缺密钥的单,但界面要等
用户上传完 Excel、点了提交才看到那句中文——白跑一趟昂贵动作。本笔把同一句话提到提交前,
形状照 `ensureBrandCheckProxyReady()` 的先例(`ElMessageBox.alert` +关窗 reject 由
`.then(()=>{},()=>{})` 收尾,不新增 catch)。

三条边界,都是把它写成"能拦但拦错东西"的风险点:
- **前置排在一切昂贵动作之前**:`parseFiles()` 里早于 `parsing.value = true`、早于
  `parseAppearancePatent(`/`parseSimilarAsin(` 建单调用(铁律 27 边界 b)。
- **unknown 放行**:`getApiSecretGateState()==='unknown'` 是"从未成功拉到服务端数据",
  网络抖动不等于未配置,拦人就是把上游抖动说成用户没配——与商标代理前置同口径。
- **文案与服务端同源**:模块名取服务端下发的 `moduleLabel`(`listApiSecretModules()`),
  句子逐字对齐 requireSubmitSecret,前端不再另起一份叫法;查的是本模块快照
  (`getStoredApiSecretSnapshot(moduleKey)`),不拿全局完整性一档误伤另一个模块。

顺手摘掉两处「本地无明文不再阻断」的 console.log 死分支——日志不等于拦住用户。
`pushToPythonQueue()` 里同名那句不动:它启动的是已建好的单,不是建单入口。

判据:`tests/pre-submit-llm-key-gate.test.ts`(4 例,两个 Tab 共用同一份
`gateViolations()` 判据,反向自证喂进实现时用的同一把尺子:摘前置/挪到建单之后/
让 unknown 拦人/硬编模块名,各自报出自己那条违规)。node --test 4 passed;
`npm test` 全面 1007 passed/0 fail;`npm run test:mount` 55 passed;
`npx vue-tsc --noEmit` rc=0。该仓无入库 lint 脚本 ⇒ 以类型检查+测试为准,不伪造 lint 绿。
2026-11-03 16:20:38 +08:00
huangzd1997 b9d23d5936 feat(phase-4): 建单凭据需求按 task type 登记进 TaskModuleRegistry(B72-01)
`/newApi` 是整包转发的透传面(客户端只搬字节),载荷里有什么凭据需求客户端猜不出来;
铁律 27 的建单闸门此前只有两处各写一枚枚举,"这一类要什么凭据"没有一处正本。本笔把它
收成表:`TaskModuleRegistry.Module` 新增 `submitSecret`(16 类逐类登记),
`requireSubmitSecret` 新增按 type 的入口,enum 形态降为包内原语——包外再想硬编一把密钥
就编译不过,只能上册表。

两处判断写死在代码里:
- **登记为空是结论,不是漏填**。外观专利/货源查询要 LLM 密钥;其余几类缺的是代理,
  而缺代理在执行侧是「直连降级」不是注定失败(铁律 27 边界 c),拦了会把现在能跑的功能
  判死——所以本笔只登记、不新增任何拦截,`enqueue_json` 那半还等"这台机器直连能不能
  采到"的实测读数(B72-01 后半欠账原样留着)。
- **空登记调到这里当场 IllegalStateException,不静默放行**。空转的闸门比没有闸门更坏,
  它让下一个人以为这条链已经防住了(门禁 1 同族)。同理 `submitSecretModuleOf` 对不在
  清单里的 type 抛错而不回落:「没登记」与「登记过=不需要」不许揉成同一个值。

判据:`TaskModuleCoverageTest` +3 例(登记表与实际问闸门的类型双向对撞/每个模块都
登记过/未知类型当场抛,源码扫描按 ConsoleWideningGuardrailTest 的 mainRoot 口径,
定位不到即抛不空扫)+`UserApiSecretServiceTest` +4 例(按 type 拒/放行不读库/
空登记抛 IllegalStateException 且不碰库/未注册抛 IllegalArgumentException)。
两处快照测试跟着改到类型形态(`anyString()` 消歧重载,摘掉不再使用的 enum 导入)。
反向验证:外观专利不登记→2 红;给 COLLECT_DATA 顺手加登记→2 红;静默放行→1 红;复原复绿。

行为对现网零变化:两个调用点问的还是同一把钥匙、同一句文案。
门禁:`mvn -o test-compile` rc=0;`mvn -o test` 整量 5274/0 失败/0 错误/19 skipped
BUILD SUCCESS(Phase 3 在册 5267+本笔 7)。
2026-11-03 16:19:59 +08:00
huangzd1997 51401de2d5 fix(phase-2): B51-R1 收口——failure_category 落库+写点全接线+双读按文案优先
判死/重试/重开原先只读 biz_file_task.error_message 里的中文子串决定:改一句用户看得见的
文案=静默改一次整单生死,而且改的人不会知道。V186 补 failure_category(可空、存量不回填),
TaskFailureLedger 作为唯一写入口把「那次判断的结果」与文案同笔落库——词汇表仍只有
TaskRetryEligibility 一处,ledger 不抄第二份 markers(B52 那族的复发形状)。

- wrapper 面 22 处写点全部同笔派生写列;实体面接线第二批(外观专利 4/相似ASIN 4/采集 1),
  正是 DELIVERY/BALANCE 那几族被判死消费的文案
- 读侧 category(task) 取「文案判得出按文案、判不出才按列」:名单外的实体写点改文案带不动列,
  无条件读列=让一列陈旧判决判死当前这一单,那是本笔自己引入的漂移,比它要修的 bug 更糟
- FileTaskEntity.failureCategory 标 @TableField(updateStrategy = ALWAYS):updateById 默认跳过
  null 字段,「清错误」的分支会留下陈旧列;让 null 真落库,最坏只退回文案判定=加列前的今天
- 判据:TaskFailureCategoryGuardrailTest(5)+TaskFailureCategoryMigrationV186Test(5),已反向验证
  「删任一处配对即红」;SourceScanTest 台账裸名 24→25、调用方 17→18
- 门禁:mvn -o test 整量 5267/0 失败/0 错误/19 skipped;_push_gate.py full overall=pass

Contract 阶段(收 contains(<中文>) 判定)按蓝图登记留到读侧全切之后,本轮不动。
2026-11-03 12:49:45 +08:00
huangzd1997 34f730d403 fix(phase-2): 任务活性与失败归因六格收口——在飞豁免/锚点分流/同源判据/回落一元化/巡检按账号分组
蓝图 docs/REFACTOR_PLAN.md Phase 2 的 ①②③④⑥ 五格+台账登记。⑤(failure_category)
未做,原因见文末,不以此笔冒充闭环。

① B74-02 卡死阈值二选一 → 选"扫描询问执行侧",没有抬阈值。
  取证:B 侧 24h 批次 costMs 实测 22,988 / 85,298 / 939,172(单行批次 15.6 分钟),
  A 侧今天 06:07:20 `STUCK_REQUEUE_EXHAUSTED jobId=23815 taskId=33179 stuckRequeueCount=20`,
  06:08 复位恢复、09:20 同样两条=环。真因不是批次长:`startJobHeartbeat` 在父任务终态时
  按 CR-08 刻意停止续期(stage=TERMINAL_STOP_RENEW),执行线程还在跑而 updated_at 冻结,
  扫描每 5 分钟扣一次计数。冻结是**无限期**的,抬到 16 分钟只把 20 次计满从 100 分钟拖到
  320 分钟,还把真遗骸回收拖慢 ⇒ 改为 TaskFileJobService 持内存在飞登记
  (markInFlight/clearInFlight/isInFlight),扫描对"本机线程还在跑"的行不重排也不计数;
  登记面随进程重启即空,遗骸回收形状不变。worker 侧登记在 activateRunningClaim 之后、
  注销在 finally(finishAfterExecution 之后再注销)。

③ B74-03 判死谓词分流(先取证后动手,红线照办)。
  取证:云助手只读 HGETALL+TTL 两枚 stall 键自洽——33179 pos="Linux后台抓取: 606/676"
  与当前 progressText 逐字相同、at 距 now 16,058s(4.46h)、TTL 余 16,342s ⇒ 键 TTL 设定
  32,400s = 9h = 窗口(180min)×3;33149 同样自洽。机制坐实:键一过期 evaluateAgainstSnapshot
  就把起点重锚到 now 并直接 ADVANCING ⇒ 每 9 小时白送一轮完整豁免,沉默客户端永远封不了口
  (11-02 那串"客户端仍在推进"即此形状)。改法:快照缺失/at 读不出与"指纹真变"分口,
  重建锚点锚到**客户端最后一次上报时刻**(位置哈希自己的 at,此前无人读过),再走同一条
  时间判据;客户端确在心跳时锚点仍新鲜 ⇒ 照旧 ADVANCING,判死线不提前(28919 教训在册)。
  P0-C2 快照按"更新即登记"补 3 支:沉默超窗不得豁免/at 读不出走同一条判据/心跳中照旧放行。

② B74-01 三格:landed 与 isJudged 收成同源(mergeLlmRowsIntoChunks 认的"塞回分片"不是结论,
  旧写法给只有 patentRisk 的行打 24h 标记 ⇒ 既不再是候选又无结论列);beginRowInspection 的
  Redis null 由"抢到"改判"未抢到"(抛异常的真降级照旧放行,两条不同路);
  deleteExtraTaskCacheKeys 原删的是从不写入的基键=删空气,改按 processed-rows:{taskId}:*
  游标 SCAN 删真实逐行标记(用 SCAN 不用 KEYS)。新断言做过反向验证:摘掉 isJudged 闸门
  即真红,不是白过。terminalizeRoundExhaustedRows 是按轮次上限终态化的唯一豁免,已写明。

④ B74-04 四台 JSON 回落收成唯一出处 TaskOwnerJsonFallback(result_json 正档先于 request_json;
  店铺采集此前只读 request_json ⇒ 列缺失的 39 行 RUNNING 存量行在不同校验里算出两个归属)。
  TaskOwnerReadSourceGuardrailTest 补回落面:四台不得再有本地回落写法,且顺序钉在那一处。

⑥ B73-03 巡检分组键按供应商账号折(供应商, 提取域, 排序后 query 的摘要——只落摘要,
  链接里的账密明文不进日志/告警面)。青果整个账号只有 1 条通道,旧 moduleKey|channel|密文
  让同一把 key 多开几枪就自己把用户的代理打成 channel_busy。另一半边界同样钉住:
  非链接型凭据(LLM 密钥)照旧逐模块分组,否则拿 A 渠道的结论冒充 B。

台账:SourceScanTest 裸名 23→24(新增 TaskOwnerJsonFallback.java 这一枚),
  与 2026-11-02 那次 22→23 同法逐笔写明是谁的哪一笔、为什么只能打在源码连线上。

门禁实录:mvn -o test 整量 **5256 例/0 失败/0 错误/19 skipped,BUILD SUCCESS**;
  mvn -o test-compile rc=0;定向面另点过(56/88/34+70/63/104 例全绿);
  本仓后端无 spotless/checkstyle ⇒ lint 与格式步如实登记、不是漏执行。

未做的一格(⑤ B51-R1 failure_category):取证显示 biz_file_task.error_message 的落库点
  **没有单一出口**(LambdaUpdateWrapper.set(errorMessage) 15 处+setErrorMessage 若干,
  合计约 25 处,且清 null 的分支也必须同步清列)。这不是"改一支方法"的量级,
  拿半截双写冒充 Expand 会变成列恒为 NULL 的死代码 ⇒ 留作单独一笔,蓝图保持未勾。
2026-11-03 10:47:59 +08:00
huangzd1997 66621d8a16 test(ratchet): f43ed6f1 落地时漏改的两处陈旧钉按实测重新上钉
这两支红在 HEAD 上(不是工作树):f43ed6f1「任务中断+继续」当时只跑了定向
79+22 与 ops 快检,没点后端整量,于是两支钉死分母跟着功能一起陈旧。本笔不放宽,
只是把覆盖面变大如实记账——与文件里既有的 126→128 那条同一写法。

- ResultFileJobHandlerTest.interfaceMethodsPresent 9→10:接口新增第 10 枚
  default onTaskResumed(Long)(继续续跑前清模块补检预算,AP 侧删 __recheck__
  哨兵键;不清则"继续"后第一轮就被"补检已耗尽"直接按部分表收尾)。断言里
  同时补上对 onTaskResumed 的 methodOf 存在性核对,别只数个数。
- RequestSuppliedIdentityOutletTest 写类分母 128→129:TaskHeartbeatController
  POST /api/tasks/{taskId}/interrupt 是新增的写类端点,@RequestParam("user_id")
  先过 adminAuthSupport.resolveOwnershipUserId 再比归属(:52-57 实核)。
2026-11-03 09:29:37 +08:00
huangzd1997 43240b9a10 fix(stability): 接手第三路未提交 WIP 并收口——卡死扫描跨实例归属守卫+补检预算闸
归属声明(不是本会话的产出,本会话只补了漏改的桩):这批改动在工作树里躺到
2026-11-03 00:47 未提交,f43ed6f1 的 commit message 已点名"同工作树另一会话的在飞件
(TaskFileJobService 卡死归属守卫、TaskResultFileJobWorker、DeliverySupport 补检闸及其
3 支测试)未卷入本提交"。用户 2026-11-03 拍板"接手收口后开 Phase 2",故原样入库。

WIP 本体(作者=第三路会话):
- TaskFileJobService:resetStuckRunningJobsDetailed 增 currentInstanceId 重载+
  belongsToAnotherInstance 谓词——B 扫到 A 正在跑的 RUNNING 行不再翻 PENDING 也不再
  +1 stuck_requeue_count(33149 爬到 20 判死线即此形状);不带实例 id 的旧入口保持
  原行为,后管人工复位按钮不受守卫影响。
- AppearancePatentDeliverySupport:requestRecheckForMissingRows 自己吃
  recheckMaxRounds 预算——行级轮次只在行真进批次才累加,"没有可比对图/载荷"的行
  永远进不了批次,于是 33179 一个 1 行缺口六小时补了 70+ 轮。
- 配套:TaskFileJobOwnerHandOffTest +4 支(谓词边界/他机 RUNNING 不翻不判死/
  自己的陈旧行照翻/无实例 id 入口原行为),StuckScan 与 FailureNotify 两支桩
  改到新 3 参签名。

本会话补的一格:TaskResultFileJobWorkerTest 三支桩没跟着改到 3 参签名,
stuckSimilarAsinJobAtRetryLimitFailsOwningTask 等 3 例 PotentialStubbingProblem
真红(11-03 09:0x 实测)——改成 eq(0),eq(0),anyString() 并补 eq 静态导入。

验证:mvn -o test 定向 6 类(Worker/StuckScan/FailureNotify/OwnerHandOff/
ResultFileJobHandler/RequestSuppliedIdentityOutlet)rc=0 全绿。
2026-11-03 09:29:23 +08:00
huangzd1997 6444c17edc refactor(phase-1): 后端依赖瘦身——CN-03 lombok provided+CN-04 测试库泄包排除+S-be-2/3 依字节码证据排 rocketmq 死重(fastjson1/guava/snappy 保留留痕) 2026-11-03 04:13:03 +08:00
huangzd1997 a04c1f3cf6 test(phase-0): 稳定性契约快照三支(P0-C1 stuck 时序/P0-C2 活性谓词三出口/P0-C5 判死 markers 词汇表) 2026-11-03 02:43:15 +08:00
huangzd1997 13fd426133 chore(slim): 删用户端未引用的 logo.jpg 冗余副本(CN-02)+ backend-java/tmp 补 gitignore(BD-8) 2026-11-03 02:43:08 +08:00
huangzd1997 f43ed6f116 feat(task-interrupt): 任务「中断+继续」——在跑可停、部分表可下载、已中断可续跑
用户口径(2026-11-03,33179 卡 80%「正在提交检测」的救援出口):任务卡片加
「中断/继续」;中断后已完成检测的数据生成结果文件供下载,未完成行不再检测;
继续在原任务上续跑剩余行(断点续传,已检测行不重检)。

中断(POST /api/tasks/{taskId}/interrupt,鉴权镜像 retry:resolveOwnershipUserId
+归属校验,普通账号只能中断自己名下的任务;终态重按幂等 no-op):
- TaskHeartbeatService.markCancelledByUser:ACTIVE→CANCELLED 条件更新(词表走
  TaskStatuses.FileTask 常量),写「用户中断任务,已完成部分可下载」+finished_at,
  syncTerminalState 同步模块缓存与进度快照;客户端心跳拿到 notAlive 即协作停止
  (app_client/maixiang 零改动,≤60s 自停)。
- LLM 批循环批间查终态即停:当前批跑完不再发新批(isOwningTaskTerminal)。
- 中断任务的组装跳过候选申领/LLM/补检,直接按已有行账出部分表(allowPartial),
  状态保持 CANCELLED 不改写,只补行账缺口文案;cleanupResultFileJob 对 CANCELLED
  任务保留分片/范围态/瞬态载荷(这就是「继续」的续跑点),常规交付照旧清理。

继续(retry 链路放宽 CANCELLED,全部在原任务上):
- retryInPlace 条件更新放宽 FAILED/CANCELLED;CAS 前经 ResultFileJobHandler
  新钩子 onTaskResumed 清模块补检预算(AP:删 __recheck__ 哨兵键;不清则继续后
  第一轮就被「预算耗尽」直接按部分表收尾,钩子抛错即中止不留半态)。
- 中断已交付过的:清 result.result_file_url/size(让位给新表)+把 SUCCESS 的
  ASSEMBLE_RESULT 作业复位 PENDING(retry/stuck 计数清零、清错误与 finished_at);
  FAILED 仍走既有 resetTerminalFailedForRecovery。
- 校验文案「只有失败或已中断的任务可以继续」;成功任务不可继续。

前端(用户端外观专利 Tab 先行,后端端点本身通用):中断按钮进当前/历史两个
动作槽(确认框说明「未完成行不再检测、已完成检测的数据会生成结果文件供下载」);
CANCELLED 显示「已中断」(判定先于 isResultPreparing,不掉「等待中」兜底);
重试按钮文案 CANCELLED→「继续」,继续的确认框警示部分结果文件将被替换请先下载;
轮询收敛集合与 keepPendingFileTask 补 CANCELLED。棘轮:前端 catch 块 310→311
(interruptTaskRecord 一支,两处 ElMessageBox 确认走 .then 两臂不新增 catch);
状态词表全走 TaskStatuses 常量。

测试:TaskHeartbeatServiceTest +4(CAS 落库+缓存同步/终态幂等/非本人 403/
任务不存在明确报错)、TaskInPlaceRetryServiceTest +3(继续复位+作业复位+
补检钩子只对 CANCELLED 触发/成功不可继续)、新增 AppearancePatentInterrupted
ResumeTest(3)(保留分片=续跑点/常规交付照旧清理/中断收尾不改写状态)与
AppearancePatentLlmBatchPipelineInterruptTest(2)(批间终态即停);后端定向
79+22 全绿。前端新增 appearance-patent-interrupt-continue.test.ts(9);npm test
1003/1003、test:mount 55/55、vue-tsc 零错;ops 快检 overall=pass(grep 需
Git usr/bin 在 PATH,两红格系本机 shell 环境非代码红)。

并发边界:同工作树另一会话的在飞件(TaskFileJobService 卡死归属守卫、
TaskResultFileJobWorker、DeliverySupport 补检闸及其 3 支测试、useLiveTaskBoard、
task-delete 三件)未卷入本提交;本提交不依赖其中任何符号(appendDeliveryGapMessage/
resetTerminalFailedForRecovery/registry.asMap 均在 HEAD 已在)。
2026-11-03 02:07:48 +08:00
huangzd1997 37f51df37d fix(owner): 跨实例归属背离改为转交作业,不再无限 defer 空转
领取按 biz_task_file_job.owner、执行时校验按 biz_file_task.owner_instance_id,
任务转交后两列一旦背离就是互斥死锁:能领到这行的实例必被校验拒,校验放过的
实例必领不到这行;而拒绝分支 deferRunning 既不计 retry_count 也不计
stuck_requeue_count 还每轮刷新 updated_at,卡死重排与 PENDING 遗骸两条兜底
因此永不触发。现网外观专利 33179/33149 停在 PENDING 每 15 秒被拒一次,单机
12 小时 6381 条拒绝,进度快照冻结 4 小时 19 分,既不失败也不完成。

- TaskFileJobService: 新增 handOffToOwner(owner 列与 scope_key 尾段一起改挂,
  CAS 按观测到的旧 owner 回撞)与 withOwnerScopeKey(ownerFromScopeKey 的逆操作);
  enqueueAssembleResult 的 PENDING 分支改为按入队 scopeKey 对账归属——Python
  超时恢复每 2 分钟走这一格一次,原先只补发事件不对账等于每 2 分钟确认死锁还在。
- TaskResultFileJobWorker: 归属拒绝改为先改挂再退回。转交后两列重合,拒绝条件
  按构造不再成立,因此不需要额外计数兜底。
- 相似ASIN/发布 ownerFromTask 改为 owner_instance_id 列优先:原先只读 resultJson
  快照(转交后不再同步),转交目标会算错、死锁只是换个方向。店铺采集本就列优先,未动。

判据:TaskFileJobOwnerHandOffTest(11) + TaskResultFileJobWorkerOwnerHandOffTest(3)
+ TaskOwnerReadSourceGuardrailTest(5,含四台校验源同源的源码绊线,已反向验证
"改回只读快照即红")。SourceScanTest 台账按设计登记新消费方:裸名 22→23、
调用方 16→17。后端整量 5206 支 0 失败 19 skipped。
2026-11-02 22:53:18 +08:00
huangzd1997 0114a5b7a7 fix(文案): NO_AVAILABLE_CHANNEL 不再断言"是你自己的采集占着",三成因一次说全
现网实测把这句文案证伪了:零并发单发 overseas.proxy.qg.net/get(就这把平台 key)仍回
NO_AVAILABLE_CHANNEL,而两台机器本小时都没有一条青果提取记录(vc 槽空闲、maixiang 走的是
极客且本小时只确立 17 次租约)。所以"等约 3 分钟释放"是一个**猜出来的单一成因**,
它会把人引去反复点、等一个根本不会来的释放。

供应商这个码至少三种成因,文案一次给全并给出去哪查:同账号其他提取占着(约 3 分钟)、
这把 key 的套餐到期/无余量、后台把鉴权切成 IP 白名单档(我们只做账密档,切了就一直拿不到
通道——铁律 25 那条口径)。后管档位名同步从「待释放」改成「无可用通道」,用户端面板提示
补"隔几分钟仍报同一句就别再等,去青果控制台核对通道数与有效期"。

判据跟着反转:原来那条测试把"正被你自己的采集占着"当事实钉住,现在改成
doesNotContain 那句 + 必须含「没有可用的空闲通道」「IP 白名单」——谁改回单一成因即红。

顺带清掉 B73-14:UserSecretModule.defaultChannel() 的注释写"代理=青果(10-29 拍板)",
而代码取 ProxyProvider.DEFAULT=JIKIP(10-30 拍板改回极客)——注释与代码相反,下一个人照
注释判断"没写 channel 就是青果"会做错事;改成只跟着 DEFAULT 取值并写明来历。

后端整量 5187/0 失败/19 skipped;用户端 994+55、后管 1872+68、tsc 两面 rc=0、
ops 可读性棘轮 10 绿。
2026-11-02 17:09:08 +08:00
huangzd1997 e26a157037 fix(后管): 状态列认得新分的 check_code,不再一律掉回「无法判定」
现网证据:uid=1 的 proxy 行库里已是 channel_busy(15:51 用户自己点检测写的),
后管却显示「无法判定」——数据对、界面不认识这个码。今天后端把青果检测从"无条件
假通过"改成真提取分档后,码集扩到 ok/channel_busy/invalid_key/forbidden/rate_limited/
insufficient_balance/tunnel_unverified/provider_error/网络超时族,前端只认旧几档就会
把"等一会儿就好"和"密钥坏了"混成同一个黄标。

档位:channel_busy→待释放(青,可重试族);rate_limited/timeout/network_error/
server_error→各自青档;insufficient_balance→欠费(现网 21 行原本吊在 failed 上,
改成按码认);tunnel_unverified→链接缺账密;invalid_key/forbidden/bad_request/
provider_error→红;**「无法判定」只留给空码/未知码**,unknown 留「未检测」
(那是后端 upsert 初值=从没问过,不是问不出)。句子一律取后端 check_message 原文,
前端不再按码自己拼措辞。行级汇总同样分族:逐格全属可重试才叫「可重试」。

判据:单元 9→19 支(含逐码档位表)+新增 mount 10 支;变异验证删掉 channel_busy
一行→单元 4 红+挂载 2 红。本面 node --test 1872/0、vitest 12 文件 68/0、tsc rc=0。
source-pin 台账按该尺子自带开关重生成(只多这一支文件)。
2026-11-02 16:20:08 +08:00
huangzd1997 2cbd99ed4f feat(密钥设置): 掩码框加眼睛核对,且按键隔离
用户点名:青果 Authpwd 是 •••••••• 且没有任何查看手段,填错只能靠猜。抽
useSecretVisibility(单槽)与 useKeyedSecretVisibility(循环卡用),眼睛按钮件沿用
登录页那对 svg 命名——登录页的 inline 是第一遍抄,这是第二遍,之后只改一处。

按键隔离不是细节:外观专利与货源查询共用同一段循环模板,共用一个布尔会变成
"我核对我手里这把"顺手把用户没打算看的另一把也摊在屏幕上。

射程按用户拍板"一起补":Authpwd、jikip 套餐 key、两张 LLM 密钥卡;弹窗外的
Aliprice 密码不在本面板、未动。三条红线:默认掩码、状态不落 localStorage 不进日志
上报、保存成功/重读配置/切供应商/卸载四处一律收回掩码。

判据:tests/密钥显隐状态机.test.ts 8 支(含"面板里不许再出现没挂眼睛的裸密码框"
这条防复发的尺子)+ tests/mount/密钥面板authpwd显隐.mount.test.ts 6 支。
本面 node --test 994/994、vitest 9 文件 55 例、vue-tsc rc=0。
2026-11-02 16:19:32 +08:00
huangzd1997 7e64c12dd6 fix(proxy): 青果检测改真探并按供应商分码,三面收口凭据外漏与「无法判定」
用户报「青果也要加检测」,往下挖出四层假象,一次收口:

- 后端:probeProxy 的青果短路(过去无条件回「提取成功(青果隧道端点,连接鉴权在客户端)」,
  依据的注释已过期——存下来的链接里就带 key/pwd)删掉,改成真打一次提取,按供应商返回码
  分档出独立 check_code:channel_busy / invalid_key / forbidden / rate_limited /
  insufficient_balance / tunnel_unverified。文案出口一律抹 key/pwd。
- 后端:巡检遇 channel_busy 不落库也不推通知。通道被占不是「密钥坏了」而是「此刻问不出
  结论」,而巡检自己那一发真提取就要占掉唯一一条通道——落库等于把用户早上看到的
  「代理异常」写成我们自己造成的。
- 后端:余量口径按供应商分档。青果账号此前会落进「否则查平台套餐」那条,界面显示的是
  别人家的 jikip 余量(串档);青果不提供可鉴权的余量/余额查询(余额接口是控制台
  appid/appkey 签名档),这一档宁可返回「查不了」也不借极客的数。
- 后端:SecretMasking.maskProxy 的脏值回落不再套 mask()——它保后 4 字符,而青果的 pwd=
  恰好挂在末尾,等于把口令尾 4 位交给界面与日志;改成只交「像 host 的那一段」。
- 用户端:去掉「青果账密直连,无需检测」的 disabled 例外,未保存账密现拼链接送检;
  「无法判定」回落改成后端文案原样显示+可重试语义;代理卡不再套 LLM 渠道字典
  (「龙抬头」错标的真根因就在这行)。
- 后管:货源标签拆成两张互不相通的字典,代理列只读 masked 且不回落到原文,删掉
  user-select:all 的全选复制旁路,「修改代理」改成重填 Authkey/Authpwd 的弹窗。

判据:SecretMaskingTest(5)、UserProxyBalanceServiceTest(6)、UserApiSecretServiceTest
(+1 巡检不落库)、UserApiSecretCheckServiceTest(+138 行分码)、ProxyLinkKeyTest、
用户端 node 5 支+mount 10 支、后管 node 9 支+mount 8 支。后端整量 5187/0 失败,
full 闸门四面绿。
2026-11-02 15:18:41 +08:00
huangzd1997 7f5437d012 feat(submit-gate): 缺 LLM 密钥的外观专利/相似ASIN 单在建单口当场拒
用户口径(2026-11-01):「没配置代理的不止是变体采集要拦,其他任务也是一样,包括 llm 密钥。」
这一支是服务端那半边——两把 LLM 密钥此前是**静默降级**:readApiKey 读空只打一条
log.warn,然后「保留原始行」把单子跑完、把表出出来,整列检测结论却是空的。
用户买到一张没检测过的结果表却看不出来,比一句「没配密钥」的失败更难发现;
而 UserSecretModule 早就把这两把密钥登记成 required=true(用户端必填),闸门只是把
这句声明变成会拦事的代码。

- UserApiSecretService#requireSubmitSecret:请求体带的密钥与库里存的那把,有一个非空即放行;
  两侧都空当场 BusinessException(文案点名是哪把密钥、去哪配)
- 外观专利 AppearancePatentTaskService.parseAndCreateTask / 相似ASIN
  SimilarAsinTaskService.parseAndCreateTask:闸门排在 Excel 解析与建单四段**之前**,
  不解析、不落库、不占配额;userId 校验仍在最前(先判身份再判凭据)
- 用例:UserApiSecretServiceTest 3 支(两侧都空拒 / 带值放行且不读库 / 库存量放行)、
  两支建单快照各 2 支(缺密钥不碰源文件不落库;正向对照验模块与请求密钥同值)
- 六支 SimilarAsinTaskService*Test 补 @Mock UserApiSecretService:@InjectMocks 缺该类型
  会注进 null,闸门调用直接 NPE——这是把闸门接真后必须显式登记的依赖
- RequestSuppliedIdentityOutletTest 写类分母 126→128:2026-11-01「原任务重试」新增的两支
  POST 端点(TaskRetryController / AppearancePatentController)都已接 resolveOwnershipUserId,
  覆盖面变大不是放宽判据;该红是当时只跑四面闸门、没点后端整量留下的陈旧分母

后端整量 mvn -o test:5164 例(本笔改动 0 红;唯一一处红即上述陈旧分母,已随本笔抬正)
2026-11-02 00:33:58 +08:00
huangzd1997 8f206a6019 chore(ratchet): 原任务重试两处兜底 catch 逐处记名并抬四格
TaskInPlaceRetryService 的 clearResultError/resetAssembleJob:WARN 留痕、
失败不阻断已复位的重试。total 1063→1065、logOnly 190/249→192/251、
notRethrow 严格/基线 602→604,出处逐条写进常量上方。
2026-11-01 01:55:34 +08:00
huangzd1997 96b090dfd5 feat(task-retry): 重试按钮推广到相似ASIN与采集数据
同类问题一起修:这两个模块与外观专利共用同一条自动重试(原先也克隆重试)。
- 新增通用端点 POST /api/tasks/{taskId}/retry(模块无关,从任务行取 moduleType)
- 两页失败任务在「删除」前显示「重试」,调用后在原任务上复位续跑
- catch 棘轮 308→310,两处均 ElMessage 可见出口
2026-11-01 00:46:08 +08:00
huangzd1997 0a467793ac feat(task-retry): 失败任务改为原任务上重试 + 重试按钮(用户拍板)
用户口径(2026-11-01):失败不再自动克隆(一单失败几次就多几行结果),
改成「删除」旁边的「重试」按钮,在原任务上断点续传;自动重试也只复位原任务。

- 新增 TaskInPlaceRetryService:FAILED→PENDING,清错误/终态时间,代数+1,
  保留分片/解析载荷/已检测标记;结果行清错误、组装作业复位(含卡死重排计数清零)
- TaskResumeService 自动重试改为调用原地复位(不再 cloneForRetry)
- TaskRetryEligibility 新增 DELIVERY(结果文件生成多次失败/卡死重排不重试)
- 新端点 POST /api/appearance-patent/tasks/{id}/retry;前端失败任务显示重试按钮
- ⚠ 本笔的 BrandAppearancePatentTab.vue 里另含他路在飞的「删除失败任务时一并删任务行」
  两小段(同一文件无法分块提交),随本笔一并入库
- 用例:TaskInPlaceRetryServiceTest 2、TaskResumeServiceTest 19、Eligibility 9、
  契约 8、前端 catch 棘轮 4,均绿
2026-11-01 00:30:51 +08:00
huangzd1997 0dfd385c4c fix(task-resume): 交付侧失败不再自动克隆重试
现网 32967→33001→33017:同一份输入失败后自动重试 3 代,每代一行
「结果文件生成多次失败」,用户看到「失败一次出一个结果」。
TaskRetryEligibility 新增 DELIVERY 类(结果文件生成多次失败/卡死重排),
排在欠费之前判定;回传中断/心跳超时仍可重试(反向用例钉住)。
2026-10-31 23:57:14 +08:00
huangzd1997 35ce0f0f40 fix(user-secret): 青果提取域名改为 overseas.proxy.qg.net
实测(2026-10-31,A 机直打青果接口):
- share.proxy.qg.net  + key/pwd → INVALID_KEY(这把 key 不属于该产品线)
- overseas.proxy.qg.net + key/pwd → NO_AVAILABLE_CHANNEL(key 与 pwd 均被接受)
- overseas 不带 pwd → API_AUTH_DENY(确认 pwd 必填、密码鉴权档)
拼装域名随之改为 overseas。
2026-10-31 23:22:51 +08:00
huangzd1997 6a9dc34713 fix(db): V185 菜单插入显式写 company_id 并按公司幂等
columns.company_id 是 NOT NULL 无默认值,漏写直接 1364,导致 V185 从未应用成功
(库里留 success=0 历史行,A/B 后端都起不来)。菜单是每公司一行,幂等判据改成
(company_id, column_key);事务内实测插入 6 行后回滚干净。
2026-10-31 22:45:24 +08:00
huangzd1997 3f827cc9af fix(user-secret): 青果链接改官方口径 share.proxy.qg.net 的 key+pwd 查询串
用户明确:青果只做密码鉴权档,白名单档不做。拼装规则随之改为
https://share.proxy.qg.net/get?key=..&pwd=..,不再用 userinfo。
2026-10-31 22:31:49 +08:00
huangzd1997 faae355bcf fix(user-secret): 青果只用 Authkey/Authpwd,链接由前端拼并上报服务端
青果没有可填的提取链接(10-30 口径),但商标检测在服务端只认 proxy_url,
保存时又主动清空服务端记录 ⇒ 用户填了账密仍被判「未配置代理」。
- 新增 qingguo-link.ts(零依赖):由账密拼 overseas.proxy.qg.net/get 链接,
  Authkey/Authpwd 走 userinfo(隧道 Basic 认证没有第二个通道)
- 保存时本地与服务端都用这条链接;已存账密的旧配置刷新后仍能读回
- 4 例纯函数用例钉住拼装规则与空 key 语义
2026-10-31 22:16:30 +08:00
huangzd1997 91d36327f9 fix(phase-5.2): 消项 CR 第二轮 P1/P2/P3(通道/证据链/交付时序/后管证据页) 2026-10-31 21:12:18 +08:00
huangzd1997 a4e4456b50 feat(llm-arrears): 上游 LLM 欠费的提示落到任务界面并让货源链欠费即判死
现网两处叠加的洞:归因文案早在 2026-10-27 就写进了 biz_file_task.error_message,
但两支历史装配器只读结果行的错误、buildActiveItem 连任务级那条都不带,用户在列表
里只看到「失败」两字;货源链更是只有行级归因、任务停在 RUNNING,采集端读不到
心跳的 alive=false,就继续为永远进不了 LLM 的行按次付费买出口 IP。

- 新增 modules/task/service/TaskVisibleFailureNotice:界面出口的单一判据。认出本仓
  写下的欠费/密钥失效归因就换成 TASK_TERMINAL_GUIDANCE 那句中文动作,库里原文一字
  不改(英文响应体与上游账户号不进界面,对齐 RawExceptionMessageSinkGuardTest)。
  刻意不用 TaskRetryEligibility.BALANCE 当显示判据——那一类还涵盖 jikip 代理欠费,
  拿它换句子会把「出口没钱」说成「LLM 账户欠费」,正是 10-27 要避免的误导。
- 两支 HistoryAssembler 共用该出口:行级为空时兜底任务级归因,欠费压过行级副产品。
- 货源链补 terminalizeOnFatalLlmFailure(口径逐字对齐外观专利):判据取 BALANCE、
  非终态才写、可重入;并让 finalizeTask 不许用空/二次错误串盖掉整单结论。
- 用例:TaskVisibleFailureNoticeTest 11 例、SimilarAsinLlmArrearsTerminalTest 16 例
  (含 502/429/连接失败/心跳超时不许误杀、已终态不改写、收尾覆盖保护、接线源码钉子),
  两支装配器各补 4/3 例。后端整量 5,127 例/0 失败/19 skipped。
2026-10-31 17:34:54 +08:00
huangzd1997 1c179e0f2e feat(collect-channel): 专利与货源建单加「本单采集方式」单选框
执行方不再由全局开关定(后端 7469c710 起读 biz_file_task.collect_channel),
两个工具页建单时逐单选本机/线上,默认选中项取 /api/collect-routing 的模块默认。

- localCollectEnabled 改为从所选通道派生的 computed:启动分支、按钮文案、提示语
  与建单入参同源,不再两处各判各的。
- 建完单即锁定单选框:通道在解析建单那一刻就写进任务行,事后再改只会被建单值覆盖,
  界面会出现「选着线上、点启动却推本机」的假象。
- 货源查询 Tab 原本两条提示语都在讲「后台自动分批检测」(本机分支文案写错),
  随本次一并改正。
- parse API 的 collect_channel 为可选参数:不传就不带这个键,服务端按模块默认兜,
  新增两条用例把「传/不传」两种载荷形状钉住。
2026-10-31 12:33:27 +08:00
huangzd1997 7469c710d7 feat(collect-channel): 采集执行方按单判定并随 /parse 落库
「这一单交本机还是线上」原先是全局 yml aiimage.collect-routing.local-enabled,
一台服务器一个值,把同机所有账号捆成同一个执行方:本机开着的用户被迫走线上,
跑 Linux 兜底的用户也没法把某一单留在本机。现改为建单时逐单登记
biz_file_task.collect_channel(V183,可空=按模块默认),全局开关只留兜底窗口。

- 列可空且不回填:空值按模块默认解释,APPEARANCE_PATENT/SIMILAR_ASIN 读作 LOCAL、
  其余读作 ONLINE,与撤掉的 AIIMAGE_COLLECT_LOCAL_* 出厂值逐字节等价,
  历史单与未升级前端行为不变。
- TaskRetryCloneSupport.buildChild 必须继承通道:原单选了线上,重试掉回模块默认
  等于悄悄换执行方。
- CollectChannel 用逐值比对而非 valueOf+catch 判「不可识别」:后者会把静默 catch
  总数顶过 CatchSilenceRatchetTest 上限 1057。
- 两支建单快照 golden 随 collect_channel 键重建(只多出 collectChannel=null)。
2026-10-31 12:33:09 +08:00
huangzd1997 7459177bb4 test(phase-5.1): 分片/教程接线的测试缝与棘轮台账随实现对齐
- upload.ts 保持 axios 实例 http.post(与打包产物一致),两处用例改对撞同一把缝
- 教程确认用例接受可选 file_key,并新增该参数的存在断言
- 静默 catch 台账登记 localStorage 两处,blocks 抬到 307 并逐支说明
2026-10-31 04:47:31 +08:00
huangzd1997 2c2cb23943 fix(phase-5.1): 回收/确认幂等与两前端分片重试按 CR 消项加固
- 分片回收与 savePart/complete 共用会话锁并锁内复查 mtime
- 版本/教程 confirm 按 version 或 fileName+version 幂等返回既有行
- 证据登记失败补偿删除已上传对象;标签截断到列宽 32
- 用户端分片持久化 upload_id、校验包体失败、失败不再 DELETE
- 后管逐片重试 2 次、放弃时删除会话;catch 台账抬到 1057/190
2026-10-31 04:26:58 +08:00
huangzd1997 b13d795731 fix(phase-4): 证据件与分片落点按既有尺子收口
- TaskEvidenceMapper 去掉注解 SQL,保留期回收改用 MyBatis-Plus 分页
- 超管出口只保留一处静态判定,AdminTaskEvidenceController 记 uid 对撞日志
- SHA-256 走 Hutool DigestUtil、临时件用 File.delete 收掉两枚新 catch
- 分页台账补 AdminTaskEvidenceController 两点,catch 台账抬到 1055/189
2026-10-31 04:03:14 +08:00
huangzd1997 6fe5c8c8d0 feat(phase-3,4): 证据件服务端落点与两前端大档分片接线
- 后端新增 evidence 模块(V182 证据表/独立桶/超管读取面/内部登记)与
  application.yml evidence 块;管理员四端点逐个 requireSuperAdmin。
- 分片通道补 @Scheduled 回收与 LocalTempCleanupService 的 chunk-uploads 覆盖;
  版本/教程 confirm 接受 file_key,把拼装件搬进 client 桶后落库。
- 用户端 9MB 视频改走 uploadTempFileToJava 分片;后管版本/教程 >8MB 走分片,
  小文件仍走原 presign 直传。
- 激活 Phase 3/4 后端与两前端预置契约。
2026-10-31 03:45:50 +08:00
huangzd1997 5c283a79fc test(phase-0): 确认基线全绿并预置迭代验收测试契约 2026-10-31 01:14:39 +08:00
618 changed files with 53931 additions and 5957 deletions
+2
View File
@@ -14,6 +14,8 @@ backend-java/target/
backend-java/data/
backend-java/*.log
backend-java/logs/
# 会话级诊断脚本残渣(2026-11-03 瘦身审计 BD-8:_diag_keyword_sync.py 有误提交风险)
backend-java/tmp/
backend-java/src/main/resources/application-local.yml
backend-java/.idea/
backend-java/*.iml
@@ -499,6 +499,32 @@ const server = createServer((req, res) => {
},
})
}
if (url === '/api/admin/user-secrets/balances') {
// 余额侧写夹具(POST):两把密钥同渠道 ⇒ 界面折叠成一行;代理给「你的套餐」形状
const llmCell = (moduleKey, moduleLabel, over = {}) => ({
moduleKey, moduleLabel,
channel: 'longtaitou', channelLabel: '龙抬头',
available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00', ...over,
})
return json(res, {
success: true,
data: {
items: [
{
userId: 1,
llm: [
llmCell('appearance-patent', '外观专利密钥'),
llmCell('similar-asin', '货源查询密钥'),
],
proxy: { available: true, surplus: '1234', balance: '56', scope: 'user', message: null },
},
],
deniedUserIds: [],
timedOutUserIds: [],
},
})
}
if (url === '/api/admin/shop-manage-groups') {
return json(res, { success: true, data: { items: [] } })
}
+211
View File
@@ -0,0 +1,211 @@
import { http, unwrap } from '@/api/http'
/**
* 大档分片阈值与片大小(AC-11):后管这一侧只有这一个出口,阈值由片大小派生。
*
* ⚠ 同族的 8MB 数还另有两处:用户端上传出口一处、桌面客户端分片入口一处。两边是各自
* 独立的构建根(各自的 `@` 别名与 tsconfig include),客户端是 Python 打包物 ⇒
* 没有共享包就合不成同一个字面量(P3-5 的边界,已登记)。
*/
export const CHUNK_UPLOAD_PART_SIZE = 8 * 1024 * 1024
export const CHUNK_UPLOAD_THRESHOLD = CHUNK_UPLOAD_PART_SIZE
/** 每片重试次数(不含首次):单片 502/超时不该让 512MB 从 0 再来。 */
const PART_RETRY_LIMIT = 2
/**
* 逐片超时(P2-8):预算只看**这一片**有多大——60s 保底 + 每 MB 30s(8MB 片=300s)。
* 过去按整包体积算(120s + MB×15s),512MB 包里的一个 8MB 片能拿到 128 分钟,
* 慢链路真卡死时没人知道,进度条还会一直爬。
*/
export function partTimeoutOf(partBytes: number): number {
return 60_000 + Math.ceil(partBytes / (1024 * 1024)) * 30_000
}
/** 会话登记/查询只发元数据,固定预算即可;失败要快快回来,别陪整包一起放大。 */
const REQUEST_TIMEOUT_MS = 60_000
/** 只有拼装这一步真随整包体积走:服务端要读全部分片、复算 sha256。 */
const COMPLETE_TIMEOUT_MS = 600_000
function partUrl(uploadId: string, index: number): string {
return `/api/files/chunk/${encodeURIComponent(uploadId)}/part/${index}`
}
/** 分片会话跨尝试/刷新续用:同一文件身份复用 upload_id,服务端没回收就从已达片号继续(P2-7)。 */
interface StoredChunkSession {
uploadId: string;
size: number;
lastModified: number;
}
const CHUNK_SESSION_PREFIX = 'shufu:admin:chunk:'
function lastModifiedOf(file: Blob): number {
const value = (file as File).lastModified
return typeof value === 'number' && Number.isFinite(value) ? value : 0
}
/** 会话键:文件名+体积+修改时间,三者同一条上传才算同一个件。 */
export function chunkSessionKeyOf(fileName: string, file: Blob): string {
return `${CHUNK_SESSION_PREFIX}${fileName}:${file.size}:${lastModifiedOf(file)}`
}
function readStoredSession(key: string, file: Blob): string {
if (typeof localStorage === 'undefined') return ''
try {
const raw = localStorage.getItem(key)
if (!raw) return ''
const parsed = JSON.parse(raw) as StoredChunkSession
return parsed.size === file.size && parsed.lastModified === lastModifiedOf(file) ? parsed.uploadId : ''
} catch {
return ''
}
}
function writeStoredSession(key: string, file: Blob, uploadId: string): void {
if (typeof localStorage === 'undefined') return
try {
localStorage.setItem(key, JSON.stringify({
uploadId, size: file.size, lastModified: lastModifiedOf(file),
} satisfies StoredChunkSession))
} catch {
// 存储不可用(隐私模式/配额满)只影响跨刷新续传,不影响本次上传
}
}
function clearStoredSession(key: string): void {
if (typeof localStorage === 'undefined') return
try {
localStorage.removeItem(key)
} catch {
// 同上:清不掉只会让下次多问一次 status
}
}
/**
* 服务端对「这个会话还在不在」的三种答复:还在(附带已到片号)/确实没了/问不出来。
* 第三态是 P2-7 与 P1-11 的共同判据——过去它被当成"没会话",瞬态抖动=整包作废。
*/
type ProbeOutcome
= { state: 'ok'; parts: number[] }
| { state: 'gone' }
| { state: 'transient' }
/** 后端回收会话的原文案(ChunkedUploadService.readMeta);BusinessException 不带 code ⇒ HTTP 200 出。 */
function messageSaysSessionGone(text: unknown): boolean {
const message = typeof text === 'string' ? text : ''
return ['不存在', '过期'].some((marker) => message.includes(marker))
}
function classifyProbe(response: unknown): ProbeOutcome {
const status = Number((response as { status?: unknown } | null | undefined)?.status)
if (status === 404) return { state: 'gone' }
if (status >= 500 || status === 408 || status === 429) return { state: 'transient' }
const body = (response as { data?: unknown } | null | undefined)?.data
if (body && typeof body === 'object' && (body as { success?: unknown }).success === false) {
return messageSaysSessionGone((body as { message?: unknown }).message)
? { state: 'gone' }
: { state: 'transient' }
}
const core = (unwrap<Record<string, unknown>>(body) ?? {}) as Record<string, unknown>
const arrived = core.uploaded_parts
return { state: 'ok', parts: Array.isArray(arrived) ? arrived.map((value) => Number(value)) : [] }
}
/**
* 探测已达片号(P2-7/与用户端 upload.ts 同一口径)。
* validateStatus 恒真:状态码要自己判——真 404/5xx 一旦被拦截器折成 Error 就分不出原因了;
* 能走到 catch 的就只剩网络层失败与超时,铁定瞬态。
*/
async function probeUploadedParts(uploadId: string): Promise<ProbeOutcome> {
try {
const response = await http.get(
`/api/files/chunk/${encodeURIComponent(uploadId)}`,
{ validateStatus: () => true },
)
return classifyProbe(response)
} catch (error) {
const status = (error as { response?: { status?: unknown } } | null | undefined)?.response?.status
if (status === 404) return { state: 'gone' }
if (messageSaysSessionGone((error as { message?: unknown } | null | undefined)?.message)) {
return { state: 'gone' }
}
return { state: 'transient' }
}
}
/** 后管大档上传(版本包/教程包共用):会话续用 → GET 已达片号 → 逐片 POST → complete。 */
export async function uploadFileInChunks(
file: Blob,
fileName: string,
onProgress?: (percent: number) => void,
): Promise<Record<string, unknown>> {
const totalParts = Math.max(1, Math.ceil(file.size / CHUNK_UPLOAD_PART_SIZE))
const sessionKey = chunkSessionKeyOf(fileName, file)
let uploadId = readStoredSession(sessionKey, file)
const arrived = new Set<number>()
if (uploadId) {
const probed = await probeUploadedParts(uploadId)
if (probed.state === 'gone') {
// 服务端确实说会话没了(404/「不存在或已过期」):清掉重开,否则这个件每次都在同一个死会话上失败。
clearStoredSession(sessionKey)
uploadId = ''
} else if (probed.state === 'ok') {
probed.parts.forEach((index) => arrived.add(index))
}
// transient:片号未知但会话还在 ⇒ 照原会话逐片重传(后端同片覆盖,幂等),不重开 init。
}
if (!uploadId) {
const initResponse = await http.post('/api/files/chunk/init', null, {
params: { fileName, totalParts, totalBytes: file.size },
timeout: REQUEST_TIMEOUT_MS,
})
const init = (unwrap(initResponse.data) ?? {}) as Record<string, unknown>
uploadId = String(init.upload_id ?? '')
if (!uploadId) {
throw new Error('后端未返回分片会话,请重试')
}
writeStoredSession(sessionKey, file, uploadId)
}
for (let index = 0; index < totalParts; index += 1) {
if (arrived.has(index)) {
continue
}
const blob = file.slice(index * CHUNK_UPLOAD_PART_SIZE,
Math.min(file.size, (index + 1) * CHUNK_UPLOAD_PART_SIZE))
let lastError: unknown = null
for (let attempt = 0; attempt <= PART_RETRY_LIMIT; attempt += 1) {
const form = new FormData()
form.append('file', blob, `part-${index}`)
try {
const partResponse = await http.post(partUrl(uploadId, index), form, {
headers: { 'Content-Type': 'multipart/form-data' },
timeout: partTimeoutOf(blob.size),
onUploadProgress: (event) => {
if (!onProgress) return
const perPart = Math.round(((index + (event.loaded || 0) / Math.max(blob.size, 1)) / totalParts) * 100)
onProgress(Math.min(perPart, 99))
},
})
unwrap(partResponse.data)
arrived.add(index)
lastError = null
break
} catch (error) {
lastError = error
}
}
if (lastError) {
// 不 DELETE(P2-7):会话连同已达片号留在服务端(后端 24h 过期回收兜底),
// 下一次点开同一个文件就从断点接着传——这才是"续传"两个字的本义。
throw lastError instanceof Error ? lastError : new Error('分片上传失败')
}
}
const completeResponse = await http.post(
`/api/files/chunk/${encodeURIComponent(uploadId)}/complete`, null, { timeout: COMPLETE_TIMEOUT_MS })
clearStoredSession(sessionKey)
if (onProgress) onProgress(100)
return (unwrap(completeResponse.data) ?? {}) as Record<string, unknown>
}
@@ -15,6 +15,8 @@ export interface CompanyItem {
remark: string | null
createdAt: string | null
updatedAt: string | null
/** 所属平台(V206):'amazon'|'jd';后端恒带值(列 NOT NULL DEFAULT 'amazon'),旧负载缺省不渲染。 */
platform?: string
}
/** 新建/改名的表单草稿。 */
@@ -22,6 +24,8 @@ export interface CompanyDraft {
companyName: string
status?: number
remark?: string | null
/** 所属平台(V206):新建必带(页面从平台 tab 取),编辑显式下发,缺省后端不动。 */
platform?: string
}
export function text(value: unknown): string {
@@ -48,5 +52,6 @@ export function toCompanyPayload(draft: CompanyDraft): Record<string, unknown> {
const payload: Record<string, unknown> = { companyName: text(draft.companyName).trim() }
if (typeof draft.status === 'number') payload.status = draft.status
payload.remark = trimmedOrNull(draft.remark)
if (draft.platform) payload.platform = draft.platform
return payload
}
@@ -18,7 +18,7 @@ export function toCompanyItem(raw: unknown): CompanyItem | null {
const r = raw as Record<string, unknown>
const id = numberOrNull(r.id)
if (id === null) return null
return {
const item: CompanyItem = {
id,
companyName: text(r.company_name),
// status 列 NOT NULL,取不到就是链路异常;未知一律按停用,不把异常状态当启用。
@@ -27,6 +27,10 @@ export function toCompanyItem(raw: unknown): CompanyItem | null {
createdAt: trimmedOrNull(r.created_at),
updatedAt: trimmedOrNull(r.updated_at),
}
// platform 后端恒带(列 NOT NULL);旧负载/测试桩缺省就不渲染该键,字段形状与 users-model 一致。
const platform = text(r.platform)
if (platform) item.platform = platform
return item
}
/** 解析 GET /api/admin/companies:接受 data 为数组或 {items:[...]},success=false 抛后端文案。 */
+4 -2
View File
@@ -4,8 +4,10 @@ import { toCompanyPayload, type CompanyDraft, type CompanyItem } from './compani
/** 公司目录(设计文档 §2.3)。GET 的可见范围由后端收窄:超管全部、公司内 admin 只自己公司。 */
export async function fetchCompanies(): Promise<CompanyItem[]> {
const { data } = await http.get('/api/admin/companies')
export async function fetchCompanies(platform?: string): Promise<CompanyItem[]> {
const { data } = await http.get('/api/admin/companies', {
params: platform ? { platform } : {},
})
return parseCompanyList(data)
}
+87 -4
View File
@@ -5,10 +5,20 @@ import { unwrap } from './envelope'
export interface AdminUserSecretModule {
moduleKey: string
moduleLabel: string
/** 货源:LLM 行为渠道(longtaitou/t8star),代理行为供应商(qingguo/jikip)。 */
/**
* 货源:按模块分域,后端 `UserSecretModule.channelOrDefault` 已归一——
* LLM 行为渠道(longtaitou/t8star),代理行为供应商(qingguo/jikip)。
* ⚠ 界面不得用一张合表渲染这两域(代理行贴出「龙抬头」就是这么来的),
* 走 `user-secret-model.ts` 的 `moduleSourceLabel`。
*/
channel?: string | null
/** 脱敏值:代理列为 `scheme://host`,不含提取链接里的 key/pwd。 */
masked: string
/** 完整明文值:仅代理列有值(后端对密钥列不下发明文)。 */
/**
* 完整明文值:后台侧**恒为空**(2026-11-02 `SecretMasking.maskProxy` 收口,代理链接里带着账密)。
* 字段保留只为接口兼容;界面**不得**读它、更不得拿它做"masked 空就回落原文"的兜底,
* 也不许有任何复制/导出整条链接的旁路。
*/
full: string
exists: boolean
/** 是否由后台代填并锁定:锁定时客户端不可修改或清空。 */
@@ -53,6 +63,53 @@ export interface GroupOption {
groupName: string
}
/**
* LLM 一格的余额(**人民币口径**,后端取龙抬头 `credits` 块)。
* 与 `AdminProxyBalanceCell` 是两套语义:这里的 `balance` 是钱、单位 CREDIT(=⚡=人民币),
* 代理那边的 `surplus` 是「次」。界面不得用一张函数渲染两域(同 `channel` 那张表的教训)。
*/
export interface AdminLlmBalanceCell {
moduleKey: string
moduleLabel: string
channel: string
channelLabel: string
available: boolean
/** 上游原样小数串(未取整);available=false 时为 null。 */
balance: string | null
availableBalance: string | null
frozen: string | null
/** 恒为 CREDIT;不是这个值就按「认不出口径」处理,不猜。 */
unit: string | null
message: string | null
checkedAt: string | null
}
/** 代理余量一格:jikip 套餐口径(`surplus`=IP 次数、`scope`=谁的池子)。青果为 scope=none。 */
export interface AdminProxyBalanceCell {
available: boolean
surplus: string | null
balance: string | null
/** user=该用户自己的套餐;platform=平台池子(不是这个用户的钱);none=查不了。 */
scope: string | null
message: string | null
low?: boolean
lowReason?: string | null
}
export interface AdminUserSecretBalanceItem {
userId: number
llm: AdminLlmBalanceCell[]
proxy: AdminProxyBalanceCell
}
export interface AdminUserSecretBalances {
items: AdminUserSecretBalanceItem[]
/** 被数据权限剔出、本次没查的用户(不静默少给数)。 */
deniedUserIds?: number[]
/** 超出整请求时间预算、这轮没取到数的用户。 */
timedOutUserIds?: number[]
}
export interface UserSecretQuery {
keyword?: string
checkStatus?: string
@@ -77,6 +134,23 @@ export async function fetchUserSecretList(params: UserSecretQuery): Promise<Admi
return unwrap<AdminUserSecretPage>(data)
}
/**
* 刷新本页用户的余额侧写:POST /api/admin/user-secrets/balances。
*
* 实时打上游、不落库,所以服务端带三条护栏(单次 ≤20 个用户、固定并发、整请求 10s 预算),
* 客户端的超时必须**长于**服务端预算,否则服务端还在取数、这边先报错,
* 界面就会把「查得慢」显示成「查不到」(与铁律 10「前端超时不得短于服务端预算」同形)。
*/
export async function fetchAdminSecretBalances(
userIds: number[],
companyId?: number | null,
): Promise<AdminUserSecretBalances> {
const body: Record<string, unknown> = { userIds }
if (companyId != null) body.company_id = companyId
const { data } = await http.post('/api/admin/user-secrets/balances', body, { timeout: 30_000 })
return unwrap<AdminUserSecretBalances>(data)
}
/** 立即检测该用户全部已配置项:POST /api/admin/user-secrets/{userId}/check
* 逐模块检测(每项最多「首查 + 传输层失败重试一次」,最坏约 31s/项),故放宽超时到 180s。 */
export async function checkUserSecret(userId: number) {
@@ -100,13 +174,22 @@ export async function deleteUserSecret(userId: number): Promise<void> {
unwrap<unknown>(data)
}
/** 代填并锁定该用户某模块配置(当前仅代理):PUT /api/admin/user-secrets/{userId}/modules/{moduleKey} */
/**
* 代填并锁定该用户某模块配置(当前仅代理):PUT /api/admin/user-secrets/{userId}/modules/{moduleKey}
* `value` 是**一次性写载荷**(代理为现拼的提取链接,带着 key/pwd):调用方不得把它渲染回界面、
* 不得打进日志;`channel` 是同一单的货源(代理=供应商 key),后端据此选解析分支——
* 不给则由后端按链接域名识别,识别不出回落默认供应商,会静默换执行方,所以本面一律显式带上。
*/
export async function saveUserSecretModule(
userId: number,
moduleKey: string,
value: string,
channel?: string,
): Promise<AdminUserSecretModule> {
const { data } = await http.put(`/api/admin/user-secrets/${userId}/modules/${moduleKey}`, { value })
const { data } = await http.put(`/api/admin/user-secrets/${userId}/modules/${moduleKey}`, {
value,
...(channel ? { channel } : {}),
})
return unwrap<AdminUserSecretModule>(data)
}
+4
View File
@@ -1,5 +1,6 @@
/** 用户管理列表/分页 DTO(任务 41):纯逻辑,无框架依赖,与 Java AdminUserController 对齐。 */
import type { AdminUser } from '../types/admin'
import type { PlatformTabId } from '../config/platform-scope.ts'
export const USER_PAGE_DEFAULT_SIZE = 10
export const USER_PAGE_MIN_PAGE = 1
@@ -18,6 +19,8 @@ export interface UserListParams {
/** 公司 tab 的当前公司;由页面从 store 传入,**不住在 UserFilterState 里**
* (normalizeUserPageParams 白名单构造会把它丢掉,取值口只认 fetchUserList 的原始入参)。 */
companyId?: number | null
/** 平台 tab 的当前平台(V206);同 companyId 形状:白名单构造不收,从原始入参读。 */
platform?: PlatformTabId
}
/** 序列化到 GET /api/admin/users 的查询参数(Java snake_case)。 */
@@ -30,6 +33,7 @@ export interface UserListQuery {
admin_id?: number
role?: string
company_id?: number
platform?: string
}
/** 用户列表项即 AdminUser(与 Java AdminUserItemVo 字段对齐)。 */
@@ -18,6 +18,10 @@ export function toAdminUserItem(raw: unknown): AdminUser | null {
const id = numberOrNull(r.id)
if (id === null) return null
const item: AdminUser = { id, username: text(r.username), role: text(r.role) }
const quota = numberOrNull(r.jd_publish_quota)
if (quota !== null) item.jdPublishQuota = quota
const platform = text(r.platform)
if (platform) item.platform = platform
if (typeof r.is_admin === 'boolean') item.isAdmin = r.is_admin
const createdById = numberOrNull(r.created_by_id)
if (createdById !== null) item.createdById = createdById
+2
View File
@@ -15,6 +15,8 @@ export async function fetchUserList(params: Partial<UserListParams> = {}): Promi
// normalizeUserPageParams 是白名单构造(只点名 page/pageSize/keyword/createdById/adminId/role),
// 公司值必须从原始 params 读:写成 normalized.companyId 会 TS 绿、运行时恒 undefined。
if (params.companyId != null) query.company_id = params.companyId
// 平台值(V206)同 companyId 形状:白名单构造不收,只认原始入参。
if (params.platform) query.platform = params.platform
const { data } = await http.get('/api/admin/users', { params: query })
return parseUserPage(data)
}
@@ -60,4 +60,12 @@ export const COMPANY_SCOPED_PAGES: readonly CompanyScopedPage[] = [
// 「无效的菜单权限项」。写侧(编辑/删除/重排)不带参数——归属由那一行的 id 与操作者公司共同判定,
// 跨公司写后端 403(见 docs/ops/menu-company-tree-design-2026-10-06.md §5)。
{ menuKey: 'admin_columns', apiFiles: ['src/pages/account/menu-manage-api.ts'], pageFiles: ['src/pages/account/MenusPage.vue'] },
// 外观专利无侵权数据(2026-11-10 v1.3):出表成功自动同步的只读明细,归属物化在行 company_id 列
// (V189,同店铺密钥形状)⇒ 后端正门 readCompanyIdOrOwn(超管显式传才收窄,非超管强制本公司)。
{ menuKey: 'admin_appearance_patent_clean_items', apiFiles: ['src/pages/patent/appearance-patent-clean-api.ts'], pageFiles: ['src/pages/patent/AppearancePatentCleanItemsPage.vue'] },
// 京东数据库(2026-11-14 v1.4)已于 2026-11-16 退出注册表(用户定案「删除掉公司 tab,参考品牌
// 数据库」=品牌库 2026-10-06 先例同形):数据全平台公共(行 company_id 只剩"哪家公司客户端
// 同步的"来源标记),摘的不只是 tab——页面/api 的 company_id 发送口与后端读侧 company_id 谓词
// (superAdminScopedCompanyId)同窗一起摘。反向钉在 tests/company-tab-wiring.test.ts 的
// 「公司维度不得回流」清单里,再加回来必须先推翻这条定案。
]
@@ -0,0 +1,42 @@
/** 平台 tab 口径的唯一清单(2026-11-16 用户定案「亚马逊/京东不混一起」)。
* 仿 company-scope.ts 的形状:单独成文件而不是塞进 routes.ts——护栏用例要从这里
* 反读清单与注册表对撞,放在一起会成环。 */
export type PlatformTabId = 'amazon' | 'jd'
export interface PlatformTabDef {
id: PlatformTabId
label: string
}
/** 侧边栏顶部平台 tab 的固定顺序:亚马逊在前(存量主体),京东在后。 */
export const PLATFORM_TABS: readonly PlatformTabDef[] = [
{ id: 'amazon', label: '亚马逊' },
{ id: 'jd', label: '京东' },
]
/** 京东侧独占菜单的 menuKey 唯一清单(与 routes.ts 的 menuKey 逐字一致,用例钉住)。
* 2026-11-17 晚:分类管理子菜单(admin_jd_category_manage,V204)随「京东分类管理并到
* 京东数据库分类编辑里」用户口径整体下线(页/路由/菜单行 V208 删),key 从清单摘除。
* 后续京东新页面上线把 key 加进这里即可,清单外的 key(含店铺管理/生成记录等
* 存量页)一律归亚马逊或双侧清单。 */
export const JD_MENU_KEYS: readonly string[] = [
'admin_jd_database',
]
/** 双侧共用菜单(2026-11-17 用户口径「这些亚马逊这边也要有」):三个账号域页面在两个
* 平台 tab 下都显示——同一套组件、按当前 tab 给接口传 platform,各自只看/管各自平台的
* 账号、分组、公司(后端 V206 三表加列,存量默认亚马逊,京东侧数据在编辑弹窗里翻档)。 */
export const BOTH_PLATFORM_MENU_KEYS: readonly string[] = [
'admin_users',
'admin_group_manage',
'admin_companies',
]
/** menuKey → 平台归属清单(唯一判定出口):京东独占 → ['jd'];双侧清单 → ['amazon','jd'];
* 其余(未知 key 在内)默认亚马逊。 */
export function platformsOfMenuKey(key: string): PlatformTabId[] {
if (JD_MENU_KEYS.includes(key)) return ['jd']
if (BOTH_PLATFORM_MENU_KEYS.includes(key)) return ['amazon', 'jd']
return ['amazon']
}
+54 -1
View File
@@ -6,6 +6,10 @@ import { useAdminSessionStore } from '@/stores/admin-session'
import { joinAdminPath } from '@/config/app'
import { pageTitleOf, topbarUserOf } from '@/layout/topbar-model'
import { groupKeysForActive, toSidebarEntries } from '@/layout/menu-mapper'
import { filterMenuTreeByPlatform, visiblePlatformsFor } from '@/layout/platform-menu-filter'
import { PLATFORM_TABS, platformsOfMenuKey } from '@/config/platform-scope'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { firstVisiblePath } from '@/router/helpers'
import {
EMPTY_MENU_DESCRIPTION,
EMPTY_MENU_TITLE,
@@ -31,7 +35,15 @@ const router = useRouter()
const session = useAdminSessionStore()
const activePath = computed(() => route.path)
const menuEntries = computed(() => toSidebarEntries(session.menuTree))
const platformTab = usePlatformTabStore()
// 平台 tab(亚马逊/京东,2026-11-16「不混」定案)只做显示分组:准入仍是 session.menuTree
// (后端按权限裁剪)+路由守卫,这里只把当前用户已被授权的菜单按平台分侧展示。
const menuEntries = computed(() =>
toSidebarEntries(filterMenuTreeByPlatform(session.menuTree, platformTab.active)),
)
const visibleTabIds = computed(() => visiblePlatformsFor(session.menuTree))
const visibleTabDefs = computed(() => PLATFORM_TABS.filter((tab) => visibleTabIds.value.includes(tab.id)))
const showPlatformTabs = computed(() => visibleTabIds.value.length > 1)
const openedKeys = computed(() => groupKeysForActive(menuEntries.value, route.path))
const emptyMenu = computed(() => shouldShowEmptyMenu(menuEntries.value.length > 0, session.loading, session.initialized))
const pageTitle = computed(() => pageTitleOf(route.meta.title))
@@ -45,6 +57,34 @@ watch(
{ immediate: true },
)
// 直达 URL/面包屑跳到另一平台的页面时,tab 指示自动跟过去(与侧边栏保持一致)。
// 双侧清单里的页面(账号域三页)两个 tab 都算归属:当前 tab 已含它就不动。
watch(
() => route.meta.menuKey as string | undefined,
(menuKey) => {
if (!menuKey) return
const owners = platformsOfMenuKey(menuKey)
if (owners.includes(platformTab.active)) return
const target = owners.find((platform) => visibleTabIds.value.includes(platform))
if (target && target !== platformTab.active) {
platformTab.setActive(target)
}
},
{ immediate: true },
)
// 切到另一侧 tab 时当前页多半不在那边:跳到该侧第一个可见页;该侧为空(tab 不可见)则不动。
// 双侧清单里的页面(账号域三页)切 tab 不跳转——页面自己按当前平台过滤数据。
watch(
() => platformTab.active,
(tab) => {
const menuKey = route.meta.menuKey as string | undefined
if (!menuKey || platformsOfMenuKey(menuKey).includes(tab)) return
const first = firstVisiblePath(filterMenuTreeByPlatform(session.menuTree, tab))
if (first) void router.replace(first)
},
)
async function signOut() {
try {
await runLogout({
@@ -77,6 +117,19 @@ async function signOut() {
</div>
</div>
<nav v-if="showPlatformTabs" class="admin-platform-tabs" role="tablist" aria-label="按平台切换菜单">
<button
v-for="tab in visibleTabDefs"
:key="tab.id"
type="button"
role="tab"
class="admin-platform-tab"
:class="{ 'is-active': tab.id === platformTab.active }"
:aria-selected="tab.id === platformTab.active"
@click="platformTab.setActive(tab.id)"
>{{ tab.label }}</button>
</nav>
<el-scrollbar class="admin-menu-scroll">
<el-menu :default-active="activePath" :default-openeds="openedKeys" router class="admin-menu">
<template v-for="entry in menuEntries" :key="entry.key">
+16 -2
View File
@@ -7,17 +7,18 @@ import { useRoute } from 'vue-router'
import { COMPANY_STATUS_ACTIVE } from '@/api/companies-dto'
import { useCompanyTabStore } from '@/stores/company-tab'
import { useAdminSessionStore } from '@/stores/admin-session'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { companyTabAppliesTo, companyTabInitFailureMessage } from '@/layout/company-tab-model'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
const route = useRoute()
const tab = useCompanyTabStore()
const session = useAdminSessionStore()
const platformTab = usePlatformTabStore()
const tabs = computed(() => tab.companies.filter((c) => c.status === COMPANY_STATUS_ACTIVE))
const show = computed(() => tab.visibleForOperator && companyTabAppliesTo(route.meta.menuKey))
watch(() => session.isSuperAdmin, (v) => {
if (!v) return
function ensureLoaded() {
// 2026-10-05 修复轮 1:改前这里是 `void tab.initialize()`,store 里也只有 try/finally ⇒
// GET /companies 抛错时异常变成 unhandled rejection(全仓 src 无 errorHandler/unhandledrejection 兜底),
// 现场只剩"tab 条没画出来",Task 13 人工清单第一项无从判断是权限问题还是接口挂了。
@@ -29,7 +30,20 @@ watch(() => session.isSuperAdmin, (v) => {
console.warn('[company-tab] 公司目录没取到,tab 条不渲染', error)
showAdminFeedback(companyTabInitFailureMessage(error), 'warning')
})
}
watch(() => session.isSuperAdmin, (v) => {
if (!v) return
ensureLoaded()
}, { immediate: true })
// 平台 tab 切换=公司目录换一份(V206 平台分侧;2026-11-17 用户口径「亚马逊侧别再挂京东-团队,
// 京东侧同理」):store 按 loadedPlatform 对撞早退,切了台必然重拉。非超管目录恒空不发请求,
// 这里同样按超管闸早退。
watch(() => platformTab.active, () => {
if (!session.isSuperAdmin) return
ensureLoaded()
})
</script>
<template>
@@ -98,7 +98,7 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
steps: ['上传教程压缩包', '到工具台核对下载', '清理历史包'],
},
admin_workbench_client_package: {
text: '上传新的工作台客户端 ZIP 包后即刻生效:客户端从 /api/workbench-client/version/latest 自动检测版本并升级;服务端会复算 sha256 供客户端校验。确认旧包不再需要后再删除。',
text: '上传新的工作台客户端 ZIP 包后即刻生效;服务端会复算 sha256 供客户端校验。确认旧包不再需要后再删除。',
steps: ['填写版本号并上传 ZIP', '核对版本与 sha256', '清理历史包'],
},
digital_human_version: {
@@ -117,6 +117,16 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
text: '按账号、业务、状态、店铺和创建时间筛出客户端任务,点任务查看明细与分组结果;顶部汇总卡给当前在跑与疑似卡住的总量。',
steps: ['按条件筛任务', '查看任务明细', '核对汇总卡'],
},
admin_appearance_patent_clean_items: {
text: '本页只读:出表成功后「结论=无侵权」的明细自动同步到这里,按分公司隔离分页展示;支持任务号/ASIN/国家/同步日期筛选,下载原表请到任务中心取结果文件。',
steps: ['筛选记录', '核对结论明细', '到任务中心下载原表'],
},
admin_jd_database: {
// 2026-11-17 分类管理子菜单并入本页(用户口径「京东分类管理并到京东数据库分类编辑里」,
// 原 admin_jd_category_manage 条目随之摘除):分类建/改名/删在工具栏「分类管理」。
text: '本页只读:客户端采集的京东店铺商品自动同步到这里(同店铺同商品只保留最新一次),按分公司隔离分页展示;点行查看全部属性与图片;分类的新建/改名/删除在工具栏「分类管理」,给商品归类先勾选再「批量编辑分类」。',
steps: ['筛选商品记录', '查看属性与图片明细', '用「分类管理」维护分类并批量归类'],
},
}
/** 全部有独立/兜底提示的后台业务菜单 key。 */
@@ -0,0 +1,39 @@
import type { AdminMenuNode } from '../types/admin'
import { PLATFORM_TABS, platformsOfMenuKey } from '../config/platform-scope.ts'
import type { PlatformTabId } from '../config/platform-scope.ts'
import { firstVisiblePath } from '../router/helpers.ts'
/**
* 按平台 tab 过滤后端菜单树(2026-11-16「亚马逊/京东不混」):**只做显示分组,不做鉴权**——
* 准入仍由 session.menuTree(后端按权限裁剪)与路由守卫负责,这里只是把当前用户已被授权的
* 菜单按平台分到两个 tab 下展示。
* 规则:叶子按 platformsOfMenuKey(key) 是否包含当前平台留下(双侧清单里的账号域三页两个
* tab 都显示);分组节点(admin_group_*)自身的 key 不参与平台判定,按「留住的子项数 > 0」
* 决定去留——否则京东 tab 下「账号与权限」这类混合分组会被整组误剪。节点的 key/name/
* route/children 形状原样透传(浅拷贝不改写),toSidebarEntries、groupKeysForActive 与
* 面包屑都不受影响。
*/
export function filterMenuTreeByPlatform(
nodes: AdminMenuNode[] | null | undefined,
platform: PlatformTabId,
): AdminMenuNode[] {
const filtered: AdminMenuNode[] = []
for (const node of nodes || []) {
const children = filterMenuTreeByPlatform(node.children, platform)
if (children.length > 0) {
filtered.push({ ...node, children })
continue
}
if ((node.children || []).length > 0) continue
if (platformsOfMenuKey(node.key || '').includes(platform)) filtered.push({ ...node })
}
return filtered
}
/** 当前用户在哪些平台下至少有一个可点页面(tab 显示依据);顺序固定随 PLATFORM_TABS。
* 「可点」沿用 firstVisiblePath 这一把尺子(有 route 即可点),不另写第二处判定。 */
export function visiblePlatformsFor(nodes: AdminMenuNode[] | null | undefined): PlatformTabId[] {
return PLATFORM_TABS
.filter((tab) => firstVisiblePath(filterMenuTreeByPlatform(nodes, tab.id)) !== '')
.map((tab) => tab.id)
}
@@ -2,18 +2,25 @@
/** 公司管理(设计文档 §2.3):列表 + 新建 + 改名/启停。
* 可见范围由后端收窄(超管全部、公司内 admin 只自己公司);写操作仅超管,这里隐藏入口只是配合,
* 真正的把关在 CompanyController,页面不得当作权限边界。 */
import { computed, onMounted, ref } from 'vue'
import { computed, onMounted, ref, watch } from 'vue'
import { formatDateTime } from '@/utils/datetime'
import { fetchCompanies } from '@/api/companies'
import { COMPANY_STATUS_ACTIVE, type CompanyItem } from '@/api/companies-dto'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import { usePlatformTabStore } from '@/stores/platform-tab'
import OldPagination from '@/components/OldPagination.vue'
import CompanyEditorDialog from './CompanyEditorDialog.vue'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
const session = useAdminSessionStore()
// 平台 tab(V206):公司列表按当前平台过滤,新建默认落当前平台。
const platformTab = usePlatformTabStore()
// 公司 tab 条(2026-11-17 起按平台过滤)共用这一份目录:公司翻档/启停后必须强制重拉,
// 否则 18 个页面的 tab 条端着旧名单,刚翻去京东的公司还挂在亚马逊侧。
const companyTab = useCompanyTabStore()
const loading = ref(false)
const loadFailure = ref('')
const rows = ref<CompanyItem[]>([])
@@ -38,7 +45,7 @@ async function loadCompanies() {
loading.value = true
loadFailure.value = ''
try {
rows.value = await fetchCompanies()
rows.value = await fetchCompanies(platformTab.active)
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '公司列表加载失败'
showAdminFeedback(loadFailure.value, 'error')
@@ -57,6 +64,21 @@ function openEdit(company: CompanyItem) {
editorVisible.value = true
}
// 保存成功后:本页列表照常重拉,共享公司目录(tab 条)强制重拉一份。
// 重拉失败不弹新提示(§12 第 5 条未批的界面暴露):tab 条保留旧名单,下一次切平台 tab / 重进页面会再试。
async function onCompaniesSaved() {
await loadCompanies()
companyTab.refresh().catch((error: unknown) => {
console.warn('[company-tab] 公司保存后目录重拉失败', error)
})
}
// 切平台 tab(V206)= 重新取数:公司归属按平台分列,两 tab 各看各的公司。
watch(() => platformTab.active, () => {
page.value = 1
void loadCompanies()
})
onMounted(loadCompanies)
</script>
@@ -127,7 +149,7 @@ onMounted(loadCompanies)
/>
</section>
<CompanyEditorDialog v-model="editorVisible" :company="editingCompany" @saved="loadCompanies" />
<CompanyEditorDialog v-model="editorVisible" :company="editingCompany" :platform="platformTab.active" @saved="onCompaniesSaved" />
</div>
</template>
@@ -1,5 +1,6 @@
<script setup lang="ts">
import { ref, watch } from 'vue'
import type { PlatformTabId } from '@/config/platform-scope'
import { createCompany, updateCompany } from '@/api/companies'
import {
COMPANY_NAME_MAX_LENGTH,
@@ -12,11 +13,11 @@ import {
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { actionableErrorText } from '@/components/admin-feedback'
/** 新建/编辑公司(改名 + 启停 + 备注);写操作仅超管可用,权限由后端把关。 */
const props = defineProps<{ modelValue: boolean; company: CompanyItem | null }>()
/** 新建/编辑公司(改名 + 启停 + 备注 + 所属平台 V206);写操作仅超管可用,权限由后端把关。 */
const props = defineProps<{ modelValue: boolean; company: CompanyItem | null; platform?: PlatformTabId }>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'saved'): void }>()
const form = ref<CompanyDraft>({ companyName: '', status: COMPANY_STATUS_ACTIVE, remark: '' })
const form = ref<CompanyDraft>({ companyName: '', status: COMPANY_STATUS_ACTIVE, remark: '', platform: 'amazon' })
const errorText = ref('')
const busy = ref(false)
@@ -25,8 +26,13 @@ watch(
(open) => {
if (!open) return
form.value = props.company
? { companyName: props.company.companyName, status: props.company.status, remark: props.company.remark || '' }
: { companyName: '', status: COMPANY_STATUS_ACTIVE, remark: '' }
? {
companyName: props.company.companyName,
status: props.company.status,
remark: props.company.remark || '',
platform: props.company.platform === 'jd' ? 'jd' : 'amazon',
}
: { companyName: '', status: COMPANY_STATUS_ACTIVE, remark: '', platform: props.platform ?? 'amazon' }
errorText.value = ''
},
)
@@ -71,6 +77,12 @@ async function save() {
placeholder="请输入公司名称(全平台唯一)"
/>
</el-form-item>
<el-form-item label="所属平台">
<el-radio-group v-model="form.platform">
<el-radio-button value="amazon">亚马逊</el-radio-button>
<el-radio-button value="jd">京东</el-radio-button>
</el-radio-group>
</el-form-item>
<el-form-item label="状态">
<el-select v-model="form.status" style="width: 100%">
<el-option :value="COMPANY_STATUS_ACTIVE" label="启用" />
@@ -1,5 +1,6 @@
<script setup lang="ts">
import { computed, reactive, ref, watch } from 'vue'
import type { PlatformTabId } from '@/config/platform-scope'
import { submitCreateUser } from './user-create-adapter'
import {
createEmptyCreateUserForm,
@@ -28,6 +29,8 @@ const props = defineProps<{
operatorCompanyId?: number | null
/** 当前公司 tab:这次建号落在哪家,就决定能建哪些角色。 */
activeCompanyId?: number | null
/** 当前平台 tab(V206):新号默认落当前平台,单选可改。 */
platform?: PlatformTabId
}>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'created'): void }>()
@@ -71,6 +74,8 @@ watch(
form.expiresAt = ''
// 预填当前 tab:跨公司时角色本来就只剩公司超管,而那一例必须带公司
form.companyId = props.activeCompanyId ?? null
// 预填当前平台 tab(V206):京东侧建的号默认归京东,亚马逊侧默认亚马逊。
form.platform = props.platform ?? 'amazon'
errors.username = undefined
errors.password = undefined
errors.companyId = undefined
@@ -131,6 +136,12 @@ async function create(): Promise<void> {
<el-option v-for="opt in roleChoices" :key="opt.value" :label="opt.label" :value="opt.value" />
</el-select>
</el-form-item>
<el-form-item label="所属平台">
<el-radio-group v-model="form.platform">
<el-radio-button value="amazon">亚马逊</el-radio-button>
<el-radio-button value="jd">京东</el-radio-button>
</el-radio-group>
</el-form-item>
<el-form-item
v-if="operatorSuper && form.role === 'company_super_admin'"
label="所属公司"
@@ -1,6 +1,7 @@
<script setup lang="ts">
import { computed, reactive, ref, watch } from 'vue'
import type { AdminUser } from '@/types/admin'
import type { PlatformTabId } from '@/config/platform-scope'
import { mayCarryOwnExpiry } from './user-create-model'
import { fillEditUserForm, validateEditUserForm, type EditUserForm, type EditUserFormErrors } from './user-edit-model'
import { submitEditUser } from './user-edit-adapter'
@@ -10,11 +11,12 @@ import { actionableErrorText } from '@/components/admin-feedback'
import UserMenuAuthTree from './UserMenuAuthTree.vue'
/** companyId 由 UsersPage 把 companyTab.requestCompanyId 透传进来(本页的用户列表本来就由它筛 ⇒ 目标账号的公司
* 就是 tab 选中的那家);弹窗自己不读 store,公司 tab 的取值口只留在页面组件那一处。 */
const props = defineProps<{ modelValue: boolean; user: AdminUser | null; operatorSuper?: boolean; companyId?: number | null }>()
* 就是 tab 选中的那家);弹窗自己不读 store,公司 tab 的取值口只留在页面组件那一处。
* platform(V206)同理由页面透传:决定上架上限是否参与校验/下发(仅京东侧)。 */
const props = defineProps<{ modelValue: boolean; user: AdminUser | null; operatorSuper?: boolean; companyId?: number | null; platform?: PlatformTabId }>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'updated'): void }>()
const form = reactive<EditUserForm>({ uid: 0, username: '', password: '', role: 'normal', columnIds: [], originalRole: '', expiresAt: '' })
const form = reactive<EditUserForm>({ uid: 0, username: '', password: '', role: 'normal', columnIds: [], originalRole: '', expiresAt: '', jdPublishQuota: 5000, platform: 'amazon' })
const errors = reactive<EditUserFormErrors>({})
const busy = ref(false)
const loadingAuth = ref(false)
@@ -22,6 +24,9 @@ const loadingAuth = ref(false)
const authReady = ref(false)
/** 公司超管目标:角色单选隐藏(请求体也不带 role),只允许改密码/到期时间/菜单。 */
const targetIsCompanySuperAdmin = computed(() => (props.user?.role || '').trim().toLowerCase() === 'company_super_admin')
/** 上架上限只属京东口径(用户 2026-11-17:「只要在京东这边用户编辑里加就行,不需要在亚马逊那边」):
* 亚马逊侧隐藏该项,且校验与下发都不带 quota——字段留后端不动。 */
const includeQuota = computed(() => props.platform === 'jd')
/** 公司超管目标的角色单选是隐藏的(改完仍是 company_super_admin),到期时间照旧可改;
* 管理员改成普通账号时这一项消失,保存按「清空」下发(见 user-edit-model 的 roleAfter)。 */
const expiryEditable = computed(() =>
@@ -40,6 +45,9 @@ watch(
form.columnIds = []
form.originalRole = base.originalRole
form.expiresAt = base.expiresAt
form.jdPublishQuota = base.jdPublishQuota
form.platform = base.platform
errors.jdPublishQuota = undefined
errors.password = undefined
authReady.value = false
void refreshAuth()
@@ -71,12 +79,12 @@ async function save(): Promise<void> {
showAdminFeedback('菜单权限尚未加载完成,请稍后重试', 'error')
return
}
const { valid, errors: errs } = validateEditUserForm(form)
const { valid, errors: errs } = validateEditUserForm(form, { includeQuota: includeQuota.value })
Object.assign(errors, errs)
if (!valid) return
busy.value = true
try {
await submitEditUser(form)
await submitEditUser(form, { includeQuota: includeQuota.value })
showAdminFeedback('更新成功', 'success')
emit('updated')
close()
@@ -120,6 +128,12 @@ async function save(): Promise<void> {
<el-form-item v-if="targetIsCompanySuperAdmin" label="角色">
<el-input model-value="公司超级管理员" readonly />
</el-form-item>
<el-form-item label="所属平台">
<el-radio-group v-model="form.platform">
<el-radio-button value="amazon">亚马逊</el-radio-button>
<el-radio-button value="jd">京东</el-radio-button>
</el-radio-group>
</el-form-item>
<el-form-item v-if="expiryEditable" label="到期时间(清空 = 永不过期;到期后该账号及其名下账号将停用)">
<el-date-picker
v-model="form.expiresAt"
@@ -130,6 +144,9 @@ async function save(): Promise<void> {
style="width: 240px"
/>
</el-form-item>
<el-form-item v-if="includeQuota && (targetIsCompanySuperAdmin || form.role === 'admin')" label="京东上架额度(0 表示不限)" :error="errors.jdPublishQuota">
<el-input-number v-model="form.jdPublishQuota" :min="0" :max="2147483647" :precision="0" />
</el-form-item>
<el-form-item v-if="props.user && props.user.creatorUsername" label="所属管理员">
<el-input :model-value="props.user.creatorUsername" readonly />
</el-form-item>
@@ -1,6 +1,7 @@
<script setup lang="ts">
import { computed, onMounted, ref, watch } from 'vue'
import type { AdminUser } from '@/types/admin'
import type { PlatformTabId } from '@/config/platform-scope'
import {
eligibleGroupMembers,
groupMemberCandidateHint,
@@ -13,11 +14,13 @@ import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { actionableErrorText } from '@/components/admin-feedback'
import { useAdminSessionStore } from '@/stores/admin-session'
const props = defineProps<{ modelValue: boolean; group: ShopGroupItem | null; operatorSuper?: boolean }>()
const props = defineProps<{ modelValue: boolean; group: ShopGroupItem | null; operatorSuper?: boolean; platform?: PlatformTabId }>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'saved'): void }>()
const session = useAdminSessionStore()
const groupName = ref('')
/** 所属平台(V206):新建默认当前平台 tab,编辑回填分组原值,单选可翻档。 */
const groupPlatform = ref<PlatformTabId>('amazon')
const memberIds = ref<number[]>([])
const errorText = ref('')
const busy = ref(false)
@@ -48,6 +51,9 @@ watch(
if (props.group) {
groupName.value = props.group.name
memberIds.value = props.group.memberUserIds ?? []
groupPlatform.value = props.group.platform === 'jd' ? 'jd' : 'amazon'
} else {
groupPlatform.value = props.platform ?? 'amazon'
}
},
)
@@ -76,7 +82,7 @@ async function save(): Promise<void> {
busy.value = true
try {
if (props.group) {
await updateShopGroup(props.group.id, groupName.value, memberIds.value)
await updateShopGroup(props.group.id, groupName.value, memberIds.value, groupPlatform.value)
showAdminFeedback('更新成功', 'success')
} else {
// 对齐 admin:组长恒为当前登录用户,提交 createdBy=当前用户 id。
@@ -85,7 +91,7 @@ async function save(): Promise<void> {
showAdminFeedback('无法获取当前登录用户,请重新登录', 'error')
return
}
await createShopGroup(groupName.value, memberIds.value, operatorId)
await createShopGroup(groupName.value, memberIds.value, operatorId, groupPlatform.value)
showAdminFeedback('创建成功', 'success')
}
emit('saved')
@@ -113,6 +119,12 @@ onMounted(loadCandidates)
<el-form-item label="分组名称" :error="errorText || undefined">
<el-input v-model="groupName" placeholder="请输入分组名称" />
</el-form-item>
<el-form-item label="所属平台">
<el-radio-group v-model="groupPlatform">
<el-radio-button value="amazon">亚马逊</el-radio-button>
<el-radio-button value="jd">京东</el-radio-button>
</el-radio-group>
</el-form-item>
<el-form-item label="组长">
<el-input :model-value="leaderUsername" readonly placeholder="当前登录用户" />
</el-form-item>
@@ -6,6 +6,7 @@ import { computed, onMounted, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { openAdminConfirm } from '@/components/admin-confirm'
import { deleteShopGroup, fetchShopGroups } from './shop-group-api'
import type { ShopGroupItem } from './shop-group-model'
@@ -16,6 +17,8 @@ import LoadFailureBar from '@/components/LoadFailureBar.vue'
const session = useAdminSessionStore()
const companyTab = useCompanyTabStore()
// 平台 tab(V206):分组列表按当前平台过滤,新建默认落当前平台。
const platformTab = usePlatformTabStore()
const loading = ref(false)
const loadFailure = ref('')
const rows = ref<ShopGroupItem[]>([])
@@ -52,7 +55,7 @@ async function loadGroups() {
loading.value = true
loadFailure.value = ''
try {
rows.value = await fetchShopGroups(companyTab.requestCompanyId)
rows.value = await fetchShopGroups(companyTab.requestCompanyId, platformTab.active)
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '数据权限分组加载失败'
showAdminFeedback(loadFailure.value, 'error')
@@ -64,6 +67,12 @@ async function loadGroups() {
// 切公司 = 重新取数(G1 的 pageFiles 断言盯着这一条)。
watch(() => companyTab.activeId, () => void loadGroups())
// 切平台 tab(V206)= 重新取数:分组归属按平台分列,两 tab 各看各的分组。
watch(() => platformTab.active, () => {
page.value = 1
void loadGroups()
})
function openCreate() {
editingGroup.value = null
editorVisible.value = true
@@ -164,6 +173,7 @@ onMounted(loadGroups)
v-model="editorVisible"
:group="editingGroup"
:operator-super="isSuperAdmin"
:platform="platformTab.active"
@saved="loadGroups"
/>
</div>
@@ -0,0 +1,248 @@
<script setup lang="ts">
import { reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { saveUserSecretModule } from '@/api/user-secrets'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { actionableErrorText } from '@/components/admin-feedback'
import {
PROXY_MODULE_KEY,
buildProxyEntryPayload,
emptyProxyEntryDraft,
validateProxyEntry,
type ProxyEntryDraft,
} from './user-secret-model.ts'
/**
* 后台代填/改代理(2026-11-02 脱敏后重做的交互)。
*
* 旧交互是 `window.prompt` 预填 `row.proxy.full` 整条提取链接——后端把这条读路套上
* `SecretMasking.maskProxy` 之后 `full` 恒空,预填必然是空的,照旧保存等于把空串顶上去、
* 或让管理员去别处翻原文。现在收**账密**、链接在本机现拼现发:
* - 青果:填 Authkey + Authpwd,`composeQingguoLink` 拼(青果产品页没有可复制的链接);
* - 极客:填极客自己的提取链接(它有可复制的链接)。
* 拼好的链接是一次性写载荷,只进 PUT 请求体:不回显、不回填、不进 tooltip、不给复制/导出旁路;
* 保存成功即清空输入位,重开必然要从头再填(这是脱敏的应然后果,界面直接把它说出来)。
*/
const props = defineProps<{
modelValue: boolean
userId: number | null
username: string
/** 后端已登记的供应商(只是预选中的单选框,不是凭据)。 */
provider?: string | null
locked?: boolean
}>()
const emit = defineEmits<{ (e: 'update:modelValue', v: boolean): void; (e: 'saved'): void }>()
const draft = reactive<ProxyEntryDraft>(emptyProxyEntryDraft())
const errorText = ref('')
const busy = ref(false)
function resetDraft() {
Object.assign(draft, emptyProxyEntryDraft(props.provider))
errorText.value = ''
}
// 开与关都重刷:关的时候把已经打进内存的账密/链接抹掉,不留到下一次。
watch(() => props.modelValue, resetDraft)
function close() {
emit('update:modelValue', false)
}
async function save() {
if (props.userId == null) return
errorText.value = validateProxyEntry(draft)
if (errorText.value) return
const payload = buildProxyEntryPayload(draft)
if (!payload) {
errorText.value = '代理配置不完整,请重新填写'
return
}
busy.value = true
try {
await saveUserSecretModule(props.userId, PROXY_MODULE_KEY, payload.value, payload.channel)
showAdminFeedback(props.locked ? '已更新锁定代理' : '已代填并锁定代理', 'success')
emit('saved')
close()
} catch (error) {
// 文案以接口返回的 message 为准,前端不解释后端状态码
errorText.value = actionableErrorText(error)
showAdminFeedback(errorText.value, 'error')
} finally {
busy.value = false
Object.assign(draft, { authkey: '', authpwd: '', link: '' })
}
}
</script>
<template>
<div v-if="modelValue" class="modal-mask" @click.self="close">
<div class="modal" role="dialog" aria-modal="true" aria-labelledby="proxy-entry-title">
<h3 id="proxy-entry-title">{{ locked ? '改代理' : '代填代理' }}</h3>
<p class="modal-note">
为「{{ username || '该用户' }}」写入代理。出于凭据保护,后台不再下发已存的提取链接原文,
这里每次都重新填写;保存后界面只显示脱敏后的地址(不含 key/pwd)。
</p>
<div class="form-group">
<label>代理供应商</label>
<div class="radio-row">
<label class="radio-item">
<input v-model="draft.provider" type="radio" value="qingguo" />
<span>青果</span>
</label>
<label class="radio-item">
<input v-model="draft.provider" type="radio" value="jikip" />
<span>极客</span>
</label>
</div>
</div>
<template v-if="draft.provider === 'qingguo'">
<div class="form-group">
<label>Authkey</label>
<input v-model="draft.authkey" type="text" autocomplete="off" placeholder="青果产品页的 Authkey" />
</div>
<div class="form-group">
<label>Authpwd</label>
<input v-model="draft.authpwd" type="password" autocomplete="new-password" placeholder="青果产品页的 Authpwd" />
<span class="field-hint">青果只填 Authkey 会被判鉴权拒绝,两把都要填。</span>
</div>
</template>
<template v-else>
<div class="form-group">
<label>极客提取链接</label>
<input
v-model="draft.link"
type="password"
autocomplete="new-password"
placeholder="https://api.jikip.com/ip-get?..."
/>
<span class="field-hint">极客有可复制的提取链接,整条粘贴进来即可。</span>
</div>
</template>
<p v-if="errorText" class="modal-error">{{ errorText }}</p>
<div class="modal-actions">
<button class="btn" type="button" :disabled="busy" @click="save">
{{ busy ? '保存中…' : '保存' }}
</button>
<button class="btn btn-ghost" type="button" :disabled="busy" @click="close">取消</button>
</div>
</div>
</div>
</template>
<style scoped>
/* 与密钥列表页同一视觉语言(本页不用 el-* 标签:新增 el-* 要同步改按需注册表)。 */
.modal-mask {
position: fixed;
inset: 0;
z-index: 3000;
display: flex;
align-items: center;
justify-content: center;
padding: 40px 20px;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(6px);
}
.modal {
display: flex;
flex-direction: column;
width: min(520px, 100%);
max-height: 84vh;
padding: 22px 24px;
border: 1px solid #c7d7e5;
border-radius: 14px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(39, 67, 94, 0.2);
overflow-y: auto;
color: #24384d;
font-family: inherit;
}
.modal h3 {
margin: 0 0 10px;
font-size: 15px;
font-weight: 650;
}
.modal-note {
margin: 0 0 14px;
color: #5b6f83;
font-size: 12.5px;
line-height: 1.65;
}
.form-group {
display: flex;
flex-direction: column;
gap: 7px;
margin-bottom: 14px;
}
.form-group label {
color: #5b6f83;
font-size: 12.5px;
font-weight: 600;
}
.form-group input[type='text'],
.form-group input[type='password'] {
min-width: 0;
min-height: 42px;
padding: 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
outline: none;
}
.radio-row {
display: flex;
gap: 18px;
}
.radio-item {
display: inline-flex;
align-items: center;
gap: 6px;
font-size: 13.5px;
font-weight: 500;
color: #24384d;
}
.field-hint {
color: #7d8fa1;
font-size: 12px;
line-height: 1.6;
}
.modal-error {
margin: 0 0 10px;
color: #b04a5a;
font-size: 12.5px;
line-height: 1.6;
}
.modal-actions {
display: flex;
gap: 10px;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 42px;
padding: 9px 18px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13.5px;
cursor: pointer;
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.55;
}
.btn-ghost {
background: #ffffff;
border-color: #c7d7e5;
color: #4f78a5;
}
</style>
@@ -3,16 +3,29 @@ import { computed, onMounted, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { formatDateTime } from '@/utils/datetime'
import OldPagination from '@/components/OldPagination.vue'
import ProxyEntryDialog from './ProxyEntryDialog.vue'
import {
checkUserSecret,
clearUserSecretModule,
deleteUserSecret,
fetchAdminSecretBalances,
fetchUserSecretList,
saveUserSecretModule,
type AdminUserSecretBalanceItem,
type AdminUserSecretModule,
type AdminUserSecretRow,
type GroupOption,
} from '@/api/user-secrets'
import {
PROXY_MODULE_KEY,
llmBalanceLines,
llmSourceLabel,
moduleStatusBand,
proxyBalanceLine,
proxyDisplayText,
proxySourceLabel,
rowDetailLines,
rowStatusBand,
} from './user-secret-model.ts'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
@@ -37,8 +50,18 @@ const groupFilter = ref<number | null>(null)
const groupOptions = ref<GroupOption[]>([])
/** 正在检测的行 userId,用于按钮 loading 态。 */
const checkingId = ref<number | null>(null)
/** 正在代填/解锁代理的行 userId,避免重复点击。 */
/** 正在解锁代理的行 userId,避免重复点击(代填在弹窗里自己管 busy)。 */
const proxyBusyId = ref<number | null>(null)
/** 代填/改代理弹窗的目标行(脱敏后没有原文可预填,只能重填账密)。 */
const proxyDialog = ref<{ userId: number; username: string; provider: string | null; locked: boolean } | null>(null)
/** 余额侧写(实时查上游、不落库):按 userId 存,列表接口本身不带这些数。 */
const balances = ref<Record<number, AdminUserSecretBalanceItem>>({})
const balanceLoading = ref(false)
/** 本轮「没取到」的原因(越权剔除/上游未应答/请求失败):进工具行悬停,不弹全局打扰。 */
const balanceNotice = ref('')
/** 服务端单次上限 20 个用户;超出会被当场拒,所以这里按批顺取(并发留给服务端那个线程池)。 */
const BALANCE_BATCH = 20
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
@@ -47,72 +70,42 @@ const STATUS_OPTIONS = [
{ value: 'passed', label: '检测通过' },
{ value: 'failed', label: '检测失败' },
{ value: 'incomplete', label: '未配齐' },
{ value: 'error', label: '无法判定' },
// 后端的行级值仍是 error:这一档现在既可能是「问不出结论」,也可能是「通道还没释放、等一会再点」,
// 界面按码把后者补成「可重试」(见 user-secret-model.ts 的档位表),筛选项就得把两档都点名。
{ value: 'error', label: '无法判定/可重试' },
{ value: 'unknown', label: '未检测' },
]
/** 行级状态药丸:三类都检测通过才显示「检测通过」。 */
function rowStatusMeta(status: string) {
switch (status) {
case 'passed':
return { label: '检测通过', tone: 'is-allowed' }
case 'failed':
return { label: '检测失败', tone: 'is-blocked' }
case 'incomplete':
return { label: '未配齐', tone: 'is-warn' }
case 'error':
return { label: '无法判定', tone: 'is-warn' }
default:
return { label: '未检测', tone: 'is-unknown' }
}
}
/* 状态药丸的档位表在 `user-secret-model.ts`(唯一出处,页面不带第二张表):
行级传整行而不是 `row.status`——后端把 failed/incomplete 都判掉之后就只剩一个「error」,
这一行到底是「查不出」还是「等青果释放」只有逐格的 `check_code` 说得清。 */
/** 单格状态药丸:未配置时统一灰色;欠费单独标识。 */
function moduleStatusMeta(module: AdminUserSecretModule | undefined) {
if (!module || !module.exists) {
return { label: '未配置', tone: 'is-unknown' }
}
switch (module.checkStatus) {
case 'passed':
return { label: '通过', tone: 'is-allowed' }
case 'failed':
if (module.checkCode === 'insufficient_balance') {
return { label: '欠费', tone: 'is-warn' }
}
return { label: '失败', tone: 'is-blocked' }
case 'error':
return { label: '无法判定', tone: 'is-warn' }
default:
return { label: '未检测', tone: 'is-unknown' }
}
}
/** 单格悬停详情:完整值(代理为全量地址)+ 锁定说明 + 检测消息 + 检测时间 + 耗时。 */
/**
* 单格悬停详情:后端下发的**脱敏值** + 锁定说明 + **检测结果原文 `check_message`** + 检测时间 + 耗时。
* 运维要判「是欠费还是被自己的采集占着」,靠的就是这句后端原文——档名只是扫一眼用的短词,
* 前端一律不按码自己拼句子。
* ⚠ 只读 `masked`:`full` 在后台侧恒空(2026-11-02 `SecretMasking.maskProxy` 收口),
* 这里不做任何「masked 空就回落原文」的兜底,也不给复制整条链接的旁路。
*/
function moduleTooltip(module: AdminUserSecretModule | undefined) {
if (!module || !module.exists) return '未配置'
const parts: string[] = []
if (module.full) parts.push(module.full)
if (module.locked) parts.push('已由后台代填并锁定:客户端不可修改或清空')
if (module.checkMessage) parts.push(module.checkMessage)
const display = String(module.masked || '').trim()
if (display) {
parts.push(isProxyModule(module) ? `代理地址(已脱敏,不含 key/pwd):${display}` : `密钥:${display}`)
}
if (module.locked) parts.push('已由后台代填并锁定:客户端不可修改或清空,改代理需重新填写账密')
// 后端的这句话就是给人看的结论,原样透出(不动一个字、不按码另拼一句)
const message = String(module.checkMessage || '').trim()
if (message) parts.push(message)
if (module.checkedAt) parts.push(`检测时间:${formatDateTime(module.checkedAt)}`)
if (module.checkLatencyMs != null) parts.push(`耗时:${module.checkLatencyMs}ms`)
return parts.join(';') || '暂无检测记录'
}
/** 货源标签:LLM 密钥显示渠道(龙抬头/贞贞),代理显示供应商(青果/极客)。 */
function sourceLabel(channel: string | null | undefined) {
switch (String(channel || '').trim().toLowerCase()) {
case 'longtaitou':
return '龙抬头'
case 't8star':
return '贞贞'
case 'qingguo':
return '青果'
case 'jikip':
return '极客'
default:
return '—'
}
/** 该格是不是代理模块:按后端下发的 moduleKey 判,货源标签与文案都走这一条口径。 */
function isProxyModule(module: AdminUserSecretModule) {
return String(module.moduleKey || '').trim().toLowerCase() === PROXY_MODULE_KEY
}
/** 分组列文案:优先分组名;未建分组的用户回退展示所属主管,便于判断归属。 */
@@ -122,9 +115,15 @@ function groupTextOf(row: AdminUserSecretRow) {
return '—'
}
/**
* 行级悬停详情:后端的行级摘要 + 逐格的 `check_message` 原文 + 更新时间。
* 行级状态一旦补成「可重试」,管理员得能立刻看出是哪一格在等、后端原话怎么说;
* 逐格那句一律取后端下发文本(`rowDetailLines` 只搬运、不改写、不另拼一句)。
*/
function rowStatusTooltip(row: AdminUserSecretRow) {
const parts: string[] = []
if (row.statusMessage) parts.push(row.statusMessage)
parts.push(...rowDetailLines(row))
if (row.updatedAt) parts.push(`最近更新:${formatDateTime(row.updatedAt)}`)
return parts.join(';') || '暂无检测记录'
}
@@ -144,6 +143,7 @@ async function load() {
rows.value = result?.items || []
total.value = Number(result?.total || 0)
groupOptions.value = result?.groupOptions || []
void loadBalances()
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '加载失败'
showAdminFeedback(loadFailure.value, 'error')
@@ -152,6 +152,57 @@ async function load() {
}
}
/**
* 取本页用户的余额:列表已经画完,这两列随后填(余额要实时打上游,不能让它在列表主数据前占位)。
*
* 失败只影响这两列并留一句说明——不 `showAdminFeedback`、不把整页判成加载失败:
* 一次上游抖动就红整页,管理员会以为密钥数据本身出了问题。
*/
async function loadBalances() {
const ids = rows.value.map((row) => row.userId)
balances.value = {}
balanceNotice.value = ''
if (!ids.length) return
balanceLoading.value = true
try {
const merged: Record<number, AdminUserSecretBalanceItem> = {}
let denied = 0
let timedOut = 0
for (let start = 0; start < ids.length; start += BALANCE_BATCH) {
const batch = ids.slice(start, start + BALANCE_BATCH)
const result = await fetchAdminSecretBalances(batch, companyTab.requestCompanyId)
for (const item of result?.items || []) {
if (item && item.userId != null) merged[Number(item.userId)] = item
}
denied += result?.deniedUserIds?.length || 0
timedOut += result?.timedOutUserIds?.length || 0
}
balances.value = merged
const notices: string[] = []
if (denied) notices.push(`${denied} 个用户不在当前数据权限内,本轮未查`)
if (timedOut) notices.push(`${timedOut} 个用户本轮上游未应答(不是余额为 0)`)
balanceNotice.value = notices.join(';')
} catch (error) {
balanceNotice.value = error instanceof Error ? error.message : '余额本轮没取到(不是余额为 0)'
} finally {
balanceLoading.value = false
}
}
/** 某行的 LLM 余额行(按渠道折叠);没取到时给一格占位而不是空白。 */
function llmLinesOf(userId: number) {
const lines = llmBalanceLines(balances.value[userId]?.llm, balanceLoading.value)
return lines.length ? lines : [{ text: '—', title: balanceNotice.value || '本轮没取到数(不是余额为 0)' }]
}
function proxyLineOf(userId: number) {
const item = balances.value[userId]
if (item?.proxy) return proxyBalanceLine(item.proxy, false)
return balanceLoading.value
? { text: '查询中…', title: '余额按实时查询,不落库' }
: { text: '—', title: balanceNotice.value || '本轮没取到数(不是余量为 0)' }
}
// 切公司 = 重新取数。不重取的页 = tab 在那页上是假的(G1 的 pageFiles 断言盯着这条)。
watch(() => companyTab.activeId, () => void load())
@@ -181,7 +232,9 @@ async function check(row: AdminUserSecretRow) {
if (failed.length) {
ElMessage.warning(failed[0].checkMessage || '存在检测失败项')
} else if (errors.length) {
ElMessage.warning('部分配置本次无法判定')
// 后端这句话会区分「通道被你自己占着,等约 3 分钟」与「真的问不出结论」;
// 硬写「无法判定」等于把可重试那一族又抹回一坨(现网 uid=1 就是这个形状)。
ElMessage.warning(errors[0].checkMessage || '部分配置本次无法判定')
} else {
ElMessage.success('检测通过')
}
@@ -206,38 +259,33 @@ async function remove(row: AdminUserSecretRow) {
}
}
/** 代填并锁定代理:写入后客户端只能查看,修改/清空会被服务端拒绝。 */
async function fillProxy(row: AdminUserSecretRow) {
const who = row.username || `UID ${row.userId}`
const value = window.prompt(
`代填「${who}」的代理地址(保存后客户端不可修改或清空,如需变更先解锁):`,
row.proxy?.full || '',
)
if (value == null) return
const trimmed = value.trim()
if (!trimmed) {
ElMessage.warning('代理地址不能为空')
return
}
proxyBusyId.value = row.userId
try {
await saveUserSecretModule(row.userId, 'proxy', trimmed)
ElMessage.success(row.proxy?.locked ? '已更新锁定代理' : '已代填并锁定代理')
load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '代填失败', 'error')
} finally {
proxyBusyId.value = null
/**
* 打开代填/改代理弹窗。
* ⚠ 不预填任何已有值:后台侧 `full` 恒空(代理链接里带着 key/pwd,2026-11-02 收口后不再下发),
* 所以这一单的语义就是「重新填账密」,界面上也没有把原文取回来的旁路。
*/
function openProxyDialog(row: AdminUserSecretRow) {
proxyDialog.value = {
userId: row.userId,
username: row.username || `UID ${row.userId}`,
provider: row.proxy?.channel ?? null,
locked: Boolean(row.proxy?.locked),
}
}
/** 弹窗保存成功:关掉并重新取数(列表只拿脱敏值,不参与拼装)。 */
function onProxySaved() {
proxyDialog.value = null
load()
}
/** 解锁代理:清空后台代填值,该用户恢复自行配置。 */
async function unlockProxy(row: AdminUserSecretRow) {
const who = row.username || `UID ${row.userId}`
if (!(await openAdminConfirm({ message: `确定解除「${who}」的代理锁定吗?解锁后当前后台代理值会被清空,客户端恢复自行配置。`, danger: true }))) return
proxyBusyId.value = row.userId
try {
await clearUserSecretModule(row.userId, 'proxy')
await clearUserSecretModule(row.userId, PROXY_MODULE_KEY)
ElMessage.success('已解锁')
load()
} catch (error) {
@@ -292,6 +340,15 @@ onMounted(load)
<div class="filter-actions">
<button class="btn" type="button" @click="search">查询</button>
<button class="btn btn-ghost" type="button" @click="reset">重置</button>
<button
class="btn btn-ghost"
type="button"
:disabled="balanceLoading || !rows.length"
:title="balanceNotice || '余额是实时查上游、不落库;这两列没取到时显示 —,不是 0'"
@click="loadBalances"
>
{{ balanceLoading ? '余额查询中…' : '刷新余额' }}
</button>
</div>
</div>
</div>
@@ -306,7 +363,9 @@ onMounted(load)
<th v-if="isSuperAdmin" style="width: 130px">分组</th>
<th style="width: 230px">货源查询密钥</th>
<th style="width: 230px">外观专利密钥</th>
<th style="width: 170px">LLM 余额</th>
<th style="width: 380px">代理设置</th>
<th style="width: 160px">代理余量</th>
<th style="width: 130px">状态</th>
<th style="width: 170px">创建时间</th>
<th style="width: 170px">更新时间</th>
@@ -328,10 +387,10 @@ onMounted(load)
<span v-if="row.similarAsin?.exists" class="mono-mask" :title="moduleTooltip(row.similarAsin)">{{ row.similarAsin.masked }}</span>
<span v-else class="empty-value">未配置</span>
<span v-if="row.similarAsin?.exists" class="wh-pill is-source" title="该用户这把密钥所属渠道">
{{ sourceLabel(row.similarAsin.channel) }}
{{ llmSourceLabel(row.similarAsin.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.similarAsin).tone" :title="moduleTooltip(row.similarAsin)">
{{ moduleStatusMeta(row.similarAsin).label }}
<span class="wh-pill" :class="moduleStatusBand(row.similarAsin).tone" :title="moduleTooltip(row.similarAsin)">
{{ moduleStatusBand(row.similarAsin).label }}
</span>
</div>
</td>
@@ -340,23 +399,33 @@ onMounted(load)
<span v-if="row.appearancePatent?.exists" class="mono-mask" :title="moduleTooltip(row.appearancePatent)">{{ row.appearancePatent.masked }}</span>
<span v-else class="empty-value">未配置</span>
<span v-if="row.appearancePatent?.exists" class="wh-pill is-source" title="该用户这把密钥所属渠道">
{{ sourceLabel(row.appearancePatent.channel) }}
{{ llmSourceLabel(row.appearancePatent.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.appearancePatent).tone" :title="moduleTooltip(row.appearancePatent)">
{{ moduleStatusMeta(row.appearancePatent).label }}
<span class="wh-pill" :class="moduleStatusBand(row.appearancePatent).tone" :title="moduleTooltip(row.appearancePatent)">
{{ moduleStatusBand(row.appearancePatent).label }}
</span>
</div>
</td>
<td>
<div class="module-cell module-cell--stack">
<span v-if="row.proxy?.exists" class="mono-mask mono-full" :title="moduleTooltip(row.proxy)">{{ row.proxy.full || row.proxy.masked }}</span>
<span
v-for="(line, lineIndex) in llmLinesOf(row.userId)"
:key="`llm-${lineIndex}`"
class="balance-line"
:title="line.title"
>{{ line.text }}</span>
</div>
</td>
<td>
<div class="module-cell module-cell--stack">
<span v-if="row.proxy?.exists" class="mono-mask" :title="moduleTooltip(row.proxy)">{{ proxyDisplayText(row.proxy) }}</span>
<span v-else class="empty-value">未配置</span>
<span class="module-cell-pills">
<span v-if="row.proxy?.exists" class="wh-pill is-source" title="该用户代理所属供应商">
{{ sourceLabel(row.proxy.channel) }}
{{ proxySourceLabel(row.proxy.channel) }}
</span>
<span class="wh-pill" :class="moduleStatusMeta(row.proxy).tone" :title="moduleTooltip(row.proxy)">
{{ moduleStatusMeta(row.proxy).label }}
<span class="wh-pill" :class="moduleStatusBand(row.proxy).tone" :title="moduleTooltip(row.proxy)">
{{ moduleStatusBand(row.proxy).label }}
</span>
<span
v-if="row.proxy?.locked"
@@ -369,8 +438,15 @@ onMounted(load)
</div>
</td>
<td>
<span class="wh-pill" :class="rowStatusMeta(row.status).tone" :title="rowStatusTooltip(row)">
{{ rowStatusMeta(row.status).label }}
<div class="module-cell module-cell--stack">
<span class="balance-line" :title="proxyLineOf(row.userId).title">
{{ proxyLineOf(row.userId).text }}
</span>
</div>
</td>
<td>
<span class="wh-pill" :class="rowStatusBand(row).tone" :title="rowStatusTooltip(row)">
{{ rowStatusBand(row).label }}
</span>
</td>
<td>{{ formatDateTime(row.createdAt) }}</td>
@@ -387,8 +463,7 @@ onMounted(load)
<button
class="btn btn-sm btn-ghost"
type="button"
:disabled="proxyBusyId === row.userId"
@click="fillProxy(row)"
@click="openProxyDialog(row)"
>
{{ row.proxy?.locked ? '改代理' : '代填代理' }}
</button>
@@ -406,16 +481,26 @@ onMounted(load)
</tr>
</template>
<tr v-else-if="loading">
<td :colspan="isSuperAdmin ? 10 : 9" class="empty-tip">加载中...</td>
<td :colspan="isSuperAdmin ? 12 : 11" class="empty-tip">加载中...</td>
</tr>
<tr v-else>
<td :colspan="isSuperAdmin ? 10 : 9" class="empty-tip">{{ keyword || statusFilter || groupFilter ? '暂无匹配记录' : '暂无用户密钥记录' }}</td>
<td :colspan="isSuperAdmin ? 12 : 11" class="empty-tip">{{ keyword || statusFilter || groupFilter ? '暂无匹配记录' : '暂无用户密钥记录' }}</td>
</tr>
</tbody>
</table>
</div>
<OldPagination :total="total" :page="page" :page-size="pageSize" @change="changePage" @size-change="changeSize" />
</section>
<ProxyEntryDialog
:model-value="proxyDialog != null"
:user-id="proxyDialog?.userId ?? null"
:username="proxyDialog?.username ?? ''"
:provider="proxyDialog?.provider ?? null"
:locked="Boolean(proxyDialog?.locked)"
@update:model-value="(open: boolean) => { if (!open) proxyDialog = null }"
@saved="onProxySaved"
/>
</div>
</template>
@@ -601,7 +686,7 @@ h3 {
gap: 8px;
min-width: 0;
}
/* 代理列:完整地址独占一行,状态药丸另起一行,避免长地址被药丸挤压折行 */
/* 代理列:脱敏地址独占一行,状态药丸另起一行(列宽按最长药丸文案留的,不按整条链接) */
.module-cell--stack {
flex-direction: column;
align-items: flex-start;
@@ -612,18 +697,9 @@ h3 {
overflow: hidden;
text-overflow: ellipsis;
}
/* 代理列展示完整明文:允许折行显示,不截断、不省略 */
.module-cell .mono-full {
flex: 1 1 auto;
min-width: 0;
overflow: visible;
text-overflow: clip;
white-space: normal;
overflow-wrap: anywhere;
line-height: 1.45;
cursor: text;
user-select: all;
}
/* 代理列只显示后端脱敏后的 scheme://host(短串,单行足够)。
这里**不许**再出现"允许折行展示完整明文 + user-select:all"那套样式:
它等于给整条带 key/pwd 的链接做了一键全选复制的旁路(2026-11-02 脱敏收口时一并拆掉)。 */
.mono-mask {
font-family: Consolas, "Cascadia Mono", monospace;
font-size: 12.5px;
@@ -632,6 +708,16 @@ h3 {
.empty-value {
color: #a7b4c1;
}
/* 余额列:数字按等宽数位对齐(两行叠着看差值才不用竖着对),超长进 title。 */
.balance-line {
max-width: 100%;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
font-variant-numeric: tabular-nums;
font-size: 12.5px;
color: #2f4256;
}
.ops-cell {
display: flex;
gap: 8px;
@@ -673,6 +759,13 @@ h3 {
border-color: #f0dfae;
color: #8f6d1e;
}
/* 「等一会再点」这一族(无可用通道/限流/超时/网络/上游):既不红(密钥没坏)
也不黄(不是欠费)更不是灰(不是查不出),独立一档青色——三种处置一眼分开。 */
.wh-pill.is-retry {
background: #e6f2f7;
border-color: #b6d8e6;
color: #2b6b86;
}
.wh-pill.is-unknown {
background: #f0f3f6;
border-color: #d6dee6;
@@ -8,6 +8,7 @@ import type { AdminUser } from '@/types/admin'
import { roleLabel } from '@/types/admin'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { deleteUser, fetchUserList, setUserDisabled } from '@/api/users'
import { fetchCompanies } from '@/api/companies'
import { createUserFilterState, toUserListParams, type UserFilterState } from './users-filter'
@@ -26,6 +27,10 @@ import { createLatestRequestGate } from '@/utils/latest-request'
const session = useAdminSessionStore()
const companyTab = useCompanyTabStore()
// 平台 tab(V206):账号域三页两 tab 共用本组件,列表/新建/编辑都按当前平台收放。
const platformTab = usePlatformTabStore()
/** 京东侧标记:上架上限列与编辑入口只在京东 tab 显示(用户口径「不需要在亚马逊那边」)。 */
const isJdSide = computed(() => platformTab.active === 'jd')
const loading = ref(false)
const loadError = ref('')
// 用户列表竞态门(S1-F4):快速切公司/翻页只让最后一次响应落地
@@ -65,10 +70,16 @@ function editableOf(row: AdminUser): boolean {
return editableBy(row.role, operatorRole.value)
}
/** 列表请求参数 = 用户填的筛选态 + 当前公司。公司值每次现取、不写进 filters:
* 它由上方 tab 决定而不是用户填的筛选项,住进 filters 就等于多出第二个取值口径(Store 之外再长一个)。 */
/** 上架上限列文案(仅京东侧渲染该列):null=旧数据未配('-'),0=不限,其余为具体条数。 */
function quotaCellText(row: AdminUser): string {
if (row.jdPublishQuota == null) return '-'
return row.jdPublishQuota === 0 ? '不限' : String(row.jdPublishQuota)
}
/** 列表请求参数 = 用户填的筛选态 + 当前公司 + 当前平台。公司/平台值每次现取、不写进 filters:
* 它们由上方 tab 决定而不是用户填的筛选项,住进 filters 就等于多出第二个取值口径(Store 之外再长一个)。 */
function listParams() {
return { ...toUserListParams(filters), companyId: companyTab.requestCompanyId }
return { ...toUserListParams(filters), companyId: companyTab.requestCompanyId, platform: platformTab.active }
}
async function loadUsers() {
@@ -171,18 +182,32 @@ function goJump() {
// ② 用户名全平台唯一(V143 的唯一索引),留着上一家填的关键字去筛新一家 ⇒ 必然空页,而输入框还显示着那个值。
watch(() => companyTab.activeId, () => { filters.createdByAdminId = null; filters.keyword = ''; filters.page = 1; void loadUsers() })
// 切平台 tab(V206)= 同样的重取数:列表按平台过滤,候选/关键字跨平台无意义,一并清掉;
// 建「公司超级管理员」的公司候选也按平台换一份(2026-11-17:京东 tab 下不能还选到亚马逊公司)。
watch(() => platformTab.active, () => {
filters.createdByAdminId = null
filters.keyword = ''
filters.page = 1
void loadUsers()
loadCompanyOptions()
})
// 公司目录仅站点超管拉取(建「公司超级管理员」时选公司用);非超管不发这个请求,后端 403 兜底。
// 按当前平台 tab 过滤(V206)——公司本身已按平台分侧,候选下拉跟着 tab 走。
function loadCompanyOptions() {
if (!isSuperAdmin.value) return
void fetchCompanies(platformTab.active)
.then((items) => {
companyOptions.value = items.map((c) => ({ id: c.id, companyName: c.companyName }))
})
.catch(() => {
companyOptions.value = []
})
}
onMounted(() => {
void loadUsers()
// 公司目录仅站点超管拉取(建「公司超级管理员」时选公司用);非超管不发这个请求,后端 403 兜底
if (isSuperAdmin.value) {
void fetchCompanies()
.then((items) => {
companyOptions.value = items.map((c) => ({ id: c.id, companyName: c.companyName }))
})
.catch(() => {
companyOptions.value = []
})
}
loadCompanyOptions()
})
</script>
@@ -232,6 +257,7 @@ onMounted(() => {
<th style="width: 140px">角色</th>
<th style="width: 160px">所属管理员</th>
<th style="width: 160px">到期时间</th>
<th v-if="isJdSide" style="width: 110px">上架上限</th>
<th style="width: 90px">状态</th>
<th style="width: 180px">创建时间</th>
<th style="width: 180px">更新时间</th>
@@ -248,6 +274,7 @@ onMounted(() => {
<td :class="{ 'expiry-cell-expired': formatExpiryCell(row).expired }">
{{ formatExpiryCell(row).text }}
</td>
<td v-if="isJdSide">{{ quotaCellText(row) }}</td>
<td class="status-cell" :class="{ 'status-cell-disabled': !!row.disabledAt }" :title="row.disabledAt ? `停用于 ${row.disabledAt}` : undefined">
{{ disabledBadgeText(row) }}
</td>
@@ -285,10 +312,10 @@ onMounted(() => {
</tr>
</template>
<tr v-else-if="loading">
<td colspan="9" class="empty-tip">加载中...</td>
<td :colspan="isJdSide ? 10 : 9" class="empty-tip">加载中...</td>
</tr>
<tr v-else>
<td colspan="9" class="empty-tip">{{ userListEmptyHint() }}</td>
<td :colspan="isJdSide ? 10 : 9" class="empty-tip">{{ userListEmptyHint() }}</td>
</tr>
</tbody>
</table>
@@ -305,9 +332,10 @@ onMounted(() => {
:company-options="companyOptions"
:operator-company-id="operatorCompanyId"
:active-company-id="companyTab.requestCompanyId"
:platform="platformTab.active"
@created="loadUsers"
/>
<EditUserDialog v-model="editVisible" :user="editUser" :operator-super="isSuperAdmin" :company-id="companyTab.requestCompanyId" @updated="loadUsers" />
<EditUserDialog v-model="editVisible" :user="editUser" :operator-super="isSuperAdmin" :company-id="companyTab.requestCompanyId" :platform="platformTab.active" @updated="loadUsers" />
</div>
</template>
@@ -11,22 +11,33 @@ import {
export const SHOP_GROUPS_ENDPOINT = '/api/admin/shop-manages/groups'
export async function fetchShopGroups(companyId?: number | null): Promise<ShopGroupItem[]> {
const { data } = await http.get<unknown>(SHOP_GROUPS_ENDPOINT, { params: companyId != null ? { company_id: companyId } : {} })
/** 列表:company_id 收公司口径(钉住的取值口),platform 收平台 tab 口径(V206),都缺省就不发。 */
export async function fetchShopGroups(companyId?: number | null, platform?: string): Promise<ShopGroupItem[]> {
const { data } = await http.get<unknown>(SHOP_GROUPS_ENDPOINT, {
params: {
...(companyId != null ? { company_id: companyId } : {}),
...(platform ? { platform } : {}),
},
})
return parseShopGroupList(data)
}
/** 新建分组:POST /api/admin/shop-manages/groups(创建人 = 组长 = 当前操作者)。 */
export async function createShopGroup(name: string, memberUserIds: number[], createdById: number): Promise<ShopGroupItem> {
const { data } = await http.post<unknown>(SHOP_GROUPS_ENDPOINT, toShopGroupCreatePayload(name, memberUserIds, createdById))
export async function createShopGroup(
name: string,
memberUserIds: number[],
createdById: number,
platform?: string,
): Promise<ShopGroupItem> {
const { data } = await http.post<unknown>(SHOP_GROUPS_ENDPOINT, toShopGroupCreatePayload(name, memberUserIds, createdById, platform))
const created = parseShopGroupItem(unwrap<unknown>(data))
if (!created) throw new Error('创建分组响应异常:缺少分组数据')
return created
}
/** 更新分组:PUT /api/admin/shop-manages/groups/{id}。 */
export async function updateShopGroup(id: number, name: string, memberUserIds: number[]): Promise<ShopGroupItem> {
const { data } = await http.put<unknown>(`${SHOP_GROUPS_ENDPOINT}/${id}`, toShopGroupUpdatePayload(name, memberUserIds))
export async function updateShopGroup(id: number, name: string, memberUserIds: number[], platform?: string): Promise<ShopGroupItem> {
const { data } = await http.put<unknown>(`${SHOP_GROUPS_ENDPOINT}/${id}`, toShopGroupUpdatePayload(name, memberUserIds, platform))
const updated = parseShopGroupItem(unwrap<unknown>(data))
if (!updated) throw new Error('更新分组响应异常:缺少分组数据')
return updated
@@ -12,6 +12,8 @@ export interface ShopGroupItem {
memberUserIds?: number[]
createdAt?: string
updatedAt?: string
/** 所属平台(V206):'amazon'|'jd';旧负载缺省不渲染该键。 */
platform?: string
}
export interface ShopGroupFormErrors {
@@ -53,6 +55,8 @@ export function parseShopGroupItem(raw: unknown): ShopGroupItem | null {
if (createdAt) item.createdAt = createdAt
const updatedAt = text(record.updatedAt ?? record.updated_at)
if (updatedAt) item.updatedAt = updatedAt
const platform = text(record.platform)
if (platform) item.platform = platform
return item
}
@@ -79,18 +83,34 @@ export function validateShopGroupForm(name: string): ShopGroupFormErrors {
return errors
}
/** 创建载荷:groupName + 成员 + 创建人(= 组长,当前操作者)。 */
/** 创建载荷:groupName + 成员 + 创建人(= 组长,当前操作者)+ 所属平台(V206,缺省不下发)。 */
export function toShopGroupCreatePayload(
name: string,
memberUserIds: number[],
createdById: number,
): { groupName: string; memberUserIds: number[]; createdById: number } {
return { groupName: text(name), memberUserIds: dedupeIds(memberUserIds), createdById }
platform?: string,
): { groupName: string; memberUserIds: number[]; createdById: number; platform?: string } {
const payload: { groupName: string; memberUserIds: number[]; createdById: number; platform?: string } = {
groupName: text(name),
memberUserIds: dedupeIds(memberUserIds),
createdById,
}
if (platform) payload.platform = platform
return payload
}
/** 更新载荷:groupName + 成员(组长/创建人不可改)。 */
export function toShopGroupUpdatePayload(name: string, memberUserIds: number[]): { groupName: string; memberUserIds: number[] } {
return { groupName: text(name), memberUserIds: dedupeIds(memberUserIds) }
/** 更新载荷:groupName + 成员 + 所属平台(V206;组长/创建人不可改)。 */
export function toShopGroupUpdatePayload(
name: string,
memberUserIds: number[],
platform?: string,
): { groupName: string; memberUserIds: number[]; platform?: string } {
const payload: { groupName: string; memberUserIds: number[]; platform?: string } = {
groupName: text(name),
memberUserIds: dedupeIds(memberUserIds),
}
if (platform) payload.platform = platform
return payload
}
/** 组员候选用户(对齐 admin.js getEligibleShopManageGroupUsers 的过滤语义)。 */
@@ -1,4 +1,5 @@
/** 新建用户表单模型(任务 45):纯逻辑,镜像 Java AdminUserCreateRequest 字段与后端校验。 */
import type { PlatformTabId } from '../../config/platform-scope.ts'
export const CREATE_USERNAME_MIN_LEN = 2
export const CREATE_PASSWORD_MIN_LEN = 6
@@ -21,6 +22,8 @@ export interface CreateUserForm {
expiresAt: string
/** 所属公司 id:仅 role=company_super_admin 时由站点超管必选(2026-10-05 需求)。 */
companyId?: number | null
/** 所属平台(V206):弹窗打开时预填当前平台 tab,单选可改。 */
platform: PlatformTabId
}
export interface CreateUserFormErrors {
@@ -43,10 +46,12 @@ export interface CreateUserPayload {
* 反向钉(company-user-create.test.ts)唯一豁免的例外:公司超管必须落指定公司,
* 否则会静默落操作者自己的公司(公司 1),用户需求就是给别家公司开超管。 */
companyId?: number
/** 所属平台(V206):恒下发(弹窗单选默认当前平台 tab),缺省后端落 amazon。 */
platform: PlatformTabId
}
export function createEmptyCreateUserForm(): CreateUserForm {
return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null, expiresAt: '', companyId: null }
return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null, expiresAt: '', companyId: null, platform: 'amazon' }
}
/** 未知/空白/超管角色归一:admin/company_super_admin/normal 白名单,其余归 normal。 */
@@ -147,6 +152,7 @@ export function toCreateUserRequest(form: CreateUserForm): CreateUserPayload {
password: form.password || '',
role,
columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [],
platform: form.platform,
}
if (payload.role === 'normal' && form.createdBy != null) {
payload.createdById = form.createdBy
@@ -5,6 +5,7 @@ import {
toEditUserUpdateRequest,
validateEditUserForm,
type EditUserForm,
type EditUserFormOptions,
} from './user-edit-model'
/** Java AdminUserController.updateUser 端点前缀。 */
@@ -12,12 +13,13 @@ export const EDIT_USER_ENDPOINT = '/api/admin/user'
/**
* 提交编辑用户:先校验(不通过抛首条错误),再序列化 PUT;http/后端失败交由调用方提示。
* options.includeQuota=false(亚马逊侧)不下发上架上限——校验与序列化同口径。
*/
export async function submitEditUser(form: EditUserForm): Promise<void> {
const { valid, errors } = validateEditUserForm(form)
export async function submitEditUser(form: EditUserForm, options: EditUserFormOptions = {}): Promise<void> {
const { valid, errors } = validateEditUserForm(form, options)
if (!valid) {
throw new Error(Object.values(errors)[0] || '编辑用户表单校验未通过')
}
const { data } = await http.put<unknown>(`${EDIT_USER_ENDPOINT}/${form.uid}`, toEditUserUpdateRequest(form))
const { data } = await http.put<unknown>(`${EDIT_USER_ENDPOINT}/${form.uid}`, toEditUserUpdateRequest(form, options))
unwrap<unknown>(data)
}
@@ -1,11 +1,13 @@
/** 编辑用户表单回填模型(任务 47):从用户行回填可编辑表单,镜像 Java AdminUserUpdateRequest。 */
import type { AdminUser } from '../../types/admin'
import type { PlatformTabId } from '../../config/platform-scope.ts'
import { CREATE_PASSWORD_MIN_LEN, mayCarryOwnExpiry } from './user-create-model.ts'
/** 编辑可选角色:站点/公司超管不可改,未知归 normal;后端只收 admin|normal。 */
export type EditUserRole = 'normal' | 'admin'
export interface EditUserForm {
jdPublishQuota: number
uid: number
/** 仅展示用,后端不支持改用户名。 */
username: string
@@ -18,9 +20,12 @@ export interface EditUserForm {
originalRole: string
/** 到期时间(yyyy-MM-dd HH:mm:ss);空串 = 永不过期。null = 后端本来就无到期。 */
expiresAt: string
/** 所属平台(V206):单选可翻档,未知/缺省归亚马逊(存量默认)。 */
platform: PlatformTabId
}
export interface EditUserFormErrors {
jdPublishQuota?: string
password?: string
}
@@ -28,10 +33,13 @@ export interface EditUserFormErrors {
export interface EditUserUpdateRequest {
/** 目标是公司超管时不携带(防止表单把公司超管误降级);站点超管改其密码/到期时间即可。 */
role?: EditUserRole
jdPublishQuota?: number
columnIds: number[]
password?: string
/** 到期时间:空串=清除(恢复永不过期),有值=改期;总是下发(与后端"传了就更新"对齐)。 */
expiresAt: string
/** 所属平台(V206):总是下发(弹窗单选恒渲染),翻档即把记录挪到另一平台的列表。 */
platform: PlatformTabId
}
/** 行角色 → 可编辑角色:仅 admin 映射 admin,其余(含 unknown)归 normal。 */
@@ -71,22 +79,38 @@ export function fillEditUserForm(user: AdminUser): EditUserForm {
const role = typeof user.role === 'string' ? user.role.trim() : ''
return {
uid: user.id,
jdPublishQuota: user.jdPublishQuota ?? 5000,
username: user.username || '',
password: '',
role: editRoleOf(role),
columnIds: [],
originalRole: role,
expiresAt: normalizeExpiryForPicker(user.expiresAt),
platform: user.platform === 'jd' ? 'jd' : 'amazon',
}
}
/** 编辑表单校验选项:includeQuota=false(亚马逊侧)跳过上架上限校验——该项不下发。 */
export interface EditUserFormOptions {
/** 是否参与上架上限(jd_publish_quota)的校验与下发;缺省 true(京东侧)。 */
includeQuota?: boolean
}
/** 编辑表单校验:密码可留空(不改),非空时须达到最小长度。 */
export function validateEditUserForm(form: EditUserForm): { valid: boolean; errors: EditUserFormErrors } {
export function validateEditUserForm(
form: EditUserForm,
options: EditUserFormOptions = {},
): { valid: boolean; errors: EditUserFormErrors } {
const errors: EditUserFormErrors = {}
const password = form.password || ''
if (password && password.length < CREATE_PASSWORD_MIN_LEN) {
errors.password = `密码至少${CREATE_PASSWORD_MIN_LEN}个字符,留空则不修改`
}
if (options.includeQuota !== false &&
(form.role === 'admin' || form.originalRole === 'company_super_admin') &&
(!Number.isInteger(form.jdPublishQuota) || form.jdPublishQuota < 0 || form.jdPublishQuota > 2147483647)) {
errors.jdPublishQuota = '请输入 0 至 2147483647 的整数'
}
return { valid: Object.keys(errors).length === 0, errors }
}
@@ -96,8 +120,11 @@ export function validateEditUserForm(form: EditUserForm): { valid: boolean; erro
* <p>expiresAt 按「改完之后的角色」决定:目标角色不能带自己的到期时间时发空串=清空
* (后端 400 闸门只拦「有值」,空串走既有的清除分支)。公司超管目标不带 role,
* 它的 roleAfter 就是 company_super_admin,续费那条空串不会被误当成清空。</p>
*
* <p>options.includeQuota=false(亚马逊侧编辑)不下发 jdPublishQuota——上架上限是京东
* 口径,亚马逊侧不显示也不改它(用户口径 2026-11-17);platform 恒下发(单选恒渲染)。</p>
*/
export function toEditUserUpdateRequest(form: EditUserForm): EditUserUpdateRequest {
export function toEditUserUpdateRequest(form: EditUserForm, options: EditUserFormOptions = {}): EditUserUpdateRequest {
const originalRole = (form.originalRole || '').trim().toLowerCase()
if (originalRole === 'super_admin') {
throw new Error('不能修改超级管理员')
@@ -110,10 +137,14 @@ export function toEditUserUpdateRequest(form: EditUserForm): EditUserUpdateReque
const request: EditUserUpdateRequest = {
columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [],
expiresAt: mayCarryOwnExpiry(roleAfter) ? (form.expiresAt || '').trim() : '',
platform: form.platform,
}
if (keepsRole) {
request.role = nextRole
}
if (options.includeQuota !== false && (roleAfter === 'admin' || roleAfter === 'company_super_admin')) {
request.jdPublishQuota = form.jdPublishQuota
}
const password = form.password || ''
if (password) request.password = password
return request
@@ -0,0 +1,463 @@
/**
* 密钥管理页的纯逻辑模型(货源标签 + 代理重填 + 检测结果档位)。
*
* 四条收口都在这个文件里,页模板只调这里导出的函数,不各写各的字典:
*
* 1. **货源标签按模块分字典**(2026-11-02 修):原先 `UserSecretsPage.vue` 里是一整张
* `sourceLabel()`,把 LLM 渠道(longtaitou/t8star)与代理供应商(qingguo/jikip)混在同一个
* switch 上,于是「按值匹配」的字典会把它认识的**任何**值贴到**任何**列上——代理行因此能长出
* 「龙抬头」这种标签。后端 VO 的 `channel` 本来就是按模块归一的(`UserSecretModule.channelOrDefault`
* 代理走 `ProxyProvider`、密钥走 `LlmChannel`),所以错标只会来自前端这张合表。
* 现在两张表互不相通:代理列只认供应商、密钥列只认渠道,跨域的值一律落到「—」而不是被硬认下来。
*
* 2. **代理列不再显示、也不再回传原文**(2026-11-02 后端 `SecretMasking.maskProxy` 收口):
* `AdminUserSecretModuleVo.full` 后台侧恒为空,界面只读 `masked`(`scheme://host`,不含
* key/pwd)。因此原先「代填/改代理」用 `window.prompt` 预填整条链接的交互已失效
* (预填必然是空的,保存还会把空串顶上去)——改成重新填账密:青果填 Authkey/Authpwd、
* 由 `composeQingguoLink` 现拼;极客按其产品口径填自家提取链接。
* ⚠ 拼出来的链接是一次性写请求的载荷,**不得**回显、回填、进 tooltip、进剪贴板。
*
* 3. **检测结果按 `check_code` 分档渲染**(2026-11-02 加,见下方档位表):状态列原先只看
* `check_status`,把后端新分出来的一族「等一会再点就行」的码(`channel_busy` 等)一律显示成
* 「无法判定」,管理员分不清「被自己占着」「密钥坏了」「欠费」三种完全不同的处置。
* 码表只在这一份文件里(页面不再自带第二张表),句子一律用后端的 `check_message` 原文。
*
* 零 `@/` 别名依赖:本文件被 `node --test` 直测(那颗 runner 不认 Vite 别名)。
*/
import { composeQingguoLink } from '../../shared/utils/qingguo-link.ts'
export type LlmChannelKey = 'longtaitou' | 't8star'
export type ProxyProviderKey = 'qingguo' | 'jikip'
/** 代理模块 key(与后端 `UserSecretModule.PROXY.key()` 同值):写请求的路径段与「这一格是代理」的判据。 */
export const PROXY_MODULE_KEY = 'proxy'
/* ------------------------------------------------------------------ *
* 检测结果的渲染档位(2026-11-02 加,起因是现网 uid=1 的 proxy 行)
*
* 后端 `UserApiSecretCheckService` 把青果检测从「无条件假通过」改成真提取后**按供应商返回码分档**,
* 于是 `check_code` 成了这一格到底怎么了的最细信号;而界面当时只认 `check_status` 三档
* (passed/failed/error),`error` 一律写成「无法判定」——`channel_busy`(青果通道被自己的采集
* 占着,等约 3 分钟就能重试)因此被显示成「查不出」,管理员既看不出「等一会就行」,
* 也分不清它和「密钥坏了」「欠费」是三种完全不同的处置。
*
* 所以现在**按码建表、按状态兜底**:
* - 认得的码 ⇒ 各有自己的档位(可重试这一族另给独立配色,既不红也不黄);
* - 「无法判定」只留给真正没有结论的情况(空码/这表里没有的码 + `check_status=error`);
* - `check_status=unknown`(后端 upsert 后的初值,等于「从没检测过」)仍是「未检测」,
* 不许冒充「无法判定」——那是两件事,前者点一次检测就有答案,后者点了也还是没答案。
*
* ⚠ 措辞的权威在后端:给人看的那句中文在 `check_message` 里,界面只出**档名**(一个词),
* 绝不按码自己拼句子;句子通过 `moduleTooltip`/行级 tooltip 原样透出。
* ------------------------------------------------------------------ */
/** 药丸配色档位,对应 `UserSecretsPage.vue` 里 `.wh-pill.is-*` 那套样式类。 */
export type StatusTone = 'is-allowed' | 'is-blocked' | 'is-warn' | 'is-retry' | 'is-unknown'
/** 一个渲染档位:档名 + 配色。档名是给管理员扫一眼用的短词,不是解释句。 */
export interface StatusBand {
label: string
tone: StatusTone
}
/** 单格「没配」与「没检测」是两档,但都用灰色:都不代表密钥本身有问题。 */
export const NOT_CONFIGURED_BAND: StatusBand = { label: '未配置', tone: 'is-unknown' }
export const NOT_CHECKED_BAND: StatusBand = { label: '未检测', tone: 'is-unknown' }
/** 真的问不出结论(空码/未知码 + `check_status=error`)才落到这一档。 */
export const INDETERMINATE_BAND: StatusBand = { label: '无法判定', tone: 'is-warn' }
/** 后端 `STATUS_PASSED`(或码 `ok`):唯一可以当成「这项配好了」的一档。 */
export const PASSED_BAND: StatusBand = { label: '通过', tone: 'is-allowed' }
/** 后端新增了一档、前端还没登记码名时的兜底:按状态给个不撒谎的词,不当场判死。 */
const GENERIC_FAILED_BAND: StatusBand = { label: '失败', tone: 'is-blocked' }
/** 后端 `UserApiSecretCheckService` 的 `CODE_*` 全集(2026-11-02 逐条对着源码登记)。 */
const CHECK_CODE_BANDS: Record<string, StatusBand> = {
ok: PASSED_BAND,
/** 通道被自己的采集占着:等释放后重点一次,密钥没坏——这一档就是本次要修的错渲染。 */
channel_busy: { label: '无可用通道', tone: 'is-retry' },
rate_limited: { label: '限流重试', tone: 'is-retry' },
timeout: { label: '超时重试', tone: 'is-retry' },
/** 传输层失败:后端两个分支都给这个码(提取接口不可达=failed、探测异常=error),都可重试。 */
network_error: { label: '网络重试', tone: 'is-retry' },
server_error: { label: '上游重试', tone: 'is-retry' },
/** 欠费(现网 21 行):修之前就只有 `check_status=failed` 这一条路径认得它,改后按码认、不再吊在状态上。 */
insufficient_balance: { label: '欠费', tone: 'is-warn' },
/** 提取成功但链接里组不出可验连的地址(没带 key/pwd):要用户重填,不是「查不出」。 */
tunnel_unverified: { label: '链接缺账密', tone: 'is-warn' },
invalid_key: { label: '密钥失效', tone: 'is-blocked' },
forbidden: { label: '鉴权被拒', tone: 'is-blocked' },
bad_request: { label: '参数被拒', tone: 'is-blocked' },
provider_error: { label: '供应商报错', tone: 'is-blocked' },
}
/** 行级档位:后端 `UserApiSecretService` 按 failed > incomplete > passed > error > unknown 聚合,界面不重排这个优先级。 */
const ROW_STATUS_BANDS: Record<string, StatusBand> = {
passed: { label: '检测通过', tone: 'is-allowed' },
failed: { label: '检测失败', tone: 'is-blocked' },
incomplete: { label: '未配齐', tone: 'is-warn' },
error: INDETERMINATE_BAND,
}
/** 行级「可重试」:仅当整行的问题**只**出在可重试那一族码上时替换掉「无法判定」(后端给不了这一档,前端按格子的码补)。 */
const ROW_RETRY_BAND: StatusBand = { label: '可重试', tone: 'is-retry' }
/** 单模块的可比较形状(不引 `@/api/*`:本文件要能被零别名的 `node --test` 直测)。 */
interface CheckModuleLike {
exists?: boolean | null
moduleLabel?: string | null
checkStatus?: string | null
checkCode?: string | null
checkMessage?: string | null
}
/** 一行的可比较形状:只用到行状态 + 三个格子。 */
interface SecretRowLike {
status?: string | null
similarAsin?: CheckModuleLike | null
appearancePatent?: CheckModuleLike | null
proxy?: CheckModuleLike | null
}
/** 按归一后的键查档位表:空键与表里没有的键都返回 null(调用方兜底,绝不硬认一档)。 */
function bandOf(table: Record<string, StatusBand>, raw: unknown): StatusBand | null {
const key = normalizeKey(raw)
if (!key || !Object.prototype.hasOwnProperty.call(table, key)) return null
return table[key] ?? null
}
/** 码 → 档位;空码或这表里没有的码返回 null(由调用方按状态兜底,不硬认一档)。 */
export function checkCodeBand(code: string | null | undefined): StatusBand | null {
return bandOf(CHECK_CODE_BANDS, code)
}
/** 这一档是不是「等一等再点」那一族(可重试):配色与行级补档都读这一个判据,不散落码名。 */
export function isRetryBand(band: StatusBand | null | undefined): boolean {
return band?.tone === 'is-retry'
}
/**
* 单格状态药丸:先看是否已配置,再看 `check_status=passed`,然后**按 `check_code` 分档**,
* 都不认才按状态兜底。
*/
export function moduleStatusBand(module: CheckModuleLike | null | undefined): StatusBand {
if (!module || !module.exists) return NOT_CONFIGURED_BAND
const status = normalizeKey(module.checkStatus)
if (status === 'passed') return PASSED_BAND
const band = checkCodeBand(module.checkCode)
if (band) return band
if (status === 'error') return INDETERMINATE_BAND
if (status === 'failed') return GENERIC_FAILED_BAND
// ''/unknown/后端下一版新增的状态值:宁可说「未检测」,也不替后端编造一个结论
return NOT_CHECKED_BAND
}
/** 行级状态药丸:后端聚合成 `error` 时,若这一行**没有结论的格子全是可重试那一族**,补成「可重试」。 */
export function rowStatusBand(row: SecretRowLike | null | undefined): StatusBand {
const status = normalizeKey(row?.status)
if (status === 'error' && awaitsRetryOnly(row)) return ROW_RETRY_BAND
// 行级 `unknown`=后端还没问过(不是「问了问不出」),留「未检测」这一档,与筛选项里那一行同词
return bandOf(ROW_STATUS_BANDS, status) ?? NOT_CHECKED_BAND
}
/**
* 这一行是不是「点一次就有答案」:后端把 error 之上的 failed/incomplete 都判掉了才轮到 error,
* 所以这里只需再确认剩下那些没通过的格子都落在可重试档——混进一格「链接缺账密」就不算可重试,
* 那一格不会自己好,把整行说成「可重试」等于让管理员一直等。
*/
function awaitsRetryOnly(row: SecretRowLike | null | undefined): boolean {
const pending = modulesOf(row).filter(
(module) => Boolean(module?.exists) && normalizeKey(module?.checkStatus) !== 'passed',
)
return pending.length > 0 && pending.every((module) => isRetryBand(moduleStatusBand(module)))
}
/**
* 行级 tooltip 的明细:逐格把**后端原文** `check_message` 抄出来(运维判「是欠费还是被自己占着」就靠这句)。
* 前端不拼句子、不改一个字;没检测过的格子没有这句话,自然不出现。
*/
export function rowDetailLines(row: SecretRowLike | null | undefined): string[] {
return modulesOf(row)
.filter((module) => Boolean(module?.exists))
.map((module) => {
const message = String(module?.checkMessage ?? '').trim()
if (!message) return ''
const label = String(module?.moduleLabel ?? '').trim()
return label ? `${label}:${message}` : message
})
.filter(Boolean)
}
function modulesOf(row: SecretRowLike | null | undefined): CheckModuleLike[] {
return [row?.similarAsin, row?.appearancePatent, row?.proxy].filter(Boolean) as CheckModuleLike[]
}
/** 后端 `ProxyProvider.DEFAULT`=极客:新建默认极客,青果手动切(2026-10-30 拍板)。 */
export const DEFAULT_PROXY_PROVIDER: ProxyProviderKey = 'jikip'
/** 认不出的货源一律这个占位,不许回退成"某个具体渠道名"(那正是错标的来源)。 */
export const UNKNOWN_SOURCE_LABEL = '—'
const LLM_CHANNEL_LABELS: Record<LlmChannelKey, string> = {
longtaitou: '龙抬头',
t8star: '贞贞',
}
const PROXY_PROVIDER_LABELS: Record<ProxyProviderKey, string> = {
qingguo: '青果',
jikip: '极客',
}
function normalizeKey(raw: unknown): string {
return String(raw ?? '').trim().toLowerCase()
}
function known<T extends string>(table: Record<T, string>, raw: unknown): string | null {
const key = normalizeKey(raw)
return Object.prototype.hasOwnProperty.call(table, key)
? table[key as T]
: null
}
/** LLM 密钥列的渠道名:只查 LLM 字典,代理供应商的值在这里认不出。 */
export function llmSourceLabel(channel: string | null | undefined): string {
return known(LLM_CHANNEL_LABELS, channel) ?? UNKNOWN_SOURCE_LABEL
}
/**
* 代理列的供应商名:只查供应商字典。
* 传进 LLM 渠道值(`longtaitou`/`t8star`)必须返回占位——这条是"代理行贴龙抬头"的直接判据。
*/
export function proxySourceLabel(channel: string | null | undefined): string {
return known(PROXY_PROVIDER_LABELS, channel) ?? UNKNOWN_SOURCE_LABEL
}
/**
* 归一为可选供应商;未知值不猜,返回 null 让调用方保持原选择。
*/
export function asProxyProvider(raw: unknown): ProxyProviderKey | null {
const key = normalizeKey(raw)
return key === 'qingguo' || key === 'jikip' ? key : null
}
/**
* 代理列的唯一显示文本:后端下发的 `masked`(青果形状 `https://overseas.proxy.qg.net`)。
* 刻意**不读** `full`,也不做任何"masked 空就回落到原文"的兜底——回落等于把脱敏前的行为留在界面里。
*/
export function proxyDisplayText(module: { masked?: string | null } | null | undefined): string {
const masked = String(module?.masked ?? '').trim()
return masked || UNKNOWN_SOURCE_LABEL
}
/** 代填/改代理的表单草稿:青果用前三个字段,极客用 `link`。 */
export interface ProxyEntryDraft {
provider: ProxyProviderKey
authkey: string
authpwd: string
link: string
}
/**
* 空草稿:`provider` 用后端已登记的那一列预置(只是选中的单选框,不是凭据),
* 三个输入位**一律空**——脱敏后没有任何原文可回填。
*/
export function emptyProxyEntryDraft(currentProvider?: string | null): ProxyEntryDraft {
return {
provider: asProxyProvider(currentProvider) ?? DEFAULT_PROXY_PROVIDER,
authkey: '',
authpwd: '',
link: '',
}
}
/** 与后端 `PROXY_FORMAT_HINT` 同一句口径:本函数只做前置提示,真判仍在服务端。 */
const PROXY_LINK_FORMAT_HINT =
'代理地址格式不正确,请填写 http://host:port 形式的代理地址,或代理服务商的提取链接(https://...)'
/** http(s) + 有主机名:镜像后端 `validateProxyValue`,不在前端扩大判死范围。 */
function isHttpUrl(raw: string): boolean {
try {
const parsed = new URL(raw)
return (parsed.protocol === 'http:' || parsed.protocol === 'https:') && Boolean(parsed.hostname)
} catch {
return false
}
}
/**
* 校验草稿,返回给界面显示的文案(空串=可以提交)。
* 点名"缺哪把":缺 pwd 时青果回 `API_AUTH_DENY`,所以两把都得填,不能只填 key 就当配好了。
*/
export function validateProxyEntry(draft: ProxyEntryDraft): string {
if (!asProxyProvider(draft.provider)) return '请选择代理供应商'
if (draft.provider === 'qingguo') {
if (!String(draft.authkey || '').trim()) return '请填写青果 Authkey'
if (!String(draft.authpwd || '').trim()) return '请填写青果 Authpwd(只填 Authkey 青果会判鉴权拒绝)'
return ''
}
const link = String(draft.link || '').trim()
if (!link) return '请填写极客提取链接'
if (!isHttpUrl(link)) return PROXY_LINK_FORMAT_HINT
return ''
}
/**
* 组装 PUT `/api/admin/user-secrets/{userId}/modules/proxy` 的请求体。
* 不合法返回 null(调用方不得把 null 顶上去,更不得拿旧值凑数)。
*/
export function buildProxyEntryPayload(
draft: ProxyEntryDraft,
): { value: string; channel: ProxyProviderKey } | null {
if (validateProxyEntry(draft)) return null
if (draft.provider === 'qingguo') {
return { value: composeQingguoLink(draft.authkey, draft.authpwd), channel: 'qingguo' }
}
return { value: String(draft.link || '').trim(), channel: 'jikip' }
}
/* ------------------------------------------------------------------ *
* 余额侧写(2026-11-05 B83):第四处收口,仍守「两张字典互不相通」那一条。
*
* LLM 那格的单位是**钱**(人民币=龙抬头站内 ⚡,后端只取 `credits` 块),
* 代理那格的 `surplus` 是**次数**、`scope` 说这份量属于谁的池子。
* 两者都叫「余额」,混用一张函数就会读出「极客 ¥34」这种既不像钱也不像次的数——
* 所以这里各写各的,跨域字段一个都不读,认不出来一律 `—`(同货源标签那条判据)。
* ------------------------------------------------------------------ */
/** 后端 credits 块登记的单位;不是这个值就说明口径换了,宁可不显示也不猜。 */
export const LLM_BALANCE_UNIT = 'CREDIT'
interface LlmBalanceLike {
moduleKey?: string | null
moduleLabel?: string | null
channel?: string | null
channelLabel?: string | null
available?: boolean | null
balance?: string | null
availableBalance?: string | null
frozen?: string | null
unit?: string | null
message?: string | null
checkedAt?: string | null
}
interface ProxyBalanceLike {
available?: boolean | null
surplus?: string | null
balance?: string | null
scope?: string | null
message?: string | null
}
/** 一行的显示内容:`text` 进格子,`title` 进悬停(整句原因与取数时刻都在那儿)。 */
export interface BalanceLine {
text: string
title: string
}
const BALANCE_PLACEHOLDER: BalanceLine = { text: UNKNOWN_SOURCE_LABEL, title: '本轮没取到数(不是余额为 0)' }
const BALANCE_PENDING: BalanceLine = { text: '查询中…', title: '余额按实时查询,不落库' }
/** 人民币读数:解析不出数字时原样回显,不返回 `¥0`(一格 0 会被读成「没钱了」)。 */
export function formatYuan(raw: string | null | undefined): string {
const text = String(raw ?? '').trim()
if (!text) return ''
const value = Number(text.replace(/,/g, ''))
if (!Number.isFinite(value)) return text
return `¥${value.toFixed(2)}`
}
function llmDetail(cell: LlmBalanceLike): string {
const parts: string[] = []
if (cell.moduleLabel) parts.push(String(cell.moduleLabel))
const total = formatYuan(cell.balance)
const usable = formatYuan(cell.availableBalance)
const frozen = formatYuan(cell.frozen)
if (total) parts.push(`总 ${total}`)
if (usable) parts.push(`可用 ${usable}`)
if (frozen) parts.push(`预冻结 ${frozen}`)
if (cell.checkedAt) parts.push(`取数于 ${String(cell.checkedAt).replace('T', ' ').slice(0, 16)}`)
const message = String(cell.message ?? '').trim()
if (message) parts.push(message)
return parts.join(';') || '暂无余额信息'
}
/**
* LLM 余额列:一把密钥一行,前缀是**渠道名**(钱挂在渠道账户上,不在模块上)。
*
* `pending=true` ⇒ 这一轮还在取数;取到但不合格(单位不是 CREDIT/available=false)
* 一律走占位与后端原文,不显示金额。
*/
export function llmBalanceLine(cell: LlmBalanceLike | null | undefined, pending = false): BalanceLine {
if (pending && !cell) return BALANCE_PENDING
if (!cell) return BALANCE_PLACEHOLDER
const label = known(LLM_CHANNEL_LABELS, cell.channel) ?? UNKNOWN_SOURCE_LABEL
// 渠道认不出(LLM 列被喂了供应商名这类跨域值)时整格给占位:宁可什么都不显示,
// 也不让一个不知道属于谁的数字或句子进界面(同货源标签那张表「跨域一律 —」的判据)
if (label === UNKNOWN_SOURCE_LABEL) {
return { text: UNKNOWN_SOURCE_LABEL, title: `${llmDetail(cell)}|渠道值认不出,未显示金额` }
}
if (!cell.available || String(cell.unit ?? '').trim().toUpperCase() !== LLM_BALANCE_UNIT) {
const message = String(cell.message ?? '').trim()
return { text: message ? `${label} 查不到` : `${label} ${UNKNOWN_SOURCE_LABEL}`, title: llmDetail(cell) }
}
const total = formatYuan(cell.balance)
if (!total) return { text: `${label} ${UNKNOWN_SOURCE_LABEL}`, title: llmDetail(cell) }
return { text: `${label} ${total}`, title: llmDetail(cell) }
}
/**
* LLM 余额列的整格内容:**按渠道折叠**,一个渠道一行。
*
* 钱挂在渠道账户上、不挂在模块上:两把密钥(外观专利/货源查询)都在龙抬头时,
* 上游回的是同一个余额——排两遍会读成「这个账户有两笔钱」。折叠后 title 里仍留每一把的原文,
* 运维要判「是哪把密钥的渠道」看得回来。
*/
export function llmBalanceLines(
cells: Array<LlmBalanceLike | null | undefined> | null | undefined,
pending = false,
): BalanceLine[] {
const list = (cells ?? []).filter((cell): cell is LlmBalanceLike => Boolean(cell))
if (!list.length) return pending ? [BALANCE_PENDING] : []
const grouped = new Map<string, BalanceLine>()
for (const cell of list) {
const key = normalizeKey(cell.channel) || 'unknown'
const line = llmBalanceLine(cell, pending)
const hit = grouped.get(key)
grouped.set(key, hit ? { text: hit.text, title: `${hit.title}|${line.title}` } : line)
}
return [...grouped.values()]
}
/** 代理池子的归属说法:platform 那份是**平台的钱**,绝不允许被读成这个用户的余量。 */
const PROXY_SCOPE_LABELS: Record<string, string> = {
user: '你的套餐',
platform: '平台池',
none: '查不了',
}
/**
* 代理余量列:极客给「剩余 IP 次数」(单位是次、不是钱);青果按 scope=none 说查不了。
* `scope` 认不出来时不硬认(回落「来源未标注」并保留原值进 title 供运维核)。
*/
export function proxyBalanceLine(cell: ProxyBalanceLike | null | undefined, pending = false): BalanceLine {
if (pending && !cell) return BALANCE_PENDING
if (!cell) return BALANCE_PLACEHOLDER
const scopeKey = normalizeKey(cell.scope)
const scopeLabel = Object.prototype.hasOwnProperty.call(PROXY_SCOPE_LABELS, scopeKey)
? PROXY_SCOPE_LABELS[scopeKey]
: '来源未标注'
const message = String(cell.message ?? '').trim()
const detailParts = [`${scopeLabel}`]
const surplus = String(cell.surplus ?? '').trim()
const amount = String(cell.balance ?? '').trim()
if (surplus) detailParts.push(`剩余 IP ${surplus}`)
if (amount) detailParts.push(`账户余额 ${amount}`)
if (message) detailParts.push(message)
const title = detailParts.join(';') || '暂无余量信息'
if (!cell.available) {
// 后端那句原文(「青果不提供余量查询…」「上游未在预算内应答…」)全在 title 里;
// 格子只说「查不了」——留 `—` 会被读成「这人没配代理」,那是另一件事。
return { text: message ? '查不了' : `${scopeLabel} ${UNKNOWN_SOURCE_LABEL}`, title }
}
// 次数就是次数:这里不套 ¥ 符号、不换算,读数带「次」把单位写在格子里
return { text: `${scopeLabel} ${surplus || UNKNOWN_SOURCE_LABEL} 次`, title }
}
@@ -0,0 +1,288 @@
<script setup lang="ts">
/** 批量编辑分类对话框(2026-11-17 用户口径「店铺分类弹窗删了,加个批量编辑分类」):
* 京东数据库页勾选商品(翻页累计,由页面持有勾选集)→ 本对话框选目标分类或移出分类 →
* 一次批量归类。归属写「本组」的归属行(biz_jd_product_group_assign,V203 一组一商品一行),
* 归类不置人工编辑锁(采集照常更新价格/库存)。本组无分类时只有提示不给提交
* (移出对未分类行是无谓操作),引导去工具栏「分类管理」新建(2026-11-17 独立页并回本页)。 */
import { computed, ref, watch } from 'vue'
import { batchAssignJdProductGroup, type JdProductGroup } from './jd-product-api.ts'
import { requestErrorMessage } from '../../api/envelope.ts'
const props = defineProps<{
visible: boolean
/** 当前数据权限分组(归类的落点组;V203 同一商品在其他组可另归一类)。 */
ownerGroupId: number
ownerGroupName: string
/** 当前分组的分类选项(含商品数徽标;由页面在打开时刷新)。 */
categories: JdProductGroup[]
/** 页面持有的勾选集(跨页累计),展开成 id 数组传入。 */
selectedIds: number[]
}>()
const emit = defineEmits<{ (event: 'close'): void; (event: 'done', updated: number, targetName: string | null): void }>()
/** 选中的目标分类 id;0=移出分类(回到未分类)。 */
const pickedId = ref(0)
const assigning = ref(false)
const errorText = ref('')
const picked = computed(() => props.categories.find((group) => group.id === pickedId.value) || null)
const confirmText = computed(() => (picked.value ? `归入「${picked.value.name}」` : '移出分类'))
/** 提交条件:有勾选、未在提交中,且选了目标分类(pickedId>0)或选了移出(pickedId=0,
* 但本组得有分类可移——全组无分类时移出是无谓操作,整对话框只留提示)。 */
const canSubmit = computed(() => props.selectedIds.length > 0 && !assigning.value
&& (picked.value ? true : props.categories.length > 0))
watch(
() => props.visible,
(visible) => {
if (visible) {
pickedId.value = 0
errorText.value = ''
}
},
)
async function submit(): Promise<void> {
if (!canSubmit.value) return
const target = picked.value
assigning.value = true
errorText.value = ''
try {
// target null=移出分类(groupId 传 null,后端只解挂本组归属行)。
const updated = await batchAssignJdProductGroup(
props.selectedIds,
target ? target.id : null,
props.ownerGroupId,
)
emit('done', updated, target ? target.name : null)
emit('close')
} catch (error) {
errorText.value = requestErrorMessage(error) || '批量归类失败'
} finally {
assigning.value = false
}
}
</script>
<template>
<div v-if="visible" class="modal-mask" @click.self="emit('close')">
<div class="batch-modal">
<div class="modal-head">
<h3>批量编辑分类<span v-if="ownerGroupName" class="modal-sub">· {{ ownerGroupName }}</span></h3>
<button class="modal-close" type="button" aria-label="关闭" @click="emit('close')">×</button>
</div>
<p class="modal-tip">
已勾选 {{ selectedIds.length }} 个商品(翻页累计)。选目标分类后确认;
归类只记在分类归属上,不影响采集对价格/库存的更新。
</p>
<p v-if="errorText" class="group-error">{{ errorText }}</p>
<div v-if="!categories.length" class="batch-empty">本组暂无分类,先用工具栏「分类管理」新建一个</div>
<ul v-else class="option-list">
<li
v-for="group in categories"
:key="group.id"
class="option-row"
:class="{ active: pickedId === group.id }"
@click="pickedId = group.id"
>
<span class="option-radio" aria-hidden="true"></span>
<span class="option-name" :title="group.name">{{ group.name }}</span>
<span class="option-meta">{{ group.productCount }}</span>
</li>
<li class="option-row option-detach" :class="{ active: pickedId === 0 }" @click="pickedId = 0">
<span class="option-radio" aria-hidden="true"></span>
<span class="option-name">移出分类</span>
<span class="option-meta">回到未分类</span>
</li>
</ul>
<div class="modal-foot">
<button class="btn btn-secondary" type="button" @click="emit('close')">取消</button>
<button class="btn" type="button" :disabled="!canSubmit" @click="submit">
{{ assigning ? '提交中...' : confirmText }}
</button>
</div>
</div>
</div>
</template>
<style scoped>
.modal-mask {
position: fixed;
inset: 0;
z-index: 2800;
display: flex;
align-items: center;
justify-content: center;
padding: 40px 20px;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(6px);
}
.batch-modal {
display: flex;
flex-direction: column;
width: min(430px, 100%);
max-height: 80vh;
padding: 18px 20px 20px;
border: 1px solid #c7d7e5;
border-radius: 14px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(39, 67, 94, 0.2);
}
.modal-head {
display: flex;
align-items: center;
justify-content: space-between;
}
.modal-head h3 {
margin: 0;
font-size: 15px;
font-weight: 650;
color: #24384d;
}
.modal-sub {
margin-left: 6px;
color: #5b6f83;
font-size: 13px;
font-weight: 500;
}
.modal-close {
width: 30px;
height: 30px;
border: 1px solid transparent;
border-radius: 9px;
background: none;
color: #5b6f83;
font-size: 20px;
line-height: 1;
cursor: pointer;
}
.modal-close:hover {
border-color: #cbd9e6;
background: #eef4fa;
color: #24384d;
}
.modal-tip {
margin: 8px 0 10px;
color: #8293a5;
font-size: 12.5px;
line-height: 1.5;
}
.group-error {
margin: 0 0 8px;
padding: 10px 12px;
border: 1px solid #f0c9c2;
border-radius: 10px;
background: #fdf1ef;
color: #a04432;
font-size: 13px;
}
.batch-empty {
padding: 26px 12px;
border: 1px dashed #cbd9e6;
border-radius: 10px;
color: #8293a5;
font-size: 13px;
text-align: center;
}
.option-list {
flex: 1;
min-height: 0;
overflow-y: auto;
margin: 0;
padding: 0;
list-style: none;
border-top: 1px solid #e7eef5;
}
.option-row {
display: flex;
align-items: center;
gap: 10px;
padding: 10px 8px;
border-bottom: 1px solid #e7eef5;
font-size: 13.5px;
cursor: pointer;
}
.option-row:hover {
background: #f1f7fb;
}
/* 点亮=归类目标:与旧弹窗左栏同款左缘蓝条。 */
.option-row.active {
background: #e8f1fa;
box-shadow: inset 3px 0 0 #4f78a5;
}
.option-radio {
flex: none;
width: 14px;
height: 14px;
border: 1.6px solid #9fb7cd;
border-radius: 50%;
background: #ffffff;
}
.option-row.active .option-radio {
border-color: #4f78a5;
background: radial-gradient(circle, #4f78a5 0 4px, #ffffff 4.6px);
}
.option-name {
flex: 1;
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: #24384d;
}
.option-detach .option-name {
color: #a04432;
}
.option-meta {
flex: none;
min-width: 22px;
padding: 1px 7px;
border-radius: 9px;
background: #eef4fa;
color: #4e6479;
font-size: 12px;
text-align: center;
white-space: nowrap;
}
.option-detach .option-meta {
background: transparent;
color: #8293a5;
}
.modal-foot {
display: flex;
justify-content: flex-end;
gap: 10px;
margin-top: 14px;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 38px;
padding: 7px 16px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13px;
cursor: pointer;
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.6;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border-color: #c7d7e5;
}
.btn-secondary:hover:not(:disabled) {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
</style>
@@ -0,0 +1,469 @@
<script setup lang="ts">
/** 京东数据库「类目」筛选的京麦同款级联面板(2026-11-16 客户口径「京麦类目是这些 我们
* 后台的现在的不对」+「你直接爬」→ 树数据换成京麦授权类目真树,见 ./jd-category-tree.ts
* 头注释的取证来源与边界)。
*
* 交互(京麦真机同款,2026-11-16 面板逐级点开取证):面板按点亮路径动态出栏——第一栏
* 一级(3 个)、后续栏=点亮节点的 children(最深 4 栏);**非末级行点击=下钻**(推进
* 路径)、**末级行(children 空)点击=选中**(radio 蓝,emit change→按 category_path
* 等值过滤,后端契约零改动)。搜索框搜**树内全部末级**(名称或路径命中,行 title 带
* 全路径);树外命中(已落库但京麦类目体系变更后的历史名)从 options 兜底段选,语义
* 同旧版第三栏。「全部类目」行=清选;触发框已选时出 × 清除;面板外点透明遮罩关闭。
* 零依赖自绘(radio 圆点/箭头都是 CSS),无 element 依赖。 */
import { computed, nextTick, ref, watch } from 'vue'
import {
jdCategoryChildren,
jdCategoryRoots,
jdCategorySearchLeaves,
type JdCategoryNode,
} from './jd-category-tree.ts'
import { clampPanelLeftX } from './jd-category-cascader-position.ts'
const props = defineProps<{
/** 已落库末级类目全集(/categories 现算,页面传入)——只作**树外兜底**(搜索无树内
* 命中时列出「已落库类目(树外历史)」段),不再默认铺第三栏。 */
options?: { name: string; productCount: number }[]
/** 当前选中末级类目名;'' = 全部类目。 */
modelValue: string
groups?: { id: number; name: string; productCount: number }[]
groupId?: string
createVersion?: number
busy?: boolean
treeOnly?: boolean
}>()
const emit = defineEmits<{
(event: 'change', value: string): void
(event: 'group', value: string): void
(event: 'create-group', value: string): void
(event: 'delete-group', id: number): void
}>()
const newGroupName = ref('')
watch(() => props.createVersion, () => { newGroupName.value = '' })
function createGroup(): void {
const name = newGroupName.value.trim()
if (name) emit('create-group', name)
}
function pickGroup(id: number): void {
emit('group', String(id))
close()
}
const open = ref(false)
/** 已下钻的节点名路径(非末级行点击推进)。 */
const activePath = ref<string[]>([])
const searchText = ref('')
/** 面板水平定位钳制(2026-11-16「超出视窗了」):触发框在筛选行中部偏右时,锚 left:0
* 的多栏面板会伸出视窗右缘。打开与栏数/搜索态变化后用真实 rect 重算 left 偏移——
* 右缘贴齐视口后继续下钻即向左生长,不再截掉末栏。钳制数学在
* ./jd-category-cascader-position.ts(纯函数,tests/jd-category-cascader-position.test.ts)。 */
const hostRef = ref<HTMLElement | null>(null)
const panelRef = ref<HTMLElement | null>(null)
const panelOffsetX = ref(0)
function reposition(): void {
const host = hostRef.value
const panel = panelRef.value
if (!host || !panel) return
panelOffsetX.value = clampPanelLeftX({
hostLeft: host.getBoundingClientRect().left,
panelWidth: panel.offsetWidth,
viewportWidth: window.innerWidth,
})
}
const roots = jdCategoryRoots()
/** 树内全部末级名集合(判定 options 哪些是「树外历史」)。 */
const treeLeafNames = new Set(
jdCategorySearchLeaves('').map((leaf) => leaf.name),
)
/** 面板各栏内容:第 0 栏一级,第 i+1 栏=点亮路径前 i+1 个的 children(路径推进到
* 末级时末栏是叶子所在栏,children 空不出栏——栏数随路径动态 1~4)。 */
const columns = computed<JdCategoryNode[][]>(() => {
const cols: JdCategoryNode[][] = [roots]
for (let i = 0; i < activePath.value.length; i++) {
const children = jdCategoryChildren(activePath.value.slice(0, i + 1))
if (!children.length) break
cols.push(children)
}
return cols
})
/** 搜索激活=搜索词非空:面板切换成扁平末级结果列表。 */
const searching = computed(() => searchText.value.trim().length > 0)
/** 树内命中末级(名称或路径段命中)。 */
const searchLeaves = computed(() =>
searching.value ? jdCategorySearchLeaves(searchText.value) : [],
)
/** 树外兜底:options 里不在树名集的行按搜索词过滤(历史行仍可选中过滤)。 */
const fallbackOptions = computed(() => {
if (!searching.value) return []
const keyword = searchText.value.trim().toLowerCase()
return (props.options ?? [])
.filter((option) => !treeLeafNames.has(option.name))
.filter((option) => option.name.toLowerCase().includes(keyword))
})
/** 栏数随下钻动态 1~4、搜索态切单栏 ⇒ 面板宽度变,开着就要重算偏移(下钻向左生长)。 */
watch(
() => [columns.value.length, searching.value] as const,
() => {
if (open.value) nextTick(reposition)
},
)
function toggle(): void {
if (open.value) {
close()
return
}
activePath.value = []
searchText.value = ''
open.value = true
nextTick(reposition)
}
function close(): void {
open.value = false
activePath.value = []
}
/** 非末级行点击=下钻;末级行点击=选中并收面板。 */
function pick(node: JdCategoryNode, depth: number): void {
if (node.children && node.children.length) {
activePath.value = [...activePath.value.slice(0, depth), node.name]
return
}
emit('change', node.name)
close()
}
function pickAll(): void {
emit('change', '')
close()
}
/** 搜索结果行点击(树内末级或树外兜底行)=按名选中。 */
function pickName(name: string): void {
emit('change', name)
close()
}
function clear(): void {
emit('change', '')
}
</script>
<template>
<div ref="hostRef" class="cat-cascader">
<button
class="cat-trigger"
type="button"
:class="{ open, filled: !!modelValue || !!groupId }"
@click="toggle"
>
<span class="cat-trigger-text" :title="modelValue || ''">{{ groups?.find(group => String(group.id) === groupId)?.name || modelValue || '全部类目' }}</span>
<span
v-if="modelValue || groupId"
class="cat-clear"
role="button"
aria-label="清除类目"
@click.stop="clear"
>×</span>
<span class="cat-chevron" aria-hidden="true"></span>
</button>
<!-- 面板外点透明遮罩关闭(零 document 监听器,无泄漏面)。 -->
<div v-if="open" class="cat-mask" @click="close"></div>
<div v-if="open" ref="panelRef" class="cat-panel" :style="{ left: `${panelOffsetX}px` }">
<div v-if="!treeOnly" class="cat-custom cat-col-custom">
<div class="cat-seg">自定义分类</div>
<form class="cat-create" @submit.prevent="createGroup">
<input v-model="newGroupName" class="cat-search" placeholder="新建分类" aria-label="新建分类名称" />
<button type="submit" :disabled="busy || !newGroupName.trim()">添加</button>
</form>
<div v-for="group in groups || []" :key="group.id" class="cat-row" :class="{ active: groupId === String(group.id) }">
<button type="button" class="cat-group-pick" :title="group.name" @click="pickGroup(group.id)">{{ group.name }}({{ group.productCount }})</button>
<button type="button" :aria-label="`删除分类 ${group.name}`" @click.stop="emit('delete-group', group.id)">删除</button>
</div>
</div>
<!-- 搜索态:树内末级命中+树外兜底段(扁平列表,行 title 带全路径)。 -->
<template v-if="searching">
<div class="cat-col cat-col-search">
<div class="cat-search-row"><input v-model="searchText" type="text" class="cat-search" placeholder="搜索类目" /></div>
<template v-if="searchLeaves.length || fallbackOptions.length">
<div
v-for="leaf in searchLeaves"
:key="`tree-${leaf.path.join('/')}`"
class="cat-row"
:class="{ active: modelValue === leaf.name }"
:title="leaf.path.join(' > ')"
@click="pickName(leaf.name)"
>
<span class="cat-dot" :class="{ on: modelValue === leaf.name }" aria-hidden="true"></span>
<span class="cat-name">{{ leaf.name }}</span>
<span class="cat-path">{{ leaf.path.slice(0, -1).join(' › ') }}</span>
</div>
<div v-if="fallbackOptions.length" class="cat-seg">已落库类目(树外历史)</div>
<div
v-for="option in fallbackOptions"
:key="`db-${option.name}`"
class="cat-row"
:class="{ active: modelValue === option.name }"
:title="option.name"
@click="pickName(option.name)"
>
<span class="cat-dot" :class="{ on: modelValue === option.name }" aria-hidden="true"></span>
<span class="cat-name">{{ option.name }}</span>
<span class="cat-count">{{ option.productCount }}</span>
</div>
</template>
<div v-else class="cat-empty">未找到类目</div>
</div>
</template>
<!-- 下钻态:逐级动态栏;首栏顶部「全部类目」行=清选。 -->
<template v-else>
<div
v-for="(col, depth) in columns"
:key="depth"
class="cat-col"
>
<div v-if="depth === 0" class="cat-search-row">
<input
v-model="searchText"
type="text"
class="cat-search"
placeholder="搜索类目"
@click.stop
/>
</div>
<div v-if="depth === 0" class="cat-row cat-row-all" :class="{ active: !modelValue }" @click="pickAll">
<span class="cat-dot" :class="{ on: !modelValue }" aria-hidden="true"></span>
<span class="cat-name">全部类目</span>
</div>
<div
v-for="node in col"
:key="`${depth}-${node.name}`"
class="cat-row"
:class="{ active: activePath[depth] === node.name || (depth === 0 && modelValue === node.name) }"
:title="node.name"
@click="pick(node, depth)"
>
<span class="cat-dot" aria-hidden="true"></span>
<span class="cat-name">{{ node.name }}</span>
<span v-if="node.children && node.children.length" class="cat-arrow" aria-hidden="true">›</span>
</div>
</div>
</template>
</div>
</div>
</template>
<style scoped>
.cat-custom { flex: none; width: 200px; max-height: 340px; overflow-y: auto; border-right: 1px solid #e7eef5; }
.cat-create { display: flex; gap: 4px; padding: 6px 8px; }
.cat-create input { min-width: 0; }
.cat-group-pick { flex: 1; min-width: 0; text-align: left; border: 0; background: transparent; color: inherit; cursor: pointer; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.cat-cascader {
position: relative;
min-width: 0;
}
/* 触发框像素对齐页面 .form-group select(42 高/9 圆角/#cbd9e6 边框/#f8fbfd 底)。 */
.cat-trigger {
display: flex;
align-items: center;
gap: 6px;
width: 100%;
min-height: 42px;
padding: 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
cursor: pointer;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.cat-trigger:hover {
border-color: #9fb7cd;
}
.cat-trigger.open,
.cat-trigger:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.cat-trigger-text {
flex: 1;
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
text-align: left;
}
.cat-trigger:not(.filled) .cat-trigger-text {
color: #8293a5;
}
.cat-clear {
flex: none;
width: 18px;
height: 18px;
display: flex;
align-items: center;
justify-content: center;
border-radius: 50%;
background: #e7eef5;
color: #5b6f83;
font-size: 13px;
line-height: 1;
}
.cat-clear:hover {
background: #dbe7f1;
color: #24384d;
}
/* 下拉箭头:CSS 三角(京麦同款向下 chevron,展开翻向上)。 */
.cat-chevron {
flex: none;
width: 0;
height: 0;
border-left: 5px solid transparent;
border-right: 5px solid transparent;
border-top: 6px solid #7b8a99;
transition: transform 160ms ease;
}
.cat-trigger.open .cat-chevron {
transform: rotate(180deg);
}
.cat-mask {
position: fixed;
inset: 0;
z-index: 2550;
}
.cat-panel {
position: absolute;
top: calc(100% + 4px);
left: 0;
z-index: 2560;
display: flex;
align-items: stretch;
max-width: min(820px, 90vw);
border: 1px solid #d8e3ee;
border-radius: 10px;
background: #ffffff;
box-shadow: 0 16px 44px rgba(39, 67, 94, 0.18);
overflow-x: auto;
overflow-y: hidden;
}
.cat-col {
flex: none;
width: 200px;
max-height: 340px;
overflow-y: auto;
padding: 6px 0;
border-right: 1px solid #e7eef5;
}
.cat-col:last-child {
border-right: 0;
}
.cat-col-search {
width: 300px;
}
/* 行=京麦同款:圆点 radio + 名称 + 右箭头;hover 浅蓝底。 */
.cat-row {
display: flex;
align-items: center;
gap: 8px;
padding: 8px 12px;
font-size: 13.5px;
color: #24384d;
cursor: pointer;
}
.cat-row:hover,
.cat-row.active {
background: #f1f7fb;
}
.cat-row.active {
color: #2f5d8b;
font-weight: 550;
}
.cat-dot {
flex: none;
width: 13px;
height: 13px;
border: 1px solid #c0ccda;
border-radius: 50%;
background: #ffffff;
}
/* radio 选中=京麦同款蓝芯。 */
.cat-dot.on {
border-color: #3b82c4;
background: radial-gradient(circle, #3b82c4 0 4px, #ffffff 4.6px);
}
.cat-name {
flex: 1;
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* 搜索态行尾的路径灰字(同名跨支时定位用)。 */
.cat-path {
flex: none;
max-width: 110px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: #9fb0c0;
font-size: 12px;
}
.cat-arrow {
flex: none;
color: #9fb0c0;
font-size: 15px;
line-height: 1;
}
.cat-count {
flex: none;
color: #8293a5;
font-size: 12px;
}
.cat-seg {
padding: 8px 12px 4px;
color: #8293a5;
font-size: 11.5px;
border-top: 1px solid #e7eef5;
}
.cat-search-row {
padding: 4px 8px 6px;
border-bottom: 1px solid #e7eef5;
}
.cat-search {
display: block;
width: 100%;
min-height: 30px;
padding: 4px 10px;
border: 1px solid #cbd9e6;
border-radius: 8px;
background: #f8fbfd;
color: #24384d;
font-size: 12.5px;
font-family: inherit;
outline: none;
}
.cat-search:focus {
background: #ffffff;
border-color: #5f85ad;
}
.cat-empty {
padding: 16px 12px;
color: #8293a5;
font-size: 12.5px;
text-align: center;
}
</style>
@@ -0,0 +1,454 @@
<script setup lang="ts">
/** 分类管理对话框(2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里,
* 做一个搜索和添加 删除 编辑 分类名称即可」):原 V204 独立子菜单页(JdCategoryManagerPage)
* 整体并入本对话框,从京东数据库页工具栏「分类管理」打开。
* 职责不变:当前数据权限分组的分类建/改名/删除+新增的名称搜索;商品归类不在这里
* (去「批量编辑分类」)。列表状态自管理(写操作后自刷新并 emit changed 让父页刷筛选下拉)。
* 权限口径(V203)不变:本组管理员/公司超管/平台超管可写(editable);同组普通号
* 只读可看(无新建行,改名/删除按钮逐行不渲染),后端同口径 403 兜底。 */
import { computed, ref, watch } from 'vue'
import {
createJdProductGroup,
deleteJdProductGroup,
fetchJdProductGroups,
updateJdProductGroup,
type JdProductGroup,
} from './jd-product-api.ts'
import { openAdminConfirm } from '@/components/admin-confirm'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { loadFailureMessage } from '@/components/load-failure-model'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
import { requestErrorMessage } from '../../api/envelope.ts'
const props = defineProps<{
visible: boolean
/** 当前数据权限分组(分类的作用域;<=0=不属于任何分组,只留空态)。 */
ownerGroupId: number
ownerGroupName: string
/** 当前分组可写(scope 的 editable):建/改名/删除控件全挂它。 */
editable: boolean
}>()
const emit = defineEmits<{ (event: 'close'): void; (event: 'changed'): void }>()
const loading = ref(false)
/** 首屏取数失败(可见红条+重试);写操作失败走 errorText 红条(无重试语义)。 */
const loadFailure = ref('')
const errorText = ref('')
const groups = ref<JdProductGroup[]>([])
/** 搜索:按分类名称包含过滤(本地过滤,不另发请求)。 */
const keyword = ref('')
/** 新建:只收名称(排序输入 2026-11-15 客户口径下线,sortOrder 恒 0,后端契约不变)。 */
const createName = ref('')
const creating = ref(false)
/** 改名:正在编辑的分类 id 与草稿名。 */
const editingId = ref(0)
const editingName = ref('')
const saving = ref(false)
const canCreate = computed(() => props.editable && createName.value.trim().length > 0 && !creating.value && !saving.value)
/** 搜索命中(名称包含,大小写不敏感;空关键字=全量)。 */
const filteredGroups = computed(() => {
const kw = keyword.value.trim().toLowerCase()
if (!kw) return groups.value
return groups.value.filter((group) => group.name.toLowerCase().includes(kw))
})
/** 空表文案分四种:不属于任何组 / 本组没分类(可管理)/ 本组没分类(只读)/ 搜索无命中。 */
const emptyListText = computed(() => {
if (props.ownerGroupId <= 0) return '你还不属于任何数据权限分组'
if (!groups.value.length) {
return props.editable ? '本组暂无分类,先新建一个' : '本组暂无分类'
}
return '没有匹配的分类'
})
async function loadGroups(): Promise<void> {
if (props.ownerGroupId <= 0) {
groups.value = []
loading.value = false
loadFailure.value = ''
errorText.value = ''
return
}
loading.value = true
loadFailure.value = ''
try {
groups.value = await fetchJdProductGroups(props.ownerGroupId)
} catch (error) {
loadFailure.value = loadFailureMessage(error, '分类列表加载失败')
groups.value = []
} finally {
loading.value = false
}
}
async function submitCreate(): Promise<void> {
const name = createName.value.trim()
if (!name || creating.value || !props.editable) return
creating.value = true
errorText.value = ''
try {
await createJdProductGroup({ name, sortOrder: 0, ownerGroupId: props.ownerGroupId })
createName.value = ''
keyword.value = ''
showAdminFeedback(`已新建分类「${name}」`, 'success')
emit('changed')
await loadGroups()
} catch (error) {
errorText.value = requestErrorMessage(error) || '新建分类失败'
} finally {
creating.value = false
}
}
function startRename(group: JdProductGroup): void {
editingId.value = group.id
editingName.value = group.name
errorText.value = ''
}
function cancelRename(): void {
editingId.value = 0
editingName.value = ''
}
async function submitRename(group: JdProductGroup): Promise<void> {
const name = editingName.value.trim()
if (!name || saving.value) return
saving.value = true
errorText.value = ''
try {
await updateJdProductGroup(group.id, { name, sortOrder: group.sortOrder })
groups.value = groups.value.map((item) => (item.id === group.id ? { ...item, name } : item))
cancelRename()
showAdminFeedback(`已把分类改名为「${name}」`, 'success')
emit('changed')
} catch (error) {
errorText.value = requestErrorMessage(error) || '改名失败'
} finally {
saving.value = false
}
}
/** 删除分类不删商品:只解挂本组归属行(商品回到未分类),后端 JdProductGroupService.delete。 */
async function removeGroup(group: JdProductGroup): Promise<void> {
const ok = await openAdminConfirm({ title: '删除分类', message: `确定删除分类「${group.name}」吗?删除后该分类下 ${group.productCount} 个商品回到未分类。`, confirmText: '确认删除', danger: true })
if (!ok || saving.value) return
saving.value = true
errorText.value = ''
try {
await deleteJdProductGroup(group.id)
showAdminFeedback(`已删除分类「${group.name}」`, 'success')
emit('changed')
await loadGroups()
} catch (error) {
errorText.value = requestErrorMessage(error) || '删除分类失败'
} finally {
saving.value = false
}
}
watch(
() => props.visible,
(visible) => {
if (visible) {
keyword.value = ''
errorText.value = ''
loadFailure.value = ''
cancelRename()
createName.value = ''
void loadGroups()
}
},
// immediate:对话框可能以 visible=true 直接挂载(测试/复用场景),这时也要首取。
{ immediate: true },
)
</script>
<template>
<div v-if="visible" class="modal-mask" @click.self="emit('close')">
<div class="manage-modal">
<div class="modal-head">
<h3>分类管理<span v-if="ownerGroupName" class="modal-sub">· {{ ownerGroupName }}</span></h3>
<button class="modal-close" type="button" aria-label="关闭" @click="emit('close')">×</button>
</div>
<p class="modal-tip">
分类按「数据权限分组」隔离,当前组{{ editable ? '只组长/超管可维护' : '由组长/超管维护' }};
给商品归类:关掉本框,勾选商品后点「批量编辑分类」。
</p>
<div class="manage-bar">
<input v-model="keyword" class="search-input" type="text" placeholder="搜索分类名称" aria-label="搜索分类名称" />
<div v-if="editable" class="group-create">
<input v-model="createName" type="text" placeholder="输入新分类名称" aria-label="新分类名称" @keyup.enter="submitCreate" />
<button class="btn" type="button" :disabled="!canCreate" @click="submitCreate">新建</button>
</div>
</div>
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="loadGroups" />
<p v-if="errorText" class="group-error">{{ errorText }}</p>
<ul class="option-list">
<template v-if="filteredGroups.length">
<li v-for="group in filteredGroups" :key="group.id" class="option-row">
<template v-if="editingId === group.id">
<input v-model="editingName" class="rename-input" type="text" aria-label="分类新名称" @keyup.enter="submitRename(group)" />
<span class="row-actions">
<button class="btn btn-sm" type="button" :disabled="saving" @click="submitRename(group)">保存</button>
<button class="btn btn-sm btn-secondary" type="button" @click="cancelRename">取消</button>
</span>
</template>
<template v-else>
<span class="option-name" :title="group.name">{{ group.name }}</span>
<span class="option-meta" title="该分类下的商品数">{{ group.productCount }}</span>
<span v-if="editable" class="row-actions">
<button class="btn btn-sm btn-secondary" type="button" :disabled="saving" @click="startRename(group)">改名</button>
<button class="btn btn-sm btn-danger" type="button" :disabled="saving" @click="removeGroup(group)">删除</button>
</span>
</template>
</li>
</template>
<li v-else-if="loading" class="manage-empty">加载中...</li>
<li v-else class="manage-empty">{{ emptyListText }}</li>
</ul>
<div class="modal-foot">
<button class="btn btn-secondary" type="button" @click="emit('close')">关闭</button>
</div>
</div>
</div>
</template>
<style scoped>
.modal-mask {
position: fixed;
inset: 0;
z-index: 2800;
display: flex;
align-items: center;
justify-content: center;
padding: 40px 20px;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(6px);
}
.manage-modal {
display: flex;
flex-direction: column;
width: min(480px, 100%);
max-height: 80vh;
padding: 18px 20px 20px;
border: 1px solid #c7d7e5;
border-radius: 14px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(39, 67, 94, 0.2);
}
.modal-head {
display: flex;
align-items: center;
justify-content: space-between;
}
.modal-head h3 {
margin: 0;
font-size: 15px;
font-weight: 650;
color: #24384d;
}
.modal-sub {
margin-left: 6px;
color: #5b6f83;
font-size: 13px;
font-weight: 500;
}
.modal-close {
width: 30px;
height: 30px;
border: 1px solid transparent;
border-radius: 9px;
background: none;
color: #5b6f83;
font-size: 20px;
line-height: 1;
cursor: pointer;
}
.modal-close:hover {
border-color: #cbd9e6;
background: #eef4fa;
color: #24384d;
}
.modal-tip {
margin: 8px 0 10px;
color: #8293a5;
font-size: 12.5px;
line-height: 1.5;
}
.manage-bar {
display: flex;
flex-wrap: wrap;
gap: 8px;
align-items: center;
margin-bottom: 12px;
}
.search-input,
.group-create input {
min-height: 36px;
padding: 6px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13px;
font-family: inherit;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.search-input:hover,
.group-create input:hover {
border-color: #9fb7cd;
}
.search-input:focus,
.group-create input:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.search-input {
flex: 1;
min-width: 140px;
}
.group-create {
display: flex;
flex: 1;
gap: 8px;
min-width: 220px;
}
.group-create input {
flex: 1;
min-width: 0;
}
.group-error {
margin: 0 0 8px;
padding: 10px 12px;
border: 1px solid #f0c9c2;
border-radius: 10px;
background: #fdf1ef;
color: #a04432;
font-size: 13px;
}
.option-list {
flex: 1;
min-height: 0;
overflow-y: auto;
margin: 0;
padding: 0;
list-style: none;
border-top: 1px solid #e7eef5;
}
.option-row {
display: flex;
align-items: center;
gap: 10px;
padding: 9px 8px;
border-bottom: 1px solid #e7eef5;
font-size: 13.5px;
}
.option-row:hover {
background: #f1f7fb;
}
.option-name {
flex: 1;
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: #24384d;
}
.option-meta {
flex: none;
min-width: 22px;
padding: 1px 7px;
border-radius: 9px;
background: #eef4fa;
color: #4e6479;
font-size: 12px;
text-align: center;
white-space: nowrap;
}
.row-actions {
flex: none;
white-space: nowrap;
}
.manage-empty {
padding: 30px 12px;
text-align: center;
color: #8293a5;
font-size: 13px;
list-style: none;
}
.rename-input {
flex: 1;
min-width: 0;
min-height: 32px;
padding: 4px 10px;
border: 1px solid #cbd9e6;
border-radius: 8px;
font-size: 13.5px;
font-family: inherit;
outline: none;
}
.rename-input:focus {
background: #ffffff;
border-color: #5f85ad;
}
.modal-foot {
display: flex;
justify-content: flex-end;
gap: 10px;
margin-top: 14px;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 36px;
padding: 6px 14px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13px;
cursor: pointer;
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.55;
}
.btn-sm {
min-height: 28px;
padding: 3px 10px;
font-size: 12.5px;
margin-right: 6px;
}
.btn-sm:last-child {
margin-right: 0;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border-color: #c7d7e5;
}
.btn-secondary:hover:not(:disabled) {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
/* 危险动作与全站 .btn-danger 同形(实心红渐变+白字)。 */
.btn-danger {
background: linear-gradient(135deg, #c06d77, #b35f6a);
border-color: #b35f6a;
color: #ffffff;
}
.btn-danger:hover:not(:disabled) {
background: linear-gradient(135deg, #cb7c84, #b96570);
}
</style>
@@ -0,0 +1,526 @@
<script setup lang="ts">
/** 京东公共商品库:支持分类和京麦类目组合筛选。
* V203(2026-11-16 用户口径):分类按「数据权限分组」隔离——不同组看不到彼此的分类,
* 能看多组的人用筛选行「分组」下拉切换当前组(只有一组时锁定显示)。
* 2026-11-17 用户口径:店铺分类弹窗下线,本页工具栏改「批量编辑分类」——勾选商品
* (翻页累计记忆)后选目标分类归入或移出;同日第二刀「京东分类管理并到京东数据库分类
* 编辑里」:V204 独立子菜单页(JdCategoryManagerPage)下线,建/改名/删分类收进工具栏
* 「分类管理」对话框(JdCategoryManageDialog,带名称搜索)。 */
import { computed, onMounted, reactive, ref } from 'vue'
import {
deleteJdProducts,
fetchJdCategoryScope,
fetchJdProductCategories,
fetchJdProductGroups,
fetchJdProductList,
type JdCategoryGroupOption,
type JdProductCategoryOption,
type JdProductGroup,
} from './jd-product-api.ts'
import type { JdProductItem } from './jd-product-model.ts'
import { jdPriceRange } from './jd-product-model.ts'
import { createJdProductFilterState } from './jd-product-filter.ts'
import JdProductDetailDrawer from './JdProductDetailDrawer.vue'
import JdProductEditDrawer from './JdProductEditDrawer.vue'
import JdCategoryCascader from './JdCategoryCascader.vue'
import JdBatchAssignDialog from './JdBatchAssignDialog.vue'
import JdCategoryManageDialog from './JdCategoryManageDialog.vue'
import OldPagination from '@/components/OldPagination.vue'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { openAdminConfirm } from '@/components/admin-confirm'
import { loadFailureMessage } from '@/components/load-failure-model'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { formatDateTime, orderedPair } from '@/utils/datetime'
/** 写权限口径(2026-11-16 用户口径):商品行写(编辑/删除/勾选批量删)只对平台超级管理员渲染;
* 分类写(建/改名/删除、归类)由 scope 的每组 editable 决定(本组管理员/公司超管/平台超管)。 */
const session = useAdminSessionStore()
const isSuperAdmin = computed(() => session.isSuperAdmin)
const loading = ref(false)
const loadFailure = ref('')
const rows = ref<JdProductItem[]>([])
const total = ref(0)
const page = ref(1)
const pageSize = ref(20)
const filter = reactive(createJdProductFilterState())
/** 分类作用域(V203):可见分组 + 每组可写标记。失败静默回空作用域(分类列全空但商品照常)。 */
const categoryScope = ref<JdCategoryGroupOption[]>([])
const scopeDefaultGroupId = ref(0)
/** 当前分组(数据权限分组 id):分类列/分类筛选/分类管理的共同作用域。 */
const ownerGroupId = ref(0)
/** 当前分组的分类下拉选项(按 ownerGroupId 取,切组即换)。 */
const groupOptions = ref<JdProductGroup[]>([])
/** 类目下拉选项(京麦末级类目):与当前行集同源(公共库全量);失败静默回空。 */
const categoryOptions = ref<JdProductCategoryOption[]>([])
const detailItem = ref<JdProductItem | null>(null)
const detailVisible = ref(false)
/** 批量编辑分类对话框(2026-11-17 替代下线的店铺分类弹窗)。 */
const batchEditVisible = ref(false)
/** 分类管理对话框(2026-11-17 第二刀:独立子菜单页并进来,建/改名/删+搜索)。 */
const manageVisible = ref(false)
/** 行级编辑抽屉(2026-11-15 用户口径「每一条数据后面 需要编辑或者删除;编辑的话
* 这里面都是可以编辑的」):删除走下面的 removeOne(同一条删除链),编辑走独立抽屉。 */
const editItem = ref<JdProductItem | null>(null)
const editVisible = ref(false)
/** 当前分组的下拉项(带 editable)——分类写入口与「店铺分类」弹窗的可管理档都读它。 */
const currentGroupOption = computed<JdCategoryGroupOption | null>(() =>
categoryScope.value.find((group) => group.id === ownerGroupId.value) || null)
const currentGroupName = computed(() => currentGroupOption.value?.name || '')
/** 分类可管理(建/改名/删除/归类):本组管理员、公司超管、平台超管(后端 scope 判)。 */
const canManageCategories = computed(() => currentGroupOption.value?.editable === true)
/** 勾选列服务两类写:批量删除(只超管)+批量编辑分类(本组可写分类的管理员也要勾)。
* 2026-11-17 弹窗下线后管理员失去弹窗右栏的勾选面 ⇒ 勾选列必须对「本组可写」放开,
* 否则本组管理员没有归类入口。商品行按钮(编辑/删除/删除勾选)仍只归平台超管。 */
const hasSelectionColumn = computed(() => isSuperAdmin.value || canManageCategories.value)
/** 空态行 colspan:勾选列有无决定 5/6/7 列三种形状(超管含操作列)。 */
const emptyColspan = computed(() => (isSuperAdmin.value ? 7 : hasSelectionColumn.value ? 6 : 5))
/** 分组下拉只在能看多组时才渲染;只有一组(含无可见组)时按锁定态展示。 */
const canSwitchGroup = computed(() => categoryScope.value.length > 1)
function openEdit(item: JdProductItem): void {
editItem.value = item
editVisible.value = true
}
function closeEdit(): void {
editVisible.value = false
editItem.value = null
}
/** 编辑保存成功:刷新列表(该行已置人工编辑锁,标题/价格等即时可见且不再被采集覆盖)。 */
async function onEditSaved(): Promise<void> {
await load()
}
/** min/max 挡不住手输,落值后把倒挂的起止交换回来。 */
function clampJdSyncedRange(): void {
const [s, e] = orderedPair(filter.syncedFrom, filter.syncedTo)
filter.syncedFrom = s
filter.syncedTo = e
}
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
/** 作用域 → 分组列表 → 该组分类:失败一律静默降级(分类只是筛选/归类面,不拦首屏行集)。 */
async function loadCategoryScope(): Promise<void> {
try {
const scope = await fetchJdCategoryScope()
categoryScope.value = scope.groups
scopeDefaultGroupId.value = scope.defaultGroupId ?? 0
} catch {
categoryScope.value = []
scopeDefaultGroupId.value = 0
}
// 当前分组:保留用户已选(仍可见时),否则回默认(可见组第一项)。
const keep = categoryScope.value.some((group) => group.id === ownerGroupId.value)
if (!keep) ownerGroupId.value = scopeDefaultGroupId.value
await loadGroupOptions()
}
/** 当前分组的分类选项:按 ownerGroupId 取(跨组不可见);失败静默回空下拉。 */
async function loadGroupOptions(): Promise<void> {
try {
groupOptions.value = await fetchJdProductGroups(ownerGroupId.value)
} catch {
groupOptions.value = []
}
}
/** 类目选项同分组口径:失败静默回空下拉(可见「全部类目」),不拦首屏行集。 */
async function loadCategoryOptions(): Promise<void> {
try {
categoryOptions.value = await fetchJdProductCategories()
} catch {
categoryOptions.value = []
}
}
/** 切换「分组」下拉:分类筛选(属于上一组的分类)清空,分类选项换成本组,回第一页重取。
* 勾选集是按商品 id 记的(跨页累计),切组不清——归类的落点组随 ownerGroupId 走,
* 误跨组批量归类由批量对话框里的组名标注防住。 */
async function changeOwnerGroup(next: number): Promise<void> {
if (next === ownerGroupId.value) return
ownerGroupId.value = next
filter.groupId = ''
await loadGroupOptions()
page.value = 1
await load()
}
/** 打开批量编辑分类:先刷一遍当前组分类(商品数徽标要新鲜),再亮对话框。 */
async function openBatchEdit(): Promise<void> {
await loadGroupOptions()
batchEditVisible.value = true
}
/** 打开分类管理(对话框自取列表);入口对所有人渲染——同组普通号只读可看(V203),
* 写控件由对话框按 editable 分档。 */
function openManage(): void {
manageVisible.value = true
}
/** 分类管理里有写操作(建/改/删):刷一遍筛选下拉与商品数徽标。 */
async function onManaged(): Promise<void> {
await loadGroupOptions()
}
/** 批量归类完成(对话框已关):清勾选+重取列表(行集 groupName 变了)。
* 移出分类 targetName 为 null;updated 是后端实际写入/解挂的归属行数。 */
async function onBatchAssigned(updated: number, targetName: string | null): Promise<void> {
showAdminFeedback(
targetName ? `已把 ${updated} 个商品归入「${targetName}」` : `已把 ${updated} 个商品移出分类`,
'success',
)
selectedIds.value = new Set()
await load()
}
async function load(): Promise<void> {
loading.value = true
loadFailure.value = ''
try {
const result = await fetchJdProductList({
page: page.value,
pageSize: pageSize.value,
productCode: filter.productCode,
titleKeyword: filter.titleKeyword,
category: filter.category,
groupId: filter.groupId,
ownerGroupId: ownerGroupId.value,
syncedFrom: filter.syncedFrom,
syncedTo: filter.syncedTo,
})
rows.value = result.items
total.value = result.total
if (result.page >= 1) page.value = result.page
// 勾选跨页记忆(2026-11-17 用户口径「支持勾选翻页也要记住」):翻页/重取/改筛选都
// 不清勾选集——批量编辑分类与批量删除都按累计 id 提交,操作前的确认弹窗点名数量;
// 「清除勾选」按钮同日用户口径删除,勾选只在批量操作成功后自动清。
} catch (error) {
loadFailure.value = loadFailureMessage(error, '京东商品列表加载失败')
showAdminFeedback(loadFailure.value, 'error')
} finally {
loading.value = false
}
}
function apply(): void {
page.value = 1
void load()
}
/** 类目级联面板点末级即查:选完立刻按该类目过滤刷新(回第一页),同分组下拉口径;
* 点「全部类目」/触发框 × = 清选重查。 */
function onCategoryPicked(name: string): void {
filter.category = name
apply()
}
/** 重置:筛选面回出厂空态,回第一页重取。 */
function reset(): void {
Object.assign(filter, createJdProductFilterState())
page.value = 1
void load()
}
function changePage(next: number): void {
if (next < 1 || next > totalPages.value) return
page.value = next
void load()
}
function changeSize(size: number) {
pageSize.value = size
page.value = 1
void load()
}
function openDetail(item: JdProductItem): void {
detailItem.value = item
detailVisible.value = true
}
function closeDetail(): void {
detailVisible.value = false
detailItem.value = null
}
/** 商品编码一键复制(京麦同款 ⧉):@click.stop 防冒泡开抽屉;剪贴板不可用(非安全上下文)时弹失败文案。 */
async function copyText(text: string): Promise<void> {
if (!text) return
try {
await navigator.clipboard.writeText(text)
showAdminFeedback(`已复制 ${text}`, 'success')
} catch {
showAdminFeedback('复制失败,请手动选择复制', 'error')
}
}
// ---------------- 删除(先删桶、全成功才删库行,语义在后端 JdProductDeleteService) ----------------
/** 勾选集(按商品 id,跨页累计记忆,2026-11-17 用户口径)。翻页/重取不清;显式出口
* 曾是工具栏「清除勾选」,同日用户口径「清除勾选这个按钮删除」后只剩批量删除/
* 批量归类成功后自动清。 */
const selectedIds = ref<Set<number>>(new Set())
const deleting = ref(false)
const selectedCount = computed(() => selectedIds.value.size)
function toggleSelect(row: JdProductItem, checked: boolean): void {
const next = new Set(selectedIds.value)
if (checked) next.add(row.id)
else next.delete(row.id)
selectedIds.value = next
}
const allSelected = computed(() => rows.value.length > 0 && rows.value.every((row) => selectedIds.value.has(row.id)))
function toggleSelectAll(checked: boolean): void {
const next = new Set(selectedIds.value)
for (const row of rows.value) {
if (checked) next.add(row.id)
else next.delete(row.id)
}
selectedIds.value = next
}
/** 单行删除入口(行内按钮):确认弹窗点名商品编码与「桶内图片一并删除」。 */
async function removeOne(row: JdProductItem): Promise<void> {
await removeMany([row.id], `确定删除商品「${row.productCode || row.title}」吗?`)
}
/** 批量删除入口(工具栏按钮):按累计勾选 id 直删(跨页的行也在内),确认弹窗点名总数。 */
async function removeSelected(): Promise<void> {
await removeMany([...selectedIds.value], `确定删除勾选的 ${selectedIds.value.size} 个商品吗?`)
}
/** 删除主流程:二次确认 → 先删桶、全成功才删库行(后端保证)→ 刷新列表并清勾选。 */
async function removeMany(ids: number[], message: string): Promise<void> {
if (!ids.length || deleting.value) return
const ok = await openAdminConfirm({ title: '删除京东商品', message: `${message}删除后该商品的 SKU、图片登记与 jd-products 桶内图片文件一并删除(被其他商品共用的图片会保留);此操作不可恢复。`, confirmText: '确认删除', danger: true })
if (!ok) return
deleting.value = true
try {
const receipt = await deleteJdProducts(ids)
showAdminFeedback(`已删除 ${receipt.deleted} 个商品,清理 ${receipt.objectsDeleted} 个图片文件` +
(receipt.objectsKept ? `(${receipt.objectsKept} 个共用图片保留)` : ''), 'success')
selectedIds.value = new Set()
if (ids.length >= rows.value.length && page.value > 1) page.value -= 1
await load()
} catch (error) {
const text = error instanceof Error && error.message ? error.message : '删除失败,请稍后重试'
showAdminFeedback(text, 'error')
} finally {
deleting.value = false
}
}
onMounted(async () => {
// 先解析作用域再取列表:首屏的 owner_group_id 必须与分类下拉同一个组(铁律 30 同形——
// 不要先发一条不带 owner_group_id 的列表请求再补,两次请求会落在不同默认组上)。
await loadCategoryScope()
void loadCategoryOptions()
await load()
})
</script>
<template>
<div class="jd-database-view">
<section class="panel-box">
<div class="jd-panel-head">
<h3>京东数据库</h3>
</div>
<div class="jd-filter-row">
<div class="form-group">
<label>商品编码</label>
<input v-model="filter.productCode" type="text" placeholder="输入商品编码" @keyup.enter="apply" />
</div>
<div class="form-group">
<label>标题关键字</label>
<input v-model="filter.titleKeyword" type="text" placeholder="输入标题关键字" @keyup.enter="apply" />
</div>
<div class="form-group">
<label>类目</label>
<!-- 类目(京麦末级类目)京麦同款级联面板(2026-11-16 客户口径):一/二级为静态导航
(采集链无层级数据),第三栏已落库末级+搜索,点行选中即查(回第一页)。 -->
<JdCategoryCascader
:options="categoryOptions"
:model-value="filter.category"
tree-only
@change="onCategoryPicked"
/>
</div>
<div v-if="categoryScope.length" class="form-group">
<label>分组</label>
<!-- 当前分组(V203):能看多组的人(平台超管/公司超管)下拉切换;只有一组时锁定显示组名。
2026-11-16 用户口径「做成分组」:从工具栏裸下拉上移进筛选行,做成带标签的表单控件
(与其他筛选同壳同圆角)。分组是分类列/分类筛选/分类管理的作用域,不是筛选条件
⇒ 放在筛选行也只是占位,「重置」不清它(挂载测试钉住)。 -->
<select
v-if="canSwitchGroup"
:value="ownerGroupId"
aria-label="当前分组"
@change="changeOwnerGroup(Number(($event.target as HTMLSelectElement).value))"
>
<option v-for="group in categoryScope" :key="group.id" :value="group.id">{{ group.label }}</option>
</select>
<span v-else class="jd-group-locked" title="你的数据权限内只有这一个分组">{{ currentGroupName }}</span>
</div>
<div class="form-group">
<label>同步开始日期</label>
<input v-model="filter.syncedFrom" type="date" :max="filter.syncedTo" @change="clampJdSyncedRange" />
</div>
<div class="form-group">
<label>同步结束日期</label>
<input v-model="filter.syncedTo" type="date" :min="filter.syncedFrom" @change="clampJdSyncedRange" />
</div>
<div class="jd-filter-actions">
<button class="btn" type="button" @click="apply">查询</button>
<button class="btn btn-secondary" type="button" @click="reset">重置</button>
</div>
</div>
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<div class="jd-toolbar">
<span class="jd-summary">共 {{ total }} 条京东商品</span>
<!-- 批量编辑分类(2026-11-17 用户口径「店铺分类弹窗删了,加个批量编辑分类」):
只对当前分组可写档(本组管理员/公司超管/平台超管)渲染;勾选 0 时置灰(与
删除勾选同款常显口径),打开后按累计勾选(跨页)提交归入/移出。 -->
<button
v-if="canManageCategories"
class="btn btn-secondary"
type="button"
:disabled="!selectedCount"
@click="openBatchEdit"
>批量编辑分类</button>
<!-- 商品行写只对平台超管;分类写由当前分组 editable 决定(本组管理员/公司超管/平台超管)。
非超管看到只读提示,分类维护入口=工具栏「分类管理」(只读可看,写控件按 editable 分档)。 -->
<span v-if="!isSuperAdmin" class="jd-readonly-tip">只读:编辑/删除仅超级管理员可用;分类在本页「分类管理」查看与维护</span>
<select v-model="filter.groupId" aria-label="筛选店铺分类" @change="apply">
<option value="">全部分类</option>
<option v-for="group in groupOptions" :key="group.id" :value="String(group.id)">{{ group.name }}</option>
</select>
<!-- 分类管理(2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里」):V204 独立
子菜单页整体并入本对话框(搜索+新建+改名+删除)。入口对所有人渲染(同组普通号
只读可看,V203),写控件由对话框按当前分组 editable 分档。 -->
<button
class="btn btn-secondary jd-manage-btn"
type="button"
@click="openManage"
>分类管理</button>
<!-- 批量删除 2026-11-16 客户口径「不要勾选后才显示」:常显,勾选 0 时置灰。
同日写权限收窄到超管:非超管整颗按钮不渲染(勾选列 2026-11-17 起对本组可写
分类管理员开放,服务批量归类)。 -->
<button
v-if="isSuperAdmin"
class="btn btn-danger jd-delete-btn"
type="button"
:disabled="deleting || !selectedCount"
@click="removeSelected"
>
{{ deleting ? '删除中...' : `删除勾选(${selectedCount})` }}
</button>
</div>
<div class="table-scroll jd-table-scroll">
<table>
<thead>
<tr>
<th v-if="hasSelectionColumn" style="width: 42px"><input type="checkbox" :checked="allSelected" @change="toggleSelectAll(($event.target as HTMLInputElement).checked)" /></th>
<th style="width: 92px">分类</th>
<th style="width: 520px">商品信息</th>
<th style="width: 76px">总库存</th>
<th style="width: 120px">价格</th>
<!-- 同步时间收尾(创建/修改两列 2026-11-16 客户口径「不要」下线,仍收详情抽屉);
操作列 2026-11-16「操作放最后一列」口径置末;同日写权限收窄到超管 ⇒ 非超管不渲染。 -->
<th style="width: 170px">同步时间</th>
<th v-if="isSuperAdmin" style="width: 138px">操作</th>
</tr>
</thead>
<tbody>
<template v-if="rows.length">
<tr v-for="row in rows" :key="row.id" class="jd-row" @click="openDetail(row)">
<td v-if="hasSelectionColumn" @click.stop><input type="checkbox" :checked="selectedIds.has(row.id)" @change="toggleSelect(row, ($event.target as HTMLInputElement).checked)" /></td>
<td :title="row.groupName || ''">{{ row.groupName || '未分类' }}</td>
<td class="jd-info-cell">
<div class="jd-info-wrap">
<div class="jd-info-figure">
<img v-if="row.mainImageUrl" class="jd-thumb" :src="row.mainImageUrl" alt="" loading="lazy" />
<span v-else class="jd-thumb jd-thumb-empty">无图</span>
<span v-if="row.healthScore !== null" class="jd-health">信息分 {{ row.healthScore }}</span>
</div>
<div class="jd-info-body">
<div class="jd-info-title" :title="row.title">{{ row.title || '-' }}</div>
<div class="jd-info-meta">
商品编码:<span class="jd-info-code">{{ row.productCode || '-' }}</span>
<button v-if="row.productCode" class="jd-copy-btn" type="button" title="复制商品编码" @click.stop="copyText(row.productCode)">⧉</button>
</div>
<div class="jd-info-meta">货号:<span class="jd-info-code">{{ row.itemNum || '-' }}</span></div>
<!-- 品牌·类目行:京麦列表同款(末级类目名紧随品牌),字段与顺序 2026-11-15 对齐京麦。 -->
<div v-if="row.brand || row.categoryPath" class="jd-info-meta jd-brand-cat">
<span class="jd-brand-name">{{ row.brand || '' }}</span>&nbsp;{{ row.categoryPath || '' }}
</div>
<div v-if="row.skuCount" class="jd-info-tags"><span class="jd-tag">{{ row.skuCount }}个SKU</span></div>
</div>
</div>
</td>
<td>{{ row.stockTotal ?? '-' }}</td>
<td>{{ jdPriceRange(row) || '-' }}</td>
<td>{{ formatDateTime(row.syncedAt || '') }}</td>
<!-- 操作列(2026-11-15 用户口径):编辑/删除;@click.stop 防冒泡开详情抽屉。
2026-11-16「操作放最后一列」口径置末;「上架时间 / 商品状态」列同日整列下线;
同日写权限收窄到超管 ⇒ 非超管不渲染该列。 -->
<td v-if="isSuperAdmin" class="jd-ops-cell" @click.stop>
<button class="btn btn-sm" type="button" @click="openEdit(row)">编辑</button>
<button class="btn btn-sm btn-danger" type="button" :disabled="deleting" @click="removeOne(row)">删除</button>
</td>
</tr>
</template>
<tr v-else-if="loading">
<td :colspan="emptyColspan" class="empty-tip">加载中...</td>
</tr>
<tr v-else>
<td :colspan="emptyColspan" class="empty-tip">暂无京东商品数据</td>
</tr>
</tbody>
</table>
</div>
<OldPagination :total="total" :page="page" :page-size="pageSize" @change="changePage" @size-change="changeSize" />
</section>
<JdBatchAssignDialog
:visible="batchEditVisible"
:owner-group-id="ownerGroupId"
:owner-group-name="currentGroupName"
:categories="groupOptions"
:selected-ids="[...selectedIds]"
@close="batchEditVisible = false"
@done="onBatchAssigned"
/>
<JdCategoryManageDialog
:visible="manageVisible"
:owner-group-id="ownerGroupId"
:owner-group-name="currentGroupName"
:editable="canManageCategories"
@close="manageVisible = false"
@changed="onManaged"
/>
<JdProductDetailDrawer
:item="detailItem"
:visible="detailVisible"
@close="closeDetail"
/>
<JdProductEditDrawer
:item="editItem"
:visible="editVisible"
@close="closeEdit"
@saved="onEditSaved"
/>
</div>
</template>
<style scoped src="./jd-database-page.css"></style>
@@ -0,0 +1,685 @@
<script setup lang="ts">
/** 京东商品详情抽屉(v1.4 Phase 5):点行打开,展示基本信息 + attrGroups 分块表格 +
* 图片网格(MAIN/ATTR/DETAIL 三区,attr 图按 attrName 归并)。
* 基本信息=商品全部字段(B104:列表只摆部分字段,类目/信息分/SKU 数/上架时间/京东创建/
* 修改时间/店铺/分组都在这里看)。
* 图片点击放大预览用自绘 modal-mask(先例:RecordsHistoryPage 的 thumb + modal-mask +
* 原图新标签;不用 element-plus)。数据由本组件按 id 自取(公共库无公司维度),失败条内提示可重试。 */
import { computed, ref, watch } from 'vue'
import { fetchJdProductDetail } from './jd-product-api.ts'
import type {
JdProductImage,
JdProductItem,
JdProductAttrGroup,
JdProductSku,
} from './jd-product-model.ts'
import { jdPriceRange, jdSkuDimensions, jdSkuSummary } from './jd-product-model.ts'
import { formatDateTime } from '@/utils/datetime'
import { requestErrorMessage } from '../../api/envelope.ts'
const props = defineProps<{
item: JdProductItem | null
visible: boolean
}>()
const emit = defineEmits<{ (event: 'close'): void }>()
const loading = ref(false)
const loadFailure = ref('')
const attrGroups = ref<JdProductAttrGroup[]>([])
const images = ref<JdProductImage[]>([])
const skus = ref<JdProductSku[]>([])
const attrJsonRaw = ref('')
/** SKU 矩阵维度(京麦「颜色 / 尺码」两列)与表头汇总。 */
const skuDimensions = computed(() => jdSkuDimensions(skus.value))
const skuSummary = computed(() => jdSkuSummary(skus.value))
function skuAttrValue(sku: JdProductSku, dimension: string): string {
return sku.saleAttrs.find((attr) => attr.name === dimension)?.value || '-'
}
/** 图片三区:MAIN / ATTR / DETAIL;未知类型归 DETAIL 之外的「其他」,不丢。 */
const mainImages = computed(() => images.value.filter((image) => image.imageType === 'MAIN'))
/** 顶部画廊(2026-11-16 客户口径「详情页样式和京麦商品详情一样」=左图右信息):
* 左侧主图大图+缩略图切换(MAIN 档),右侧关键信息。 */
const galleryImages = computed(() => mainImages.value)
const activeImageUrl = ref('')
function switchGallery(image: JdProductImage): void {
activeImageUrl.value = image.url
}
const attrImageGroups = computed(() => {
const buckets = new Map<string, JdProductImage[]>()
for (const image of images.value) {
if (image.imageType !== 'ATTR') continue
const key = image.attrName || '属性图'
const bucket = buckets.get(key)
if (bucket) bucket.push(image)
else buckets.set(key, [image])
}
return [...buckets.entries()].map(([attrName, list]) => ({ attrName, list }))
})
const detailImages = computed(() => images.value.filter((image) => image.imageType === 'DETAIL'))
const otherImages = computed(() =>
images.value.filter((image) => image.imageType !== 'MAIN' && image.imageType !== 'ATTR' && image.imageType !== 'DETAIL'),
)
/** 放大预览:点缩略图弹自绘 modal-mask,原图可新标签打开。 */
const previewVisible = ref(false)
const previewUrl = ref('')
function openPreview(url: string): void {
previewUrl.value = url
previewVisible.value = true
}
function close(): void {
previewVisible.value = false
emit('close')
}
async function loadDetail(): Promise<void> {
const item = props.item
if (!item) return
loading.value = true
loadFailure.value = ''
attrGroups.value = []
images.value = []
skus.value = []
attrJsonRaw.value = ''
try {
const detail = await fetchJdProductDetail(item.id)
attrGroups.value = detail.attrGroups
images.value = detail.images
skus.value = detail.skus
attrJsonRaw.value = detail.attrJsonRaw
activeImageUrl.value = detail.images.find((image) => image.imageType === 'MAIN')?.url || ''
if (!detail.attrGroups.length && detail.attrJsonRaw) {
// 结构化解析失败但原文在:兜底展示原文,不静默吞
loadFailure.value = ''
}
} catch (error) {
loadFailure.value = requestErrorMessage(error) || '商品详情加载失败'
} finally {
loading.value = false
}
}
watch(
() => [props.visible, props.item?.id] as const,
([visible]) => {
previewVisible.value = false
previewUrl.value = ''
activeImageUrl.value = ''
if (visible && props.item) void loadDetail()
},
)
function dash(value: string | number | null | undefined): string {
const text = value === null || value === undefined ? '' : String(value).trim()
return text || '-'
}
</script>
<template>
<div v-if="visible" class="drawer-mask" @click.self="close">
<aside class="drawer">
<header class="drawer-head">
<h3>商品详情{{ item?.productCode ? ` · ${item.productCode}` : '' }}</h3>
<button class="drawer-close" type="button" aria-label="关闭" @click="close">×</button>
</header>
<div class="drawer-body">
<div v-if="loadFailure" class="drawer-failure">
<span>{{ loadFailure }}</span>
<button class="btn btn-secondary" type="button" @click="loadDetail">重试</button>
</div>
<p v-else-if="loading" class="drawer-tip">加载中...</p>
<template v-else>
<!-- 顶部「左图右信息」(2026-11-16 客户口径「详情页的样式要和京麦商品详情一样的布局样式」):
左侧主图大图+缩略图切换,右侧关键信息;属性/SKU/详情图等区块保持下方。 -->
<section class="detail-block">
<div class="detail-hero">
<div class="hero-gallery">
<img
v-if="activeImageUrl"
class="hero-main"
:src="activeImageUrl"
alt=""
title="点击放大预览"
@click="openPreview(activeImageUrl)"
/>
<div v-else class="hero-empty">无图</div>
<div v-if="galleryImages.length > 1" class="hero-thumbs">
<img
v-for="image in galleryImages"
:key="image.id"
:src="image.url"
alt=""
loading="lazy"
:class="{ active: image.url === activeImageUrl }"
title="切换主图"
@click="switchGallery(image)"
/>
</div>
</div>
<dl class="hero-info">
<div class="info-item info-item-wide hero-title">
<dt>标题</dt>
<dd :title="item?.title || ''">{{ dash(item?.title) }}</dd>
</div>
<div class="info-item"><dt>价格区间</dt><dd>{{ dash(jdPriceRange(item ?? { priceMin: '', priceMax: '' })) }}</dd></div>
<div class="info-item"><dt>总库存</dt><dd>{{ dash(item?.stockTotal) }}</dd></div>
<div class="info-item"><dt>状态</dt><dd>{{ dash(item?.saleStatus) }}</dd></div>
<div class="info-item"><dt>信息分</dt><dd>{{ dash(item?.healthScore) }}</dd></div>
<div class="info-item"><dt>SKU 数</dt><dd>{{ dash(item?.skuCount) }}</dd></div>
<div class="info-item"><dt>商品编码</dt><dd>{{ dash(item?.productCode) }}</dd></div>
<div class="info-item"><dt>货号</dt><dd>{{ dash(item?.itemNum) }}</dd></div>
<div class="info-item"><dt>SKU</dt><dd>{{ dash(item?.skuId) }}</dd></div>
<div class="info-item"><dt>品牌</dt><dd>{{ dash(item?.brand) }}</dd></div>
<div class="info-item"><dt>店铺</dt><dd :title="item?.shopName || ''">{{ dash(item?.shopName) }}</dd></div>
<div class="info-item"><dt>分类</dt><dd>{{ dash(item?.groupName || '未分类') }}</dd></div>
<div class="info-item info-item-wide"><dt>类目</dt><dd :title="item?.categoryPath || ''">{{ dash(item?.categoryPath) }}</dd></div>
<div class="info-item"><dt>上架时间</dt><dd>{{ item?.jdOnlineAt ? formatDateTime(item.jdOnlineAt) : '-' }}</dd></div>
<div class="info-item"><dt>同步时间</dt><dd>{{ formatDateTime(item?.syncedAt || '') }}</dd></div>
<div class="info-item"><dt>京东创建时间</dt><dd>{{ item?.jdCreatedAt ? formatDateTime(item.jdCreatedAt) : '-' }}</dd></div>
<div class="info-item"><dt>京东修改时间</dt><dd>{{ item?.jdUpdatedAt ? formatDateTime(item.jdUpdatedAt) : '-' }}</dd></div>
</dl>
</div>
</section>
<section v-if="attrGroups.length" class="detail-block">
<h4>属性与设置(按京麦 Tab 分组)</h4>
<div v-for="group in attrGroups" :key="group.groupName" class="attr-group">
<h5>{{ group.groupName }}</h5>
<table>
<tbody>
<tr v-for="(attr, index) in group.attrs" :key="`${attr.key}-${index}`">
<th>{{ attr.label || attr.key || '-' }}</th>
<td>{{ attr.value || '-' }}</td>
</tr>
</tbody>
</table>
</div>
</section>
<section v-else-if="attrJsonRaw" class="detail-block">
<h4>属性(原始 JSON)</h4>
<pre class="attr-raw">{{ attrJsonRaw }}</pre>
</section>
<section class="detail-block">
<h4>销售属性 / SKU 矩阵</h4>
<template v-if="skus.length">
<p class="sku-summary">{{ skuSummary }}</p>
<div class="sku-table-wrap">
<table class="sku-table">
<thead>
<tr>
<th>序号</th>
<th v-for="dimension in skuDimensions" :key="dimension">{{ dimension }}</th>
<th>京东价</th>
<th>库存</th>
<th>SKU ID</th>
<th>SKU 名称</th>
</tr>
</thead>
<tbody>
<tr v-for="(sku, index) in skus" :key="sku.skuId">
<td>{{ sku.skuSeq || index + 1 }}</td>
<td v-for="dimension in skuDimensions" :key="dimension">{{ skuAttrValue(sku, dimension) }}</td>
<td>{{ sku.price ? `¥${sku.price}` : '-' }}</td>
<td>{{ dash(sku.stock) }}</td>
<td class="sku-id">{{ sku.skuId }}</td>
<td :title="sku.skuName">{{ dash(sku.skuName) }}</td>
</tr>
</tbody>
</table>
</div>
</template>
<p v-else class="drawer-tip">暂无 SKU 矩阵(V198 之前采集的旧行需重新采集)</p>
</section>
<section class="detail-block">
<h4>主图</h4>
<div v-if="mainImages.length" class="image-grid">
<img
v-for="image in mainImages"
:key="image.url"
:src="image.url"
alt=""
title="点击放大预览"
@click="openPreview(image.url)"
/>
</div>
<p v-else class="drawer-tip">暂无主图</p>
</section>
<section v-for="bucket in attrImageGroups" :key="bucket.attrName" class="detail-block">
<h4>属性图 · {{ bucket.attrName }}</h4>
<div class="image-grid">
<img
v-for="image in bucket.list"
:key="image.url"
:src="image.url"
alt=""
title="点击放大预览"
@click="openPreview(image.url)"
/>
</div>
</section>
<section class="detail-block">
<h4>详情图</h4>
<div v-if="detailImages.length" class="image-grid">
<img
v-for="image in detailImages"
:key="image.url"
:src="image.url"
alt=""
title="点击放大预览"
@click="openPreview(image.url)"
/>
</div>
<p v-else class="drawer-tip">暂无详情图</p>
</section>
<section v-if="otherImages.length" class="detail-block">
<h4>其他图</h4>
<div class="image-grid">
<img
v-for="image in otherImages"
:key="image.url"
:src="image.url"
alt=""
title="点击放大预览"
@click="openPreview(image.url)"
/>
</div>
</section>
</template>
</div>
</aside>
<div v-if="previewVisible" class="modal-mask" @click.self="previewVisible = false">
<div class="preview-modal">
<div class="preview-head">
<h3>图片预览</h3>
<button class="drawer-close" type="button" aria-label="关闭" @click="previewVisible = false">×</button>
</div>
<img class="preview-image" :src="previewUrl" alt="" />
<div class="preview-foot">
<a :href="previewUrl" target="_blank" rel="noopener">新标签打开原图</a>
<button class="btn btn-secondary" type="button" @click="previewVisible = false">关闭</button>
</div>
</div>
</div>
</div>
</template>
<style scoped>
.drawer-mask {
position: fixed;
inset: 0;
z-index: 2600;
display: flex;
justify-content: flex-end;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(4px);
}
.drawer {
display: flex;
flex-direction: column;
width: min(920px, 100%);
height: 100%;
background: #ffffff;
box-shadow: -18px 0 40px rgba(39, 67, 94, 0.18);
}
.drawer-head {
display: flex;
align-items: center;
justify-content: space-between;
padding: 16px 20px;
border-bottom: 1px solid #dbe5ee;
}
.drawer-head h3 {
margin: 0;
font-size: 15px;
font-weight: 650;
color: #24384d;
}
.drawer-close {
width: 30px;
height: 30px;
border: 1px solid transparent;
border-radius: 9px;
background: none;
color: #5b6f83;
font-size: 20px;
line-height: 1;
cursor: pointer;
}
.drawer-close:hover {
border-color: #cbd9e6;
background: #eef4fa;
color: #24384d;
}
.drawer-body {
flex: 1;
min-height: 0;
overflow-y: auto;
padding: 16px 20px 28px;
display: flex;
flex-direction: column;
gap: 18px;
}
.drawer-tip {
margin: 0;
color: #8293a5;
font-size: 13.5px;
}
.drawer-failure {
display: flex;
align-items: center;
gap: 12px;
padding: 12px 14px;
border: 1px solid #f0c9c2;
border-radius: 10px;
background: #fdf1ef;
color: #a04432;
font-size: 13.5px;
}
.detail-block h4 {
margin: 0 0 10px;
font-size: 13.5px;
font-weight: 650;
color: #4e6479;
}
/* 顶部「左图右信息」(京麦详情布局):左侧主图大图+缩略图切换,右侧关键信息网格。 */
.detail-hero {
display: flex;
align-items: flex-start;
gap: 16px;
}
.hero-gallery {
flex: 0 0 300px;
display: flex;
flex-direction: column;
gap: 8px;
min-width: 0;
}
.hero-main {
display: block;
width: 100%;
aspect-ratio: 1;
object-fit: cover;
border: 1px solid #d8e3ee;
border-radius: 10px;
background: #f2f7fb;
cursor: zoom-in;
}
.hero-empty {
display: flex;
align-items: center;
justify-content: center;
width: 100%;
aspect-ratio: 1;
border: 1px dashed #c7d7e5;
border-radius: 10px;
background: #f8fbfd;
color: #8293a5;
font-size: 13px;
}
.hero-thumbs {
display: flex;
flex-wrap: wrap;
gap: 6px;
}
.hero-thumbs img {
width: 44px;
height: 44px;
object-fit: cover;
border: 1px solid #d8e3ee;
border-radius: 6px;
cursor: pointer;
opacity: 0.85;
}
.hero-thumbs img.active {
outline: 2px solid #2f5d8b;
opacity: 1;
}
.hero-info {
flex: 1;
min-width: 0;
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 10px 16px;
margin: 0;
}
.hero-info dt {
color: #5b6f83;
font-size: 12px;
margin-bottom: 3px;
}
.hero-info dd {
margin: 0;
color: #24384d;
font-size: 13.5px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.hero-title dd {
font-size: 14.5px;
font-weight: 650;
color: #24384d;
white-space: normal;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
}
@media (max-width: 760px) {
.detail-hero {
flex-direction: column;
}
.hero-gallery {
flex-basis: auto;
width: 100%;
}
}
.info-grid {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: 10px 16px;
margin: 0;
}
.info-item {
min-width: 0;
}
.info-item-wide {
grid-column: 1 / -1;
}
.info-item dt {
color: #5b6f83;
font-size: 12px;
margin-bottom: 3px;
}
.info-item dd {
margin: 0;
color: #24384d;
font-size: 13.5px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.attr-group {
margin-bottom: 12px;
}
.attr-group h5 {
margin: 0 0 6px;
color: #5b6f83;
font-size: 12.5px;
}
.attr-group table {
width: 100%;
border-collapse: collapse;
border: 1px solid #dbe5ee;
border-radius: 8px;
overflow: hidden;
}
.attr-group th,
.attr-group td {
padding: 7px 10px;
border-bottom: 1px solid #e7eef5;
font-size: 13px;
text-align: left;
vertical-align: top;
}
.attr-group th {
width: 180px;
background: #f2f7fb;
color: #4e6479;
font-weight: 600;
}
.attr-group tr:last-child th,
.attr-group tr:last-child td {
border-bottom: 0;
}
.attr-raw {
margin: 0;
padding: 10px 12px;
border: 1px solid #dbe5ee;
border-radius: 8px;
background: #f8fbfd;
color: #24384d;
font-size: 12px;
white-space: pre-wrap;
word-break: break-all;
max-height: 240px;
overflow-y: auto;
}
.sku-summary {
margin: 0 0 8px;
color: #5b6f83;
font-size: 12.5px;
}
.sku-table-wrap {
overflow-x: auto;
border: 1px solid #dbe5ee;
border-radius: 8px;
}
.sku-table {
width: 100%;
border-collapse: collapse;
font-size: 12.5px;
white-space: nowrap;
}
.sku-table th,
.sku-table td {
padding: 7px 10px;
border-bottom: 1px solid #e7eef5;
text-align: left;
color: #24384d;
}
.sku-table th {
background: #f2f7fb;
color: #4e6479;
font-weight: 600;
}
.sku-table tbody tr:last-child td {
border-bottom: 0;
}
.sku-table .sku-id {
font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
font-size: 12px;
color: #4e6479;
}
.image-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(110px, 1fr));
gap: 10px;
}
.image-grid img {
display: block;
width: 100%;
aspect-ratio: 1;
object-fit: cover;
border: 1px solid #d8e3ee;
border-radius: 8px;
background: #f2f7fb;
cursor: zoom-in;
}
.modal-mask {
position: fixed;
inset: 0;
z-index: 3000;
display: flex;
align-items: center;
justify-content: center;
padding: 40px 20px;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(6px);
}
.preview-modal {
display: flex;
flex-direction: column;
width: min(880px, 100%);
max-height: 88vh;
padding: 16px 20px;
border: 1px solid #c7d7e5;
border-radius: 14px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(39, 67, 94, 0.2);
}
.preview-head {
display: flex;
align-items: center;
justify-content: space-between;
}
.preview-head h3 {
margin: 0;
font-size: 15px;
color: #24384d;
}
.preview-image {
display: block;
flex: 1;
min-height: 0;
max-height: 68vh;
margin: 12px 0;
object-fit: contain;
background: #f2f7fb;
border-radius: 8px;
}
.preview-foot {
display: flex;
align-items: center;
justify-content: space-between;
}
.preview-foot a {
color: #2f5d8b;
font-size: 13px;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 38px;
padding: 7px 16px;
border-radius: 9px;
font-size: 13px;
cursor: pointer;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border: 1px solid #c7d7e5;
}
.btn-secondary:hover {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
</style>
@@ -0,0 +1,616 @@
<script setup lang="ts">
/** 京东商品编辑抽屉(2026-11-15 用户口径「每一条数据后面 需要编辑或者删除;编辑的话
* 这里面都是可以编辑的」):详情抽屉的可编辑版——基本信息/属性与设置/SKU 矩阵(价格、
* 库存)/图片(标删)四块。形状照 JdProductDetailDrawer(自绘 drawer + 分块 + attr-group
* 表格 + image-grid,零 element-plus)。
* 保存语义在后端 JdProductUpdateService(PUT /api/admin/jd-products/{id}):主字段全量提交
* +可选块(attrGroups 重建 attr_json 的 tabs 段、skus 按 skuId 改价格库存、deleteImageIds
* 删图——先删桶、共用对象保留)。保存即置人工编辑锁 manual_locked=1:后续采集不再覆盖该行,
* 底部常驻提示点名这件事。
* V203(2026-11-16):分类<b>不在本抽屉编辑</b>(分类按数据权限分组隔离,归属存
* biz_jd_product_group_assign,归类只走「店铺分类」弹窗)——原「分类」下拉与 groupId 负载已下线,
* 避免写遗留的 biz_jd_product.group_id 列造成「界面改了、列表分组没变」。
* 图片区拆在 JdProductImageManager 子组件(2026-11-16:× 右上角标删+替换/新增本地图,
* B109-01 落地;标删集合经 update:deleteIds 上抛进保存负载,上传立即生效由子组件自理)。
* 京东时间/信息分/商品编码只读。
* 数据自取 fetchJdProductDetail 回填,保存成功用返回的刷新详情直接回填并 emit('saved')。 */
import { computed, ref, watch } from 'vue'
import {
fetchJdProductDetail,
updateJdProduct,
} from './jd-product-api.ts'
import JdProductImageManager from './JdProductImageManager.vue'
import type {
JdProductAttrEntry,
JdProductAttrGroup,
JdProductImage,
JdProductItem,
JdProductSku,
} from './jd-product-model.ts'
import { jdSkuDimensions } from './jd-product-model.ts'
import { requestErrorMessage } from '../../api/envelope.ts'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
const props = defineProps<{
item: JdProductItem | null
visible: boolean
}>()
const emit = defineEmits<{ (event: 'close'): void; (event: 'saved'): void }>()
const loading = ref(false)
const loadFailure = ref('')
const saving = ref(false)
/** 保存失败红条(后端校验/业务文案原样展示,如价格倒挂、SKU 行不存在)。 */
const saveError = ref('')
// ---------------- 草稿(基本信息 + 属性 + SKU + 删图标记) ----------------
interface DraftAttrGroup {
groupName: string
attrs: JdProductAttrEntry[]
}
const form = ref({
title: '',
brand: '',
categoryPath: '',
itemNum: '',
priceMin: '',
priceMax: '',
stockTotal: '' as string,
saleStatus: '',
})
const draftAttrGroups = ref<DraftAttrGroup[]>([])
const draftSkus = ref<JdProductSku[]>([])
const images = ref<JdProductImage[]>([])
/** 图片子组件上抛的标删行 id(保存时一次提交 deleteImageIds)。 */
const managerDeleteIds = ref<number[]>([])
/** attr_json 解析失败(attrJsonRaw 兜底行):属性块禁用,防保存把原文形状弄丢。 */
const attrJsonRaw = ref('')
const skuDimensions = computed(() => jdSkuDimensions(draftSkus.value))
function skuAttrValue(sku: JdProductSku, dimension: string): string {
return sku.saleAttrs.find((attr) => attr.name === dimension)?.value || '-'
}
function removeAttrRow(group: DraftAttrGroup, index: number): void {
group.attrs.splice(index, 1)
}
// ---------------- 取数与保存 ----------------
async function loadDetail(): Promise<void> {
const item = props.item
if (!item) return
loading.value = true
loadFailure.value = ''
saveError.value = ''
try {
const detail = await fetchJdProductDetail(item.id)
const row = detail.item
form.value = {
title: row.title,
brand: row.brand,
categoryPath: row.categoryPath,
itemNum: row.itemNum,
priceMin: row.priceMin,
priceMax: row.priceMax,
stockTotal: row.stockTotal === null ? '' : String(row.stockTotal),
saleStatus: row.saleStatus,
}
// 深拷贝草稿:直接改副本,保存前才拼负载。
draftAttrGroups.value = detail.attrGroups.map((group: JdProductAttrGroup) => ({
groupName: group.groupName,
attrs: group.attrs.map((attr) => ({ ...attr })),
}))
draftSkus.value = detail.skus.map((sku) => ({ ...sku }))
images.value = detail.images
managerDeleteIds.value = []
attrJsonRaw.value = detail.attrJsonRaw
} catch (error) {
loadFailure.value = requestErrorMessage(error) || '商品详情加载失败'
} finally {
loading.value = false
}
}
function close(): void {
emit('close')
}
/** 保存:主字段全量 + 有改动的可选块。前端先拦「标题为空」(后端 @NotBlank 同判),失败红条。 */
async function save(): Promise<void> {
if (!props.item || saving.value) return
saveError.value = ''
if (!form.value.title.trim()) {
saveError.value = '标题不能为空'
return
}
saving.value = true
try {
const detail = await updateJdProduct(props.item.id, {
title: form.value.title.trim(),
brand: form.value.brand.trim() || null,
categoryPath: form.value.categoryPath.trim() || null,
itemNum: form.value.itemNum.trim() || null,
priceMin: form.value.priceMin.trim() || null,
priceMax: form.value.priceMax.trim() || null,
stockTotal: form.value.stockTotal.trim() === '' ? null : Number(form.value.stockTotal),
saleStatus: form.value.saleStatus.trim() || null,
// 属性块:原文兜底行(解析失败)不提交,防保存把解析不出的原文形状弄丢。
attrGroups: attrJsonRaw.value
? null
: draftAttrGroups.value.map((group) => ({
groupName: group.groupName,
attrs: group.attrs.map((attr) => ({
key: attr.key,
label: attr.label,
value: attr.value,
})),
})),
skus: draftSkus.value.length
? draftSkus.value.map((sku) => ({
skuId: sku.skuId,
price: sku.price || null,
stock: sku.stock,
}))
: null,
deleteImageIds: managerDeleteIds.value.length ? [...managerDeleteIds.value] : null,
})
// 保存成功:用返回的刷新详情直接回填(图片行集已扣掉删掉的行、计数已刷新)。
form.value.title = detail.item.title
form.value.brand = detail.item.brand
form.value.categoryPath = detail.item.categoryPath
form.value.itemNum = detail.item.itemNum
form.value.priceMin = detail.item.priceMin
form.value.priceMax = detail.item.priceMax
form.value.stockTotal = detail.item.stockTotal === null ? '' : String(detail.item.stockTotal)
form.value.saleStatus = detail.item.saleStatus
draftAttrGroups.value = detail.attrGroups.map((group) => ({
groupName: group.groupName,
attrs: group.attrs.map((attr) => ({ ...attr })),
}))
draftSkus.value = detail.skus.map((sku) => ({ ...sku }))
images.value = detail.images
managerDeleteIds.value = []
showAdminFeedback('已保存,该商品已转为人工维护(采集不再覆盖)', 'success')
emit('saved')
} catch (error) {
saveError.value = requestErrorMessage(error) || '保存失败,请稍后重试'
} finally {
saving.value = false
}
}
watch(
() => [props.visible, props.item?.id] as const,
([visible]) => {
if (visible && props.item) void loadDetail()
},
)
function dash(value: string | number | null | undefined): string {
const text = value === null || value === undefined ? '' : String(value).trim()
return text || '-'
}
</script>
<template>
<div v-if="visible" class="drawer-mask" @click.self="close">
<aside class="drawer">
<header class="drawer-head">
<h3>编辑商品{{ item?.productCode ? ` · ${item.productCode}` : '' }}</h3>
<button class="drawer-close" type="button" aria-label="关闭" @click="close">×</button>
</header>
<div class="drawer-body">
<div v-if="loadFailure" class="drawer-failure">
<span>{{ loadFailure }}</span>
<button class="btn btn-secondary" type="button" @click="loadDetail">重试</button>
</div>
<p v-else-if="loading" class="drawer-tip">加载中...</p>
<template v-else>
<section class="detail-block">
<h4>基本信息</h4>
<div class="edit-grid">
<div class="edit-item edit-item-wide">
<label>标题</label>
<input v-model="form.title" type="text" />
</div>
<div class="edit-item">
<label>品牌</label>
<input v-model="form.brand" type="text" />
</div>
<div class="edit-item">
<label>类目</label>
<input v-model="form.categoryPath" type="text" />
</div>
<div class="edit-item">
<label>货号(系统生成=行号,可改)</label>
<input v-model="form.itemNum" type="text" />
</div>
<div class="edit-item">
<label>状态</label>
<input v-model="form.saleStatus" type="text" />
</div>
<div class="edit-item">
<label>价格下限</label>
<input v-model="form.priceMin" type="text" inputmode="decimal" />
</div>
<div class="edit-item">
<label>价格上限</label>
<input v-model="form.priceMax" type="text" inputmode="decimal" />
</div>
<div class="edit-item">
<label>总库存</label>
<input v-model="form.stockTotal" type="text" inputmode="numeric" />
</div>
<div class="edit-item">
<label>商品编码(只读)</label>
<input type="text" :value="dash(item?.productCode)" readonly class="readonly" />
</div>
<div class="edit-item">
<label>信息分(只读)</label>
<input type="text" :value="dash(item?.healthScore)" readonly class="readonly" />
</div>
</div>
</section>
<section v-if="draftAttrGroups.length" class="detail-block">
<h4>属性与设置(键值可改,行可删)</h4>
<div v-for="group in draftAttrGroups" :key="group.groupName" class="attr-group">
<h5>{{ group.groupName }}</h5>
<table>
<tbody>
<tr v-for="(attr, index) in group.attrs" :key="`${attr.key}-${index}`">
<th>{{ attr.label || attr.key || '-' }}</th>
<td><input v-model="attr.value" type="text" class="attr-input" /></td>
<td class="attr-remove-cell">
<button class="attr-remove" type="button" title="删除该属性行" @click="removeAttrRow(group, index)">删</button>
</td>
</tr>
</tbody>
</table>
</div>
</section>
<p v-else-if="attrJsonRaw" class="drawer-tip">属性原文解析失败(原始 JSON 兜底),属性区不可编辑以防丢失原文;可照常改基本信息。</p>
<p v-else class="drawer-tip">暂无属性</p>
<section class="detail-block">
<h4>SKU 矩阵(京东价 / 库存可改)</h4>
<template v-if="draftSkus.length">
<div class="sku-table-wrap">
<table class="sku-table">
<thead>
<tr>
<th v-for="dimension in skuDimensions" :key="dimension">{{ dimension }}</th>
<th>京东价</th>
<th>库存</th>
<th>SKU ID</th>
</tr>
</thead>
<tbody>
<tr v-for="sku in draftSkus" :key="sku.skuId">
<td v-for="dimension in skuDimensions" :key="dimension">{{ skuAttrValue(sku, dimension) }}</td>
<td><input v-model="sku.price" type="text" inputmode="decimal" class="sku-input" /></td>
<td>
<input
:value="sku.stock === null ? '' : String(sku.stock)"
type="text"
inputmode="numeric"
class="sku-input"
@input="sku.stock = ($event.target as HTMLInputElement).value === '' ? null : Number(($event.target as HTMLInputElement).value)"
/>
</td>
<td class="sku-id">{{ sku.skuId }}</td>
</tr>
</tbody>
</table>
</div>
</template>
<p v-else class="drawer-tip">暂无 SKU 矩阵(V198 之前采集的旧行需重新采集)</p>
</section>
<JdProductImageManager
:product-id="item?.id ?? 0"
:images="images"
:disabled="loading"
@update:images="images = $event"
@update:delete-ids="managerDeleteIds = $event"
@saved="emit('saved')"
/>
<div v-if="saveError" class="drawer-failure">{{ saveError }}</div>
<p class="save-hint">保存后该商品转为人工维护,后续采集不再覆盖它的数据(含本单重爬);删除的图片文件一并从存储桶清理(共用的保留);替换 / 新增图片立即生效并同样置锁。</p>
</template>
</div>
<footer class="drawer-foot">
<button class="btn btn-secondary" type="button" :disabled="saving" @click="close">取消</button>
<button class="btn" type="button" :disabled="saving || loading" @click="save">
{{ saving ? '保存中...' : '保存' }}
</button>
</footer>
</aside>
</div>
</template>
<style scoped>
.drawer-mask {
position: fixed;
inset: 0;
z-index: 2600;
display: flex;
justify-content: flex-end;
background: rgba(45, 66, 86, 0.36);
backdrop-filter: blur(4px);
}
.drawer {
display: flex;
flex-direction: column;
width: min(920px, 100%);
height: 100%;
background: #ffffff;
box-shadow: -18px 0 40px rgba(39, 67, 94, 0.18);
}
.drawer-head {
display: flex;
align-items: center;
justify-content: space-between;
padding: 16px 20px;
border-bottom: 1px solid #dbe5ee;
}
.drawer-head h3 {
margin: 0;
font-size: 15px;
font-weight: 650;
color: #24384d;
}
.drawer-close {
width: 30px;
height: 30px;
border: 1px solid transparent;
border-radius: 9px;
background: none;
color: #5b6f83;
font-size: 20px;
line-height: 1;
cursor: pointer;
}
.drawer-close:hover {
border-color: #cbd9e6;
background: #eef4fa;
color: #24384d;
}
.drawer-body {
flex: 1;
min-height: 0;
overflow-y: auto;
padding: 16px 20px 28px;
display: flex;
flex-direction: column;
gap: 18px;
}
.drawer-foot {
display: flex;
justify-content: flex-end;
gap: 12px;
padding: 14px 20px;
border-top: 1px solid #dbe5ee;
background: #f8fbfd;
}
.drawer-tip {
margin: 0;
color: #8293a5;
font-size: 13.5px;
}
.drawer-failure {
padding: 12px 14px;
border: 1px solid #f0c9c2;
border-radius: 10px;
background: #fdf1ef;
color: #a04432;
font-size: 13.5px;
}
.detail-block h4 {
margin: 0 0 10px;
font-size: 13.5px;
font-weight: 650;
color: #4e6479;
}
.edit-grid {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: 10px 16px;
}
.edit-item {
min-width: 0;
display: flex;
flex-direction: column;
gap: 5px;
}
.edit-item-wide {
grid-column: 1 / -1;
}
.edit-item label {
color: #5b6f83;
font-size: 12px;
}
.edit-item input,
.edit-item select {
min-width: 0;
min-height: 36px;
padding: 6px 10px;
border: 1px solid #cbd9e6;
border-radius: 8px;
background: #ffffff;
color: #24384d;
font-size: 13px;
font-family: inherit;
outline: none;
}
.edit-item input:focus,
.edit-item select:focus {
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.edit-item input.readonly {
background: #f2f7fb;
color: #5b6f83;
}
.attr-group {
margin-bottom: 12px;
}
.attr-group h5 {
margin: 0 0 6px;
color: #5b6f83;
font-size: 12.5px;
}
.attr-group table {
width: 100%;
border-collapse: collapse;
border: 1px solid #dbe5ee;
border-radius: 8px;
overflow: hidden;
}
.attr-group th,
.attr-group td {
padding: 6px 10px;
border-bottom: 1px solid #e7eef5;
font-size: 13px;
text-align: left;
vertical-align: middle;
}
.attr-group th {
width: 180px;
background: #f2f7fb;
color: #4e6479;
font-weight: 600;
}
.attr-group tr:last-child th,
.attr-group tr:last-child td {
border-bottom: 0;
}
.attr-input {
width: 100%;
min-height: 32px;
padding: 5px 8px;
border: 1px solid #cbd9e6;
border-radius: 7px;
background: #ffffff;
color: #24384d;
font-size: 13px;
font-family: inherit;
outline: none;
}
.attr-input:focus {
border-color: #5f85ad;
}
.attr-remove-cell {
width: 44px;
text-align: center;
}
.attr-remove {
border: 1px solid #e4b3a8;
border-radius: 6px;
background: #ffffff;
color: #a04432;
font-size: 12px;
padding: 3px 8px;
cursor: pointer;
}
.attr-remove:hover {
background: #fdf1ef;
}
.sku-table-wrap {
overflow-x: auto;
border: 1px solid #dbe5ee;
border-radius: 8px;
}
.sku-table {
width: 100%;
border-collapse: collapse;
font-size: 12.5px;
white-space: nowrap;
}
.sku-table th,
.sku-table td {
padding: 6px 10px;
border-bottom: 1px solid #e7eef5;
text-align: left;
color: #24384d;
}
.sku-table th {
background: #f2f7fb;
color: #4e6479;
font-weight: 600;
}
.sku-table tbody tr:last-child td {
border-bottom: 0;
}
.sku-input {
width: 110px;
min-height: 32px;
padding: 5px 8px;
border: 1px solid #cbd9e6;
border-radius: 7px;
background: #ffffff;
color: #24384d;
font-size: 13px;
font-family: inherit;
outline: none;
}
.sku-input:focus {
border-color: #5f85ad;
}
.sku-id {
font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
font-size: 12px;
color: #4e6479;
}
.save-hint {
margin: 0;
padding: 10px 14px;
border: 1px solid #cfe3f5;
border-radius: 10px;
background: #eef5fc;
color: #3b6d99;
font-size: 12.5px;
line-height: 1.6;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 38px;
padding: 7px 16px;
border-radius: 9px;
font-size: 13px;
cursor: pointer;
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.6;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border: 1px solid #c7d7e5;
}
.btn-secondary:hover:not(:disabled) {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
.btn:not(.btn-secondary) {
border: 1px solid #4f78a5;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
}
.btn:not(.btn-secondary):hover:not(:disabled) {
background: linear-gradient(135deg, #7094ba, #5d83ac);
}
</style>
@@ -0,0 +1,300 @@
<script setup lang="ts">
/** 京东商品编辑抽屉「图片区」子组件(2026-11-16 从 JdProductEditDrawer 拆出:编辑抽屉
* 856 行超后管 800 报警线,图片区自洽成件——× 右上角标删+hover 替换+新增主图,
* B109-01 落地,2026-11-16 客户口径「删除做成打叉的 icon 放图右上角,也要支持编辑
* 替换本地的图」)。
*
* 交互语义:× 标删=前端标记、随父级「保存」一并提交(deleteImageIds 上抛);替换/新增
* =multipart 立即生效(服务端置锁+刷投影),上传成功用返回详情回填本区并上抛 saved。
* objectKey 由服务端按上传字节 sha256 内容寻址生成(铁律 32),前端不自造 key。
* 形状照 JdProductEditDrawer 原图片区(image-grid + image-cell,零 element-plus)。 */
import { computed, ref, watch } from 'vue'
import { uploadJdProductImage } from './jd-product-api.ts'
import type { JdProductImage } from './jd-product-model.ts'
import { requestErrorMessage } from '../../api/envelope.ts'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
const props = defineProps<{
productId: number
images: JdProductImage[]
/** 父级 loading 中禁上传入口。 */
disabled: boolean
}>()
const emit = defineEmits<{
(event: 'update:images', images: JdProductImage[]): void
(event: 'update:deleteIds', ids: number[]): void
(event: 'saved'): void
}>()
/** 标删的图片行 id(前端只标记,父级保存时一次提交 deleteImageIds)。 */
const deleteImageIds = ref<Set<number>>(new Set())
function toggleDeleteImage(image: JdProductImage): void {
const next = new Set(deleteImageIds.value)
if (next.has(image.id)) next.delete(image.id)
else next.add(image.id)
deleteImageIds.value = next
emit('update:deleteIds', [...next])
}
// ---------------- 图片上传/替换(立即生效,与标删的「保存时生效」不同) ----------------
/** 文件选择上下文:null=新增主图;有值=替换该登记行(档位继承原行,后端语义)。 */
const pendingReplaceImageId = ref<number | null>(null)
const fileInputRef = ref<HTMLInputElement | null>(null)
/** 上传中的图行 id(0=新增上传中);上传期间防重复点。 */
const uploadingImageId = ref<number | null>(null)
const uploadError = ref('')
function pickImage(replaceImageId: number | null): void {
if (uploadingImageId.value !== null || props.disabled) return
uploadError.value = ''
pendingReplaceImageId.value = replaceImageId
// 同选一张图也要重触发 change:先清值再弹窗。
if (fileInputRef.value) {
fileInputRef.value.value = ''
fileInputRef.value.click()
}
}
async function onFileChosen(event: Event): Promise<void> {
const input = event.target as HTMLInputElement
const file = input.files?.[0]
if (!file || props.disabled) return
uploadingImageId.value = pendingReplaceImageId.value ?? 0
try {
const detail = await uploadJdProductImage(props.productId, file, pendingReplaceImageId.value
? { replaceImageId: pendingReplaceImageId.value }
: { imageType: 'MAIN' })
// 立即生效:用返回详情回填图片区(标删集合里已不存在的行 id 由 images watch 清理)。
emit('update:images', detail.images)
showAdminFeedback(pendingReplaceImageId.value ? '图片已替换(该商品已转为人工维护)' : '图片已新增(该商品已转为人工维护)', 'success')
emit('saved')
} catch (error) {
uploadError.value = requestErrorMessage(error) || '图片上传失败,请稍后重试'
} finally {
uploadingImageId.value = null
pendingReplaceImageId.value = null
input.value = ''
}
}
/** 换商品打开时标删集合必须清零(父级 loadDetail 换 item.id)。 */
watch(() => props.productId, () => {
deleteImageIds.value = new Set()
emit('update:deleteIds', [])
})
/** 行集变化时清掉已不存在的标删 id(保存删行回填/上传回填两路共用;不清理的话
* 下次保存会把已删的 id 再提交一遍=后端按「图片不存在」整笔拒绝)。 */
watch(() => props.images, (images) => {
const live = new Set(images.map((image) => image.id))
const next = new Set([...deleteImageIds.value].filter((id) => live.has(id)))
if (next.size !== deleteImageIds.value.size) {
deleteImageIds.value = next
emit('update:deleteIds', [...next])
}
})
const markedCount = computed(() => deleteImageIds.value.size)
</script>
<template>
<section class="detail-block">
<div class="image-head">
<h4>图片(右上角 × 标记删除,保存时一并删除;替换 / 新增立即生效)</h4>
<button class="btn-add-image" type="button" :disabled="uploadingImageId !== null || disabled" @click="pickImage(null)">
{{ uploadingImageId === 0 ? '上传中...' : '+ 新增主图' }}
</button>
</div>
<input ref="fileInputRef" type="file" accept="image/jpeg,image/png,image/webp,image/gif" hidden @change="onFileChosen" />
<div v-if="images.length" class="image-grid">
<div
v-for="image in images"
:key="`${image.id}-${image.url}`"
class="image-cell"
:class="{ marked: deleteImageIds.has(image.id) }"
>
<img
:src="image.url"
alt=""
loading="lazy"
:class="{ dimmed: deleteImageIds.has(image.id) || uploadingImageId === image.id }"
/>
<!-- 右上角 × 删除标记(京麦样式,2026-11-16 客户口径):点 × 标记,再点撤销。 -->
<button
class="image-x"
type="button"
:title="deleteImageIds.has(image.id) ? '撤销删除标记' : '标记删除(保存时一并删除)'"
@click="toggleDeleteImage(image)"
>×</button>
<!-- 标删遮罩(整格可点撤销),未标删时 hover 底部出现「替换」条。 -->
<button
v-if="deleteImageIds.has(image.id)"
class="image-marked-mask"
type="button"
title="点击撤销删除标记"
@click="toggleDeleteImage(image)"
>已标记删除 · 点击撤销</button>
<button
v-else
class="image-replace"
type="button"
:disabled="uploadingImageId !== null"
@click="pickImage(image.id)"
>{{ uploadingImageId === image.id ? '上传中...' : '替换' }}</button>
</div>
</div>
<p v-else class="drawer-tip">暂无图片(可点右上「+ 新增主图」上传本地图)</p>
<p v-if="uploadError" class="drawer-failure">{{ uploadError }}</p>
<p v-if="markedCount" class="delete-count">已标记删除 {{ markedCount }} 张,保存后剩余 {{ images.length - markedCount }} 张</p>
</section>
</template>
<style scoped>
.image-head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
}
.image-head h4 {
margin: 0 0 10px;
font-size: 13.5px;
font-weight: 650;
color: #4e6479;
}
.btn-add-image {
min-height: 30px;
padding: 4px 12px;
border: 1px solid #95b1cb;
border-radius: 8px;
background: #ffffff;
color: #2f5d8b;
font-size: 12.5px;
cursor: pointer;
white-space: nowrap;
}
.btn-add-image:hover {
background: #edf5fb;
}
.btn-add-image:disabled {
opacity: 0.55;
cursor: not-allowed;
}
.image-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(110px, 1fr));
gap: 10px;
}
.image-cell {
position: relative;
}
.image-cell img {
display: block;
width: 100%;
aspect-ratio: 1;
object-fit: cover;
border: 1px solid #d8e3ee;
border-radius: 8px;
background: #f2f7fb;
}
.image-cell img.dimmed {
opacity: 0.35;
}
.image-cell.marked img {
outline: 2px solid #d08a7b;
}
/* 右上角 × 删除标记(京麦样式):hover 格子时出现;已标删常显。 */
.image-x {
position: absolute;
top: 4px;
right: 4px;
display: none;
align-items: center;
justify-content: center;
width: 22px;
height: 22px;
border: none;
border-radius: 50%;
background: rgba(38, 50, 63, 0.72);
color: #ffffff;
font-size: 15px;
line-height: 1;
cursor: pointer;
}
.image-cell:hover .image-x,
.image-cell.marked .image-x {
display: flex;
}
.image-x:hover {
background: #a04432;
}
/* 标删态:整格遮罩可点撤销。 */
.image-marked-mask {
position: absolute;
inset: 0;
display: flex;
align-items: center;
justify-content: center;
padding: 6px;
border: none;
border-radius: 8px;
background: rgba(160, 68, 50, 0.32);
color: #ffffff;
font-size: 12px;
line-height: 1.5;
cursor: pointer;
}
.image-marked-mask:hover {
background: rgba(160, 68, 50, 0.5);
}
/* hover 底部替换条(京麦替换入口);上传中常显。 */
.image-replace {
position: absolute;
left: 0;
right: 0;
bottom: 0;
display: none;
align-items: center;
justify-content: center;
min-height: 26px;
border: none;
border-radius: 0 0 8px 8px;
background: rgba(38, 50, 63, 0.72);
color: #ffffff;
font-size: 12px;
cursor: pointer;
}
.image-cell:hover .image-replace {
display: flex;
}
.image-cell .image-replace:disabled {
display: flex;
background: rgba(38, 50, 63, 0.55);
cursor: wait;
}
.image-replace:hover {
background: #2f5d8b;
}
.delete-count {
margin: 10px 0 0;
color: #a04432;
font-size: 12.5px;
}
.drawer-tip {
margin: 0;
color: #8293a5;
font-size: 13.5px;
}
.drawer-failure {
margin: 10px 0 0;
padding: 10px 14px;
border: 1px solid #f0c9c2;
border-radius: 10px;
background: #fdf1ef;
color: #a04432;
font-size: 13px;
}
</style>
@@ -0,0 +1,29 @@
/** 类目级联面板的水平定位钳制(2026-11-16 客户截图「超出视窗了」:面板锚在触发框
* left:0,下钻到 3~4 栏时宽 600~800px,而「类目」筛选框在 jd-filter-row 流式布局里
* 常落在页面中部偏右 ⇒ 面板右半截伸出视窗,末栏被窗缘裁到只剩一列 radio 圆点)。
*
* 本文件是**纯钳制数学**(零依赖,node --test 可直测):默认锚左(偏移 0);视口右缘
* 装不下时整体左移到右缘贴齐(留 margin),左移后越出左缘则贴左缘为止。组件侧在面板
* 打开与栏数/搜索态变化后用真实 rect 调它(JdCategoryCascader.vue),栏数随下钻动态
* 1~4,宽度变了要重算——右贴齐后继续下钻即向左生长,不会再伸出右缘。 */
export interface PanelClampInput {
/** 触发框(.cat-cascader)的视口左缘 x。 */
hostLeft: number
/** 面板当前实际渲染宽(含边框;栏数不同宽度不同)。 */
panelWidth: number
/** 视口宽(window.innerWidth)。 */
viewportWidth: number
/** 视口两侧最小留白,默认 8px。 */
margin?: number
}
/** 返回面板相对触发框左缘应加的 left 偏移(px;负=左移、0=默认锚左即可、正=触发框
* 本身已贴近视口左缘时把面板推回 margin 内,物理上只在窄窗极端值出现)。 */
export function clampPanelLeftX(input: PanelClampInput): number {
const margin = input.margin ?? 8
const overflowRight = input.hostLeft + input.panelWidth - (input.viewportWidth - margin)
if (overflowRight <= 0) return 0
const desiredLeft = Math.max(margin, input.hostLeft - overflowRight)
return desiredLeft - input.hostLeft
}
File diff suppressed because one or more lines are too long
@@ -0,0 +1,402 @@
/* 像素复刻「外观专利数据库」页样式(panel-box + 自绘表格 + 旧式分页);列表只摆部分字段,全量属性在详情抽屉。 */
.jd-database-view {
font-family: inherit;
color: var(--c-text, #24384d);
display: flex;
flex-direction: column;
gap: 18px;
}
.panel-box {
width: 100%;
min-width: 0;
padding: 20px 22px 24px;
border: 1px solid #d8e3ee;
border-radius: 14px;
background: linear-gradient(145deg, #ffffff, #f9fbfd);
box-shadow: 0 1px 2px rgba(39, 67, 94, 0.04), 0 14px 30px -24px rgba(39, 67, 94, 0.28);
}
h3 {
margin: 0 0 16px;
font-size: 15px;
font-weight: 650;
color: #24384d;
letter-spacing: 0.2px;
}
.jd-panel-head {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: 16px;
}
.jd-panel-head h3 {
margin: 0;
}
.jd-filter-row {
/* 可换行流式布局:固定 6 列 minmax(140px) 的网格在窄面板下最小宽超出容器,
把查询/重置挤出面板右缘(与「管理分组」重叠)。flex-wrap 让放不下的项自然折行。 */
display: flex;
flex-wrap: wrap;
gap: 12px;
align-items: flex-end;
margin-bottom: 16px;
}
.jd-filter-row .form-group {
flex: 1 1 160px;
min-width: 150px;
max-width: 260px;
}
.jd-filter-actions {
display: flex;
gap: 10px;
align-items: center;
white-space: nowrap;
}
.form-group {
display: flex;
flex-direction: column;
gap: 7px;
margin-bottom: 0;
}
.form-group label {
color: #5b6f83;
font-size: 12.5px;
font-weight: 600;
}
.form-group input,
.form-group select {
min-width: 0;
min-height: 42px;
padding: 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
color-scheme: light;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.form-group input:hover,
.form-group select:hover {
border-color: #9fb7cd;
}
.form-group input:focus,
.form-group select:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.form-group input[type="date"] {
color-scheme: light;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 8px;
min-height: 42px;
padding: 9px 18px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13.5px;
cursor: pointer;
box-shadow: 0 8px 18px -14px rgba(79, 120, 165, 0.72);
transition: background 160ms ease, box-shadow 160ms ease, transform 120ms ease;
}
.btn:hover:not(:disabled) {
background: linear-gradient(135deg, #7094ba, #5d83ac);
box-shadow: 0 11px 22px -14px rgba(79, 120, 165, 0.8);
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.55;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border-color: #c7d7e5;
}
.btn-secondary:hover:not(:disabled) {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
.jd-toolbar {
display: flex;
align-items: center;
gap: 10px;
margin-bottom: 10px;
}
/* 工具栏里的下拉与按钮统一 42px 外壳(2026-11-16 用户口径「样式要统一」):
这一行此前只有 .btn 有壳,原生 <select> 落成 28px 灰框、字号也不跟,
与旁边按钮同排时高矮不齐(分组下拉同日上移进筛选行,本行只剩分类筛选一颗)。
数值与 .form-group select / .btn 同一套(42px 高、
9px 圆角、#cbd9e6 描边、#f8fbfd 底),箭头用内联 SVG 自绘,避免各浏览器原生
箭头粗细不一(appearance:none 后必须补 padding-right 给箭头留位)。 */
.jd-toolbar select {
min-height: 42px;
max-width: 220px;
padding: 0 34px 0 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background-color: #f8fbfd;
background-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='8' viewBox='0 0 12 8'%3E%3Cpath d='M1 1.5 6 6.5 11 1.5' fill='none' stroke='%235b6f83' stroke-width='1.8' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E");
background-repeat: no-repeat;
background-position: right 12px center;
appearance: none;
-webkit-appearance: none;
color: #24384d;
font-family: inherit;
font-size: 13.5px;
cursor: pointer;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.jd-toolbar select:hover {
border-color: #9fb7cd;
}
.jd-toolbar select:focus {
background-color: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
/* 危险动作(删除勾选)推到行尾:留在「批量编辑分类/分类筛选」旁边会被读成同一组动作。 */
.jd-delete-btn {
margin-left: auto;
}
/* 分类管理(2026-11-17 独立分类管理页并入本页的对话框入口):贴着分类筛选下拉。 */
.jd-manage-btn {
margin-left: 6px;
}
/* 危险动作(删除勾选):与全站 .btn-danger 同形——实心红渐变+白字。
旧版是白底红字描边,落在工具栏里看着像「未激活的次要按钮」,与打卡/分组等页不统一。 */
.btn-danger {
background: linear-gradient(135deg, #c06d77, #b35f6a);
border-color: #b35f6a;
color: #ffffff;
}
.btn-danger:hover:not(:disabled) {
background: linear-gradient(135deg, #cb7c84, #b96570);
}
.jd-summary {
color: #5b6f83;
font-size: 13px;
white-space: nowrap;
}
/* 非超管只读提示(2026-11-16 写权限收窄):紧跟汇总的一句话,不冒充可点按钮。 */
.jd-readonly-tip {
color: #8293a5;
font-size: 12.5px;
white-space: nowrap;
}
/* 只有一个可见分组时锁定的组名(不可切):筛选行「分组」标签下的静态芯片(2026-11-16 用户口径
「做成分组」把下拉从工具栏上移进筛选行后跟着搬),与同排 select 同高同壳(42px/9px 圆角),
"一组锁定"和"多组下拉"两种形态占位一致;组名超宽省略号收口,不把筛选行撑破。 */
.jd-group-locked {
display: flex;
align-items: center;
min-height: 42px;
padding: 0 12px;
border: 1px solid #dbe5ee;
border-radius: 9px;
background: #f1f6fb;
color: #4e6479;
font-size: 13.5px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.table-scroll {
width: 100%;
min-width: 0;
overflow-x: auto;
border: 1px solid #dbe5ee;
border-radius: 10px;
background: #ffffff;
}
.table-scroll table {
width: 100%;
border-collapse: collapse;
table-layout: fixed;
}
/* 列宽收口(2026-11-16 用户口径「列表间距有点大」):1500px 的 min-width 让宽屏下
唯一的弹性列(商品信息)独吞剩余宽度,标题右侧留出近 800px 空白,价格/库存被推到最右。
商品信息改固定 520px 后各列按比例分摊余量,min-width 降到 1180px 即可无横向滚动。 */
.jd-table-scroll > table {
min-width: 1180px;
}
/* 操作列(编辑/删除):双小按钮需 138px(ops-cell-must-wrap 实测口径:两字按钮 53×2+24 padding)。
overflow 显式放开:td 全局是 overflow:hidden(611 行),压线时第二颗(删除)会被裁成
「编辑+…」的形状——2026-11-16 用户报「删除没了」的真因,列宽 120px < 实测 138px。 */
.jd-ops-cell {
white-space: nowrap;
text-overflow: clip;
overflow: visible;
}
.btn-sm {
min-height: 28px;
padding: 3px 10px;
font-size: 12.5px;
margin-right: 6px;
}
.btn-sm:last-child {
margin-right: 0;
}
.table-scroll th,
.table-scroll td {
/* 单元格左右内距 12→10px(同上「间距有点大」):列与列之间少 4px,行内更紧凑。 */
padding: 10px 10px;
text-align: left;
font-size: 13.5px;
line-height: 1.5;
border-bottom: 1px solid #e0e8ef;
vertical-align: middle;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* 首列勾选格:checkbox 的 UA 默认 margin(3px 3px 3px 4px)使其 margin-box 溢出
42px 格的内容盒(42−24 padding=18px),配合上面的 overflow:hidden,Chromium 在
首次渲染时会把被裁的 checkbox 碎片留在裁剪边缘,看起来像格子右边多出 ".."。
margin 归零后 margin-box 收进内容盒,首渲染即干净(playwright 三次冷加载已验)。 */
.table-scroll th:first-child input,
.table-scroll td:first-child input {
margin: 0;
}
.table-scroll th {
background: #edf4fa;
color: #4e6479;
border-bottom-color: #d5e1eb;
font-size: 12.5px;
font-weight: 600;
letter-spacing: 0.4px;
}
.table-scroll tbody tr:hover td {
background: #f1f7fb;
}
.table-scroll tbody tr:last-child td {
border-bottom: 0;
}
/* 点行开详情抽屉:行级 hover 已有底色反馈,光标再点一下提示可点。 */
.jd-row {
cursor: pointer;
}
.jd-thumb {
display: block;
width: 48px;
height: 48px;
object-fit: cover;
border: 1px solid #d8e3ee;
border-radius: 6px;
background: #f2f7fb;
}
/* 商品信息列=京麦同款合并布局:td 的全局 nowrap/ellipsis 与多行内容冲突,本列放开换行,
截断交给内部各行(标题两行 line-clamp、编码/货号单行 ellipsis)。 */
.jd-info-cell {
white-space: normal;
text-overflow: clip;
}
.jd-info-wrap {
display: flex;
align-items: flex-start;
gap: 10px;
min-width: 0;
}
.jd-info-figure {
display: flex;
flex-direction: column;
align-items: center;
gap: 3px;
flex-shrink: 0;
}
.jd-thumb-empty {
display: flex;
align-items: center;
justify-content: center;
color: #8293a5;
font-size: 12px;
}
.jd-health {
color: #2e9e6b;
font-size: 11px;
line-height: 1.2;
white-space: nowrap;
}
.jd-info-body {
min-width: 0;
display: flex;
flex-direction: column;
gap: 3px;
}
.jd-info-title {
color: #24384d;
font-size: 13.5px;
font-weight: 500;
line-height: 1.45;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
overflow: hidden;
word-break: break-all;
}
.jd-info-meta {
display: flex;
align-items: center;
gap: 4px;
color: #7b8a99;
font-size: 12px;
line-height: 1.4;
white-space: nowrap;
overflow: hidden;
}
.jd-info-code {
font-family: "Cascadia Mono", "SF Mono", Consolas, "Courier New", monospace;
color: #4e6479;
overflow: hidden;
text-overflow: ellipsis;
}
.jd-copy-btn {
flex-shrink: 0;
border: 0;
background: transparent;
color: #8aa5bf;
font-size: 12px;
cursor: pointer;
padding: 0 2px;
line-height: 1;
}
.jd-copy-btn:hover {
color: #3b82c4;
}
.jd-info-tags {
display: flex;
gap: 6px;
margin-top: 2px;
}
/* 品牌·类目行(京麦列表同款深色文字):信息 meta 是灰色,这行按京麦用主文字色。 */
.jd-brand-cat {
color: #3d5368;
font-weight: 550;
}
.jd-tag {
display: inline-flex;
align-items: center;
height: 18px;
padding: 0 6px;
border: 1px solid #cfe3f5;
border-radius: 3px;
background: #eef5fc;
color: #3b82c4;
font-size: 11.5px;
white-space: nowrap;
}
.empty-tip {
padding: 44px 24px;
text-align: center;
color: #8293a5;
font-size: 13.5px;
}
@@ -0,0 +1,305 @@
/** 京东数据库查询适配(v1.4 Phase 5):GET /api/admin/jd-products + 删除(DELETE /{id} +
* POST /batch-delete)+ 分组端点 /api/admin/jd-product-groups。
* 公司口径(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」):全页零公司维度——
* 只读列表与类目下拉的 company_id 发送口已随公司 tab 摘除(后端读侧谓词同窗撤,重上时
* 从 git 历史找回),详情/编辑/删除/分组管理本就不带;行 company_id 列仍是同步来源标记、
* 随详情下发。反向钉在 company-tab-wiring「公司维度不得回流」清单。
* 导出发送口已随 2026-11-15 客户口径「导出也不用」从前端下线(后端 /export 端点保留)。 */
import { http } from '@/api/http'
import { errorTextOf, unwrap } from '../../api/envelope.ts'
import {
toJdProductListParams,
type JdProductListParams,
} from './jd-product-filter.ts'
import {
parseJdProductDetail,
parseJdProductPage,
type JdProductPageResult,
} from './jd-product-model.ts'
export const JD_PRODUCT_ENDPOINT = '/api/admin/jd-products'
export const JD_PRODUCT_GROUP_ENDPOINT = '/api/admin/jd-product-groups'
export async function fetchJdProductList(
params: JdProductListParams,
): Promise<JdProductPageResult> {
const query = toJdProductListParams(
{
productCode: params.productCode ?? '',
titleKeyword: params.titleKeyword ?? '',
category: params.category ?? '',
groupId: params.groupId ?? '',
syncedFrom: params.syncedFrom ?? '',
syncedTo: params.syncedTo ?? '',
},
params.page,
params.pageSize,
params.ownerGroupId ?? null,
)
const { data } = await http.get<unknown>(JD_PRODUCT_ENDPOINT, { params: query })
return parseJdProductPage(data)
}
/** 详情:GET /api/admin/jd-products/{id}(信封 data=主字段 + attrGroups + attrJsonRaw + images)。
* 公共库无公司维度,按 id 直取;分类字段按「当前分组」(owner_group_id)取(V203)。 */
export async function fetchJdProductDetail(
id: number,
ownerGroupId?: number | null,
): Promise<ReturnType<typeof parseJdProductDetail>> {
const params = typeof ownerGroupId === 'number' && ownerGroupId > 0
? { owner_group_id: ownerGroupId }
: undefined
const { data } = await http.get<unknown>(`${JD_PRODUCT_ENDPOINT}/${id}`, { params })
return parseJdProductDetail(data)
}
/** 删除回执(后端 JdProductDeleteVo):三个对象计数分开报——真删的、共用的、前缀外不敢动的。 */
export interface JdProductDeleteResult {
deleted: number
imagesDeleted: number
objectsDeleted: number
objectsKept: number
objectsSkipped: number
}
/** 删除是先删桶、全成功才删库行(后端 JdProductDeleteService);失败文案原样抛给页面。
* 公共库写侧无公司维度(2026-11-15 用户定案)。 */
export async function deleteJdProducts(
ids: number[],
): Promise<JdProductDeleteResult> {
if (ids.length === 1) {
const { data } = await http.delete<unknown>(`${JD_PRODUCT_ENDPOINT}/${ids[0]}`)
return unwrap<JdProductDeleteResult>(data)
}
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/batch-delete`, { ids })
return unwrap<JdProductDeleteResult>(data)
}
/** 编辑提交负载(PUT /api/admin/jd-products/{id} body,后端 JdProductUpdateRequest):
* 主字段全量提交;attrGroups/skus/deleteImageIds 可选——null=不修改该块
* (后端对 null 块零触碰)。分类不在本负载里(V203:分类按数据权限分组归属存
* biz_jd_product_group_assign,编辑面不写 group_id,归类只走列表页「批量编辑分类」)。 */
export interface JdProductUpdatePayload {
title: string
brand: string | null
categoryPath: string | null
itemNum: string | null
priceMin: string | null
priceMax: string | null
stockTotal: number | null
saleStatus: string | null
attrGroups: { groupName: string; attrs: { key: string; label: string; value: string }[] }[] | null
skus: { skuId: string; price: string | null; stock: number | null }[] | null
deleteImageIds: number[] | null
}
/** 编辑保存(PUT):主字段保存即置人工编辑锁(V199 manual_locked=1,后续采集不再覆盖该行);
* 失败文案原样抛给抽屉红条。公共库写侧无公司维度。返回刷新后的详情(与
* fetchJdProductDetail 同一信封),抽屉用它回填。 */
export async function updateJdProduct(
id: number,
payload: JdProductUpdatePayload,
): Promise<ReturnType<typeof parseJdProductDetail>> {
const { data } = await http.put<unknown>(`${JD_PRODUCT_ENDPOINT}/${id}`, payload)
return parseJdProductDetail(data)
}
/** 图片上传参数(POST /{id}/images multipart):replaceImageId 有值=替换该登记行
* (后端继承原行档位,imageType/attrName 忽略);缺省=新增(imageType=MAIN/DETAIL,
* ATTR 需带 attrName)。objectKey 由服务端按上传字节 sha256 内容寻址生成(铁律 32),
* 前端不自造 key。返回刷新后的详情(与 fetchJdProductDetail 同一信封)。 */
export interface JdProductImageUploadParams {
replaceImageId?: number
imageType?: 'MAIN' | 'ATTR' | 'DETAIL'
attrName?: string
}
/** 上传/替换商品图片(multipart 后端中转):上传/替换即生效(服务端立即落库并置
* 人工编辑锁),与「删图保存时批量生效」不同。失败文案原样抛给抽屉。 */
export async function uploadJdProductImage(
id: number,
file: File,
params: JdProductImageUploadParams,
): Promise<ReturnType<typeof parseJdProductDetail>> {
const body = new FormData()
body.append('file', file)
if (params.replaceImageId != null) {
body.append('replace_image_id', String(params.replaceImageId))
}
if (params.imageType) body.append('image_type', params.imageType)
if (params.attrName) body.append('attr_name', params.attrName)
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/${id}/images`, body, {
headers: { 'Content-Type': 'multipart/form-data' },
})
return parseJdProductDetail(data)
}
/** 分组行(GET 列表返回:[{id,name,ownerGroupId,sortOrder,productCount}])。 */
export interface JdProductGroup {
id: number
name: string
ownerGroupId: number
sortOrder: number
productCount: number
}
/** 分组管理的写入负载(POST / PUT body:{name, sortOrder, ownerGroupId?})。 */
export interface JdProductGroupPayload {
name: string
sortOrder: number
/** 新建时归属的数据权限分组(缺省=操作者自己带的组,后端 requireWritableGroup 收敛)。 */
ownerGroupId?: number | null
}
/** 「当前分组」下拉的一项(GET /scope 的 groups[],V203):editable=本账号对该组分类可写
* (建/改名/删除/归类)。跨公司的组名由后端拼进 label,前端不解析公司字段。 */
export interface JdCategoryGroupOption {
id: number
name: string
label: string
editable: boolean
}
/** 分类作用域回执(GET /api/admin/jd-product-groups/scope):分组下拉 + 平台超管标记。 */
export interface JdCategoryScope {
platformSuperAdmin: boolean
defaultGroupId: number | null
groups: JdCategoryGroupOption[]
}
/** 分组信封是 `{code, message, data}` 三段式:code 非 0 =业务失败,message 是中文文案
* (重名等),用 errorTextOf 取出来抛给界面展示(unwrap 只认 success=false,不认 code)。 */
function groupDataOf<T>(payload: unknown): T {
const record = payload && typeof payload === 'object' ? (payload as Record<string, unknown>) : null
if (record && typeof record.code === 'number' && record.code !== 0) {
throw new Error(errorTextOf(payload))
}
return unwrap<T>(payload)
}
function numberOr(value: unknown, fallback: number): number {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : fallback
}
/** 分组下拉/管理列表:按「当前分组」(owner_group_id)取该组的分类(V203,跨组不可见);
* 缺省=后端按作用域默认分组取。失败由页面自己兜(分类只是筛选项,不拦首屏行集)。 */
export async function fetchJdProductGroups(ownerGroupId?: number | null): Promise<JdProductGroup[]> {
const params = typeof ownerGroupId === 'number' && ownerGroupId > 0
? { owner_group_id: ownerGroupId }
: undefined
const { data } = await http.get<unknown>(JD_PRODUCT_GROUP_ENDPOINT, { params })
const core = unwrap<unknown>(data)
if (!Array.isArray(core)) return []
const out: JdProductGroup[] = []
for (const raw of core) {
if (!raw || typeof raw !== 'object') continue
const record = raw as Record<string, unknown>
const id = numberOr(record.id, 0)
if (id <= 0) continue
out.push({
id,
name: typeof record.name === 'string' ? record.name.trim() : '',
ownerGroupId: numberOr(record.ownerGroupId ?? record.owner_group_id, 0),
sortOrder: numberOr(record.sortOrder ?? record.sort_order, 0),
productCount: numberOr(record.productCount ?? record.product_count, 0),
})
}
return out
}
/** 分类作用域(GET /scope):本账号可见的数据权限分组 + 每组可写标记。
* 页面用它渲染「分组」下拉并按 editable 渲染分类写入口;失败由页面自己兜(回空作用域=
* 分类列全空、分类管理页提示不属于任何分组,但商品列表照常可用)。 */
export async function fetchJdCategoryScope(): Promise<JdCategoryScope> {
const { data } = await http.get<unknown>(`${JD_PRODUCT_GROUP_ENDPOINT}/scope`)
const core = groupDataOf<unknown>(data)
const record = core && typeof core === 'object' ? (core as Record<string, unknown>) : {}
const rawGroups = Array.isArray(record.groups) ? record.groups : []
const groups: JdCategoryGroupOption[] = []
for (const raw of rawGroups) {
if (!raw || typeof raw !== 'object') continue
const row = raw as Record<string, unknown>
const id = numberOr(row.id, 0)
if (id <= 0) continue
const name = typeof row.name === 'string' ? row.name.trim() : ''
groups.push({
id,
name,
label: typeof row.label === 'string' && row.label.trim() ? row.label.trim() : name,
editable: row.editable === true,
})
}
return {
platformSuperAdmin: record.platformSuperAdmin === true || record.platform_super_admin === true,
defaultGroupId: numberOr(record.defaultGroupId ?? record.default_group_id, 0) || null,
groups,
}
}
/** 类目下拉选项(GET /categories 返回 [{name, productCount}],name=京麦末级类目即
* 落库的 category_path;等值过滤)。失败由页面自己兜(类目只是筛选项,不拦首屏行集)。 */
export interface JdProductCategoryOption {
name: string
productCount: number
}
export async function fetchJdProductCategories(): Promise<JdProductCategoryOption[]> {
const { data } = await http.get<unknown>(`${JD_PRODUCT_ENDPOINT}/categories`)
const core = unwrap<unknown>(data)
if (!Array.isArray(core)) return []
const out: JdProductCategoryOption[] = []
for (const raw of core) {
if (!raw || typeof raw !== 'object') continue
const record = raw as Record<string, unknown>
const name = typeof record.name === 'string' ? record.name.trim() : ''
if (!name) continue
out.push({ name, productCount: numberOr(record.productCount ?? record.product_count, 0) })
}
return out
}
/** 新建分类(归属当前分组,V203):ownerGroupId 缺省=后端取操作者自己带的组;
* 同一分组内重名等业务失败把后端中文文案抛回(页面直接展示)。 */
export async function createJdProductGroup(
payload: JdProductGroupPayload,
): Promise<JdProductGroup | null> {
const body: Record<string, unknown> = { name: payload.name, sortOrder: payload.sortOrder }
if (typeof payload.ownerGroupId === 'number' && payload.ownerGroupId > 0) {
body.ownerGroupId = payload.ownerGroupId
}
const { data } = await http.post<unknown>(JD_PRODUCT_GROUP_ENDPOINT, body)
return groupDataOf<JdProductGroup | null>(data)
}
/** 改名/改排序;业务失败文案同上。 */
export async function updateJdProductGroup(
id: number,
payload: JdProductGroupPayload,
): Promise<JdProductGroup | null> {
const body: Record<string, unknown> = { name: payload.name, sortOrder: payload.sortOrder }
const { data } = await http.put<unknown>(`${JD_PRODUCT_GROUP_ENDPOINT}/${id}`, body)
return groupDataOf<JdProductGroup | null>(data)
}
/** 删除分组;业务失败文案同上。 */
export async function deleteJdProductGroup(id: number): Promise<void> {
const { data } = await http.delete<unknown>(`${JD_PRODUCT_GROUP_ENDPOINT}/${id}`)
groupDataOf<unknown>(data)
}
/** 批量人工归类(2026-11-17 起唯一入口=京东数据库页工具栏「批量编辑分类」;
* 旧「店铺分类弹窗+工具栏移除分类」已随同日口径下线):勾选商品行(跨页累计)
* → 归入当前分组(ownerGroupId)的指定分类或移出分类(V203:归属写
* biz_jd_product_group_assign 的 (product_id, owner_group_id) 一行,同一商品各组可各自归类)。
* groupId 传 null=移出本组分类;返回实际写入/解挂的归属行数。
* 归类<b>不再置人工编辑锁</b>(2026-11-16 用户拍板):分类不在商品行上,采集冲不掉它。
* 业务失败(分类不存在/不属于当前分组)把中文文案抛回,对话框红条原样展示。 */
export async function batchAssignJdProductGroup(
ids: number[],
groupId: number | null,
ownerGroupId: number,
): Promise<number> {
const body: Record<string, unknown> = { ids, groupId, ownerGroupId }
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/batch-assign-group`, body)
return groupDataOf<number>(data)
}
@@ -0,0 +1,121 @@
/** 京东数据库页筛选纯函数(v1.4 Phase 5):商品编码/标题关键字/类目/分组/同步起止 + snake 分页参数。
* 产出与后端契约 §列表 query 逐字对撞:`page`/`page_size`(默认 20、上限 100)、
* `product_code`、`title_keyword`、`category`(京麦末级类目等值过滤,2026-11-15 增)、
* `group_id`(当前分组下的分类 id)、`owner_group_id`(当前数据权限分组,V203)、
* `synced_from`/`synced_to`(ISO yyyy-MM-dd;空白不下发)。
* 商品状态筛选与导出(2026-11-15 客户口径「这两个不要/导出也不用」)已从前端下线;
* 店铺筛选同日客户口径「店铺不需要」从前端下线(后端 shop_name 参数同窗撤,DB 列与详情不动)。
* 后端 `sale_status` 参数与 `/export` 端点保留(无 UI 入口),重上时从 git 历史找回取值口。
* 分页钳制(铁律 15):page < 1 归 1、上限 10_000(后端 CR-18 同值),(page-1)*page_size
* 最大 999_900,Number.MAX_SAFE_INTEGER 也不会把乘积顶出安全整数。纯逻辑,node --test 直测。
* 公司维已整页摘除(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」):归一化构造器
* 与入参类型都不认识 company_id——读侧发送口已随公司 tab 撤下(品牌库 2026-10-06 先例同形)。
* 日期默认空字符串:同步台账是累计数据,默认当天会让首屏只剩今天同步的行
* (date-filter-default-today 护栏 EXEMPT 口径,外观专利页同款)。 */
import { validIsoDateOrUndefined } from '../asin/asin-filter.ts'
/** 每页条数默认 20(v1.4 §3.4),上限 100。 */
export const JD_PRODUCT_PAGE_SIZE = 20
export const JD_PRODUCT_MAX_PAGE_SIZE = 100
/** 页码上限:与后端 MAX_PAGE(CR-18 先例,外观专利同值)对齐,两侧不漂。 */
export const JD_PRODUCT_MAX_PAGE = 10_000
export interface JdProductFilterState {
/** 商品编码,空串不限。 */
productCode: string
/** 标题关键字,空串不限。 */
titleKeyword: string
/** 类目(京麦末级类目名,等值过滤;选项来自 GET /categories),空串=全部类目。 */
category: string
/** 分组 id 文本(分组管理里那一行),空串=全部分组。 */
groupId: string
/** 同步开始日期(ISO yyyy-MM-dd;空串不限)。 */
syncedFrom: string
/** 同步结束日期(ISO yyyy-MM-dd;空串不限)。 */
syncedTo: string
}
export function createJdProductFilterState(): JdProductFilterState {
return { productCode: '', titleKeyword: '', category: '', groupId: '', syncedFrom: '', syncedTo: '' }
}
/** 是否有任一激活筛选条件。 */
export function jdProductFilterActive(state: JdProductFilterState): boolean {
if ((state.productCode || '').trim()) return true
if ((state.titleKeyword || '').trim()) return true
if ((state.category || '').trim()) return true
if ((state.groupId || '').trim()) return true
if (validIsoDateOrUndefined(state.syncedFrom) || validIsoDateOrUndefined(state.syncedTo)) return true
return false
}
/** 序列化到后端的列表查询参数(snake_case,仅下发非空字段)。 */
export interface JdProductQuery {
page: number
page_size: number
product_code?: string
title_keyword?: string
/** 京麦末级类目等值过滤(后端 JdProductQueryService.Filter.category)。 */
category?: string
/** 自定义分类 id(当前分组下的一个分类;V203 起按归属表 EXISTS 过滤)。 */
group_id?: number
/** 当前数据权限分组 id(分类列/分类筛选都按它取;V203「不同组不能看到跨组的分类」)。 */
owner_group_id?: number
synced_from?: string
synced_to?: string
}
/** api 模块的入参:筛选态 + 分页 + 当前分组(公共库无公司维度)。 */
export interface JdProductListParams {
page: number
pageSize: number
productCode?: string
titleKeyword?: string
category?: string
groupId?: string
/** 当前分组(数据权限分组 id):分类列/分类筛选的作用域,非筛选条件(重置不清它)。 */
ownerGroupId?: number | null
syncedFrom?: string
syncedTo?: string
}
/** 过滤态 → 过滤面参数(snake_case,仅下发非空字段)。 */
function toJdProductFilterQuery(state: JdProductFilterState): Omit<JdProductQuery, 'page' | 'page_size'> {
const query: Omit<JdProductQuery, 'page' | 'page_size'> = {}
const productCode = (state.productCode || '').trim()
if (productCode) query.product_code = productCode
const titleKeyword = (state.titleKeyword || '').trim()
if (titleKeyword) query.title_keyword = titleKeyword
const category = (state.category || '').trim()
if (category) query.category = category
const groupId = Number.parseInt((state.groupId || '').trim(), 10)
if (Number.isFinite(groupId) && groupId > 0) query.group_id = groupId
const syncedFrom = validIsoDateOrUndefined(state.syncedFrom)
if (syncedFrom) query.synced_from = syncedFrom
const syncedTo = validIsoDateOrUndefined(state.syncedTo)
if (syncedTo) query.synced_to = syncedTo
return query
}
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期不下发,分页钳制在此单出口(不含公司维)。
* {@code ownerGroupId} 是「当前分组」(分类列/分类筛选作用域,V203),不是筛选条件:
* >0 时下发 `owner_group_id`,缺省/0 不下发=后端按作用域默认分组取。 */
export function toJdProductListParams(
state: JdProductFilterState,
page: number,
pageSize: number,
ownerGroupId?: number | null,
): JdProductQuery {
const safePage = Math.min(Math.max(Math.floor(page) || 1, 1), JD_PRODUCT_MAX_PAGE)
const rawSize = Math.floor(pageSize) || JD_PRODUCT_PAGE_SIZE
const safeSize = Math.min(Math.max(rawSize, 1), JD_PRODUCT_MAX_PAGE_SIZE)
const query: JdProductQuery = {
page: safePage,
page_size: safeSize,
...toJdProductFilterQuery(state),
}
if (typeof ownerGroupId === 'number' && Number.isFinite(ownerGroupId) && ownerGroupId > 0) {
query.owner_group_id = Math.floor(ownerGroupId)
}
return query
}
@@ -0,0 +1,347 @@
/** 京东数据库列表查询模型(v1.4 Phase 5):解析 JdProductPageVo(camel),纯逻辑零依赖。
* camel 为正、snake 容错(与外观专利/去重页模型同形),缺 id 弃行。
* 纯函数、无框架依赖(envelope 只借纯 unwrap),node --test 可直测。 */
import { unwrap } from '../../api/envelope.ts'
/** 京东商品列表行(后端 JdProductItemVo,camel 为正)。 */
export interface JdProductItem {
id: number
shopId: number | null
shopName: string
productCode: string
skuId: string
/** 货号(京麦后台「货号」列,与 SKU 不是同一个值)。 */
itemNum: string
/** SKU 数(京麦后台「12个SKU」列)。 */
skuCount: number | null
/** 信息分(京麦后台「信息分」列)。 */
healthScore: number | null
title: string
brand: string
categoryPath: string
/** 价格区间下限(京麦 priceDetailVO.minJdPrice):后端 BigDecimal 序列化成 JSON number,
* decimalText 数值/字符串都收——2026-11-16 实录:text() 把 number 丢成空串=生产库
* 273/273 行 price_min 全有值而列表价格全显示「-」(用户报「价格没采集到」的真因)。 */
priceMin: string
/** 价格区间上限(京麦 priceDetailVO.maxJdPrice),解析口径同 priceMin。 */
priceMax: string
stockTotal: number | null
/** 上架中/已下架/审核中/草稿。 */
saleStatus: string
listTab: string
jdCreatedAt: string
/** 上架时间(京麦后台「上架时间」列,与创建时间不是同一个值)。 */
jdOnlineAt: string
jdUpdatedAt: string
mainImageUrl: string
attrCount: number | null
imageCount: number | null
groupId: number | null
groupName: string
syncedAt?: string
}
export interface JdProductPageResult {
items: JdProductItem[]
total: number
page: number
pageSize: number
}
/** 前端首屏默认容量(与 filter 侧 JD_PRODUCT_PAGE_SIZE 同值 20)。 */
export const JD_PRODUCT_DEFAULT_SIZE = 20
export function emptyJdProductPage(): JdProductPageResult {
return { items: [], total: 0, page: 1, pageSize: JD_PRODUCT_DEFAULT_SIZE }
}
function text(value: unknown): string {
return typeof value === 'string' ? value.trim() : ''
}
function numberOrNull(value: unknown): number | null {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
}
/** 价格区间展示:min/max 都空为 -,只空一侧给单值。输入数值/字符串都收
* (后端 BigDecimal 序列化成 JSON number;列表行解析层之外,mount 测试 mock
* 绕过解析层时 number 会原样进这里——对 number 直接 .trim() 抛 TypeError
* 炸整页渲染,2026-11-16 实录),统一 decimalText 归一后再拼。 */
export function jdPriceRange(item: Pick<JdProductItem, 'priceMin' | 'priceMax'>): string {
const min = decimalText(item.priceMin).trim()
const max = decimalText(item.priceMax).trim()
if (min && max) return min === max ? min : `${min} ~ ${max}`
return min || max || ''
}
/** 解析单行;缺 id 视为无效。camel 为正、snake 容错。 */
export function toJdProductItem(raw: unknown): JdProductItem | null {
if (!raw || typeof raw !== 'object') return null
const record = raw as Record<string, unknown>
const id = numberOrNull(record.id)
if (id === null) return null
return {
id,
shopId: numberOrNull(record.shopId ?? record.shop_id),
shopName: text(record.shopName ?? record.shop_name),
productCode: text(record.productCode ?? record.product_code),
skuId: text(record.skuId ?? record.sku_id),
itemNum: text(record.itemNum ?? record.item_num),
skuCount: numberOrNull(record.skuCount ?? record.sku_count),
healthScore: numberOrNull(record.healthScore ?? record.health_score),
title: text(record.title),
brand: text(record.brand),
categoryPath: text(record.categoryPath ?? record.category_path),
// 价格必须走 decimalText(数值/字符串都收):后端 BigDecimal 序列化成 JSON number,
// text() 对非字符串一律回空串=采集到的价格在解析层被丢掉(2026-11-16 生产库 273 行
// price_min 全有值、列表全「-」实录)。与详情 SKU 价(decimalText)同一出口。
priceMin: decimalText(record.priceMin ?? record.price_min),
priceMax: decimalText(record.priceMax ?? record.price_max),
stockTotal: numberOrNull(record.stockTotal ?? record.stock_total),
saleStatus: text(record.saleStatus ?? record.sale_status),
listTab: text(record.listTab ?? record.list_tab),
jdCreatedAt: text(record.jdCreatedAt ?? record.jd_created_at),
jdOnlineAt: text(record.jdOnlineAt ?? record.jd_online_at),
jdUpdatedAt: text(record.jdUpdatedAt ?? record.jd_updated_at),
mainImageUrl: text(record.mainImageUrl ?? record.main_image_url),
attrCount: numberOrNull(record.attrCount ?? record.attr_count),
imageCount: numberOrNull(record.imageCount ?? record.image_count),
groupId: numberOrNull(record.groupId ?? record.group_id),
groupName: text(record.groupName ?? record.group_name),
syncedAt: text(record.syncedAt ?? record.synced_at) || undefined,
}
}
/** 归一化分页负载(信封或已解包 VO)为前端结果;缺省字段回默认。 */
export function parseJdProductPage(payload: unknown): JdProductPageResult {
const out = emptyJdProductPage()
const core = unwrap<unknown>(payload)
if (!core || typeof core !== 'object') return out
const record = core as Record<string, unknown>
if (Array.isArray(record.items)) {
out.items = record.items
.map((raw) => toJdProductItem(raw))
.filter((item): item is JdProductItem => item !== null)
}
if (typeof record.total === 'number') out.total = Math.floor(record.total)
if (typeof record.page === 'number' && record.page >= 1) out.page = Math.floor(record.page)
const rawSize = record.pageSize ?? record.page_size
if (typeof rawSize === 'number' && rawSize >= 1) out.pageSize = Math.floor(rawSize)
return out
}
/** 详情属性块:attrGroups[{groupName, attrs:[{key,label,value}]}]。 */
export interface JdProductAttrEntry {
key: string
label: string
value: string
}
export interface JdProductAttrGroup {
groupName: string
attrs: JdProductAttrEntry[]
}
/** 详情图片:images[{id, imageType, attrName, sortNo, url, byteSize, width, height}]
* (id=biz_jd_product_image 行号,编辑抽屉按它提交删图;旧后端不带 id 时按缺 0 弃行口径不拦展示)。 */
export interface JdProductImage {
id: number
imageType: string
attrName: string
sortNo: number
url: string
byteSize: number | null
width: number | null
height: number | null
}
/** 销售属性组合的一项(颜色=上衣 / 尺码=S,京麦详情页「销售属性」)。 */
export interface JdProductSkuAttr {
name: string
value: string
}
/** 详情 SKU 行(后端 JdProductDetailVo.SkuVo,V198;京麦 12 行矩阵的一行)。 */
export interface JdProductSku {
skuId: string
skuName: string
/** 商家自定义序号(京麦 skuSeq)。 */
skuSeq: string
/** 京东价(后端 BigDecimal,前端按文本展示,不做金额运算)。 */
price: string
stock: number | null
saleAttrs: JdProductSkuAttr[]
sortNo: number
}
export interface JdProductDetail {
item: JdProductItem
attrGroups: JdProductAttrGroup[]
images: JdProductImage[]
/** SKU 矩阵(京麦详情页「销售属性」区,V198;旧数据为空数组)。 */
skus: JdProductSku[]
/** attrGroups 解析失败时的原始 JSON 兜底(界面原样展示,不静默吞)。 */
attrJsonRaw: string
}
/** 归一化 attrGroups(camel/snake 同级容错),非法项跳过、块名缺省归「属性」。 */
function toAttrGroups(raw: unknown): JdProductAttrGroup[] {
if (!Array.isArray(raw)) return []
const out: JdProductAttrGroup[] = []
for (const groupRaw of raw) {
if (!groupRaw || typeof groupRaw !== 'object') continue
const group = groupRaw as Record<string, unknown>
const groupName = text(group.groupName ?? group.group_name) || '属性'
const attrsRaw = group.attrs
if (!Array.isArray(attrsRaw)) continue
const attrs: JdProductAttrEntry[] = []
for (const attrRaw of attrsRaw) {
if (!attrRaw || typeof attrRaw !== 'object') continue
const attr = attrRaw as Record<string, unknown>
attrs.push({
key: text(attr.key),
label: text(attr.label),
value: text(attr.value),
})
}
out.push({ groupName, attrs })
}
return out
}
/** 归一化 images;缺 url 弃行(界面没有可展示/可打开的目标),sortNo 缺省 0。 */
function toImages(raw: unknown): JdProductImage[] {
if (!Array.isArray(raw)) return []
const out: JdProductImage[] = []
for (const imageRaw of raw) {
if (!imageRaw || typeof imageRaw !== 'object') continue
const image = imageRaw as Record<string, unknown>
const url = text(image.url)
if (!url) continue
out.push({
id: numberOrNull(image.id) ?? 0,
imageType: text(image.imageType ?? image.image_type),
attrName: text(image.attrName ?? image.attr_name),
sortNo: numberOrNull(image.sortNo ?? image.sort_no) ?? 0,
url,
byteSize: numberOrNull(image.byteSize ?? image.byte_size),
width: numberOrNull(image.width),
height: numberOrNull(image.height),
})
}
return out
}
/** 数值/字符串都收(后端 BigDecimal 序列化成 JSON number),去尾零后展示:
* 京麦详情页写 `162`,不给 `162.00`;数字形状之外的原文照原样回(不吞异常值)。 */
function decimalText(value: unknown): string {
if (typeof value === 'number' && Number.isFinite(value)) {
return String(Math.round(value * 100) / 100)
}
const raw = text(value)
if (!/^\d+(?:\.\d+)?$/.test(raw)) return raw
return String(Math.round(Number(raw) * 100) / 100)
}
/** 归一化 SKU 矩阵(camel/snake 容错);缺 skuId 弃行(京麦每一行都以 skuId 为身份)。 */
function toSkus(raw: unknown): JdProductSku[] {
if (!Array.isArray(raw)) return []
const out: JdProductSku[] = []
for (const skuRaw of raw) {
if (!skuRaw || typeof skuRaw !== 'object') continue
const sku = skuRaw as Record<string, unknown>
const skuId = text(sku.skuId ?? sku.sku_id)
if (!skuId) continue
const saleAttrs: JdProductSkuAttr[] = []
const attrsRaw = sku.saleAttrs ?? sku.sale_attrs
if (Array.isArray(attrsRaw)) {
for (const attrRaw of attrsRaw) {
if (!attrRaw || typeof attrRaw !== 'object') continue
const attr = attrRaw as Record<string, unknown>
const value = text(attr.value)
if (!value) continue
saleAttrs.push({ name: text(attr.name) || '属性', value })
}
}
out.push({
skuId,
skuName: text(sku.skuName ?? sku.sku_name),
skuSeq: text(sku.skuSeq ?? sku.sku_seq),
price: decimalText(sku.price),
stock: numberOrNull(sku.stock),
saleAttrs,
sortNo: numberOrNull(sku.sortNo ?? sku.sort_no) ?? 0,
})
}
return out
}
/** 销售属性维度名(按首次出现顺序):京麦详情页「颜色 / 尺码」两列。 */
export function jdSkuDimensions(skus: JdProductSku[]): string[] {
const order: string[] = []
for (const sku of skus) {
for (const attr of sku.saleAttrs) {
if (!order.includes(attr.name)) order.push(attr.name)
}
}
return order
}
/** SKU 矩阵汇总:`12 个 SKU · ¥162 ~ ¥168 · 库存 2400`(缺项不硬凑)。 */
export function jdSkuSummary(skus: JdProductSku[]): string {
if (!skus.length) return ''
const prices = skus
.map((sku) => Number(sku.price))
.filter((value) => Number.isFinite(value) && value > 0)
const priceText = prices.length
? Math.min(...prices) === Math.max(...prices)
? `¥${Math.min(...prices)}`
: `¥${Math.min(...prices)} ~ ¥${Math.max(...prices)}`
: ''
const stocks = skus.map((sku) => sku.stock).filter((value): value is number => typeof value === 'number')
const stockText = stocks.length ? `库存 ${stocks.reduce((sum, value) => sum + value, 0)}` : ''
return [`${skus.length} 个 SKU`, priceText, stockText].filter(Boolean).join(' · ')
}
/** 解析详情负载(信封或已解包 VO);attrGroups 解析不出时回 attrJsonRaw 原文兜底。 */
export function parseJdProductDetail(payload: unknown): JdProductDetail {
const core = unwrap<unknown>(payload)
const record = core && typeof core === 'object' ? (core as Record<string, unknown>) : {}
const item = toJdProductItem(record) ?? {
id: 0,
shopId: null,
shopName: '',
productCode: '',
skuId: '',
itemNum: '',
skuCount: null,
healthScore: null,
title: '',
brand: '',
categoryPath: '',
priceMin: '',
priceMax: '',
stockTotal: null,
saleStatus: '',
listTab: '',
jdCreatedAt: '',
jdOnlineAt: '',
jdUpdatedAt: '',
mainImageUrl: '',
attrCount: null,
imageCount: null,
groupId: null,
groupName: '',
}
const attrGroups = toAttrGroups(record.attrGroups ?? record.attr_groups)
const attrJsonRaw = typeof record.attrJsonRaw === 'string'
? record.attrJsonRaw
: typeof record.attr_json_raw === 'string' ? record.attr_json_raw : ''
return {
item,
attrGroups,
images: toImages(record.images),
skus: toSkus(record.skus),
attrJsonRaw,
}
}
@@ -0,0 +1,444 @@
<script setup lang="ts">
import { formatDateTime, orderedPair } from '@/utils/datetime'
/** 外观专利数据库 · 明细分页表(2026-11-11 晚间按客户口径恢复「昨天那个格式」:
* 「不是这种格式 你就按照昨天那个格式」——撤掉一主管一卡视图,恢复只读明细表;
* 「添加个管理员 跟导出数据就可以」——表上加「管理员」列(后端读侧现算:主管/公司超管=自己,
* 普通账户=创建人,读不到为空展示 -,不猜名),筛选行加「导出」(与「去重数据库」页同款:
* 当前过滤面+公司 tab 全量出 xlsx,不传 supervisor_user_id——传了会走按主管分支并忽略任务号/ASIN);
* 「任务号/ASIN 两个筛选框恢复」(后端能力一直在,之前产品决定下过架,客户要「一目了然」选数据);
* 分组(主管)下拉保留「选中即查」。数据按 ASIN 累计:同 ASIN 只保留一条(V192 唯一键,
* 重复检测更新那条),不同 ASIN 同品牌全保留——页面只管展示,累计语义在后端同步链。
* 主管卡片视图与卡片级删除按钮从页面下架(客户下午反馈数据疑似被误删,删除入口先撤;
* 后端 /supervisors 两接口保留不动)。 */
import { computed, onMounted, reactive, ref, watch } from 'vue'
import {
exportAppearancePatentCleanList,
fetchAppearancePatentCleanList,
fetchDedupeTotalGroups,
type DedupeGroupOption,
} from './appearance-patent-clean-api.ts'
import type { AppearancePatentCleanItem } from './appearance-patent-clean-model.ts'
import { cleanItemReasonTooltip } from './appearance-patent-clean-model.ts'
import { createAppearancePatentCleanFilterState } from './appearance-patent-clean-filter.ts'
import { ASIN_COUNTRY_CODES, asinCountryLabel } from '../asin/asin-country.ts'
import OldPagination from '@/components/OldPagination.vue'
import { useCompanyTabStore } from '@/stores/company-tab'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { loadFailureMessage } from '@/components/load-failure-model'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
const companyTab = useCompanyTabStore()
const loading = ref(false)
const loadFailure = ref('')
const rows = ref<AppearancePatentCleanItem[]>([])
const total = ref(0)
const page = ref(1)
const pageSize = ref(10)
/** 导出在途锁:避免连点导出把同一份过滤面重复请求两遍。 */
const exporting = ref(false)
/** 同步台账是累计数据,日期初值故意留空(默认当天会让首屏只剩今天同步的行);见 date-filter-default-today 护栏的 EXEMPT。 */
const filter = reactive(createAppearancePatentCleanFilterState())
/** 分组(主管)下拉选项:公司 tab 切换时重取;选项失败不拦列表,只回空下拉(可见「全部分组」)。 */
const groupOptions = ref<DedupeGroupOption[]>([])
/** min/max 挡不住手输,落值后把倒挂的起止交换回来。 */
function clampDatePair(): void {
const [s, e] = orderedPair(filter.startDate, filter.endDate)
filter.startDate = s
filter.endDate = e
}
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
/** 分组选项与去重页/店铺管理同源(GET /shop-manages/groups);失败静默回空——分组只是筛选项,
* 不该让它把首屏行集一起拖死(列表失败有自己的 LoadFailureBar)。 */
async function loadGroupOptions(): Promise<void> {
try {
groupOptions.value = await fetchDedupeTotalGroups(companyTab.requestCompanyId)
} catch {
groupOptions.value = []
}
}
async function load(): Promise<void> {
loading.value = true
loadFailure.value = ''
try {
const result = await fetchAppearancePatentCleanList({
page: page.value,
pageSize: pageSize.value,
taskId: filter.taskId,
asin: filter.asin,
country: filter.country,
groupId: filter.groupId,
startDate: filter.startDate,
endDate: filter.endDate,
companyId: companyTab.requestCompanyId,
})
rows.value = result.items
total.value = result.total
if (result.page >= 1) page.value = result.page
} catch (error) {
loadFailure.value = loadFailureMessage(error, '无侵权数据加载失败')
showAdminFeedback(loadFailure.value, 'error')
} finally {
loading.value = false
}
}
/** 导出与页签同一过滤面(含公司 tab 与分组),服务端全量出 xlsx;成功后浏览器落盘,失败弹可读文案。
* 不传 supervisor_user_id:按主管分支会忽略任务号/ASIN 参数,「按当前筛选导出」必须走明细分支。 */
async function exportAll(): Promise<void> {
if (exporting.value) return
exporting.value = true
try {
const result = await exportAppearancePatentCleanList({
taskId: filter.taskId,
asin: filter.asin,
country: filter.country,
groupId: filter.groupId,
startDate: filter.startDate,
endDate: filter.endDate,
companyId: companyTab.requestCompanyId,
})
const url = URL.createObjectURL(result.blob)
const anchor = document.createElement('a')
anchor.href = url
anchor.download = result.filename
document.body.appendChild(anchor)
anchor.click()
anchor.remove()
URL.revokeObjectURL(url)
showAdminFeedback(`已导出 ${result.filename}`, 'success')
} catch (error) {
const message = error instanceof Error && error.message ? error.message : '导出失败,请稍后重试'
showAdminFeedback(message, 'error')
} finally {
exporting.value = false
}
}
function apply(): void {
page.value = 1
void load()
}
/** 重置(对齐店铺数据记录页样式):筛选面回出厂空态,回第一页重取。 */
function reset(): void {
Object.assign(filter, createAppearancePatentCleanFilterState())
page.value = 1
void load()
}
function changePage(next: number): void {
if (next < 1 || next > totalPages.value) return
page.value = next
void load()
}
function changeSize(size: number) {
pageSize.value = size
page.value = 1
void load()
}
// 切公司 = 重新取数:任务号/ASIN/分组是上一家选中的值,在新一家的行集里筛不出东西,必须一起清,
// 分组选项也按新公司重取(选项集是公司隔离的)。
watch(() => companyTab.activeId, () => { filter.taskId = ''; filter.asin = ''; filter.groupId = ''; page.value = 1; void loadGroupOptions(); void load() })
onMounted(() => {
void loadGroupOptions()
void load()
})
</script>
<template>
<div class="clean-items-view">
<section class="panel-box">
<div class="clean-panel-head">
<h3>外观专利数据库</h3>
</div>
<div class="clean-filter-row">
<div class="form-group">
<label>任务号</label>
<input v-model="filter.taskId" type="text" placeholder="输入任务号" @keyup.enter="apply" />
</div>
<div class="form-group">
<label>ASIN</label>
<input v-model="filter.asin" type="text" placeholder="输入 ASIN" @keyup.enter="apply" />
</div>
<div class="form-group">
<label>国家</label>
<select v-model="filter.country">
<option value="">全部国家</option>
<option v-for="code in ASIN_COUNTRY_CODES" :key="code" :value="code">{{ asinCountryLabel(code) }}</option>
</select>
</div>
<div class="form-group">
<label>分组</label>
<!-- 分组(主管)选中即查:选完立刻按该主管过滤刷新(回第一页),不必再点查询。 -->
<select v-model="filter.groupId" @change="apply">
<option value="">全部分组</option>
<option v-for="group in groupOptions" :key="group.id" :value="String(group.id)">{{ group.name }}</option>
</select>
</div>
<div class="form-group">
<label>同步开始日期</label>
<input v-model="filter.startDate" type="date" :max="filter.endDate" @change="clampDatePair" />
</div>
<div class="form-group">
<label>同步结束日期</label>
<input v-model="filter.endDate" type="date" :min="filter.startDate" @change="clampDatePair" />
</div>
<div class="clean-filter-actions">
<button class="btn" type="button" @click="apply">查询</button>
<button class="btn btn-export" type="button" :disabled="exporting" @click="exportAll">
{{ exporting ? '导出中...' : '导出' }}
</button>
<button class="btn btn-secondary" type="button" @click="reset">重置</button>
</div>
</div>
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<div class="clean-toolbar">
<span class="clean-summary">共 {{ total }} 条无侵权数据</span>
</div>
<div class="table-scroll clean-table-scroll">
<table>
<thead>
<tr>
<th style="width: 90px">任务号</th>
<th style="width: 110px">管理员</th>
<th>ASIN</th>
<th style="width: 64px">国家</th>
<th>SKU</th>
<th>品牌</th>
<th style="width: 90px">价格</th>
<th>标题</th>
<th style="width: 130px">结论</th>
<th style="width: 170px">同步时间</th>
</tr>
</thead>
<tbody>
<template v-if="rows.length">
<tr v-for="row in rows" :key="row.id">
<td>{{ row.taskId ?? '-' }}</td>
<td :title="row.supervisorName || ''">{{ row.supervisorName || '-' }}</td>
<td class="mono-cell">{{ row.asin || '-' }}</td>
<td>{{ asinCountryLabel(row.country || '') }}</td>
<td class="mono-cell">{{ row.sku || '-' }}</td>
<td>{{ row.brand || '-' }}</td>
<td>{{ row.price || '-' }}</td>
<td class="title-cell" :title="row.title">{{ row.title || '-' }}</td>
<td class="conclusion-cell" :title="cleanItemReasonTooltip(row)">{{ row.conclusion || '-' }}</td>
<td>{{ formatDateTime(row.syncedAt || '') }}</td>
</tr>
</template>
<tr v-else-if="loading">
<td colspan="10" class="empty-tip">加载中...</td>
</tr>
<tr v-else>
<td colspan="10" class="empty-tip">暂无无侵权数据</td>
</tr>
</tbody>
</table>
</div>
<OldPagination :total="total" :page="page" :page-size="pageSize" @change="changePage" @size-change="changeSize" />
</section>
</div>
</template>
<style scoped>
/* 像素复刻参照「去重数据库」页(panel-box + 自绘表格 + 旧式分页),只读无操作列。
2026-11-11 晚间恢复明细表形态(客户「按照昨天那个格式」),表头第二列=管理员。 */
.clean-items-view {
font-family: inherit;
color: var(--c-text, #24384d);
display: flex;
flex-direction: column;
gap: 18px;
}
.panel-box {
width: 100%;
min-width: 0;
padding: 20px 22px 24px;
border: 1px solid #d8e3ee;
border-radius: 14px;
background: linear-gradient(145deg, #ffffff, #f9fbfd);
box-shadow: 0 1px 2px rgba(39, 67, 94, 0.04), 0 14px 30px -24px rgba(39, 67, 94, 0.28);
}
h3 {
margin: 0 0 16px;
font-size: 15px;
font-weight: 650;
color: #24384d;
letter-spacing: 0.2px;
}
.clean-panel-head h3 {
margin: 0 0 16px;
}
.clean-filter-row {
display: grid;
grid-template-columns: repeat(6, minmax(150px, 1fr)) auto;
gap: 12px;
align-items: end;
margin-bottom: 16px;
}
.clean-filter-row .form-group {
min-width: 0;
}
.clean-filter-actions {
display: flex;
gap: 10px;
align-items: center;
white-space: nowrap;
}
.form-group {
display: flex;
flex-direction: column;
gap: 7px;
margin-bottom: 0;
}
.form-group label {
color: #5b6f83;
font-size: 12.5px;
font-weight: 600;
}
.form-group input,
.form-group select {
min-width: 0;
min-height: 42px;
padding: 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
color-scheme: light;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.form-group input:hover,
.form-group select:hover {
border-color: #9fb7cd;
}
.form-group input:focus,
.form-group select:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.form-group input[type="date"] {
color-scheme: light;
}
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 8px;
min-height: 42px;
padding: 9px 18px;
border: 1px solid #4f78a5;
border-radius: 9px;
background: linear-gradient(135deg, #5f85ad, #4f78a5);
color: #ffffff;
font-family: inherit;
font-size: 13.5px;
cursor: pointer;
box-shadow: 0 8px 18px -14px rgba(79, 120, 165, 0.72);
transition: background 160ms ease, box-shadow 160ms ease, transform 120ms ease;
}
.btn:hover:not(:disabled) {
background: linear-gradient(135deg, #7094ba, #5d83ac);
box-shadow: 0 11px 22px -14px rgba(79, 120, 165, 0.8);
}
.btn:disabled {
cursor: not-allowed;
opacity: 0.6;
}
.btn-secondary {
background: #ffffff;
color: #5b6f83;
border-color: #c7d7e5;
}
.btn-secondary:hover:not(:disabled) {
color: #2f5d8b;
border-color: #95b1cb;
background: #edf5fb;
}
.clean-toolbar {
display: flex;
align-items: center;
margin-bottom: 10px;
}
.clean-summary {
color: #5b6f83;
font-size: 13px;
white-space: nowrap;
}
.table-scroll {
width: 100%;
min-width: 0;
overflow-x: auto;
border: 1px solid #dbe5ee;
border-radius: 10px;
background: #ffffff;
}
.table-scroll table {
width: 100%;
border-collapse: collapse;
table-layout: fixed;
}
/* 同步时间列=`YYYY-MM-DD HH:mm:ss` 固定 19 字符,13.5px 下实测约 133px;全局 `* { box-sizing: border-box }`
把 24px 左右内边距算进列宽,旧的 150px 只剩 126px 内容宽 ⇒ 末尾被 ellipsis 吃掉(客户 2026-11-12
反馈「日期显示不全」)。170px 与店铺管理/跳过价格等页的时间列同值(内容宽 146px,留 13px 余量);
表 min-width 同步 +20px,其余列的可用宽度与改前一致。 */
.clean-table-scroll > table {
min-width: 1060px;
}
.table-scroll th,
.table-scroll td {
padding: 10px 12px;
text-align: left;
font-size: 13.5px;
line-height: 1.5;
border-bottom: 1px solid #e0e8ef;
vertical-align: middle;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.table-scroll th {
background: #edf4fa;
color: #4e6479;
border-bottom-color: #d5e1eb;
font-size: 12.5px;
font-weight: 600;
letter-spacing: 0.4px;
}
.table-scroll tbody tr:hover td {
background: #f1f7fb;
}
.table-scroll tbody tr:last-child td {
border-bottom: 0;
}
.mono-cell {
font-family: "Cascadia Mono", "SF Mono", Consolas, "Courier New", monospace;
font-size: 12.5px;
}
.title-cell {
max-width: 260px;
}
.conclusion-cell {
max-width: 130px;
}
.empty-tip {
padding: 44px 24px;
text-align: center;
color: #8293a5;
font-size: 13.5px;
}
</style>
@@ -0,0 +1,104 @@
/** 外观专利无侵权数据列表查询适配(v1.3 AC-5):GET /api/admin/appearance-patent-clean-items。
* 只读页+导出(2026-11-11 客户需求「数据得导出来」):公司 tab 的值由本发送口从原始入参自己下传
* (白名单构造不认识 company_id),取值口形状由 company-tab-wiring 护栏钉住。
* 2026-11-11 晚间恢复明细表:主管聚合(/supervisors)与按主管删除的前端发送口随卡片视图一并
* 下架(客户「不是这种格式 按照昨天那个格式」+删除入口先撤);后端两接口保留,要恢复时
* 从 git 历史(e1767faf)找回。 */
import { http } from '@/api/http'
import { errorTextOf, unwrap } from '../../api/envelope.ts'
import {
toAppearancePatentCleanExportParams,
toAppearancePatentCleanListParams,
type AppearancePatentCleanExportParams,
type AppearancePatentCleanExportQuery,
type AppearancePatentCleanListParams,
} from './appearance-patent-clean-filter.ts'
import {
parseAppearancePatentCleanPage,
type AppearancePatentCleanPageResult,
} from './appearance-patent-clean-model.ts'
export const APPEARANCE_PATENT_CLEAN_ENDPOINT = '/api/admin/appearance-patent-clean-items'
export async function fetchAppearancePatentCleanList(
params: AppearancePatentCleanListParams,
): Promise<AppearancePatentCleanPageResult> {
const query = toAppearancePatentCleanListParams(
{
taskId: params.taskId ?? '',
asin: params.asin ?? '',
country: params.country ?? '',
groupId: params.groupId ?? '',
startDate: params.startDate ?? '',
endDate: params.endDate ?? '',
},
params.page,
params.pageSize,
)
if (params.companyId != null) query.company_id = params.companyId
const { data } = await http.get<unknown>(APPEARANCE_PATENT_CLEAN_ENDPOINT, { params: query })
return parseAppearancePatentCleanPage(data)
}
export interface AppearancePatentCleanExportResult {
blob: Blob
filename: string
}
/** 从 Content-Disposition 取 filename*(UTF-8 轨,后端 DownloadHeaderUtil 双轨口径),取不到回退常量名。 */
function exportFilenameOf(disposition: unknown): string {
const raw = typeof disposition === 'string' ? disposition : ''
const star = /filename\*=(?:UTF-8'')?([^;]+)/i.exec(raw)
if (star?.[1]) {
try {
return decodeURIComponent(star[1].trim().replace(/^"|"$/g, '')) || '外观专利数据库.xlsx'
} catch {
// 编码坏的 filename* 当作没有,走 ASCII 轨或常量名
}
}
const plain = /filename="([^"]+)"/i.exec(raw)
return plain?.[1] || '外观专利数据库.xlsx'
}
/** 导出当前过滤面全量明细:与列表共用同一过滤面取值口(含公司 tab),blob 下载交给页面触发保存。 */
export async function exportAppearancePatentCleanList(
params: AppearancePatentCleanExportParams,
): Promise<AppearancePatentCleanExportResult> {
const query: AppearancePatentCleanExportQuery = toAppearancePatentCleanExportParams({
taskId: params.taskId ?? '',
asin: params.asin ?? '',
country: params.country ?? '',
groupId: params.groupId ?? '',
startDate: params.startDate ?? '',
endDate: params.endDate ?? '',
})
if (params.companyId != null) query.company_id = params.companyId
const response = await http.get<Blob>(`${APPEARANCE_PATENT_CLEAN_ENDPOINT}/export`, {
params: query,
responseType: 'blob',
timeout: 120_000,
})
const disposition = response.headers?.['content-disposition']
if (!disposition) {
// 没有附件头=服务端回了业务错误信封(HTTP 200 + JSON),把 blob 文本解回错误文案抛给页面
const blob = response.data
let payload: unknown = null
if (blob && typeof blob.text === 'function') {
const text = await blob.text()
try {
payload = JSON.parse(text)
} catch {
payload = text
}
}
throw new Error(errorTextOf(payload))
}
return { blob: response.data, filename: exportFilenameOf(disposition) }
}
/** 分组(主管)下拉选项:复用既有 GET /shop-manages/groups(与去重页/店铺管理共用同一分组集,
* 不下新端点)。2026-11-11 客户口径「主管就是组长,可以筛选组长来导出,就是分组」——
* 选项是分组管理里那一行(DedupeGroupOption {id, name, leaderUserId}),选中后以 group_id
* 走本文件 list/export 同一过滤面。 */
export { fetchDedupeTotalGroups } from '../asin/dedupe-total-api.ts'
export type { DedupeGroupOption } from '../asin/dedupe-total-api.ts'
@@ -0,0 +1,138 @@
/** 外观专利无侵权数据页筛选纯函数(v1.3 AC-5):任务号/ASIN/国家/分组/起止时间 + snake 分页参数。
* 产出与后端 §3.2 参数归一逐字对撞:`page`/`page_size`(默认 10、上限 100)、`task_id`、
* `asin`、`country`、`group_id`、`start_date`/`end_date`(ISO yyyy-MM-dd;空白不下发)。
* 分页钳制(铁律 15):page < 1 归 1、上限 10_000(后端 CR-18 同值),(page-1)*page_size
* 最大 999_900,Number.MAX_SAFE_INTEGER 也不会把乘积顶出安全整数。纯逻辑,node --test 直测。
* 公司维不在这里:归一化构造器不认识 company_id(同 asin-filter 惯例),由 api 发送口从
* 原始入参自己下传——取值口由 company-tab-wiring 护栏的发送行钉看守。
* 分组语义(2026-11-11 客户口径「主管就是组长,可以筛选组长来导出,就是分组」):下拉选项是
* 分组管理里那一行(biz_shop_manage_group),group_id 下发后服务端解析「组长本人+名下子账户」
* 整集 SQL 下推;表上「管理员」列与它同源(组长行=自己,子账户行=创建人)。 */
import { validIsoDateOrUndefined } from '../asin/asin-filter.ts'
/** 每页条数默认 10(蓝图 §3.2),上限 100。 */
export const APPEARANCE_PATENT_CLEAN_PAGE_SIZE = 10
export const APPEARANCE_PATENT_CLEAN_MAX_PAGE_SIZE = 100
/** 页码上限:与后端 AppearancePatentCleanItemQueryService.MAX_PAGE(CR-18 先例)同值,两侧不漂。 */
export const APPEARANCE_PATENT_CLEAN_MAX_PAGE = 10_000
export interface AppearancePatentCleanFilterState {
/** 任务号(纯数字文本,空串不限)。 */
taskId: string
/** ASIN 前缀。 */
asin: string
/** 国家代码,空串=全部。 */
country: string
/** 分组 id 文本(分组管理里那一行,组长即该组主管),空串=全部分组。 */
groupId: string
/** 同步开始日期(ISO yyyy-MM-dd;空串不限)。 */
startDate: string
/** 同步结束日期(ISO yyyy-MM-dd;空串不限)。 */
endDate: string
}
export function createAppearancePatentCleanFilterState(): AppearancePatentCleanFilterState {
return { taskId: '', asin: '', country: '', groupId: '', startDate: '', endDate: '' }
}
/** 是否有任一激活筛选条件。 */
export function appearancePatentCleanFilterActive(state: AppearancePatentCleanFilterState): boolean {
if ((state.taskId || '').trim()) return true
if ((state.asin || '').trim()) return true
if ((state.country || '').trim()) return true
if ((state.groupId || '').trim()) return true
if (validIsoDateOrUndefined(state.startDate) || validIsoDateOrUndefined(state.endDate)) return true
return false
}
/** 序列化到后端的查询参数(snake_case,仅下发非空字段)。 */
export interface AppearancePatentCleanQuery {
page: number
page_size: number
task_id?: number
asin?: string
country?: string
group_id?: number
start_date?: string
end_date?: string
/** 公司 tab:白名单构造不点名它,字段只为 api 发送口的 `query.company_id = params.companyId` 存在。 */
company_id?: number
}
/** 导出查询参数:与列表同一过滤面、无分页(全量导出由服务侧 EXPORT_MAX_ROWS 上限兜住)。 */
export interface AppearancePatentCleanExportQuery {
task_id?: number
asin?: string
country?: string
group_id?: number
start_date?: string
end_date?: string
/** 公司 tab 同列表口径:白名单构造不点名,由 api 发送口下传。 */
company_id?: number
}
/** api 模块的入参:筛选态 + 分页 + 公司值(camel)。 */
export interface AppearancePatentCleanListParams {
page: number
pageSize: number
taskId?: string
asin?: string
country?: string
groupId?: string
startDate?: string
endDate?: string
companyId?: number | null
}
/** api 导出入口的入参:筛选态 + 公司值(camel,无分页)。 */
export interface AppearancePatentCleanExportParams {
taskId?: string
asin?: string
country?: string
groupId?: string
startDate?: string
endDate?: string
companyId?: number | null
}
/** 过滤态 → 过滤面参数(snake_case,仅下发非空字段);列表与导出共用这一个取值口,
* 「导出的过滤面和页签看到的永远同源」由这条单出口保证,不出现两处各算各的。 */
function toAppearancePatentCleanFilterQuery(state: AppearancePatentCleanFilterState): AppearancePatentCleanExportQuery {
const query: AppearancePatentCleanExportQuery = {}
const taskId = Number.parseInt((state.taskId || '').trim(), 10)
if (Number.isFinite(taskId) && taskId > 0) query.task_id = taskId
const asin = (state.asin || '').trim()
if (asin) query.asin = asin
const country = (state.country || '').trim()
if (country) query.country = country
const groupId = Number.parseInt((state.groupId || '').trim(), 10)
if (Number.isFinite(groupId) && groupId > 0) query.group_id = groupId
const startDate = validIsoDateOrUndefined(state.startDate)
if (startDate) query.start_date = startDate
const endDate = validIsoDateOrUndefined(state.endDate)
if (endDate) query.end_date = endDate
return query
}
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期不下发,分页钳制在此单出口(不含公司维)。 */
export function toAppearancePatentCleanListParams(
state: AppearancePatentCleanFilterState,
page: number,
pageSize: number,
): AppearancePatentCleanQuery {
const safePage = Math.min(Math.max(Math.floor(page) || 1, 1), APPEARANCE_PATENT_CLEAN_MAX_PAGE)
const rawSize = Math.floor(pageSize) || APPEARANCE_PATENT_CLEAN_PAGE_SIZE
const safeSize = Math.min(Math.max(rawSize, 1), APPEARANCE_PATENT_CLEAN_MAX_PAGE_SIZE)
return {
page: safePage,
page_size: safeSize,
...toAppearancePatentCleanFilterQuery(state),
}
}
/** 过滤态 → 导出查询参数(无分页;归一规则与列表逐字同源)。 */
export function toAppearancePatentCleanExportParams(
state: AppearancePatentCleanFilterState,
): AppearancePatentCleanExportQuery {
return toAppearancePatentCleanFilterQuery(state)
}
@@ -0,0 +1,109 @@
/** 外观专利无侵权数据列表查询模型(v1.3 AC-5):解析 AppearancePatentCleanItemPageVo(camel),纯逻辑。
* 行值是同步服务从 chunk payload 原样落的,读侧只搬运不加工(与后端 toVo 同一口径)。 */
import { unwrap } from '../../api/envelope.ts'
export interface AppearancePatentCleanItem {
id: number
resultId: number | null
taskId: number | null
userId: number | null
/** 管理员列(表头「管理员」,客户 2026-11-11 口径;后端读侧现算:主管/公司超管=自己,普通账户=创建人,读不到为空 → 界面展示 -)。 */
supervisorName: string
companyId: number | null
rowNo: number | null
asin: string
country: string
sku: string
brand: string
price: string
title: string
imageUrl: string
itemUrl: string
conclusion: string
titleReason: string
appearanceReason: string
patentReason: string
sourceFilename: string
syncedAt?: string
}
export interface AppearancePatentCleanPageResult {
items: AppearancePatentCleanItem[]
total: number
page: number
pageSize: number
}
/** 前端首屏默认容量:与后端 PageDefaults.CLEAN_ITEMS_PAGE_SIZE(蓝图 §3.2 默认 10)同值。 */
export const APPEARANCE_PATENT_CLEAN_DEFAULT_SIZE = 10
export function emptyAppearancePatentCleanPage(): AppearancePatentCleanPageResult {
return { items: [], total: 0, page: 1, pageSize: APPEARANCE_PATENT_CLEAN_DEFAULT_SIZE }
}
/** 结论列悬停提示=三因原文拼装(2026-11-11 随明细表恢复回归;3cfca462 曾随结论徽章一起退役)。 */
export function cleanItemReasonTooltip(item: AppearancePatentCleanItem): string {
const parts: string[] = []
if (item.titleReason) parts.push(`标题:${item.titleReason}`)
if (item.appearanceReason) parts.push(`外观:${item.appearanceReason}`)
if (item.patentReason) parts.push(`专利:${item.patentReason}`)
return parts.join('\n')
}
function text(value: unknown): string {
return typeof value === 'string' ? value.trim() : ''
}
function numberOrNull(value: unknown): number | null {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
}
/** 解析单行明细;缺 id 视为无效。camel 为正、snake 容错(与去重页模型同形)。 */
export function toAppearancePatentCleanItem(raw: unknown): AppearancePatentCleanItem | null {
if (!raw || typeof raw !== 'object') return null
const record = raw as Record<string, unknown>
const id = numberOrNull(record.id)
if (id === null) return null
return {
id,
resultId: numberOrNull(record.resultId ?? record.result_id),
taskId: numberOrNull(record.taskId ?? record.task_id),
userId: numberOrNull(record.userId ?? record.user_id),
supervisorName: text(record.supervisorName ?? record.supervisor_name),
companyId: numberOrNull(record.companyId ?? record.company_id),
rowNo: numberOrNull(record.rowNo ?? record.row_no),
asin: text(record.asin),
country: text(record.country),
sku: text(record.sku),
brand: text(record.brand),
price: text(record.price),
title: text(record.title),
imageUrl: text(record.imageUrl ?? record.image_url),
itemUrl: text(record.itemUrl ?? record.item_url),
conclusion: text(record.conclusion),
titleReason: text(record.titleReason ?? record.title_reason),
appearanceReason: text(record.appearanceReason ?? record.appearance_reason),
patentReason: text(record.patentReason ?? record.patent_reason),
sourceFilename: text(record.sourceFilename ?? record.source_filename),
syncedAt: text(record.syncedAt ?? record.synced_at) || undefined,
}
}
/** 归一化分页负载(信封或已解包 VO)为前端结果;缺省字段回默认。无 keyset 游标(蓝图 Out of Scope)。 */
export function parseAppearancePatentCleanPage(payload: unknown): AppearancePatentCleanPageResult {
const out = emptyAppearancePatentCleanPage()
const core = unwrap<unknown>(payload)
if (!core || typeof core !== 'object') return out
const record = core as Record<string, unknown>
if (Array.isArray(record.items)) {
out.items = record.items
.map((raw) => toAppearancePatentCleanItem(raw))
.filter((item): item is AppearancePatentCleanItem => item !== null)
}
if (typeof record.total === 'number') out.total = Math.floor(record.total)
if (typeof record.page === 'number' && record.page >= 1) out.page = Math.floor(record.page)
const rawSize = record.pageSize ?? record.page_size
if (typeof rawSize === 'number' && rawSize >= 1) out.pageSize = Math.floor(rawSize)
return out
}
@@ -9,6 +9,7 @@ import { fetchSoftwareVersions, uploadSoftwareVersion, deleteSoftwareVersions }
import type { SoftwareVersionItem } from './version-dto.ts'
import { isNonEmptyVersion } from './version-dto.ts'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { loadFailureMessage } from '@/components/load-failure-model'
import { openAdminConfirm } from '@/components/admin-confirm'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
@@ -62,7 +63,7 @@ async function removeSelected() {
selectedIds.value = new Set()
await load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '删除失败', 'error')
showAdminFeedback(loadFailureMessage(error, '删除失败'), 'error')
}
}
async function removeOne(row: SoftwareVersionItem) {
@@ -73,7 +74,7 @@ async function removeOne(row: SoftwareVersionItem) {
selectedIds.value = new Set([...selectedIds.value].filter((id) => id !== row.id))
await load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '删除失败', 'error')
showAdminFeedback(loadFailureMessage(error, '删除失败'), 'error')
}
}
@@ -92,7 +93,7 @@ async function load() {
try {
items.value = (await fetchSoftwareVersions()).items
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '版本列表加载失败'
loadFailure.value = loadFailureMessage(error, '版本列表加载失败')
showAdminFeedback(loadFailure.value, 'error')
} finally {
loading.value = false
@@ -146,7 +147,8 @@ async function submitUpload() {
uploadPercent.value = 0
load()
} catch (error) {
uploadMsg.value = error instanceof Error ? error.message : '上传失败'
// P2-10:api/http 拦截器不 sanitize,error.message 可能是英文异常原文——界面只吃中文出口,原文进 console。
uploadMsg.value = loadFailureMessage(error, '上传失败')
} finally {
uploading.value = false
}
@@ -11,6 +11,7 @@ import { fetchTutorialPackages, uploadTutorialPackage, deleteTutorialPackages }
import { formatFileSize } from './tutorial-model.ts'
import type { TutorialPackageItem } from './tutorial-dto.ts'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { loadFailureMessage } from '@/components/load-failure-model'
import { openAdminConfirm } from '@/components/admin-confirm'
import LoadFailureBar from '@/components/LoadFailureBar.vue'
@@ -119,7 +120,7 @@ async function removeSelected() {
selectedIds.value = new Set()
await load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '删除失败', 'error')
showAdminFeedback(loadFailureMessage(error, '删除失败'), 'error')
}
}
async function removeOne(row: TutorialPackageItem) {
@@ -130,7 +131,7 @@ async function removeOne(row: TutorialPackageItem) {
selectedIds.value = new Set([...selectedIds.value].filter((id) => id !== row.id))
await load()
} catch (error) {
showAdminFeedback(error instanceof Error ? error.message : '删除失败', 'error')
showAdminFeedback(loadFailureMessage(error, '删除失败'), 'error')
}
}
@@ -149,7 +150,7 @@ async function load() {
try {
items.value = (await fetchTutorialPackages()).items
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '教程包列表加载失败'
loadFailure.value = loadFailureMessage(error, '教程包列表加载失败')
showAdminFeedback(loadFailure.value, 'error')
} finally {
loading.value = false
@@ -198,7 +199,8 @@ async function submitUpload() {
uploadPercent.value = 0
load()
} catch (error) {
uploadMsg.value = error instanceof Error ? error.message : '上传失败'
// P2-10:api/http 拦截器不 sanitize,error.message 可能是英文异常原文——界面只吃中文出口,原文进 console。
uploadMsg.value = loadFailureMessage(error, '上传失败')
} finally {
uploading.value = false
}
@@ -1,7 +1,6 @@
<script setup lang="ts">
import { formatDateTime } from '@/utils/datetime'
/** 数富AI工作台客户端包管理页:上传 ZIP → 直传 MinIO → 服务端复算 sha256 落库;
* 客户端从 /api/workbench-client/version/latest 自动检测并按最新上传升级。
/** 数富AI工作台客户端包管理页:上传 ZIP → 直传 MinIO → 服务端复算 sha256 落库。
* 列表默认按上传时间倒序,第一条即当前生效版本;删除最新包后自动回落到上一版。 */
import { computed, onMounted, ref, watch } from 'vue'
import OldPagination from '@/components/OldPagination.vue'
@@ -177,7 +176,7 @@ onMounted(load)
<button class="btn" type="button" @click="openUpload">上传客户端包</button>
</div>
</div>
<p class="page-hint">客户端更新检查接口:<code>/api/workbench-client/version/latest</code>;最新上传的一条即当前生效版本。</p>
<p class="page-hint">最新上传的一条即当前生效版本。</p>
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<div class="table-scroll workbench-table-scroll">
@@ -1,6 +1,7 @@
/** 教程包接口适配(教程管理页):列表 / 直传预签名 / 确认 / 删除。 */
import axios from 'axios'
import { http, unwrap } from '@/api/http'
import { CHUNK_UPLOAD_THRESHOLD, uploadFileInChunks } from '@/api/chunk-upload'
import { parseTutorialPackageList, parseTutorialPackageUpload } from './tutorial-model.ts'
import type { TutorialPackageItem, TutorialPackageList } from './tutorial-dto.ts'
@@ -43,10 +44,15 @@ export async function requestTutorialPresign(fileName: string, version = ''): Pr
}
/** 第三步:直传完成后通知后端校验对象并写入记录(data.item 为新记录行)。 */
export async function confirmTutorialPackage(objectKey: string, fileName: string, version = ''): Promise<TutorialPackageItem | null> {
const { data } = await http.post<unknown>(TUTORIAL_CONFIRM_ENDPOINT, null, {
params: { object_key: objectKey, file_name: fileName, version },
})
export async function confirmTutorialPackage(
objectKey: string,
fileName: string,
version = '',
fileKey = '',
): Promise<TutorialPackageItem | null> {
const params: Record<string, string> = { object_key: objectKey, file_name: fileName, version }
if (fileKey) params.file_key = fileKey
const { data } = await http.post<unknown>(TUTORIAL_CONFIRM_ENDPOINT, null, { params })
return parseTutorialPackageUpload(data)
}
@@ -68,6 +74,11 @@ export async function uploadTutorialPackage(
version = '',
onProgress?: (percent: number) => void,
): Promise<TutorialPackageItem | null> {
if (file.size > CHUNK_UPLOAD_THRESHOLD) {
const uploaded = await uploadFileInChunks(file, fileName, onProgress)
const fileKey = String(uploaded.fileKey ?? uploaded.file_key ?? '')
return confirmTutorialPackage(String(uploaded.objectKey ?? ''), fileName, version, fileKey)
}
const target = await requestTutorialPresign(fileName, version)
await directPut.put(target.uploadUrl, file, {
headers: { 'Content-Type': 'application/octet-stream' },
@@ -1,6 +1,7 @@
/** 软件版本列表加载适配(任务 127):GET /api/admin/versions。 */
import axios from 'axios'
import { http, unwrap } from '@/api/http'
import { CHUNK_UPLOAD_THRESHOLD, uploadFileInChunks } from '@/api/chunk-upload'
import { parseSoftwareVersionList, parseSoftwareVersionUpload } from './version-model.ts'
import type { SoftwareVersionItem, SoftwareVersionList } from './version-dto.ts'
@@ -45,9 +46,14 @@ export async function requestSoftwareVersionPresign(version: string): Promise<So
}
}
/** 第三步:直传完成后通知后端校验对象并写入版本记录(data.item 为新版本行)。 */
export async function confirmSoftwareVersion(version: string): Promise<SoftwareVersionItem | null> {
const { data } = await http.post<unknown>(SOFTWARE_VERSION_CONFIRM_ENDPOINT, null, { params: { version } })
/**
* 第三步:上传完成后通知后端校验并写入版本记录(data.item 为新版本行)。
* 分片通道把拼装件留在 Java 临时目录,服务端按 file_key 搬进 client 桶后再落库。
*/
export async function confirmSoftwareVersion(version: string, fileKey = ''): Promise<SoftwareVersionItem | null> {
const params: Record<string, string> = { version }
if (fileKey) params.file_key = fileKey
const { data } = await http.post<unknown>(SOFTWARE_VERSION_CONFIRM_ENDPOINT, null, { params })
return parseSoftwareVersionUpload(data)
}
@@ -69,6 +75,12 @@ export async function uploadSoftwareVersion(
_filename = '',
onProgress?: (percent: number) => void,
): Promise<SoftwareVersionUploadResult> {
if (file.size > CHUNK_UPLOAD_THRESHOLD) {
const uploaded = await uploadFileInChunks(file, `${version}.zip`, onProgress)
const fileKey = String(uploaded.fileKey ?? uploaded.file_key ?? '')
const item = await confirmSoftwareVersion(version, fileKey)
return { version, fileUrl: item?.fileUrl || String(uploaded.url ?? ''), item }
}
const target = await requestSoftwareVersionPresign(version)
await directPut.put(target.uploadUrl, file, {
headers: { 'Content-Type': 'application/octet-stream' },
@@ -20,9 +20,6 @@ export const WORKBENCH_CLIENT_CHUNK_ENDPOINT = `${WORKBENCH_CLIENT_PACKAGE_ENDPO
export const WORKBENCH_CLIENT_UNCONFIRMED_OBJECT_ENDPOINT = `${WORKBENCH_CLIENT_PACKAGE_ENDPOINT}/object`
export const FILES_CHUNK_ENDPOINT = '/api/files/chunk'
/** 客户端自动更新契约(后管页面不直接调用):GET 返回 {version,file_url,sha256,...}。 */
export const WORKBENCH_CLIENT_PUBLIC_LATEST_ENDPOINT = '/api/workbench-client/version/latest'
/** MinIO 直传专用实例:不带 cookie、不挂 401 跳登录拦截器;大 zip 给足超时。 */
const directPut = axios.create({ timeout: 600_000, withCredentials: false })
@@ -9,7 +9,16 @@ import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
import type { DuplicateItem, DuplicateOccurrence, DuplicateMetrics, DuplicateShop } from './duplicate-model.ts'
import { fetchDuplicateConsole, fetchDuplicateLedger, requestDuplicateExportBlob, type LedgerSortKey } from './duplicate-console-api.ts'
import { aggregateDrawerRows, drawerSummaryOf, dupWithinGroup, indexShopGroups, type DrawerAggRow, type DrawerSummary, type ShopGroups } from './duplicate-console-logic.ts'
import {
aggregateDrawerRows,
drawerSummaryOf,
indexShopGroups,
itemBrandOf,
type DrawerAggRow,
type DrawerSummary,
type ShopGroups,
} from './duplicate-console-logic.ts'
import { useDuplicateMatrix } from './duplicate-matrix-window.ts'
import type { DuplicateConsole, LedgerRow } from './duplicate-console-model.ts'
import { ASIN_COUNTRY_CODES, asinCountryLabel } from '../asin/asin-country.ts'
import { orderedPair } from '@/utils/datetime'
@@ -73,7 +82,8 @@ function toast(msg: string) {
const overview = computed(() => consoleData.value?.overview ?? null)
const summary = computed<DuplicateMetrics | null>(() => overview.value?.summary ?? null)
const shops = computed(() => overview.value?.shops ?? [])
const dupItems = computed(() => consoleData.value?.dup ?? [])
/** 当前撞款行窗口:服务端按 page/page_size(+dup_group) 切好的一窗(B60),页面不再自切全集。 */
const dupItems = computed<DuplicateItem[]>(() => consoleData.value?.dup ?? [])
const groupStats = computed(() => consoleData.value?.groups ?? [])
const countryOptions = computed<string[]>(() => {
@@ -118,26 +128,32 @@ function selectedGroupMembers(): string[] {
const groupChips = computed(() => groupStats.value.filter((group) => group.shopCount >= 2))
/** 当前撞款行集:全局=撞款全集;分组=组内成员撞款子集;均按 ASIN 升序(reference 台账顺序)。 */
const dupRows = computed<DuplicateItem[]>(() => {
const rows = scope.value === 'global' ? dupItems.value : dupWithinGroup(dupItems.value, selectedGroupMembers())
return [...rows].sort((a, b) => a.asin.localeCompare(b.asin))
})
/** 矩阵列:分组范围=该组成员店;全店=全部可见店铺(按上架量降序)。 */
const matrixShops = computed<string[]>(() => {
if (scope.value === 'group') return selectedGroupMembers()
return orderedShops.value.map((shop) => shop.shopName)
})
const activeGroupStat = computed(() => groupStats.value.find((group) => group.name === selectedGroup.value) || null)
/** 撞款 Tab 计数:全店范围取后端权威 total_dup(防后端截断计数偏小);分组范围取组内子集长度。 */
const totalDupCount = computed(() => (scope.value === 'global' ? (consoleData.value?.totalDup ?? dupRows.value.length) : dupRows.value.length))
/** 撞款行总数:服务端在本页 + 本范围(全局或所选分组)内未分页的计数,翻页控件与 KPI 共用。 */
const totalDupCount = computed(() => consoleData.value?.totalDup ?? 0)
function itemBrand(item: DuplicateItem): string {
for (const occ of item.occurrences || []) if (occ.brand) return occ.brand
return ''
}
/** 撞款矩阵的行窗 + 列窗 + 格子视图(B60):状态与算法在 `duplicate-matrix-window.ts`,翻页动作交回这里。 */
const {
matrixPage,
matrixPageSize,
columnPage,
columnWindowTotal,
matrixAllColumns,
matrixShops,
matrixView,
matrixHint,
goMatrixPage,
changeMatrixSize,
goColumnPage,
resetMatrixWindows,
} = useDuplicateMatrix({
rows: dupItems,
groupMembers: computed(() => selectedGroupMembers()),
groupScoped: computed(() => scope.value === 'group'),
selectedGroup,
reload: () => void loadConsole(),
dataVersion: consoleData,
})
// ---- 撞款视图分页(分布/矩阵/撞款详情/抽屉明细;10/20/50/100 可选) ----
@@ -147,16 +163,7 @@ const distPageSize = ref(10)
const pagedDistBars = computed(() =>
storeDistribution.value.list.slice((distPage.value - 1) * distPageSize.value, distPage.value * distPageSize.value),
)
const matrixPage = ref(1)
const matrixPageSize = ref(10)
const matrixRows = computed(() =>
dupRows.value.slice((matrixPage.value - 1) * matrixPageSize.value, matrixPage.value * matrixPageSize.value),
)
const dupCardPage = ref(1)
const dupCardPageSize = ref(10)
const dupCardRows = computed(() =>
dupRows.value.slice((dupCardPage.value - 1) * dupCardPageSize.value, dupCardPage.value * dupCardPageSize.value),
)
const drawerPage = ref(1)
const drawerPageSize = ref(10)
const drawerRows = computed(() =>
@@ -168,46 +175,15 @@ const groupStatsPageSize = ref(10)
const pagedGroupStats = computed(() =>
groupStats.value.slice((groupStatsPage.value - 1) * groupStatsPageSize.value, groupStatsPage.value * groupStatsPageSize.value),
)
watch([dupRows, drawerOccurrences, groupStats], () => {
matrixPage.value = Math.min(matrixPage.value, Math.max(1, Math.ceil(dupRows.value.length / matrixPageSize.value)))
dupCardPage.value = Math.min(dupCardPage.value, Math.max(1, Math.ceil(dupRows.value.length / dupCardPageSize.value)))
watch([drawerOccurrences, groupStats], () => {
drawerPage.value = 1
groupStatsPage.value = Math.min(groupStatsPage.value, Math.max(1, Math.ceil(groupStats.value.length / groupStatsPageSize.value)))
})
const matrixHint = computed(() =>
scope.value === 'global'
? '行 = 全店撞款ASIN,列 = 全部店铺;有数字表示该店在售此 ASIN,点击行可看上架时间明细'
: selectedGroup.value
? `行 = 分组「${selectedGroup.value}」内的撞款ASIN,列 = 该分组店铺;有数字表示组内该店在售此 ASIN`
: '行 = 分组内撞款ASIN,列 = 该分组店铺;有数字表示组内该店在售此 ASIN',
)
/* ----- 矩阵单元格辅助 ----- */
function shopKey(name: string): string {
return (name || '').trim().toLowerCase()
}
function cellOccurrences(item: DuplicateItem, shop: string): DuplicateOccurrence[] {
const key = shopKey(shop)
return (item.occurrences || []).filter((occ) => shopKey(occ.shopName) === key)
}
function cellCount(item: DuplicateItem, shop: string): number {
return cellOccurrences(item, shop).length
}
function cellCountryDots(item: DuplicateItem, shop: string): string[] {
const codes = new Set<string>()
for (const occ of cellOccurrences(item, shop)) if (occ.country) codes.add(occ.country.toUpperCase())
return [...codes]
}
function cellCountryCount(item: DuplicateItem, shop: string, code: string): number {
return cellOccurrences(item, shop).filter((occ) => (occ.country || '').toUpperCase() === code).length
}
function cellTitle(item: DuplicateItem, shop: string): string {
const count = cellCount(item, shop)
if (!count) return `${shop} 无此 ASIN`
const sites = cellCountryDots(item, shop).map((code) => `${asinCountryLabel(code)} ${cellCountryCount(item, shop, code)}条`).join('、')
return `${shop} 在售 ${count} 条 · ${sites}`
}
function activeFilterParams() {
return { asin: filter.asin.trim(), shopName: filter.shop.trim(), group: filter.group.trim(), country: filter.country, site: '', dateFrom: filter.dateFrom, dateTo: filter.dateTo }
@@ -217,7 +193,13 @@ async function loadConsole() {
loading.value = true
loadError.value = ''
try {
consoleData.value = await fetchDuplicateConsole({ view: '', ...activeFilterParams() }, companyTab.requestCompanyId)
consoleData.value = await fetchDuplicateConsole(
{ view: '', ...activeFilterParams() },
companyTab.requestCompanyId,
matrixPage.value,
matrixPageSize.value,
scope.value === 'group' ? selectedGroup.value : '',
)
shopGroups.value = indexShopGroups(orderedShops.value)
if (groupStats.value.length && !groupStats.value.some((group) => group.name === selectedGroup.value)) {
selectedGroup.value = groupChips.value[0] ? groupChips.value[0].name : ''
@@ -270,6 +252,7 @@ function resetQuery() {
scope.value = 'global'
selectedGroup.value = ''
activeTab.value = 'dup'
resetMatrixWindows()
applyQuery()
toast('筛选已重置')
}
@@ -280,8 +263,21 @@ function switchTab(tab: Tab) {
}
function switchScope(next: Scope) {
if (scope.value === next) return
scope.value = next
if (next === 'group' && !selectedGroup.value && groupChips.value.length) selectedGroup.value = groupChips.value[0].name
// 行范围换了(全局 ↔ 组内),服务端裁出来的那一窗也就换了 ⇒ 重新请一窗。
resetMatrixWindows()
void loadConsole()
}
/** 分组 chip:选中即换行范围,与 switchScope 同一条出口(不再在客户端重裁一遍全集)。 */
function selectGroup(name: string) {
if (selectedGroup.value === name && scope.value === 'group') return
scope.value = 'group'
selectedGroup.value = name
resetMatrixWindows()
void loadConsole()
}
async function reAnalyze() {
@@ -338,7 +334,7 @@ function openDrawer(asin: string, brand: string, dupFlag: boolean, occurrences:
}
function openDupDrawer(item: DuplicateItem) {
openDrawer(item.asin, itemBrand(item), item.shopCount >= 2, item.occurrences)
openDrawer(item.asin, itemBrandOf(item), item.shopCount >= 2, item.occurrences)
}
function openLedgerDrawer(row: LedgerRow) {
@@ -553,7 +549,7 @@ onMounted(() => {
</div>
<div v-if="scope === 'group'" class="group-chips">
<template v-if="groupChips.length">
<button v-for="group in groupChips" :key="group.name" type="button" class="g-chip" :class="{ active: selectedGroup === group.name, dup: group.dupCount > 0 }" @click="selectedGroup = group.name">
<button v-for="group in groupChips" :key="group.name" type="button" class="g-chip" :class="{ active: selectedGroup === group.name, dup: group.dupCount > 0 }" @click="selectGroup(group.name)">
{{ group.name }} <span class="g-count">{{ group.shopCount }}店 · {{ group.dupCount }}撞款</span>
</button>
</template>
@@ -568,9 +564,16 @@ onMounted(() => {
<div class="gs-item" :class="{ warn: activeGroupStat.dupCount > 0 }"><div class="gs-v">{{ activeGroupStat.dupCount }}</div><div class="gs-l">组内撞款ASIN</div></div>
</div>
<div class="section-title">撞款覆盖矩阵 <span class="hint">{{ matrixHint }}</span></div>
<div class="section-title">
撞款覆盖矩阵 <span class="hint">{{ matrixHint }}</span>
<span v-if="columnWindowTotal > 1" class="col-window">
<button type="button" class="link-btn" :disabled="columnPage <= 1" @click="goColumnPage(-1)">‹ 上一窗列</button>
列 {{ columnPage }}/{{ columnWindowTotal }}(共 {{ matrixAllColumns.length }} 列)
<button type="button" class="link-btn" :disabled="columnPage >= columnWindowTotal" @click="goColumnPage(1)">下一窗列 ›</button>
</span>
</div>
<div class="matrix-wrap">
<table v-if="dupRows.length" class="matrix">
<table v-if="dupItems.length" class="matrix">
<thead>
<tr>
<th>ASIN</th>
@@ -579,13 +582,13 @@ onMounted(() => {
</tr>
</thead>
<tbody>
<tr v-for="item in matrixRows" :key="item.asin" @click="openDupDrawer(item)">
<td><span class="asin-code">{{ item.asin }}</span></td>
<td><span class="m-brand">{{ itemBrand(item) || '—' }}</span></td>
<td v-for="shop in matrixShops" :key="shop" style="text-align:center">
<div class="m-cell" :class="{ empty: cellCount(item, shop) === 0 }" :title="cellTitle(item, shop)">
{{ cellCount(item, shop) || '' }}
<span class="dots"><span v-for="code in cellCountryDots(item, shop)" :key="code" class="m-dot" :style="{ background: siteColor(code) }"></span></span>
<tr v-for="row in matrixView" :key="row.asin" @click="openDupDrawer(row.item)">
<td><span class="asin-code">{{ row.asin }}</span></td>
<td><span class="m-brand">{{ row.brand }}</span></td>
<td v-for="(cell, index) in row.cells" :key="matrixShops[index]" style="text-align:center">
<div class="m-cell" :class="{ empty: cell.count === 0 }" :title="cell.title">
{{ cell.count || '' }}
<span class="dots"><span v-for="code in cell.dots" :key="code" class="m-dot" :style="{ background: siteColor(code) }"></span></span>
</div>
</td>
</tr>
@@ -596,15 +599,15 @@ onMounted(() => {
调整筛选条件或切换到其他分组查看
</div>
</div>
<OldPagination :total="dupRows.length" :page="matrixPage" :page-size="matrixPageSize" @change="matrixPage = $event" @size-change="(s: number) => { matrixPageSize = s; matrixPage = 1 }" />
<OldPagination :total="totalDupCount" :page="matrixPage" :page-size="matrixPageSize" @change="goMatrixPage" @size-change="changeMatrixSize" />
<div class="section-title" style="margin-top:24px">撞款详情 <span class="hint">同一 ASIN 在多家店铺的上架时间明细</span></div>
<div v-if="dupRows.length" class="dup-grid">
<div v-for="item in dupCardRows" :key="item.asin" class="dup-card">
<div v-if="dupItems.length" class="dup-grid">
<div v-for="item in dupItems" :key="item.asin" class="dup-card">
<div class="dup-head">
<span class="asin-code">{{ item.asin }}</span>
<span class="badge dup">{{ item.shopCount }}店在售</span>
<span class="d-brand">{{ itemBrand(item) || '未知品牌' }}</span>
<span class="d-brand">{{ itemBrandOf(item) || '未知品牌' }}</span>
<button class="link-btn" type="button" @click="openDupDrawer(item)">查看明细</button>
</div>
<div class="dup-body">
@@ -620,8 +623,8 @@ onMounted(() => {
</div>
</div>
<div v-else class="dup-empty">当前范围下没有撞款ASIN</div>
<OldPagination :total="dupRows.length" :page="dupCardPage" :page-size="dupCardPageSize" @change="dupCardPage = $event" @size-change="(s: number) => { dupCardPageSize = s; dupCardPage = 1 }" />
<div class="dup-total">共 <b>{{ dupRows.length }}</b> 条{{ scope === 'group' && selectedGroup ? `分组「${selectedGroup}」组内撞款ASIN` : '全店撞款ASIN' }}</div>
<OldPagination :total="totalDupCount" :page="matrixPage" :page-size="matrixPageSize" @change="goMatrixPage" @size-change="changeMatrixSize" />
<div class="dup-total">共 <b>{{ dupItems.length }}</b> 条{{ scope === 'group' && selectedGroup ? `分组「${selectedGroup}」组内撞款ASIN` : '全店撞款ASIN' }}</div>
</template>
<!-- ============ 全部ASIN台账 ============ -->
@@ -885,6 +888,9 @@ onMounted(() => {
.dup-ref .section-title { font-size: 14px; font-weight: 700; display: flex; align-items: baseline; gap: 8px; margin-bottom: 12px; }
.dup-ref .section-title .hint { font-size: 11px; font-weight: 400; color: var(--text3); }
.dup-ref .matrix-wrap { overflow-x: auto; overflow-y: auto; border-radius: var(--radius); background: var(--surface); border: 1px solid var(--border); max-height: 480px; }
/* 列窗口控件:与 section-title 同行,只在看得到第二窗列时出现。 */
.dup-ref .col-window { margin-left: 12px; display: inline-flex; align-items: center; gap: 8px; font-size: 12px; color: var(--text2); }
.dup-ref .col-window .link-btn:disabled { color: var(--text3); cursor: not-allowed; }
.dup-ref table.matrix { border-collapse: separate; border-spacing: 0; width: 100%; background: var(--surface); }
.dup-ref table.matrix th {
background: #F7F9FC; color: var(--text2); font-size: 12px; font-weight: 600; padding: 10px 12px;
@@ -10,7 +10,7 @@ import {
export const DUPLICATE_CHECK_ENDPOINT = '/api/admin/shop-data-crawl'
/** console 端点吃 asin/shop_name/group/country/site/date_from/date_to;多余分页参数后端忽略。 */
/** console 端点吃 asin/shop_name/group/country/site/date_from/date_to(行窗口的 page/page_size/dup_group 由调用方另传)。 */
function toConsoleQuery(filter: DuplicateFilter): Record<string, string> {
const query: Record<string, string> = {}
const asin = (filter.asin || '').trim()
@@ -32,14 +32,25 @@ function toConsoleQuery(filter: DuplicateFilter): Record<string, string> {
export type LedgerSortKey = 'asin' | 'brand' | 'store_count' | 'record_count' | 'earliest' | 'latest'
/** 加载撞款控制台快照:GET /duplicate-check-console。 */
/**
* 加载撞款控制台快照:GET /duplicate-check-console。
*
* 行窗口(B60):`page`/`pageSize` 决定返回的 `dup` 是这一窗,`dupGroup` 非空时行集先按
* 该分组成员裁剪(组内 ≥2 店才算撞款)。三者都是**服务端**口径——矩阵与详情卡片共用同一窗口,
* 页面不再自己从全集里切片(那需要后端把整份撞款数组发回来,正是 B60 要收掉的那件事)。
*/
export async function fetchDuplicateConsole(
filter: DuplicateFilter,
companyId?: number | null,
page = 1,
pageSize = 100,
dupGroup = '',
): Promise<DuplicateConsole> {
// toConsoleQuery 是白名单构造(只点名 asin/shop_name/group/country/site/date_*),
// 公司值只许落在本函数自己的 companyId 形参上。
const query: Record<string, string | number> = toConsoleQuery(filter)
const query: Record<string, string | number> = { ...toConsoleQuery(filter), page, page_size: pageSize }
const group = (dupGroup || '').trim()
if (group) query.dup_group = group
if (companyId != null) query.company_id = companyId
const { data } = await http.get<unknown>(`${DUPLICATE_CHECK_ENDPOINT}/duplicate-check-console`, { params: query })
return parseDuplicateConsole(data)
@@ -1,4 +1,4 @@
/** 撞款控制台视图派生(分组索引 / 组内撞款子集 / 店铺列并集):纯逻辑。 */
/** 撞款控制台视图派生(分组索引 / 店铺列并集 / 矩阵格子预聚合):纯逻辑。 */
import type { DuplicateItem, DuplicateOccurrence, DuplicateShop } from './duplicate-model.ts'
export interface ShopGroups {
@@ -41,27 +41,6 @@ export function indexShopGroups(shops: DuplicateShop[]): ShopGroups {
return { members, shopGroupNames }
}
/** 仅在指定成员店铺(展示名)内保留 occurrences;重算 shop_count,返回 ≥2 店的撞款子集。 */
export function dupWithinGroup(items: DuplicateItem[], memberShops: string[]): DuplicateItem[] {
const memberKeys = new Set<string>()
for (const shop of memberShops || []) memberKeys.add(shopKey(shop))
const result: DuplicateItem[] = []
for (const item of items || []) {
const kept: DuplicateOccurrence[] = []
const shops = new Set<string>()
for (const occ of item.occurrences || []) {
if (memberKeys.has(shopKey(occ.shopName))) {
kept.push(occ)
shops.add(occ.shopName || '')
}
}
if (kept.length > 0 && shops.size >= 2) {
result.push({ asin: item.asin, shopCount: shops.size, recordCount: kept.length, occurrences: kept })
}
}
return result
}
/** 撞款行涉及店铺的并集列(出现顺序去重);memberShops 非空时仅取交集成员的子集顺序。 */
export function storeColumnsOf(items: DuplicateItem[], memberShops: string[] = []): string[] {
const restricted = new Set(memberShops.map((shop) => shopKey(shop)))
@@ -90,6 +69,74 @@ export function storeColumnsOf(items: DuplicateItem[], memberShops: string[] = [
return order
}
/** 矩阵一格:该店在售此 ASIN 的条数 + 站点(国家)分布。 */
export interface MatrixCell {
count: number
sites: { code: string; count: number }[]
}
/** 空格的单份实例:模板每格都要拿一个,不能每格 new 一个对象。 */
export const EMPTY_MATRIX_CELL: MatrixCell = { count: 0, sites: [] }
function cellKey(asin: string, shop: string): string {
// 用 \u0000 拼键:ASIN 与店铺名都可打印,任何可见分隔符都可能出现在店铺名里(那样就会串格)。
return `${(asin || '').trim()}\u0000${shopKey(shop)}`
}
/**
* 撞款矩阵的格子集合:把 rows×columns 一次算完(B60 的「预聚合」)。
*
* <p>原形状是每格现算:`cellCount`/`cellCountryDots`/`cellTitle` 各自把该行 occurrences 全 filter
* 一遍,一格 4~6 次、50 行 × 200 列就是每帧上万次整行扫描,勾选/翻页都要重付。这里每行只按
* 店铺分桶一次(O(occurrences)),之后一格一次 Map 取值。
*
* 只给 `columns` 里点名的列建格:不在列集内的 occurrence 直接不装桶,列窗口收窄时开销跟着降。
*/
export function buildMatrixCells(items: DuplicateItem[], columns: string[]): Map<string, MatrixCell> {
const cells = new Map<string, MatrixCell>()
const wanted = new Set<string>()
for (const column of columns || []) wanted.add(shopKey(column))
if (!wanted.size) return cells
for (const item of items || []) {
const buckets = new Map<string, DuplicateOccurrence[]>()
const siteCounts = new Map<string, Map<string, number>>()
for (const occ of item.occurrences || []) {
const key = shopKey(occ.shopName)
if (!wanted.has(key)) continue
const bucket = buckets.get(key)
if (bucket) bucket.push(occ)
else buckets.set(key, [occ])
const code = (occ.country || '').trim().toUpperCase()
if (!code) continue
let counts = siteCounts.get(key)
if (!counts) {
counts = new Map<string, number>()
siteCounts.set(key, counts)
}
counts.set(code, (counts.get(code) || 0) + 1)
}
for (const [key, occurrences] of buckets) {
const codes = siteCounts.get(key)
cells.set(cellKey(item.asin, key), {
count: occurrences.length,
sites: codes ? [...codes].map(([code, count]) => ({ code, count })) : [],
})
}
}
return cells
}
/** 取一格;没有格子时返回同一份空对象(模板里 `cellOf(...).count` 要能直接读)。 */
export function matrixCellOf(cells: Map<string, MatrixCell>, asin: string, shop: string): MatrixCell {
return cells.get(cellKey(asin, shop)) || EMPTY_MATRIX_CELL
}
/** 一个撞款 ASIN 的品牌:取第一条带品牌的上架记录,全空就是"未知品牌"(页面自己决定怎么显示)。 */
export function itemBrandOf(item: DuplicateItem): string {
for (const occ of item.occurrences || []) if (occ.brand) return occ.brand
return ''
}
/** 明细抽屉聚合行:店铺×站点聚合(对齐 reference 抽屉的 店铺/分组/站点/上架时间(升序堆叠)/次数)。 */
export interface DrawerAggRow {
shopName: string
@@ -18,12 +18,19 @@ export interface ConsoleGroupStat {
dupCount: number
}
/** 撞款控制台单次快照:总览(指标/店铺分布) + 撞款全集 + 分组统计。 */
/**
* 撞款控制台单次快照:总览(指标/店铺分布) + 撞款**行窗口** + 分组统计。
*
* `dup` 是服务端按 page/pageSize 切出来的一窗(B60),`totalDup` 是该范围内未分页的总数;
* 两者不是同一个口径,页面分页器读 totalDup、列表读 dup。
*/
export interface DuplicateConsole {
overview: DuplicateOverview
dup: DuplicateItem[]
groups: ConsoleGroupStat[]
totalDup: number
page: number
pageSize: number
}
/** 台账单行(含 occurrences,供明细抽屉还原每店上架时间线)。 */
@@ -87,7 +94,14 @@ export function parseDuplicateConsole(payload: unknown): DuplicateConsole {
const groups = Array.isArray(record.groups)
? record.groups.map((raw) => parseConsoleGroup(raw)).filter((group): group is ConsoleGroupStat => group !== null)
: []
return { overview, dup, groups, totalDup: count(record.total_dup ?? record.totalDup) }
return {
overview,
dup,
groups,
totalDup: count(record.total_dup ?? record.totalDup),
page: count(record.page) || 1,
pageSize: count(record.page_size ?? record.pageSize),
}
}
/** 解析单条台账行。 */
@@ -0,0 +1,169 @@
/**
* 撞款覆盖矩阵的「行窗 + 列窗」组合式(B60 从 DuplicateCheckPage.vue 拆出)。
*
* 为什么单独立一支:那一屏矩阵原本是每格现算——`cellCount / cellCountryDots / cellTitle`
* 各自把该行 occurrences 全 filter 一遍(一格 4~6 次),而且整份撞款全集一次性铺成
* 「全部行 × 全部列」的 DOM。收口后行由服务端切窗、列在本模块切窗,格子的文案与
* 国家点一次算完、空格按列共享同一份视图。这些状态(列游标、行游标、三份 computed)
* 是一件事,留在页面里会把本页推到可读性基线之外,也更难单测。
*
* 纯逻辑部分(分桶、取列)在 `duplicate-console-logic.ts`,本文件只做"窗口"这一层,
* 数据从页面注入,不认识 store。
*/
import { computed, ref, watch, type ComputedRef, type Ref } from 'vue'
import { buildMatrixCells, itemBrandOf, matrixCellOf, storeColumnsOf } from './duplicate-console-logic.ts'
import { asinCountryLabel } from '../asin/asin-country.ts'
import type { DuplicateItem } from './duplicate-model.ts'
/**
* 列窗口上限(B60「限制列数」)。一窗 40 列 × 最多 100 行=单帧最多 4,000 格;
* 不封顶时 200 列 × 100 行=2 万格 DOM,任何一次勾选/翻页都要重排。
* 列没被裁掉,只是切成窗口(`goColumnPage`),所以信息一条不丢。
*/
export const MATRIX_COLUMN_WINDOW = 40
/** 模板只读这一份:数字、国家点、悬浮说明都在这里算完。 */
export interface MatrixCellView {
count: number
dots: string[]
title: string
}
/** 一行矩阵视图:行对象本身(点开抽屉要用)+ 品牌 + 本窗每一格。 */
export interface MatrixRowView {
item: DuplicateItem
asin: string
brand: string
cells: MatrixCellView[]
}
export interface MatrixWindowSource {
/** 当前行窗(服务端切好的那一窗)。 */
rows: ComputedRef<DuplicateItem[]>
/** 列范围的第二正本=分组页签选中的组员(非分组范围给空数组)。 */
groupMembers: ComputedRef<string[]>
/** 分组范围与否:决定列要不要与组员取交集。 */
groupScoped: Ref<boolean> | ComputedRef<boolean>
/** 选中的分组名(只用于矩阵那行说明文案,让"看到的是什么范围"写在屏上)。 */
selectedGroup: Ref<string> | ComputedRef<string>
/** 行窗换页/换档都要重新请一窗(服务端切,页面不再从全集里自切)。 */
reload: () => void
/** 数据到达的版本号(一般是 consoleData 本身):新数据 ⇒ 旧游标已指向不存在的位置。 */
dataVersion: Ref<unknown>
}
/** 空格共用同一份 dots(模板只读不写,共享数组不会被改)。 */
const NO_DOTS: string[] = []
export function useDuplicateMatrix(source: MatrixWindowSource) {
const matrixPage = ref(1)
const matrixPageSize = ref(10)
const columnPage = ref(1)
/** 本页行里真出现过的店铺=矩阵该配的列(分组范围再与组员取交集)。 */
const matrixAllColumns = computed<string[]>(() =>
storeColumnsOf(source.rows.value, source.groupScoped.value ? source.groupMembers.value : []),
)
const columnWindowTotal = computed(() =>
Math.max(1, Math.ceil(matrixAllColumns.value.length / MATRIX_COLUMN_WINDOW)),
)
/** 矩阵列:按窗口切(超出部分用列窗口控件翻)。 */
const matrixShops = computed<string[]>(() => {
const start = Math.max(0, (columnPage.value - 1) * MATRIX_COLUMN_WINDOW)
return matrixAllColumns.value.slice(start, start + MATRIX_COLUMN_WINDOW)
})
/** 一次把「本窗行 × 本窗列」全部算完,模板只读不算。 */
const matrixCells = computed(() => buildMatrixCells(source.rows.value, matrixShops.value))
function cellView(shop: string, cell: ReturnType<typeof matrixCellOf>): MatrixCellView {
const sites = cell.sites.map((site) => `${asinCountryLabel(site.code)} ${site.count}条`).join('、')
return {
count: cell.count,
dots: cell.sites.map((site) => site.code),
title: sites ? `${shop} 在售 ${cell.count} 条 · ${sites}` : `${shop} 在售 ${cell.count} 条`,
}
}
/**
* 每列一份「本格为空」的视图,整列复用同一对象。
*
* <p>矩阵里绝大多数格是空的(一个 ASIN 只在几家店在售,列却是几十上百家店)。原先一格
* 一条 `无此 ASIN` 文案,50 行 × 200 列=1 万条字符串;按列准备一次之后行数再多也不
* 乘上去——这条才是"每格现算"剩下的那半开销。
*/
const emptyColumnViews = computed<MatrixCellView[]>(() =>
matrixShops.value.map((shop) => ({ count: 0, dots: NO_DOTS, title: `${shop} 无此 ASIN` })),
)
const matrixView = computed<MatrixRowView[]>(() => {
const cells = matrixCells.value
const blanks = emptyColumnViews.value
return source.rows.value.map((item) => ({
item,
asin: item.asin,
brand: itemBrandOf(item) || '—',
cells: matrixShops.value.map((shop, index) => {
const cell = matrixCellOf(cells, item.asin, shop)
return cell.count ? cellView(shop, cell) : blanks[index]
}),
}))
})
/** 屏上那行说明:把"行/列各是什么范围"写清楚,尤其分组范围是服务端裁过行的那一窗。 */
const matrixHint = computed(() =>
source.groupScoped.value
? source.selectedGroup.value
? `行 = 分组「${source.selectedGroup.value}」内的撞款ASIN(服务端裁行+分页),列 = 组内在售店铺;有数字表示组内该店在售此 ASIN`
: '行 = 分组内撞款ASIN,列 = 该分组店铺;有数字表示组内该店在售此 ASIN'
: '行 = 本页撞款ASIN(服务端分页),列 = 本页撞款涉及店铺;有数字表示该店在售此 ASIN,点击行可看上架时间明细',
)
/** 行窗口翻页:同一页重复点不重新请(翻页控件的当前页也会触发 change)。 */
function goMatrixPage(page: number): void {
if (page === matrixPage.value) return
matrixPage.value = page
source.reload()
}
function changeMatrixSize(size: number): void {
matrixPageSize.value = size
matrixPage.value = 1
source.reload()
}
/** 列窗口翻页:行不动,只把看得见的店铺换一窗。 */
function goColumnPage(step: number): void {
const next = columnPage.value + step
if (next < 1 || next > columnWindowTotal.value) return
columnPage.value = next
}
/** 换了行范围(全局 ↔ 组内、换分组、重置筛选):两个游标都回到第一窗。 */
function resetMatrixWindows(): void {
matrixPage.value = 1
columnPage.value = 1
}
watch(source.dataVersion, () => {
columnPage.value = Math.min(columnPage.value, columnWindowTotal.value)
})
return {
MATRIX_COLUMN_WINDOW,
matrixPage,
matrixPageSize,
columnPage,
columnWindowTotal,
matrixAllColumns,
matrixShops,
matrixView,
matrixHint,
goMatrixPage,
changeMatrixSize,
goColumnPage,
resetMatrixWindows,
}
}
+6
View File
@@ -43,6 +43,12 @@ export const adminPages: AdminPageDef[] = [
{ path: 'asin-center/query', menuKey: 'admin_query_asin', title: '查询ASIN', companyScoped: true, load: () => import('@/pages/asin/QueryAsinPage.vue') },
{ path: 'asin-center/categories', menuKey: 'admin_product_categories', title: '商品类目', companyScoped: false, load: () => import('@/pages/asin/ProductCategoryPage.vue') },
{ path: 'asin-center/skip-price', menuKey: 'admin_skip_price_asin', title: '最低价ASIN', companyScoped: true, load: () => import('@/pages/asin/SkipPricePage.vue') },
{ path: 'patent-center/clean-items', menuKey: 'admin_appearance_patent_clean_items', title: '外观专利数据库', companyScoped: true, load: () => import('@/pages/patent/AppearancePatentCleanItemsPage.vue') },
// 京东数据库 2026-11-16 退出公司 tab(参考品牌数据库先例):数据全平台公共,不按公司取数。
// 2026-11-17 第二刀:V204 独立「京东分类管理」子菜单页(jd-center/categories)整体并入
// 本页工具栏「分类管理」对话框(JdCategoryManageDialog),路由与菜单行(V208 删 V204 行)
// 一并下线——用户口径「京东分类管理并到京东数据库分类编辑里」。
{ path: 'jd-center/database', menuKey: 'admin_jd_database', title: '京东数据库', companyScoped: false, load: () => import('@/pages/jd/JdDatabasePage.vue') },
]
export function routeOf(page: AdminPageDef): RouteRecordRaw {
@@ -0,0 +1,26 @@
/**
* 青果提取链接的拼装(后管侧镜像)。
*
* 正本在**用户端那棵前端树**的同名文件 `src/shared/utils/qingguo-link.ts`。两棵前端树各自独立构建
* (各自的 vite root 与 tsconfig include),跨树 import 会把用户端拖进后管的产物图(本仓
* `src/config/workspace.ts` 的边界尺子也判这种耦合为违规),所以这里按**同名同形**镜像一份,
* 而不是另起一套新逻辑:口径只有一条
* `https://overseas.proxy.qg.net/get?key=<Authkey>&pwd=<Authpwd>`
* 改这一条 URL 时必须两边同改(用户端那份有 `node --test` 判据钉着)。
*
* 业务背景(2026-10-31 用户口径、2026-11-02 后台脱敏收口):青果**没有**可填的提取链接,
* 产品页只给 Authkey / Authpwd 两个值;后台「代填/改代理」因此改成收这两个值、在这里拼,
* 界面上任何时候都不再把拼好的链接回显或留档(链接里带着 pwd)。
*
* ⚠ 本文件保持**零依赖**:`node --test` 不认 Vite 的 `@/` 别名,带别名的模块进不了
* `tests/*.test.ts`,这条拼装规则就没法被用例钉住。
*/
export const QINGGUO_EXTRACT_URL = 'https://overseas.proxy.qg.net/get'
export function composeQingguoLink(account: string, password: string): string {
const key = (account || '').trim()
if (!key) return ''
const pwd = (password || '').trim()
const query = `key=${encodeURIComponent(key)}` + (pwd ? `&pwd=${encodeURIComponent(pwd)}` : '')
return `${QINGGUO_EXTRACT_URL}?${query}`
}
+28 -4
View File
@@ -2,6 +2,8 @@ import { defineStore } from 'pinia'
import { fetchCompanies } from '@/api/companies'
import type { CompanyItem } from '@/api/companies-dto'
import { useAdminSessionStore } from '@/stores/admin-session'
import { usePlatformTabStore } from '@/stores/platform-tab'
import type { PlatformTabId } from '@/config/platform-scope'
import { firstSelectableCompanyId, companyIdForRequest } from '@/layout/company-tab-model'
/** 公司 tab 的状态。成员 user ids **不在这里缓存**——每次请求交后端解析,
@@ -12,6 +14,11 @@ export const useCompanyTabStore = defineStore('company-tab', {
activeId: null as number | null,
loading: false,
loaded: false,
/** 当前这份目录是按哪个平台 tab 拉的(V206 平台分侧,2026-11-17 用户口径「公司 tab
* 条也按平台分侧,两边各看各的公司」)。空串=还没按平台拉过。早退闸拿它对撞当前
* tab:一致才免拉,平台切了就重拉一份;`fetchCompanies` 失败时不翻转它,旧清单
* (可能过时)继续顶着,下一次切台/重进页面会再试。 */
loadedPlatform: '' as PlatformTabId | '',
/** GET /companies 失败时的原因。**只住 store 与 console,不在模板里渲染**——
* §12 第 5 条没批任何新的用户可见提示,接口暴露禁令高于"失败可见"。
* 取不到目录时 loaded 保持 false ⇒ visibleForOperator 为 false ⇒ tab 条整体不画(fail-closed,观感与改前一致)。 */
@@ -35,15 +42,27 @@ export const useCompanyTabStore = defineStore('company-tab', {
},
},
actions: {
async initialize() {
/** 拉公司目录(按当前平台 tab 过滤,后端 GET /api/admin/companies?platform=…)。
* `force`=绕开「该平台已拉过」的早退闸(公司编辑弹窗翻档/启停后的 refresh 用),
* 旧清单保留到成功那刻再整份替换,取数期间 tab 条不闪空。 */
async initialize(options?: { force?: boolean }) {
const session = useAdminSessionStore()
if (this.loaded || this.loading || !session.isSuperAdmin) return
const platform = usePlatformTabStore().active
const alreadyLoadedForThisPlatform = this.loaded && this.loadedPlatform === platform
if ((!options?.force && alreadyLoadedForThisPlatform) || this.loading || !session.isSuperAdmin) return
this.loading = true
// 失败后 loaded 仍是 false ⇒ 下一次 watch 命中超管会重试;重试前先清掉旧原因,免得留着一条已经翻篇的错误。
this.error = ''
try {
this.companies = await fetchCompanies()
this.activeId = firstSelectableCompanyId(this.companies)
const companies = await fetchCompanies(platform)
this.companies = companies
this.loadedPlatform = platform
// 换台重拉后旧选中未必还在新清单里(跨平台公司不重叠):还在就保住(别的页可能正按它取数),
// 不在就回落「id 最小的启用公司」。force 重拉同平台时,选中公司仍在 ⇒ 选中不跳。
const stillListed = this.activeId !== null && companies.some((c) => c.id === this.activeId)
if (!stillListed) {
this.activeId = firstSelectableCompanyId(companies)
}
this.loaded = true
} catch (error) {
// 2026-10-05 修复轮 1:改前只有 try/finally ⇒ GET /companies 抛错时零痕迹(loaded 永远 false、
@@ -57,6 +76,11 @@ export const useCompanyTabStore = defineStore('company-tab', {
this.loading = false
}
},
/** 公司目录被编辑(公司管理翻档/启停/改名)后的强制重拉:不受 loadedPlatform 早退闸
* 限制。失败语义与 initialize 同口径(error + rethrow),调用方自行决定要不要提示。 */
async refresh() {
await this.initialize({ force: true })
},
setActiveId(id: number) {
this.activeId = id
},
@@ -0,0 +1,42 @@
import { defineStore } from 'pinia'
import { PLATFORM_TABS } from '@/config/platform-scope'
import type { PlatformTabId } from '@/config/platform-scope'
const STORAGE_KEY = 'admin-platform-tab'
const DEFAULT_TAB: PlatformTabId = 'amazon'
function isKnownTab(id: unknown): id is PlatformTabId {
return PLATFORM_TABS.some((tab) => tab.id === id)
}
/** 读取持久化偏好;无存储/值非法/存储不可用一律回落亚马逊(隐私模式不阻断交互)。 */
function readStoredTab(): PlatformTabId {
try {
const raw = typeof localStorage === 'undefined' ? null : localStorage.getItem(STORAGE_KEY)
return isKnownTab(raw) ? raw : DEFAULT_TAB
} catch {
return DEFAULT_TAB
}
}
function writeStoredTab(id: PlatformTabId): void {
try {
if (typeof localStorage !== 'undefined') localStorage.setItem(STORAGE_KEY, id)
} catch {
// localStorage 不可用(隐私模式等)时忽略
}
}
/** 侧边栏平台 tab(亚马逊/京东)状态:纯显示分组不参与鉴权(2026-11-16 用户定案)。
* 菜单可见性仍由 session.menuTree(后端按权限裁剪)决定,这里只记「当前看哪一侧」。 */
export const usePlatformTabStore = defineStore('platform-tab', {
state: () => ({
active: readStoredTab(),
}),
actions: {
setActive(id: PlatformTabId) {
this.active = id
writeStoredTab(id)
},
},
})
+16
View File
@@ -65,6 +65,22 @@ button, input, textarea, select { font: inherit; }
.admin-brand-copy strong { color: var(--admin-text); font-size: 15px; font-weight: 600; letter-spacing: .5px; white-space: nowrap; }
.admin-brand-copy span { color: #77899b; font-size: 11px; white-space: nowrap; }
/* 侧边栏顶部平台 tab(亚马逊/京东,2026-11-16「不混」定案):纯显示分组,只对当前用户
* 已授权菜单分侧展示;单侧无可见菜单时整条隐藏(AdminLayout showPlatformTabs)。 */
.admin-platform-tabs { display: flex; gap: 6px; padding: 10px 12px 0; }
.admin-platform-tab {
flex: 1; height: 34px; text-align: center; font-size: 13px; font-weight: 600;
color: var(--admin-sidebar-text); background: transparent;
border: 1px solid var(--admin-border); border-radius: 9px; cursor: pointer;
}
.admin-platform-tab:hover { color: #1e3b57; background: rgba(47, 93, 139, 0.16); }
.admin-platform-tab.is-active {
color: var(--admin-primary-strong);
background: linear-gradient(180deg, #dce9f5, #edf4fa);
border-color: #b6cbe0;
box-shadow: inset 0 2px 0 #5f85ad;
}
.admin-menu-scroll { flex: 1; padding: 12px 10px; }
.admin-menu { border-right: 0; background: transparent; }
.admin-menu .el-sub-menu__title,
+3
View File
@@ -4,9 +4,12 @@
export type AdminRole = 'super_admin' | 'company_super_admin' | 'admin' | 'normal'
export interface AdminUser {
jdPublishQuota?: number
id: number
username: string
role: string
/** 所属平台(V206):'amazon'|'jd',存量默认亚马逊;账号域三页按当前平台 tab 过滤/归类。 */
platform?: string
/** 1 为管理员标志位;role 为空时可据此推断角色。 */
isAdmin?: boolean
createdById?: number | null
@@ -52,15 +52,46 @@ test('align_dup_console_pagination_all_lists', () => {
// 且分布/矩阵/详情常显(不足一页也显示分页器,反馈:数据少时看不到分页)。
const page = readSource('src/pages/tasks/DuplicateCheckPage.vue')
assert.match(page, /:total="distCount"/, '店铺上架分布有分页器(常显)')
assert.match(page, /:total="dupRows\.length"/, '撞款覆盖矩阵有分页器(常显)')
assert.match(page, /v-for="item in dupCardRows"/, '撞款详情卡片绑定分页切片')
assert.match(page, /:total="dupRows\.length"[\s\S]*dupCardPageSize/, '撞款详情卡片有分页器(常显)')
// B60:撞款行改由服务端切窗口,矩阵与详情卡片读同一窗 ⇒ 两个分页器必须共用同一个游标
// (各自独立翻页在"一窗"的形状下已经不可表示,留着就是界面说一套、请求发另一套)。
assert.match(page, /:total="totalDupCount"[\s\S]*:page="matrixPage"/, '撞款覆盖矩阵分页器绑服务端总数与行窗口游标')
assert.match(page, /v-for="item in dupItems"/, '撞款详情卡片绑这一窗行集')
assert.match(page, /:total="totalDupCount"[\s\S]*:page-size="matrixPageSize"/, '撞款详情卡片分页器与矩阵同游标')
assert.doesNotMatch(page, /dupCardPage/, '卡片不再自持一个分页游标(同窗就是同游标)')
assert.doesNotMatch(page, /matrixRows/, '矩阵不再客户端切片(行窗口是服务端切的)')
assert.match(page, /<OldPagination[^>]*:total="distCount"/, '分布分页器无 v-if 条件')
assert.match(page, /<OldPagination[^>]*:total="dupRows\.length"/, '矩阵/详情分页器无 v-if 条件')
assert.match(page, /<OldPagination[^>]*:total="totalDupCount"/, '矩阵/详情分页器无 v-if 条件')
assert.match(page, /v-for="group in pagedGroupStats"/, '分组说明抽屉表绑定分页切片')
assert.match(page, /:total="groupStats\.length"/, '分组说明抽屉表有分页器')
})
/**
* B60 的前后两处出口:行窗口三键要真发出去,矩阵格子要一次算完。
* 反向自证:把 api 改回不带 page/page_size、或把模板改回逐格 filter,即红。
*/
test('align_dup_console_b60_row_window_and_precomputed_cells', () => {
const api = readSource('src/pages/tasks/duplicate-console-api.ts')
assert.match(api, /page, page_size: pageSize/, 'console 请求带行窗口参数')
assert.match(api, /query\.dup_group = group/, 'console 请求带分组裁行参数')
assert.doesNotMatch(api, /多余分页参数后端忽略/, '旧注释说分页参数被后端忽略,现在后端认了')
const page = readSource('src/pages/tasks/DuplicateCheckPage.vue')
// 矩阵窗口那一层已从页面拆进 `duplicate-matrix-window.ts`(B60 之后本页顶在可读性基线的
// 超长文件名单上,只许减)。绊线跟着搬,判据一字不松:改回逐格 filter 照样红。
const matrix = readSource('src/pages/tasks/duplicate-matrix-window.ts')
assert.match(page, /useDuplicateMatrix\(/, '页面接的是矩阵窗口组合式')
assert.match(matrix, /buildMatrixCells\(/, '矩阵格子一次预聚合')
assert.match(matrix, /MATRIX_COLUMN_WINDOW = 40/, '列数有窗口上限(按列切窗)')
assert.match(page, /v-for="\(cell, index\) in row\.cells"/, '模板只读预聚合好的格子')
assert.doesNotMatch(page, /function cellCount\(/, '逐格 filter 那套函数已收掉')
assert.doesNotMatch(matrix, /function cellCount\(/, '窗口组合式里也不许再长出逐格 filter')
const service = readSource('../backend-java/src/main/java/com/nanri/aiimage/modules/shopduplicatecheck/service/ShopDataDuplicateCheckQueryService.java')
assert.match(service, /consoleData\(DuplicateScanView view, Set<String> visibleKeys, Filters filters,\s*\n?\s*int page, int pageSize, String dupGroup\)/,
'服务端 console 收行窗口与分组参数')
assert.match(service, /"total_dup", total,/, 'total_dup 是未分页总数,不是本页行数')
})
test('align_dup_console_ledger_total_preload', () => {
const page = readSource('src/pages/tasks/DuplicateCheckPage.vue')
assert.match(page, /onMounted\(\(\) => \{\s*loadConsole\(\).*loadLedger\(1\)/s, '挂载即预取台账计数')
@@ -45,7 +45,8 @@ test('align_tutorial_api_contract', () => {
assert.match(api, /\$\{TUTORIAL_UPLOAD_ENDPOINT\}\/confirm/, '确认端点')
assert.match(api, /\$\{TUTORIAL_UPLOAD_ENDPOINT\}\/delete/, '删除端点')
assert.match(api, /params: \{ file_name: fileName, version \}/, '预签名回传文件名与版本号')
assert.match(api, /params: \{ object_key: objectKey, file_name: fileName, version \}/, '确认回传对象 key、文件名与版本号')
assert.match(api, /params: Record<string, string> = \{ object_key: objectKey, file_name: fileName, version \}/, '确认回传对象 key、文件名与版本号')
assert.match(api, /if \(fileKey\) params\.file_key = fileKey/, '分片拼装件的 file_key 必须随确认一起回传')
assert.match(api, /withCredentials: false/, '直传实例不挂会话拦截器')
})
@@ -4,7 +4,7 @@ import { readSource } from './helpers.ts'
import { adminPages } from '../src/router/routes.ts'
import { OPERATION_GUIDES } from '../src/layout/operation-guides.ts'
/** 工作台客户端包管理页:独立渠道、上传直传、服务端 sha256、客户端自动更新契约。 */
/** 工作台客户端包管理页:独立渠道、上传直传、服务端 sha256。 */
test('align_workbench_client_page_registered', () => {
const page = adminPages.find((p) => p.path === 'records/workbench-client-package')
@@ -28,7 +28,6 @@ test('align_workbench_client_page_wiring', () => {
assert.match(page, /当前生效/, '最新上传的包标记当前生效')
assert.match(page, /sha256/, '展示服务端复算的摘要')
assert.match(page, /formatFileSize/, '展示包体大小')
assert.match(page, /\/api\/workbench-client\/version\/latest/, '页面标明客户端更新检查接口')
assert.match(page, /确认删除选中的/, '批量删除二次确认')
assert.match(page, /暂无客户端包记录/, '空态文案')
})
@@ -43,7 +42,6 @@ test('align_workbench_client_api_contract', () => {
assert.match(api, /params: \{ file_name: fileName, version \}/, '预签名回传文件名与版本号')
assert.match(api, /params: \{ object_key: objectKey, file_name: fileName, version \}/, '确认回传对象 key、文件名与版本号')
assert.match(api, /withCredentials: false/, '直传实例不挂会话拦截器')
assert.match(api, /\/api\/workbench-client\/version\/latest/, '公开更新契约路径固定')
})
test('align_workbench_client_model_parsers', () => {
@@ -61,5 +59,4 @@ test('align_workbench_client_guide_registered', () => {
const guide = OPERATION_GUIDES.admin_workbench_client_package
assert.ok(guide, '每个菜单页都必须有操作提示')
assert.match(guide.text, /sha256/, '提示说明服务端会复算摘要')
assert.match(guide.text, /\/api\/workbench-client\/version\/latest/, '提示说明客户端更新检查接口')
})
@@ -0,0 +1,99 @@
/**
* 外观专利无侵权数据页筛选纯函数(v1.3 AC-5)—— Phase 3 激活。
*
* 1. **snake 参数形状**:toAppearancePatentCleanListParams({...}) 产出
* `page`/`page_size`(默认 10、上限 100)、`task_id`、`asin`、`country`、
* `start_date`/`end_date`(ISO yyyy-MM-dd;空白不下发)——与后端 §3.2 参数归一逐字对撞;
* 2. **分页钳制**(铁律 15):page < 1 归 1;page_size 上限 100;
* `(page-1)*page_size` 溢出边界样本(page 极大值不得把乘积顶成负数/溢出)。
*
* 跑法:`node --test tests/appearance-patent-clean-filter.test.ts`(node --test 只收顶层
* `tests/*.test.ts`,不递归;纯函数零依赖可直测)
*/
import { test } from 'node:test'
import assert from 'node:assert/strict'
import {
APPEARANCE_PATENT_CLEAN_MAX_PAGE,
createAppearancePatentCleanFilterState,
toAppearancePatentCleanExportParams,
toAppearancePatentCleanListParams,
} from '../src/pages/patent/appearance-patent-clean-filter.ts'
test('AC-5 筛选参数——snake page/page_size/task_id/asin/country/group_id/start_date/end_date 形状', () => {
const full = toAppearancePatentCleanListParams(
{ taskId: '33179', asin: ' B0AB8CDEF9 ', country: 'DE', groupId: ' 7 ', startDate: '2026-11-01', endDate: '2026-11-09' },
2,
20,
)
// snake 逐字对撞后端 §3.2;ASIN 前后空白被构造器剥掉(后端服务侧再 trim 一次是双保险)。
// 分组(主管=组长,2026-11-11 客户口径「就是分组」):group_id 下发,选中行是分组管理里那一行。
assert.deepEqual(full, {
page: 2,
page_size: 20,
task_id: 33179,
asin: 'B0AB8CDEF9',
country: 'DE',
group_id: 7,
start_date: '2026-11-01',
end_date: '2026-11-09',
})
// 空白/非法值不下发:全空态只有分页两项;非法日期与空串同罪。
const blank = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 1, 10)
assert.deepEqual(blank, { page: 1, page_size: 10 })
const dirty = toAppearancePatentCleanListParams(
{ taskId: 'abc', asin: ' ', country: '', groupId: 'abc', startDate: '2026/11/01', endDate: 'not-a-date' },
1,
10,
)
assert.deepEqual(dirty, { page: 1, page_size: 10 })
assert.equal('task_id' in dirty, false, '非数字任务号不下发')
assert.equal('group_id' in dirty, false, '非数字分组 id 不下发')
assert.equal('start_date' in dirty, false, '非法日期不下发')
})
test('AC-5 筛选参数——page 钳制防 (page-1)*page_size 溢出(铁律 15)', () => {
// page < 1 归 1;page_size 下限 1、默认 10、上限 100。
const low = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 0, 0)
assert.equal(low.page, 1, 'page<1 归 1')
assert.equal(low.page_size, 10, 'page_size 非法回默认 10')
const big = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 3, 500)
assert.equal(big.page_size, 100, 'page_size 上限 100')
// 溢出边界:page 极大值钳到 10_000(与后端 MAX_PAGE 同值),乘积 999_900 必须还是安全整数——
// 不钳的话 (Number.MAX_SAFE_INTEGER-1)*100 直接顶出安全整数域,翻页偏移就不再可靠。
const extreme = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), Number.MAX_SAFE_INTEGER, 100)
assert.equal(extreme.page, APPEARANCE_PATENT_CLEAN_MAX_PAGE)
const offset = (extreme.page - 1) * extreme.page_size
assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`)
assert.equal(offset, 999_900)
})
test('导出参数——与列表同一过滤面单出口(无分页,空白/非法值不下发)', () => {
// 同一过滤态下导出与列表的过滤面字段逐字同源(防「页签筛了公司、导出全量」的两处各算各的)。
const state = { taskId: '33179', asin: ' B0AB8CDEF9 ', country: 'de', groupId: '7', startDate: '2026-11-01', endDate: '' }
const list = toAppearancePatentCleanListParams(state, 3, 20)
const exp = toAppearancePatentCleanExportParams(state)
for (const key of Object.keys(exp) as Array<keyof typeof exp>) {
assert.equal((list as Record<string, unknown>)[key], exp[key], `导出与列表的 ${key} 必须同源`)
}
assert.equal('page' in exp, false, '导出参数无分页(全量导出由服务侧上限兜住)')
assert.deepEqual(exp, {
task_id: 33179,
asin: 'B0AB8CDEF9',
country: 'de',
group_id: 7,
start_date: '2026-11-01',
})
// 全空态零字段;非法日期与非数字任务号/分组同列表口径不下发。
assert.deepEqual(toAppearancePatentCleanExportParams(createAppearancePatentCleanFilterState()), {})
assert.deepEqual(
toAppearancePatentCleanExportParams(
{ taskId: 'abc', asin: ' ', country: '', groupId: 'abc', startDate: '2026/11/01', endDate: 'not-a-date' },
),
{},
'脏值不下发,与列表参数归一规则逐字同源',
)
})
File diff suppressed because it is too large Load Diff
@@ -15,6 +15,12 @@ const BRAND_GATING_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src',
'V174__restore_admin_brand_gating_menu.sql')
const KEYWORD_USAGE_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
'V175__move_gating_and_add_keyword_usage_menu.sql')
const JD_DATABASE_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
'V196__jd_database_menu.sql')
/** V204 插入的「京东分类管理」菜单行已随 2026-11-17 用户口径「京东分类管理并到京东数据库
* 分类编辑里」由 V208 删除(页面并入 JdDatabasePage 工具栏「分类管理」对话框)。 */
const JD_CATEGORY_MANAGE_DROP_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
'V208__drop_jd_category_manage_menu.sql')
interface MigrationMenu {
name: string
@@ -95,3 +101,40 @@ test('V175 新增的关键词使用记录菜单 key 必须在路由注册表登
assert.ok(sql.includes('SET col.`parent_id` = grp.`id`'), 'V175 必须把品牌Gating库迁到店铺管理组')
assert.ok(sql.includes('col.`sort_order` = 85'), '品牌Gating库排序应为 85')
})
test('V196 新增的京东数据库菜单 key 必须在路由注册表登记', () => {
const sql = readFileSync(JD_DATABASE_MIGRATION, 'utf8')
const menus = menusInsertedBy(sql)
const insertCount = (sql.match(/INSERT INTO `columns`/g) || []).length
assert.ok(menus.length > 0, 'V196 应当插入后台菜单,一条都没解析出来说明正则失效')
assert.equal(menus.length, insertCount, `解析到 ${menus.length} 条,但迁移有 ${insertCount} 条 INSERT INTO columns`)
const menu = menus.find((item) => item.columnKey === 'admin_jd_database')
assert.ok(menu, 'V196 必须插入 admin_jd_database 菜单')
const page = adminPages.find((item) => item.menuKey === 'admin_jd_database')
assert.ok(page, 'routes.ts 必须有 admin_jd_database 页面,否则菜单点进去 404')
assert.equal(page.path, menu.routePath, '库里的 route_path 应与注册表路径一致')
assert.equal(page.title, menu.name, '页面标题应与菜单名一致')
// 2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」:数据全平台公共(行 company_id
// 只剩同步来源标记),页面退出公司 tab 注册表、取数口不带 company_id ⇒ meta 必须 false
// (true 会画出 tab 而取数不带参=点了没反应;同品牌数据库 admin_invalid_asin_data 的形状)。
assert.equal(page.companyScoped, false, '京东数据库全平台公共,不画公司 tab(V196 当时的按公司隔离口径已被推翻)')
// 每公司一套树(公司 1 模板行 + 其余公司复制),挂数据管理组、排序 68(V190 外观专利占 67)。
assert.ok(sql.includes("grp.`column_key` = 'admin_group_data'"), 'V196 必须把京东数据库挂到数据管理组')
assert.ok(/'京东数据库', 'admin_jd_database', 'admin', 'jd-center\/database', 68/.test(sql), '京东数据库排序应为 68')
assert.ok(!sql.includes('user_column_permission'), 'V196 不得预插授权行(默认仅超管可见)')
})
test('V208 删掉 V204 的京东分类管理菜单行,且注册表不再认这个 key(2026-11-17 分类管理并入京东数据库页)', () => {
// V204 本体已应用不可回改(铁律 10,文件原样保留作历史取证);下线动作由 V208 出 DELETE,
// 页面并入京东数据库页工具栏「分类管理」对话框。
const sql = readFileSync(JD_CATEGORY_MANAGE_DROP_MIGRATION, 'utf8')
assert.ok(sql.includes("DELETE FROM `columns` WHERE `column_key` = 'admin_jd_category_manage'"),
'V208 必须 DELETE admin_jd_category_manage 菜单行(授权行随外键 CASCADE)')
const registered = adminPages.find((item) => item.menuKey === 'admin_jd_category_manage')
assert.ok(!registered, 'routes.ts 不得再登记 admin_jd_category_manage(页面已并入京东数据库页,残留=404 入口)')
const jdRouteGone = !adminPages.some((item) => item.path === 'jd-center/categories')
assert.ok(jdRouteGone, 'jd-center/categories 路由必须下线')
})
@@ -70,12 +70,14 @@ function escapeRegExp(text: string): string {
}
/**
* 全部 21 个字面发送口:批次 1 的任务看板 5 处 + 批次 2(控制方 2026-10-05 点名「切 tab 数据还一样」那五页)7 处
* 全部 25 个字面发送口:批次 1 的任务看板 5 处 + 批次 2(控制方 2026-10-05 点名「切 tab 数据还一样」那五页)7 处
* + 批次 3(控制方 2026-10-05 点名「店铺撞款监控 店铺数据也要做隔离」那两页)4 处
* + 批次 4(控制方 2026-10-05 点名「菜单权限和用户管理也要区分公司 tab 的数据」里的用户管理)1 处
* + 批次 5(控制方 2026-10-06 点名「店铺密钥管理的数据按照公司区分」)1 处
* + 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」)3 处:菜单目录 / 新建菜单 / 用户管理里的授权树。
* + 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」)3 处:菜单目录 / 新建菜单 / 用户管理里的授权树
* + 批次 7(2026-11-10 v1.3 外观专利无侵权数据)2 处:只读列表 + 导出(2026-11-11 客户需求「数据得导出来」)。
* 批次 2 原 12 处里的品牌库 1 处 + 商品类目 4 处,随 2026-10-06「这两页退回全平台共享」一并摘掉。
* 批次 8 原 2 处(京东数据库列表/类目)随 2026-11-16「删除掉公司 tab,参考品牌数据库」一并摘掉。
*
* <p>`window` 的取法:本轮实扫的 own(到自己那行的距离)+ ≥150 余量,且当同文件还有下一个同名发送口时必须
* `window < next`。own/next 不写死在这里——下面「窗口与真文件对平」那条用例逐处从真文件重算,
@@ -122,6 +124,18 @@ const SEND_POINTS: ReadonlyArray<SendPoint> = [
{ menuKey: 'admin_columns', file: 'src/pages/account/menu-manage-api.ts', fn: 'fetchMenuManageNodes', line: TASK_CENTER_SEND_LINE, window: 300, title: 'GET /permission-menus 目录(超管不带就把两家的同名行混成一排下发)' },
{ menuKey: 'admin_columns', file: 'src/pages/account/menu-manage-api.ts', fn: 'createMenu', line: TASK_CENTER_SEND_LINE, window: 300, title: 'POST /permission-menus 新建:归属由端点参数决定,前端不从树里猜' },
{ menuKey: 'admin_users', file: 'src/pages/account/user-menu-auth-api.ts', fn: 'fetchGrantableMenus', line: TASK_CENTER_SEND_LINE, window: 300, title: 'GET /permission-menus?grantableOnly 授权树:一家一套树后取错公司=已授权勾不上、提交必判无效' },
// ↓ 批次 7(2026-11-10 v1.3 外观专利无侵权数据):出表成功自动同步的只读明细,归属物化在行
// company_id 列(V189,同店铺密钥形状)⇒ 后端正门 readCompanyIdOrOwn;2026-11-11 客户需求
// 「数据得导出来」补导出发送口(与列表共用同一过滤面与正门)。这一页共两个发送口
// (同日曾加的 /supervisors 取数与按主管删除两口,随当晚「恢复昨天那个明细表格式」一并
// 下架——后端接口保留,前端发送口撤,重上时从 e1767faf 历史找回再登记)。
// 窗口 500:own 实测 416(groupId 行加入后),同文件两条塞键行的间距 1585 ⇒
// 500 够得着自己、够不到隔壁(对平用例逐处从真文件重算,注释过期即红)。
{ menuKey: 'admin_appearance_patent_clean_items', file: 'src/pages/patent/appearance-patent-clean-api.ts', fn: 'fetchAppearancePatentCleanList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 500, title: 'GET /appearance-patent-clean-items 无侵权只读列表' },
{ menuKey: 'admin_appearance_patent_clean_items', file: 'src/pages/patent/appearance-patent-clean-api.ts', fn: 'exportAppearancePatentCleanList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 500, title: 'GET /appearance-patent-clean-items/export 导出(2026-11-11 客户需求「数据得导出来」,与列表共用同一过滤面)' },
// 批次 8(2026-11-14 v1.4 京东数据库)的两条发送口(列表/类目下拉)已于 2026-11-16 随
// 「删除掉公司 tab,参考品牌数据库」整批摘下(后端读侧谓词同窗撤,重上时从 git 历史找回);
// 「不得回流」由文件末尾「公司维度不得回流」清单看守(admin_jd_database 已入列)。
]
/** 任务看板那 5 处(1b ④ 那条用例按文件筛它们,沿用旧名字不漂;表只有一份,不会漂出两个口径)。 */
@@ -243,6 +257,10 @@ const COMPANY_ID_SOURCE_PINS: Readonly<Record<string, readonly CompanyIdPin[]>>
// 编辑/删除/重排三支**故意不带**参数——归属由那一行的 id 与操作者公司共同判定,跨公司写后端 403
// (见 docs/ops/menu-company-tree-design-2026-10-06.md §5),给它们发 company_id 反而是第三处口径。
admin_columns: pinsFor('admin_columns'),
// 批次 7(v1.3 无侵权只读页):同样由 SEND_POINTS 现算——只有一个发送口(列表)。
admin_appearance_patent_clean_items: pinsFor('admin_appearance_patent_clean_items'),
// 批次 8(v1.4 京东数据库)2026-11-16 随「删除掉公司 tab」整页摘除:登记表条目一并撤下,
// 「不得回流」改由文件末尾「公司维度不得回流」清单看守(同品牌库/商品类目的先例形状)。
}
/** 严格判据的分母由本轮实扫得出(修完不许恒绿也不许恒红):求值了几条 shape、其中几条通过。 */
@@ -341,8 +359,13 @@ test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company
// ⚠ 分母是本轮实扫的表条数(批次 1 的 5 + 批次 2 的 7 + 批次 3 的 4 + 批次 4 的 1 + 批次 5 的 1 + 批次 6 的 3;
// 批次 2 原 12 条里的品牌库 1 条 + 商品类目 4 条随 2026-10-06「这两页退回全平台共享」摘掉)。
// 这条只防"整表被摘空/被改窄",逐处脱管由下面两条(对平闸门 + 窗口对平)负责。
assert.ok(SEND_POINTS.length >= 21,
`发送口表只剩 ${SEND_POINTS.length} 条(批次 1+2+3+4+5+6 实扫 21 条)⇒ 有人把钉从表里摘了,取值口看守成空`)
// 2026-11-15 京东数据库公共化(用户定案「不区分公司、属于公共的」):批次 8 的详情/删除/
// 分组列表/删分组/编辑 5 条 company_id 发送口随公司谓词整批撤下(后端写侧同窗摘),批次 8
// 只剩列表/类目两条 ⇒ 32 → 27。
// 2026-11-16 京东数据库摘公司 tab(用户定案「删除掉公司 tab,参考品牌数据库」):最后两条
// 发送口(列表/类目下拉)与后端读侧谓词同窗摘掉,页面退出注册表 ⇒ 27 → 25。
assert.ok(SEND_POINTS.length >= 25,
`发送口表只剩 ${SEND_POINTS.length} 条(批次 1+2+3+4+5+6 实扫 21 条 + 批次 7 v1.3 无侵权列表/导出 2 条 + 主管聚合 1 条 + 按主管删除 1 条 = 25 条;京东数据库两条 2026-11-16 随「删除掉公司 tab」摘、导出口 2026-11-15 随客户口径摘)⇒ 有人把钉从表里摘了,取值口看守成空`)
for (const p of SEND_POINTS) {
const shape = pointShape(p)
const compliant = pointCompliant(p)
@@ -374,8 +397,8 @@ test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company
if (hit) hit.pinned += 1
else grouped.set(key, { file: p.file, line: p.line, pinned: 1 })
}
assert.equal(grouped.size, 18,
`发送口表按 (文件, 整行) 应聚成 18 组(22 处发送口),现在却有 ${grouped.size} 组 —— 表被改形状了,对平判据失去分母`)
assert.equal(grouped.size, 19,
`发送口表按 (文件, 整行) 应聚成 19 组(25 处发送口,批次 7 的列表/导出/主管聚合/按主管删除逐字同行各走同一组;京东数据库两组 2026-11-16 随「删除掉公司 tab」摘),现在却有 ${grouped.size} 组 —— 表被改形状了,对平判据失去分母`)
for (const g of grouped.values()) {
const actual = occurrences(stripComments(read(g.file)), g.line)
assert.equal(g.pinned, actual,
@@ -717,6 +740,23 @@ const WATCH_BODY_PINS: ReadonlyArray<{
{ file: 'src/pages/account/menu-manage-api.ts', shapes: [/company_id\s*=\s*companyId\b/] },
],
},
// ↓ 批次 7(2026-11-10 v1.3 无侵权只读页):任务号/ASIN 是自由文本筛选,上一家填的值在新一家的
// 行集里筛不出东西 ⇒ 首屏「暂无无侵权数据」而输入框里还显示着那个值;页码回 1 同理。
// 2026-11-11 分组筛选(主管=组长,就是分组)落地:分组选项集是公司隔离的(GET /shop-manages/groups
// 带 company_id),上一家选的 groupId 在新一家的选项集里不存在 ⇒ 同罪必清,选项也按新公司重取。
{
file: 'src/pages/patent/AppearancePatentCleanItemsPage.vue',
token: "filter.taskId = ''; filter.asin = ''; filter.groupId = ''; page.value = 1; void loadGroupOptions(); void load()",
why: '任务号/ASIN 是按行集筛的自由文本,上一家的值在新一家的行里不存在 ⇒ 切 tab 后首屏被筛成「暂无无侵权数据」,'
+ '而输入框还显示着上一家填的值;分组(主管)选项集是公司隔离的,上一家选的 groupId 在新一家的选项里不存在,'
+ '同罪必清且选项重取;页码回 1 是因为新一家的行数更少,末尾的 void load() 才让切 tab 真的换数据',
premise: [
{ file: 'src/pages/patent/appearance-patent-clean-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
// 批次 8(2026-11-14 v1.4 京东数据库页)那条 watch 看守已于 2026-11-16 随「删除掉公司 tab,
// 参考品牌数据库」一并摘下——页面不再 watch companyTab.activeId、不再消费公司 tab store,
// 「不得回流」改由文件末尾「公司维度不得回流」清单看守。
]
/** 取「`watch(() => companyTab.activeId, () => { … })`」这一条语句的原文;匹配不出返回 null(由调用方判探针失效)。 */
@@ -725,9 +765,9 @@ function watchStatement(source: string): string | null {
return m ? m[0] : null
}
test('切公司的 watch 体:每对 (file, token) 都要在该页 watch 体内出现(批次 1 两页 + 批次 2 三页 + 批次 3 两页 + 批次 4 一页 + 批次 5 一页 + 批次 6 一页)', () => {
assert.ok(WATCH_BODY_PINS.length >= 10,
`watch 体看守只剩 ${WATCH_BODY_PINS.length} 对(批次 1 的店铺管理/任务看板 + 批次 2 的去重库/查询ASIN/最低价ASIN + 批次 3 的撞款监控/店铺数据记录 + 批次 4 的用户管理 + 批次 5 的店铺密钥 + 批次 6 的菜单管理共 10 对)`
test('切公司的 watch 体:每对 (file, token) 都要在该页 watch 体内出现(批次 1 两页 + 批次 2 三页 + 批次 3 两页 + 批次 4 一页 + 批次 5 一页 + 批次 6 一页 + 批次 7 一页)', () => {
assert.ok(WATCH_BODY_PINS.length >= 11,
`watch 体看守只剩 ${WATCH_BODY_PINS.length} 对(批次 1 的店铺管理/任务看板 + 批次 2 的去重库/查询ASIN/最低价ASIN + 批次 3 的撞款监控/店铺数据记录 + 批次 4 的用户管理 + 批次 5 的店铺密钥 + 批次 6 的菜单管理 + 批次 7 v1.3 无侵权只读页共 11 对;批次 8 京东数据库页那条 2026-11-16 随「删除掉公司 tab」摘下)`
+ '⇒ 这一族又退回"只钉少数几页",被摘掉那一页的"切公司不清筛选项"再次没人看守')
const pinnedFiles = new Set(WATCH_BODY_PINS.map((pin) => pin.file))
for (const pin of WATCH_BODY_PINS) {
@@ -929,26 +969,30 @@ test('渲染范围:tab 条只画在按公司取数的页上,公司管理那
})
/**
* 2026-10-06 控制方定案:品牌数据库、商品类目「做成所有公司共享的,不区分」。
* 控制方/用户定案的「全平台共享、不区分公司」页清单:
* - 品牌数据库、商品类目(2026-10-06 控制方定案「做成所有公司共享的,不区分」);
* - 京东数据库(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」)。
*
* <p>上面那几条正向判据全是从 {@code COMPANY_SCOPED_PAGES} 派生的,页一退出注册表就自动不再求值 ⇒
* 「退出」这件事本身没有看守:谁把 {@code company_id} 重新塞回这三个取数口,全仓用例一支都不会红,
* 而后端唯一键已经退回全局(V151),带公司参数的读会把共享库筛窄成「只看这一家」,
* 「退出」这件事本身没有看守:谁把 {@code company_id} 重新塞回这些取数口,全仓用例一支都不会红,
* 而后端唯一键已经退回全局(V151)/读侧谓词已摘(京东),带公司参数的读会把共享库筛窄成「只看这一家」,
* 写侧则把一张全平台共享的表按家拆开——两边都是静默改口径,不是报错。所以这一支必须存在。</p>
*
* <p>判据只认「剥完注释的代码」:这三份文件现在各自留有一句说明共享口径的注释,
* 注释里的 {@code company_id} 三个字面字符不是接线(全局约束 6)。正样本用摘掉之前那三行原文,
* <p>判据只认「剥完注释的代码」:这些文件各自留有一句说明共享口径的注释,
* 注释里的 {@code company_id} 三个字面字符不是接线(全局约束 6)。正样本用摘掉之前那些行原文,
* 所以下面的 false 是测出来的,不是「正则本来就抓不到」。</p>
*/
const SHARED_PAGE_KEYS = ['admin_invalid_asin_data', 'admin_product_categories'] as const
const SHARED_PAGE_KEYS = ['admin_invalid_asin_data', 'admin_product_categories', 'admin_jd_database'] as const
const SHARED_API_FILES = [
'src/pages/invalidasin/invalid-asin-api.ts',
'src/pages/asin/product-category-api.ts',
'src/pages/asin/product-category-export.ts',
'src/pages/jd/jd-product-api.ts',
] as const
const SHARED_PAGE_FILES = [
'src/pages/asin/AsinInvalidPage.vue',
'src/pages/asin/ProductCategoryPage.vue',
'src/pages/jd/JdDatabasePage.vue',
] as const
/** 公司参数的两种写法:下传用的 snake、形参/字段用的 camel。 */
@@ -961,7 +1005,7 @@ const FORMER_SEND_LINES = [
'if (companyId != null) params.push(`company_id=${companyId}`)',
]
test('公司维度不得回流:品牌库与商品类目已定案全平台共享,取数口与页面都不许再带公司参数', () => {
test('公司维度不得回流:品牌库/商品类目/京东数据库已定案全平台共享,取数口与页面都不许再带公司参数', () => {
// 判据自证(全局约束 15:反向钉不许独自成立)——改动前那三行必须抓得到,否则下面的 false 是空判据。
for (const line of FORMER_SEND_LINES) {
assert.ok(COMPANY_PARAM_TOKEN.test(line), `反向钉判据连原来的发送口「${line}」都匹配不出 ⇒ 这一族恒绿`)
@@ -976,7 +1020,7 @@ test('公司维度不得回流:品牌库与商品类目已定案全平台共
for (const key of SHARED_PAGE_KEYS) {
assert.equal(COMPANY_SCOPED_PAGES.some((p) => p.menuKey === key), false,
`${key} 又回到 COMPANY_SCOPED_PAGES:2026-10-06 已定案这两页全平台共享,不区分公司`)
`${key} 又回到 COMPANY_SCOPED_PAGES:已定案全平台共享、不区分公司(品牌库/商品类目 2026-10-06、京东数据库 2026-11-16)`)
const page = adminPages.find((p) => p.menuKey === key)
assert.ok(page, `${key} 在路由注册表里找不到:菜单名改了,反向钉对不上页`)
assert.equal(page.companyScoped, false,
@@ -24,13 +24,13 @@ function form(overrides: Record<string, unknown> = {}) {
return { ...createEmptyCreateUserForm(), username: 'zhangsan', password: 'secret123', ...overrides }
}
test('空表单默认没有公司、没有到期时间', () => {
test('空表单默认没有公司、没有到期时间(平台默认亚马逊 = 存量口径,V206)', () => {
const blank = createEmptyCreateUserForm()
assert.equal(blank.companyId ?? null, null, 'companyId 默认 null(仅公司超管角色使用)')
assert.equal(blank.expiresAt, '', '到期时间默认空 = 永不过期')
assert.deepEqual(
{ ...blank, companyId: null, expiresAt: '' },
{ username: '', password: '', role: 'normal', columnIds: [], createdBy: null, companyId: null, expiresAt: '' },
{ username: '', password: '', role: 'normal', columnIds: [], createdBy: null, companyId: null, expiresAt: '', platform: 'amazon' },
)
})
@@ -51,6 +51,8 @@ test('请求体:admin/normal 一律不带 companyId;公司超管必须带且
password: 'secret123',
role: 'normal',
columnIds: [3, 1],
// V206:所属平台恒下发(弹窗单选默认当前平台 tab,空表单缺省亚马逊)。
platform: 'amazon',
})
// 所属管理员仍按原语义携带(仅 normal 角色)
assert.equal(toCreateUserRequest(form({ role: 'normal', createdBy: 5 })).createdById, 5)
@@ -88,11 +88,13 @@ test('账号页与顶栏的源码里公司维度已摘干净', () => {
'拉公司目录必须按站点超管门控,非超管不发这个请求(后端 403 兜底)')
// 「删了列忘了改占位行 colspan」是这类改动最常留下的残行:按表头列数交叉核对
// (`<th` 是 `<thead` 的前缀,必须带上后随字符才数得准)
// (`<th` 是 `<thead` 的前缀,必须带上后随字符才数得准)。
// 2026-11-17 V206:上架上限列 v-if="isJdSide" 按平台动态渲染 ⇒ 表头数 10(含源码里的 v-if th),
// 占位行走 :colspan 动态绑定;字面量 colspan 在动态列下必然错位一半的 tab,反向钉死。
const headers = (page.match(/<th[\s>]/g) || []).length
const spans = [...page.matchAll(/colspan="(\d+)"/g)].map((m) => Number(m[1]))
assert.ok(spans.length >= 1, '列表 tbody 没有 colspan 占位行')
for (const span of spans) assert.equal(span, headers, `占位行 colspan=${span} 与表头列数 ${headers} 不符`)
assert.equal(headers, 10, `用户列表表头应为 10 列(9 列存量 + 京东侧上架上限 v-if 列),实际 ${headers}`)
assert.match(page, /:colspan="isJdSide \? 10 : 9"/, '空态占位行必须按平台动态切 colspan(静态值与动态列数错位一半 tab)')
assert.equal(/colspan="\d+"/.test(page), false, '动态列下不许再留字面量 colspan(必有一侧 tab 列数对不上)')
const dialog = readSource('src/pages/account/CreateUserDialog.vue')
assert.match(dialog, /operatorSuper && form\.role === 'company_super_admin'/,
@@ -34,6 +34,12 @@ const EXEMPT = new Set([
'src/pages/tasks/ShopDataTasksPage.vue',
'src/pages/tasks/ImageVideoTasksPage.vue',
'src/pages/records/RecordsHistoryPage.vue',
// 2026-11-10(v1.3):外观专利无侵权数据页与去重库同形状——出表成功自动同步的累计台账,
// 默认当天会让首屏只剩今天同步的行,历史同步行整批"消失"。
'src/pages/patent/AppearancePatentCleanItemsPage.vue',
// 2026-11-14(v1.4 Phase 5):京东数据库页与外观专利页同形状——京东商品同步落库的累计台账,
// 默认当天会让首屏只剩今天同步的行(页面注释与 filter 工厂同口径留空)。
'src/pages/jd/JdDatabasePage.vue',
// 2026-10-05(V146):两处是「到期时间」表单字段而非列表筛选——留空 = 永不过期,
// 是有业务语义的默认值,绝不能默认当天(默认当天等于建号即过期)。
'src/pages/account/CreateUserDialog.vue',
@@ -231,11 +231,11 @@ test('orderedPair 只在两端都有值且倒挂时交换', () => {
})
test('分母硬钉:四面控件实例数与成对数(扫描失明即红)', () => {
assert.equal(adminCtrls.length, 19, '后管实例数变了,先复算普查再改这里')
assert.equal(adminCtrls.length, 23, '后管实例数变了,先复算普查再改这里(v1.4 京东数据库页同步时间起止再落一对=2 实例)')
assert.equal(userCtrls.length, 2, '用户端实例数变了')
assert.equal(finCtrls.length, 30, '财务系统实例数变了')
assert.equal(mxCtrls.length, 4, '麦象实例数变了')
assert.equal(pairCount(adminCtrls), 8, '后管成对区间应为 8')
assert.equal(pairCount(adminCtrls), 10, '后管成对区间应为 10(v1.4 京东数据库页同步时间起止再落一对)')
assert.equal(pairCount(finCtrls), 11, '财务系统成对区间应为 11')
assert.equal(pairCount(mxCtrls), 2, '麦象成对区间应为 2')
assert.equal(pairCount(userCtrls), 0, '用户端出现成对区间说明新加了两个单只控件')
@@ -0,0 +1,183 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { buildMatrixCells, matrixCellOf, storeColumnsOf } from '../src/pages/tasks/duplicate-console-logic.ts'
import type { DuplicateItem, DuplicateOccurrence } from '../src/pages/tasks/duplicate-model.ts'
/**
* B60 撞款矩阵:预聚合的等价性与前后读数。
*
* 审计指的那件事是「每格多次全量 filter」——模板一格要付 cellCount ×2 + cellTitle(内部再
* cellCount + cellCountryDots + 每站点一次 cellCountryCount),每次都是把该行 occurrences 整份
* filter 一遍,而且**每格都新建一条文案字符串**。下面 `legacyCell` 就是页面原来那几行函数的
* 原样搬运,当"前";与新一次算完的 `buildMatrixCells`(空格按列共用一份视图)对撞:
* 先证明结果逐字相同(预聚合不是靠少算蒙过去的),再同尺量时间。
*/
function occ(asin: string, shopName: string, country: string): DuplicateOccurrence {
return {
asin,
date: '2026-09-01',
price: '',
brand: 'B',
shopName,
groupName: '',
countryCodes: [country],
country,
}
}
const shopKey = (name: string): string => (name || '').trim().toLowerCase()
interface CellView {
count: number
dots: string[]
title: string
}
/** 原页面的逐格算法(一格扫整行 occurrences 若干次,并且每格造一条文案)。 */
function legacyCellOccurrences(item: DuplicateItem, shop: string): DuplicateOccurrence[] {
const key = shopKey(shop)
return (item.occurrences || []).filter((entry) => shopKey(entry.shopName) === key)
}
function legacyCell(item: DuplicateItem, shop: string): CellView {
const count = legacyCellOccurrences(item, shop).length
const codes = new Set<string>()
for (const entry of legacyCellOccurrences(item, shop)) if (entry.country) codes.add(entry.country.toUpperCase())
const dots = [...codes]
const sites = dots.map((code) => `${code} ${legacyCellOccurrences(item, shop).filter((entry) => (entry.country || '').toUpperCase() === code).length}条`)
return {
count,
dots,
title: count ? `${shop} 在售 ${count} 条 · ${sites.join('、')}` : `${shop} 无此 ASIN`,
}
}
/** 页面现在的读法:一次取值;空格取该列那一份共用视图(不再造文案)。 */
function fastCell(cells: ReturnType<typeof buildMatrixCells>, item: DuplicateItem, shop: string, blank: CellView): CellView {
const cell = matrixCellOf(cells, item.asin, shop)
if (!cell.count) return blank
const sites = cell.sites.map((site) => `${site.code} ${site.count}条`)
return {
count: cell.count,
dots: cell.sites.map((site) => site.code),
title: sites.length ? `${shop} 在售 ${cell.count} 条 · ${sites.join('、')}` : `${shop} 在售 ${cell.count} 条`,
}
}
function fixtureItem(asin: string, shops: [string, string][]): DuplicateItem {
const occurrences = shops.map(([shop, country]) => occ(asin, shop, country))
return {
asin,
shopCount: new Set(occurrences.map((entry) => shopKey(entry.shopName))).size,
recordCount: occurrences.length,
occurrences,
}
}
function blankViews(columns: string[]): CellView[] {
return columns.map((shop) => ({ count: 0, dots: [] as string[], title: `${shop} 无此 ASIN` }))
}
/**
* 200 列 × 50 行的矩阵夹具。`shopsPerRow` 决定密度:现实中一个撞款 ASIN 落在几家到几十家店,
* 而逐格 filter 的代价正是按「行内 occurrences × 列数」乘出来的——密度越高旧算法越吃亏,
* 所以两种密度都取读数,不挑对自己有利的那一档。
*/
function matrixFixture(columns: string[], shopsPerRow: number): DuplicateItem[] {
return Array.from({ length: 50 }, (_, index) => {
const pairs: [string, string][] = []
for (let offset = 0; offset < shopsPerRow; offset++) {
const shop = columns[(index * 7 + offset * 61) % columns.length]
pairs.push([shop, 'UK'], [shop, 'DE'])
}
return fixtureItem(`B${String(index).padStart(4, '0')}`, pairs)
})
}
test('矩阵预聚合与逐格 filter 结果逐字相同', () => {
const rows = [
fixtureItem('A1', [['Shop a', 'UK'], ['Shop a', 'uk'], ['ShopB', ''], ['ShopB', 'DE']]),
fixtureItem('A2', [['ShopC', 'FR']]),
]
const columns = storeColumnsOf(rows)
const cells = buildMatrixCells(rows, columns)
const blanks = blankViews(columns)
columns.forEach((column, index) => {
for (const item of rows) {
assert.deepEqual(fastCell(cells, item, column, blanks[index]), legacyCell(item, column), `${item.asin}/${column}`)
}
})
// 每行只给「本行真涉及」的列建格:A1 涉及 2 店(大小写/空格归一后同店)+ A2 涉及 1 店。
assert.equal(cells.size, 3)
})
test('列集或行集为空时不建任何格', () => {
const rows = [fixtureItem('A1', [['ShopA', 'UK']])]
assert.equal(buildMatrixCells(rows, []).size, 0)
assert.equal(buildMatrixCells([], ['ShopA']).size, 0)
})
/** 列窗口:只给本窗点名的列建格(120 列的夹具切 40 列窗口,格子数就按 40 乘)。 */
test('列窗口切窗后每行最多铺满窗口宽度的格', () => {
const window = 40
const rows = Array.from({ length: 50 }, (_, index) =>
fixtureItem(`A${index}`, Array.from({ length: window * 3 }, (_, shop) => [`Shop${shop}`, 'UK'])))
const all = storeColumnsOf(rows)
assert.equal(all.length, window * 3, '夹具本身就有 120 列(不设上限时的形状)')
const columns = all.slice(0, window)
const cells = buildMatrixCells(rows, columns)
assert.equal(columns.length, window, '本窗只铺 40 列')
assert.equal(cells.size, rows.length * window, '窗口外的 80 列一格都不建')
})
/**
* B60 判据的读数:200 列 × 50 行,同一把尺前后各跑一遍(5 轮取最好一次——本机同时有别的路在跑,
* 单次读数能被调度噪声放大好几倍)。
*
* 度量对象是「矩阵格集合的 JS 计算」,审计点名的就是这条。**浏览器首屏/交互耗时本机拿不到**
* (没有真实店铺数据、也没有浏览器现场),按准出括注登记为现网复量项,不许拿这条当"首屏已实测"读。
*/
test('200列×50行:预聚合与按列切窗都必须快过逐格 filter', () => {
const columns = Array.from({ length: 200 }, (_, index) => `Shop${index}`)
const blanks = blankViews(columns)
const windowColumns = columns.slice(0, 40)
const windowBlanks = blanks.slice(0, 40)
const best = (run: () => unknown): number => {
let ms = Number.POSITIVE_INFINITY
for (let attempt = 0; attempt < 5; attempt++) {
const start = performance.now()
run()
ms = Math.min(ms, performance.now() - start)
}
return ms
}
const readings: string[] = []
for (const shopsPerRow of [3, 40]) {
const rows = matrixFixture(columns, shopsPerRow)
const legacySweep = () => {
const out: CellView[] = []
for (const item of rows) for (const column of columns) out.push(legacyCell(item, column))
return out
}
const precomputedSweep = (cols: string[], cellBlanks: CellView[]) => {
const cells = buildMatrixCells(rows, cols)
const out: CellView[] = []
for (const item of rows) {
cols.forEach((column, index) => out.push(fastCell(cells, item, column, cellBlanks[index])))
}
return out
}
assert.deepEqual(precomputedSweep(columns, blanks), legacySweep(), '前后必须同一份格子(快不是靠少算)')
const beforeMs = best(legacySweep)
const precomputeMs = best(() => precomputedSweep(columns, blanks))
const shippedMs = best(() => precomputedSweep(windowColumns, windowBlanks))
readings.push(`每行${shopsPerRow}店:逐格filter=${beforeMs.toFixed(1)}ms → 预聚合=${precomputeMs.toFixed(1)}ms(${(beforeMs / precomputeMs).toFixed(1)}×) → 预聚合+切窗40列=${shippedMs.toFixed(1)}ms(${(beforeMs / shippedMs).toFixed(1)}×)`)
assert.ok(precomputeMs < beforeMs, `预聚合没省下来(每行${shopsPerRow}店):${beforeMs.toFixed(1)}ms → ${precomputeMs.toFixed(1)}ms`)
assert.ok(shippedMs * 2 < beforeMs, `切窗后仍不够快(每行${shopsPerRow}店):${beforeMs.toFixed(1)}ms → ${shippedMs.toFixed(1)}ms`)
}
console.log(`[B60 读数] 200列×50行 ${readings.join(' | ')}`)
})
@@ -2,8 +2,9 @@ import test from 'node:test'
import assert from 'node:assert/strict'
import { parseDuplicateConsole, parseLedgerPage, parseConsoleGroup, parseLedgerRow } from '../src/pages/tasks/duplicate-console-model.ts'
import {
buildMatrixCells,
indexShopGroups,
dupWithinGroup,
matrixCellOf,
storeColumnsOf,
} from '../src/pages/tasks/duplicate-console-logic.ts'
@@ -49,6 +50,21 @@ test('test_dup_console_model_parses_overview_dup_and_groups', () => {
assert.deepEqual(group, { name: 'GroupA', shopCount: 2, asinUnique: 4, recordCount: 6, dupCount: 2 })
})
/** B60:console 多了行窗口三键;缺字段要退得回安全默认(page 至少 1,pageSize 缺省 0=调用方自持)。 */
test('test_dup_console_model_parses_row_window', () => {
const windowed = parseDuplicateConsole({
success: true,
data: { pending: false, dup: [], groups: [], total_dup: 2650, page: 3, page_size: 50 },
})
assert.equal(windowed.totalDup, 2650, 'total_dup 是该范围未分页总数,不是本页行数')
assert.equal(windowed.page, 3)
assert.equal(windowed.pageSize, 50)
const legacy = parseDuplicateConsole({ success: true, data: { pending: false, dup: [], groups: [] } })
assert.equal(legacy.page, 1, '没有 page 字段时读成第一页,别让分页控件显示第 0 页')
assert.equal(legacy.pageSize, 0)
})
test('test_dup_console_parse_group_ignores_missing_name', () => {
assert.equal(parseConsoleGroup({ shop_count: 1 }), null)
assert.ok(parseConsoleGroup({ name: 'G', shop_count: 2 }))
@@ -71,15 +87,9 @@ test('test_dup_console_group_derivation_restricts_to_members', () => {
])
assert.deepEqual(groups.members.GroupA, ['ShopA', 'ShopB'])
assert.deepEqual(groups.shopGroupNames.ShopC, ['GroupC'])
const inGroupA = dupWithinGroup([dupA, dupE], groups.members.GroupA)
assert.equal(inGroupA.length, 2)
// E 组内只剩 ShopA/ShopB 两条记录。
const e = inGroupA.find((item) => item.asin === 'E')
assert.equal(e?.shopCount, 2)
assert.equal(e?.recordCount, 2)
// 单店成员组内不会命中(ShopD 不在数据里)。
assert.deepEqual(dupWithinGroup([dupA, dupE], ['ShopD']), [])
assert.deepEqual(storeColumnsOf([dupA, dupE], groups.members.GroupA), ['ShopA', 'ShopB'])
// 「组内 ≥2 店才算撞款」的裁行只剩服务端一处正本(console 的 dup_group)——
// 页面原先在客户端用 dupWithinGroup 再裁一遍,那是同一规则的第二个正本,B60 收掉它。
})
test('test_dup_console_store_columns_order_and_restriction', () => {
@@ -0,0 +1,37 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { clampPanelLeftX } from '../src/pages/jd/jd-category-cascader-position.ts'
/** 类目面板水平钳制(2026-11-16 客户截图「超出视窗了」回归判据):面板锚 left:0 最宽
* 4 栏 ×200px,触发框落在筛选行中部偏右时面板伸出视窗右缘。判据形状统一=「右缘装
* 不下必须左移、左移过头贴左缘、装得下不动」三种写法一格定红;把组件改回无条件锚左
* 即红(JdCategoryCascader.vue 的 reposition 必须经本函数算偏移)。 */
test('视口装得下=不偏移(默认锚左)', () => {
// 宽视口:触发框在 x=300,4 栏 800px,右缘 1100 < 1920-8。
assert.equal(clampPanelLeftX({ hostLeft: 300, panelWidth: 800, viewportWidth: 1920 }), 0)
// 恰好贴齐:右缘正好压在 viewport-margin 上=零偏移(≤0 分支)。
assert.equal(clampPanelLeftX({ hostLeft: 300, panelWidth: 800, viewportWidth: 1108 }), 0)
})
test('右缘越界=整体左移到右缘贴齐(客户截图形状:末栏被窗缘裁掉)', () => {
// 截图形状:触发框 x=250、3 栏 600px、窗宽 830 ⇒ 右缘 850 越界 28px ⇒ 左移 28。
assert.equal(clampPanelLeftX({ hostLeft: 250, panelWidth: 600, viewportWidth: 830 }), -28)
// 宽视口下钻到 4 栈仍越界(触发框靠右):1920 窗、触发框 x=1200、800px 面板。
assert.equal(clampPanelLeftX({ hostLeft: 1200, panelWidth: 800, viewportWidth: 1920 }), -88)
})
test('越界过头不得把面板推出左缘=钳在 margin', () => {
// 窄窗:触发框 x=100、面板 800、窗宽 830 ⇒ 直移要 -78,但那样左缘到 22>8 可行;
// 极端:触发框 x=4、面板 800、窗宽 500 ⇒ 直移 -312 ⇒ 左缘 -308 越左,钳到 margin=8。
assert.equal(clampPanelLeftX({ hostLeft: 4, panelWidth: 800, viewportWidth: 500, margin: 8 }), 4)
// 钳制后面板左缘=margin:偏移=margin-hostLeft。
assert.equal(clampPanelLeftX({ hostLeft: 2, panelWidth: 600, viewportWidth: 400, margin: 8 }), 6)
})
test('窄窗越界:直移后左缘仍够留白就正常左移;不够则钳在 margin(物理极限,不假装能塞下)', () => {
// 窗宽 400、margin 8:面板 380 ⇒ 直移 -138 后左缘 12 ≥ 8 可行;
// 面板 390 ⇒ 直移后左缘 2 < 8 ⇒ 钳到左缘 8(偏移 -142),右侧溢出是物理极限。
assert.equal(clampPanelLeftX({ hostLeft: 150, panelWidth: 380, viewportWidth: 400, margin: 8 }), -138)
assert.equal(clampPanelLeftX({ hostLeft: 150, panelWidth: 390, viewportWidth: 400, margin: 8 }), -142)
})
@@ -0,0 +1,97 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import {
JD_CATEGORY_TREE,
jdCategoryChildren,
jdCategoryLeaves,
jdCategoryRoots,
jdCategorySearchLeaves,
} from '../src/pages/jd/jd-category-tree.ts'
/** 京麦授权类目真树(2026-11-16 真机取证 getVenderLicenseCategory 快照;与用户端
* frontend-vue 侧同数据两份正本,改树两边同轮同步)。判据钉的是取证读数:
* 3 个一级 / 250 个末级 / 最深 4 级 / 4 组同名跨支——改树先对取证数据(京麦面板
* 或 getVenderLicenseCategory 重抓),不得手改数字凑测试。 */
test('树形状=京麦授权类目真机读数:3 个一级、250 个末级、最深 4 级', () => {
const roots = jdCategoryRoots()
assert.deepEqual(
roots.map((node) => node.name),
['服饰内衣', '母婴', '运动户外'],
'一级就 3 个(京麦面板 2026-11-16 真机:该店铺授权经营类目,不得加回京东公开全量)',
)
assert.deepEqual(
roots.map((node) => node.value),
['1315', '1319', '1318'],
'一级类目 id 与取证响应逐字同',
)
const leaves = jdCategoryLeaves()
assert.equal(leaves.length, 250, '末级节点 250 个(取证读数)')
const maxDepth = Math.max(...leaves.map((leaf) => leaf.path.length))
assert.equal(maxDepth, 4, '树最深 4 级')
})
test('服饰内衣二级与京麦面板逐字同源;逐级下钻到真机样本叶', () => {
assert.deepEqual(
jdCategoryChildren(['服饰内衣']).map((node) => node.name),
['服饰配件', '内衣', '女装', '男装', '定制服装/工装'],
'服饰内衣二级 5 个(京麦面板逐字)',
)
assert.deepEqual(
jdCategoryChildren(['服饰内衣', '服饰配件']).map((node) => node.name),
['腰带/腰链', '耳罩/耳包', '领带/领结/领带夹', '男士丝巾/围巾', '女士丝巾/围巾/披肩', '鸭舌帽',
'礼帽', '手套', '围巾/手套/帽子套装', '毛线帽', '遮阳帽', '棒球帽', '渔夫帽'],
'服饰配件三级 13 个(京麦面板 2026-11-16 截图逐字前 6 +取证快照全量)',
)
assert.deepEqual(
jdCategoryChildren(['服饰内衣', '服饰配件', '腰带/腰链']),
[],
'三级叶子 children 空(末级,可选中)',
)
assert.deepEqual(
jdCategoryChildren(['不存在的一级']),
[],
'未知路径回落空子级(面板该栏缺省)',
)
})
test('落库末级名真机样本都在树内(category_path 等值过滤成立的前提)', () => {
const names = new Set(jdCategoryLeaves().map((leaf) => leaf.name))
for (const sample of ['艺考形体服', '啦啦队服', '拉丁舞服']) {
assert.ok(names.has(sample), `真机样本「${sample}」必须是树内末级(契约 E3 口径)`)
}
const yikao = jdCategoryLeaves().find((leaf) => leaf.name === '艺考形体服')
assert.ok(yikao, '艺考形体服在树内')
assert.equal(yikao!.path.length, 3, '艺考形体服是 level 3 节点(取证读数)')
})
test('同名跨支叶子如实登记:4 组重名(同名行等值过滤一起命中,B112-05 口径)', () => {
const counts = new Map<string, number>()
for (const leaf of jdCategoryLeaves()) {
counts.set(leaf.name, (counts.get(leaf.name) ?? 0) + 1)
}
const dups = [...counts.entries()].filter(([, count]) => count > 1)
assert.deepEqual(
dups.map(([name]) => name).sort(),
['唐装', '吊带/背心', '短裤', '赠品'].sort(),
'重名集与取证读数逐字同(改树后这里红=重名集变了,须复核登记)。注:「汉服」两处节点中'
+ '一处带四级子级是非叶(点它会下钻),不构成末级重名。',
)
})
test('搜索:按名称或路径段命中末级;空词返回全量', () => {
assert.equal(jdCategorySearchLeaves('').length, 250, '空词=全量末级')
const byName = jdCategorySearchLeaves('艺考')
assert.equal(byName.length, 1)
assert.equal(byName[0]!.name, '艺考形体服')
const byPath = jdCategorySearchLeaves('服饰配件')
assert.ok(byPath.length >= 13, '按路径段命中服饰配件全部末级')
assert.ok(byPath.every((leaf) => leaf.path.includes('服饰配件')))
assert.deepEqual(jdCategorySearchLeaves('不存在词xyz'), [])
})
test('树数据快照不可空、value 全非空(取证 id 留档完整)', () => {
assert.ok(JD_CATEGORY_TREE.length > 0)
for (const leaf of jdCategoryLeaves()) {
assert.ok(leaf.value, `叶子 ${leaf.name} 必须带京麦类目 id`)
}
})
@@ -0,0 +1,119 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { adminPages } from '../src/router/routes.ts'
import {
jdPriceRange,
jdSkuDimensions,
jdSkuSummary,
parseJdProductDetail,
toJdProductItem,
} from '../src/pages/jd/jd-product-model.ts'
/** v1.4「京东数据库」后管页契约(蓝图 docs/ITERATION_PLAN.md §3.4 / §4 Phase 5)。
*
* 只用 import 断言 routes 注册表——readSource 台账(source-pin-ratchet)钉住
* tests/ 里 readFileSync/globSync 读取点逐文件只许减,新读源码文件会撞棘轮;
* V196 迁移 / company-scope / operation-guides 的接线由既有护栏在 Phase 5 收口时
* 自动覆盖(company-menu-route 把 V196 加进迁移清单、align-operation-guide、
* company-tab-wiring),本文件不重复 fs 断言。
* Pending 期整组 skip;Phase 5 落地后去掉 skip 跑绿。
*/
const MENU_KEY = 'admin_jd_database'
const ROUTE = 'jd-center/database'
test('routes 注册表出现京东数据库页面且退出公司 tab(2026-11-16 参考品牌数据库定案)', () => {
const page = adminPages.find((item) => item.menuKey === MENU_KEY)
assert.ok(page, `routes.ts 缺 menuKey=${MENU_KEY} 的注册行`)
assert.equal(page.path, ROUTE, 'route_path 必须与 V196 菜单一侧一致')
assert.equal(page.title, '京东数据库', '菜单标题以「京东数据库」为准')
// 数据全平台公共(2026-11-15「不区分公司」→ 2026-11-16「删除掉公司 tab,参考品牌数据库」):
// meta.companyScoped 必须 false——true 会画出公司 tab,而取数口已不带 company_id(点了没反应)。
assert.equal(page.companyScoped, false, '京东数据库全平台公共,不画公司 tab(AC-6 已被 11-15/11-16 口径推翻)')
})
/** 2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里」:V204 独立子菜单页下线
* (分类建/改名/删收进京东数据库页工具栏「分类管理」对话框),路由注册表不得再登记该 key。 */
test('routes 注册表不再登记京东分类管理独立页(V204 页并入京东数据库页,残留=404 入口)', () => {
assert.ok(!adminPages.some((item) => item.menuKey === 'admin_jd_category_manage'),
'admin_jd_category_manage 注册行必须已删(页面并入京东数据库页)')
assert.ok(!adminPages.some((item) => item.path === 'jd-center/categories'),
'jd-center/categories 路由必须下线')
})
/** 详情面的 SKU 矩阵解析(V198):后端下发 camelCase,snake 容错;坏行不炸整块。 */
test('详情负载的 skus 归一化成矩阵行:skuId 为身份、销售属性维度按首次出现排序', () => {
const detail = parseJdProductDetail({
id: 1,
productCode: '10036442942137',
skus: [
{ skuId: '10238877506570', skuName: '上衣 S', skuSeq: '1', price: 162.0, stock: 200, sortNo: 0,
saleAttrs: [{ name: '颜色', value: '上衣' }, { name: '尺码', value: 'S' }] },
{ skuId: '10238877506580', sku_name: '半裙 S', sku_seq: '3', price: '168.00', stock: 80, sort_no: 2,
sale_attrs: [{ name: '颜色', value: '半裙' }, { name: '尺码', value: 'S' }] },
],
})
assert.equal(detail.skus.length, 2)
assert.equal(detail.skus[0].skuId, '10238877506570')
assert.equal(detail.skus[0].price, '162', 'BigDecimal 序列化成 number 也要能读')
assert.equal(detail.skus[1].price, '168', '字符串价去尾零')
assert.equal(detail.skus[1].sortNo, 2, 'snake 容错')
assert.deepEqual(jdSkuDimensions(detail.skus), ['颜色', '尺码'], '维度名按首次出现顺序')
assert.equal(jdSkuSummary(detail.skus), '2 个 SKU · ¥162 ~ ¥168 · 库存 280')
})
test('缺 skuId 的行弃掉、空 skus 回空数组(旧数据不渲染空表)', () => {
const detail = parseJdProductDetail({
id: 2,
skus: [{ skuName: '没有 skuId' }, { skuId: 'A1', price: 1, stock: 0 }],
})
assert.equal(detail.skus.length, 1)
assert.equal(jdSkuSummary(detail.skus), '1 个 SKU · ¥1 · 库存 0')
assert.equal(parseJdProductDetail({ id: 3 }).skus.length, 0)
assert.equal(jdSkuSummary([]), '')
})
/** 列表行价格(2026-11-16 修「采集到了却全显示 -」):后端 BigDecimal 序列化成 JSON number,
* 解析层必须数值/字符串都收——text() 只认字符串=价格在解析层被丢成空串的生产实录
* (生产库 273/273 行 price_min 全有值、界面价格列全「-」,用户报「价格没采集到」的真因)。 */
test('列表行价格:BigDecimal 的 JSON number 形状与字符串形状都归一成展示文本', () => {
const numeric = toJdProductItem({ id: 9, productCode: '10036368647085', priceMin: 107.64, priceMax: 109.26 })
assert.ok(numeric, '只缺价格之外的字段不弃行')
assert.equal(numeric.priceMin, '107.64', 'number 形状不许丢成空串')
assert.equal(jdPriceRange(numeric), '107.64 ~ 109.26', 'number 形状价格列不许显示 -')
const single = toJdProductItem({ id: 10, priceMin: 64.8, priceMax: 64.8 })
assert.ok(single)
assert.equal(jdPriceRange(single), '64.8', '单值价(min==max)不拼区间')
const stringShape = toJdProductItem({ id: 11, priceMin: '12.90', priceMax: '' })
assert.ok(stringShape)
assert.equal(stringShape.priceMin, '12.9', '字符串形状仍收(去尾零,与详情 SKU 价同口径)')
assert.equal(jdPriceRange(stringShape), '12.9')
const missing = toJdProductItem({ id: 12 })
assert.ok(missing)
assert.equal(jdPriceRange(missing), '', '两侧都空回空串(列表显示 -)')
})
/** 类目筛选(2026-11-15):京麦末级类目等值过滤,空串不下发、非空透传 category。 */
test('类目筛选参数序列化:空串不下发、非空下发 category(等值过滤)', async () => {
const { createJdProductFilterState, toJdProductListParams, jdProductFilterActive } =
await import('../src/pages/jd/jd-product-filter.ts')
const empty = createJdProductFilterState()
assert.equal('category' in toJdProductListParams(empty, 1, 20), false, '全部类目不下发 category')
assert.equal(jdProductFilterActive(empty), false)
const filtered = { ...empty, category: ' 服饰内衣 ' }
assert.equal(toJdProductListParams(filtered, 1, 20).category, '服饰内衣', '去空白透传(等值过滤)')
assert.equal(jdProductFilterActive(filtered), true, '选中类目算激活筛选')
})
test('自定义分类使用 group_id,不发送分类状态参数', async () => {
const { createJdProductFilterState, toJdProductListParams } = await import('../src/pages/jd/jd-product-filter.ts')
const query = toJdProductListParams({ ...createJdProductFilterState(), groupId: '7' }, 1, 20)
assert.equal(query.group_id, 7)
assert.equal('grouped' in query, false)
assert.equal('ungrouped' in query, false)
})
@@ -0,0 +1,208 @@
/**
* 京东数据库页纯逻辑契约(v1.4 Phase 5)—— node --test 直跑(纯函数零依赖)。
*
* 不用 readFileSync/readSource/globSync 读点:source-pin-ratchet 对台账外新文件带读点即红,
* 本文件只 import 被测纯函数。
*
* 覆盖:
* 1. **snake 参数形状**:toJdProductListParams 产出 `page`/`page_size`(默认 20、上限 100)、
* `product_code`/`title_keyword`/`group_id`/`owner_group_id`/`synced_from`/`synced_to`
* (ISO yyyy-MM-dd;空白不下发;groupId 空串→不带、有值→snake group_id;ownerGroupId>0 才带、
* 0/null/NaN 一律不带=后端按作用域默认分组取,V203);分页钳制(铁律 15)。
* 商品状态筛选与导出参数口已随 2026-11-15 客户口径下线,不再出现在参数面;
* 店铺筛选同日客户口径「店铺不需要」下线(shop_name 也不在参数面)。
* 2. **详情解析**:parseJdProductDetail 解析 attrGroups/images(camel 为正 snake 容错、缺 url 弃行),
* attrGroups 解析不出时 attrJsonRaw 原文兜底;列表行解析缺 id 弃行。
*
* 跑法:`node --test tests/jd-product-group.test.ts`
*/
import { test } from 'node:test'
import assert from 'node:assert/strict'
import {
JD_PRODUCT_MAX_PAGE,
createJdProductFilterState,
toJdProductListParams,
} from '../src/pages/jd/jd-product-filter.ts'
import {
jdCategoryChildren,
jdCategoryRoots,
} from '../src/pages/jd/jd-category-tree.ts'
import {
jdPriceRange,
parseJdProductDetail,
parseJdProductPage,
toJdProductItem,
} from '../src/pages/jd/jd-product-model.ts'
test('类目级联静态导航树——服饰内衣二级与京麦面板样本逐字同源,一级集非空且无重名', () => {
// 京麦面板真机样本(2026-11-16 客户截图):服饰内衣下就是这五个二级,改名即红。
assert.deepEqual(jdCategoryChildren(['服饰内衣']).map(node => node.name), ['服饰配件', '内衣', '女装', '男装', '定制服装/工装'])
assert.deepEqual(jdCategoryChildren(['不存在的类目']), [], '未知一级回落空子级(面板不出第二栏)')
const roots = jdCategoryRoots().map(node => node.name)
assert.deepEqual(roots, ['服饰内衣', '母婴', '运动户外'], '一级导航与京麦授权类目一致')
assert.equal(new Set(roots).size, roots.length, '一级类目名不得重复')
for (const root of roots) {
const children = jdCategoryChildren([root]).map(node => node.name)
assert.equal(new Set(children).size, children.length, `${root} 的二级不得重复`)
}
})
test('京东列表参数——snake 形状:groupId 空→不带、有值→group_id,日期空白/非法不下发', () => {
const full = toJdProductListParams(
{
productCode: ' JD-10086 ',
titleKeyword: ' 保温杯 ',
groupId: ' 7 ',
syncedFrom: '2026-11-01',
syncedTo: '2026-11-09',
},
2,
20,
// V203 第 4 参=当前数据权限分组(分类列/分类筛选的作用域,不是筛选条件)。
11,
)
assert.deepEqual(full, {
page: 2,
page_size: 20,
product_code: 'JD-10086',
title_keyword: '保温杯',
group_id: 7,
owner_group_id: 11,
synced_from: '2026-11-01',
synced_to: '2026-11-09',
})
assert.equal('shop_name' in full, false, '店铺筛选已下线,参数面不再出现 shop_name')
// 全空态只有分页两项;脏值(非数字分组、非法日期)同罪不下发。
const blank = toJdProductListParams(createJdProductFilterState(), 1, 20)
assert.deepEqual(blank, { page: 1, page_size: 20 })
assert.equal('group_id' in blank, false, 'groupId 空串不带 group_id')
assert.equal('owner_group_id' in blank, false, '没传当前分组就不带 owner_group_id(后端按作用域默认组取)')
const dirty = toJdProductListParams(
{ productCode: '', titleKeyword: '', groupId: 'abc', syncedFrom: '2026/11/01', syncedTo: 'not-a-date' },
1,
20,
)
assert.deepEqual(dirty, { page: 1, page_size: 20 }, '脏值不下发')
assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status')
// 当前分组非法值(0/NaN/null)一律不下发:0 是「不属于任何组」的哨兵,不能当组 id 发出去。
for (const bad of [0, null, undefined, Number.NaN]) {
assert.equal('owner_group_id' in toJdProductListParams(createJdProductFilterState(), 1, 20, bad), false,
`ownerGroupId=${String(bad)} 不得下发 owner_group_id`)
}
})
test('京东列表参数——page 钳制防 (page-1)*page_size 溢出(铁律 15)', () => {
const low = toJdProductListParams(createJdProductFilterState(), 0, 0)
assert.equal(low.page, 1, 'page<1 归 1')
assert.equal(low.page_size, 20, 'page_size 非法回默认 20')
const big = toJdProductListParams(createJdProductFilterState(), 3, 500)
assert.equal(big.page_size, 100, 'page_size 上限 100')
const extreme = toJdProductListParams(createJdProductFilterState(), Number.MAX_SAFE_INTEGER, 100)
assert.equal(extreme.page, JD_PRODUCT_MAX_PAGE)
const offset = (extreme.page - 1) * extreme.page_size
assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`)
assert.equal(offset, 999_900)
})
test('详情解析——attrGroups/images 结构化解析(snake 容错、缺 url 弃行)', () => {
const detail = parseJdProductDetail({
code: 0,
message: 'ok',
data: {
id: 42,
title: '304不锈钢保温杯',
sale_status: '上架中',
attrGroups: [
{
groupName: '规格',
attrs: [
{ key: 'capacity', label: '容量', value: '500ml' },
{ key: 'material', label: '', value: '304不锈钢' },
],
},
{ group_name: '其他', attrs: [{ key: 'color', label: '颜色', value: '白色' }] },
],
images: [
{ imageType: 'MAIN', attrName: '', sortNo: 1, url: 'https://img.example/main.jpg', width: 800, height: 800 },
{ image_type: 'ATTR', attrName: '白色', sortNo: 2, url: 'https://img.example/white.jpg' },
{ imageType: 'ATTR', attrName: '', sortNo: 3, url: 'https://img.example/attr2.jpg' },
{ imageType: 'DETAIL', sortNo: 4, url: '' }, // 缺 url 弃行
],
},
})
assert.equal(detail.item.id, 42)
assert.equal(detail.item.title, '304不锈钢保温杯')
assert.equal(detail.item.saleStatus, '上架中', 'snake 容错')
assert.equal(detail.attrGroups.length, 2, '两个属性块')
assert.equal(detail.attrGroups[0].groupName, '规格')
assert.equal(detail.attrGroups[0].attrs[0].label, '容量')
assert.equal(detail.attrGroups[1].groupName, '其他', 'group_name snake 容错')
assert.equal(detail.images.length, 3, '缺 url 的 DETAIL 图弃行')
assert.equal(detail.images[1].imageType, 'ATTR', 'image_type snake 容错')
assert.equal(detail.images[1].attrName, '白色')
assert.equal(detail.images[1].sortNo, 2)
assert.equal(detail.images[2].attrName, '', 'attrName 缺省空串')
assert.equal(detail.attrJsonRaw, '', '结构化解析成功时不需要原文兜底')
})
test('详情解析——attrGroups 缺失时 attrJsonRaw 原文兜底;信封外裸负载同口径', () => {
const raw = '{"规格":{"容量":"500ml"}}'
const detail = parseJdProductDetail({ id: 7, attrJsonRaw: raw })
assert.equal(detail.item.id, 7)
assert.deepEqual(detail.attrGroups, [], 'attrGroups 解析不出为空')
assert.equal(detail.attrJsonRaw, raw, '原文兜底字段原样透传(界面展示,不静默吞)')
assert.deepEqual(detail.images, [])
// 非法负载不抛:整包垃圾回空详情(id 0),attrJsonRaw 留空。
const junk = parseJdProductDetail('not-an-object')
assert.equal(junk.item.id, 0)
assert.equal(junk.attrJsonRaw, '')
})
test('列表行解析——camel 为正 snake 容错、缺 id 弃行、价格区间拼装', () => {
const page = parseJdProductPage({
success: true,
data: {
items: [
{
id: 1,
shopId: 3,
shopName: '旗舰自营店',
productCode: 'JD-10086',
priceMin: '12.90',
priceMax: '15.90',
stockTotal: 500,
saleStatus: '上架中',
groupId: 7,
groupName: '甲组',
syncedAt: '2026-11-12 09:00:00',
},
{ id: 'not-a-number', title: '缺 id 弃行' },
{ shop_name: 'snake 行也缺 id,弃' },
],
total: 1,
page: 1,
page_size: 20,
},
})
assert.equal(page.items.length, 1, '三条原始行里两条缺有效 id,只留 1 行')
const row = page.items[0]
assert.equal(row.shopName, '旗舰自营店')
assert.equal(row.groupId, 7)
assert.equal(row.groupName, '甲组')
// 2026-11-16 价格改走 decimalText(数值/字符串都收)后同口径去尾零,与详情 SKU 价一致。
assert.equal(jdPriceRange(row), '12.9 ~ 15.9', 'min/max 都有给区间(去尾零)')
assert.equal(jdPriceRange({ priceMin: '12.90', priceMax: '' }), '12.9', '只空一侧给单值')
assert.equal(jdPriceRange({ priceMin: '', priceMax: '' }), '', '全空为空串(界面展示 -)')
// snake 行同口径 + 缺省回默认。
const snakePage = parseJdProductPage({ data: { items: [{ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' }], total: 1, page: 2, page_size: 5 } })
const snakeRow = toJdProductItem({ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' })
assert.equal(snakeRow?.mainImageUrl, 'https://img/x.jpg')
assert.equal(snakePage.pageSize, 5)
})
@@ -0,0 +1,15 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { fillEditUserForm, toEditUserUpdateRequest, validateEditUserForm } from '../src/pages/account/user-edit-model.ts'
test('京东上架额度回填、校验和按管理员提交', () => {
const form = fillEditUserForm({ id: 3, username: '管理员', role: 'admin', jdPublishQuota: 0 })
assert.equal(form.jdPublishQuota, 0)
assert.equal(toEditUserUpdateRequest(form).jdPublishQuota, 0)
form.jdPublishQuota = -1
assert.equal(validateEditUserForm(form).valid, false)
form.jdPublishQuota = 1.5
assert.equal(validateEditUserForm(form).valid, false)
form.role = 'normal'
assert.equal(toEditUserUpdateRequest(form).jdPublishQuota, undefined)
})
@@ -0,0 +1,337 @@
/**
* 外观专利数据库页(v1.3 AC-5,2026-11-11 晚间恢复明细表)的挂载契约。
*
* 形态(客户当日口径「不是这种格式 你就按照昨天那个格式」):撤掉一主管一卡视图,
* 恢复只读明细表(自绘 table + OldPagination,参照「去重数据库」页);表头第二列=「管理员」
* (后端读侧现算 supervisorName,读不到展示 -);「添加个管理员 跟导出数据就可以」——
* 筛选行有「导出」(当前过滤面+公司 tab 全量出 xlsx,与去重页同款);「任务号/ASIN 两个
* 筛选框恢复」(客户要「一目了然」选数据);分组(主管)下拉保留选中即查。
* 卡片级下载/删除入口随卡片视图一并下架(删除入口先撤,防误删;后端 /supervisors 接口保留)。
* 数据按 ASIN 累计(同 ASIN 只保留一条,V192 唯一键),页面零写操作。
*
* 跑法:`npx vitest run tests/mount/appearance-patent-clean-page.test.ts`
*/
import { readFileSync } from 'node:fs'
import { resolve } from 'node:path'
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import AppearancePatentCleanItemsPage from '@/pages/patent/AppearancePatentCleanItemsPage.vue'
import { adminPages } from '@/router/routes'
import { COMPANY_SCOPED_PAGES } from '@/config/company-scope'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const PAGE_PATH = 'src/pages/patent/AppearancePatentCleanItemsPage.vue'
const MENU_KEY = 'admin_appearance_patent_clean_items'
const cleanApi = vi.hoisted(() => ({
fetchAppearancePatentCleanList: vi.fn(),
exportAppearancePatentCleanList: vi.fn(),
fetchDedupeTotalGroups: vi.fn(),
}))
vi.mock('@/pages/patent/appearance-patent-clean-api.ts', () => cleanApi)
function item(id: number, over: Record<string, unknown> = {}) {
return {
id,
resultId: 36800 + id,
taskId: 33874,
userId: 9,
supervisorName: '主管9',
companyId: 1,
rowNo: id,
asin: `B0CLEAN00${id}`,
country: 'DE',
sku: `SKU-00${id}`,
brand: 'Nike',
price: '12.99',
title: 'Women Floral Dress Summer Casual',
imageUrl: '',
itemUrl: '',
conclusion: '无侵权',
titleReason: '',
appearanceReason: '',
patentReason: '',
sourceFilename: 'appearance_patent_33874.xlsx',
syncedAt: '2026-11-11T11:34:29',
...over,
}
}
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
useCompanyTabStore().setActiveId(1)
cleanApi.fetchDedupeTotalGroups.mockResolvedValue([])
})
async function mountWith(payload: unknown): Promise<VueWrapper<Element>> {
cleanApi.fetchAppearancePatentCleanList.mockImplementation(() => Promise.resolve(payload))
const wrapper = mount(AppearancePatentCleanItemsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
return wrapper
}
describe('外观专利数据库页(明细表,2026-11-11 恢复「昨天那个格式」)', () => {
it('页面组件落位:明细表 + 明细端点 + 导出,卡片视图与删除入口已下架', () => {
const src = readFileSync(resolve(process.cwd(), PAGE_PATH), 'utf-8')
expect(src).toContain('OldPagination')
expect(src).toContain('<table', '恢复自绘明细表(客户「按照昨天那个格式」)')
expect(src).toContain('管理员', '表头必须有「管理员」列(客户「添加个管理员」)')
expect(src).toContain('fetchAppearancePatentCleanList', '必须走明细分页端点')
expect(src).toContain('exportAll', '筛选行要有「导出」(客户「跟数据去重一样 能导出来就可以」)')
expect(src).toContain('cleanItemReasonTooltip', '结论列带三因原因提示')
expect(src).toContain('filter.taskId', '任务号筛选框恢复')
expect(src).toContain('filter.asin', 'ASIN 筛选框恢复')
// 卡片视图与删除入口下架:这些符号只该在后端/历史里,不该再出现在本页
expect(src).not.toContain('clean-card-grid', '一主管一卡视图已撤')
expect(src).not.toContain('fetchAppearancePatentCleanSupervisors', '主管聚合取数口已撤')
expect(src).not.toContain('deleteAppearancePatentCleanSupervisor', '按主管删除的页面入口已撤')
expect(src).not.toContain('openAdminConfirm', '本页零写操作,不该再有任何确认弹窗')
expect(src).not.toContain('el-card')
})
it('路由与公司 Tab 注册齐备(companyScoped: true)', () => {
const page = adminPages.find((p) => p.path === 'patent-center/clean-items')
expect(page).toBeTruthy()
expect(page?.menuKey).toBe(MENU_KEY)
expect(page?.title).toBe('外观专利数据库')
expect(page?.companyScoped).toBe(true)
const scoped = COMPANY_SCOPED_PAGES.find((p) => p.menuKey === MENU_KEY)
expect(scoped).toBeTruthy()
expect(scoped?.pageFiles).toContain(PAGE_PATH)
})
it('挂载后按首屏分页参数取明细列表,行数=本页明细条数', async () => {
const wrapper = await mountWith({
items: [item(1), item(2), item(3)],
total: 42,
page: 1,
pageSize: 10,
})
expect(cleanApi.fetchAppearancePatentCleanList).toHaveBeenCalledTimes(1)
const firstCall = cleanApi.fetchAppearancePatentCleanList.mock.calls[0][0]
expect(firstCall.page).toBe(1)
expect(firstCall.pageSize).toBe(10)
expect(firstCall.companyId).toBe(1)
expect(wrapper.findAll('tbody tr')).toHaveLength(3)
expect(wrapper.find('.clean-summary').text()).toContain('共 42 条', '汇总按明细条数(不是主管数)')
})
it('行内容=任务号/管理员/ASIN/国家/SKU/品牌/价格/标题/结论/同步时间', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 10 })
const cells = wrapper.findAll('tbody tr')[0].findAll('td')
expect(cells).toHaveLength(10)
expect(cells[0].text()).toBe('33874', '任务号')
expect(cells[1].text()).toBe('主管9', '管理员(supervisorName 读侧现算列)')
expect(cells[2].text()).toBe('B0CLEAN001')
expect(cells[3].text()).toBe('德国', '国家码翻中文')
expect(cells[4].text()).toBe('SKU-001')
expect(cells[5].text()).toBe('Nike')
expect(cells[6].text()).toBe('12.99')
expect(cells[7].text()).toContain('Women Floral Dress')
expect(cells[8].text()).toBe('无侵权')
expect(cells[9].text()).not.toBe('-', '同步时间格式化展示')
const headers = wrapper.findAll('thead th').map((th) => th.text())
expect(headers).toContain('管理员')
expect(headers).not.toContain('所属主管', '列名按客户口径叫「管理员」')
})
/** 客户 2026-11-12 反馈「外观专利数据库的日期显示不全」:全局 `* { box-sizing: border-box }` 把左右 24px
* 内边距算进列宽,旧的 150px 只剩 126px 内容宽,而 `YYYY-MM-DD HH:mm:ss` 十九字符在 13.5px 下实测约
* 133px ⇒ 末尾被 ellipsis 吃掉(表格单元格是 nowrap + text-overflow: ellipsis)。判据钉列宽下限:
* ≥160px 才有 ≥136px 内容宽放得下完整时间;回退到 150px 即红。 */
it('同步时间列宽够放十九字符时间(列宽下限 160px,防 ellipsis 再截断)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 10 })
const headers = wrapper.findAll('thead th')
const dateHeader = headers[headers.length - 1]
expect(dateHeader.text()).toBe('同步时间')
const declared = Number.parseFloat(dateHeader.element.style.width)
expect(Number.isFinite(declared), '同步时间列必须显式声明宽度(table-layout: fixed 下靠它定列宽)').toBe(true)
expect(declared).toBeGreaterThanOrEqual(160, '150px − 24px 内边距 = 126px < 133px,时间会被截断')
})
it('读不到主管的那一行管理员列展示 -(不猜名字)', async () => {
const wrapper = await mountWith({ items: [item(1, { supervisorName: '' })], total: 1, page: 1, pageSize: 10 })
expect(wrapper.findAll('tbody tr')[0].findAll('td')[1].text()).toBe('-')
})
it('导出=当前过滤面全量(含任务号/ASIN 与公司 tab),不传按主管参数', async () => {
const createObjectURL = vi.fn(() => 'blob:mock-url')
const revokeObjectURL = vi.fn()
const urlRecord = URL as unknown as Record<string, unknown>
Object.defineProperty(URL, 'createObjectURL', { value: createObjectURL, configurable: true, writable: true })
Object.defineProperty(URL, 'revokeObjectURL', { value: revokeObjectURL, configurable: true, writable: true })
const clickSpy = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => {})
cleanApi.exportAppearancePatentCleanList.mockImplementation(() =>
Promise.resolve({ blob: new Blob(['xlsx']), filename: '外观专利数据库-20261111235900.xlsx' }),
)
try {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 10 })
const btn = wrapper.findAll('button').find((b) => b.text() === '导出')
expect(btn, '筛选行必须有「导出」按钮').toBeTruthy()
await btn!.trigger('click')
await flushPromises()
await flushPromises()
expect(cleanApi.exportAppearancePatentCleanList).toHaveBeenCalledTimes(1)
const call = cleanApi.exportAppearancePatentCleanList.mock.calls[0][0]
expect(call).toMatchObject({ taskId: '', asin: '', country: '', groupId: '', companyId: 1 })
expect(call.supervisorUserId).toBeUndefined()
expect(createObjectURL).toHaveBeenCalledTimes(1)
expect(clickSpy).toHaveBeenCalled()
expect(document.body.textContent).toContain('已导出', '成功反馈点名落盘文件')
} finally {
Object.defineProperty(URL, 'createObjectURL', { value: undefined, configurable: true, writable: true })
Object.defineProperty(URL, 'revokeObjectURL', { value: undefined, configurable: true, writable: true })
clickSpy.mockRestore()
}
})
it('导出失败把服务端业务文案弹出来,不许静默;在途标记复位', async () => {
cleanApi.exportAppearancePatentCleanList.mockImplementation(() =>
Promise.reject(new Error('无侵权数据共 90001 行,超过导出上限 50000 行,请缩小筛选范围后重试')))
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 10 })
await wrapper.findAll('button').find((b) => b.text() === '导出')!.trigger('click')
await flushPromises()
await flushPromises()
expect(document.body.textContent).toContain('超过导出上限')
const btn = wrapper.findAll('button').find((b) => b.text() === '导出')
expect(btn!.text()).toBe('导出', '失败后在途标记必须复位')
expect((btn!.element as HTMLButtonElement).disabled).toBe(false)
})
it('任务号/ASIN/国家/分组/起止时间筛选生效', async () => {
cleanApi.fetchDedupeTotalGroups.mockResolvedValue([{ id: 7, name: '甲组', leaderUserId: 9 }])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 10 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
expect(textInputs).toHaveLength(2, '任务号+ASIN 两个筛选框恢复(客户要一目了然)')
await textInputs[0].setValue('33874')
await textInputs[1].setValue('B0CLEAN')
const selects = wrapper.findAll('select')
await selects[0].setValue('DE') // 国家排在前(模板顺序:任务号/ASIN/国家/分组)
await selects[1].setValue('7') // 分组(主管=组长)
const dateInputs = wrapper.findAll('input[type="date"]')
await dateInputs[0].setValue('2026-11-01')
await dateInputs[1].setValue('2026-11-09')
await wrapper.findAll('button').find((b) => b.text() === '查询')!.trigger('click')
await flushPromises()
const last = cleanApi.fetchAppearancePatentCleanList.mock.calls.at(-1)![0]
expect(last).toMatchObject({
taskId: '33874',
asin: 'B0CLEAN',
country: 'DE',
groupId: '7',
startDate: '2026-11-01',
endDate: '2026-11-09',
page: 1,
})
})
it('分组下拉(主管=组长)选中即查', async () => {
cleanApi.fetchDedupeTotalGroups.mockResolvedValue([
{ id: 7, name: '甲组', leaderUserId: 9 },
{ id: 8, name: '乙组', leaderUserId: 10 },
])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 10 })
expect(cleanApi.fetchDedupeTotalGroups).toHaveBeenCalledWith(1)
const groupSelect = wrapper.findAll('select')[1] // 模板顺序:国家在前、分组在后
const optionTexts = groupSelect.findAll('option').map((o) => o.text())
expect(optionTexts).toContain('全部分组')
expect(optionTexts).toContain('甲组')
const callsBeforeSelect = cleanApi.fetchAppearancePatentCleanList.mock.calls.length
await groupSelect.setValue('7')
await flushPromises()
expect(cleanApi.fetchAppearancePatentCleanList.mock.calls.length).toBe(callsBeforeSelect + 1,
'选中分组必须立刻重查')
expect(cleanApi.fetchAppearancePatentCleanList.mock.calls.at(-1)![0]).toMatchObject({
groupId: '7',
page: 1,
})
})
it('重置把筛选面回空并回第一页重取', async () => {
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 10 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
await textInputs[0].setValue('33874')
await textInputs[1].setValue('B0CLEAN')
const callsBefore = cleanApi.fetchAppearancePatentCleanList.mock.calls.length
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(cleanApi.fetchAppearancePatentCleanList.mock.calls.length).toBeGreaterThan(callsBefore)
const last = cleanApi.fetchAppearancePatentCleanList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ taskId: '', asin: '', page: 1 }, '重置后筛选全空、回第一页')
})
it('翻页与改每页条数都重发请求,改条数回第一页', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 42, page: 2, pageSize: 10 })
await wrapper.findAll('button').find((b) => b.text() === '下一页')!.trigger('click')
await flushPromises()
expect(cleanApi.fetchAppearancePatentCleanList).toHaveBeenCalledTimes(2)
expect(cleanApi.fetchAppearancePatentCleanList.mock.calls[1][0].page).toBe(3)
const sizeSelect = wrapper.find('.page-size-select')
await sizeSelect.setValue('50')
await flushPromises()
const last = cleanApi.fetchAppearancePatentCleanList.mock.calls.at(-1)![0]
expect(last.pageSize).toBe(50)
expect(last.page).toBe(1, '改每页条数后回第一页')
})
it('空态与加载失败条(失败给重试,不把整页打死)', async () => {
const empty = await mountWith({ items: [], total: 0, page: 1, pageSize: 10 })
const tip = empty.find('.empty-tip')
expect(tip.exists()).toBe(true)
expect(tip.text()).toContain('暂无无侵权数据')
empty.unmount()
cleanApi.fetchAppearancePatentCleanList.mockRejectedValue(new Error('上游 502'))
const failed = mount(AppearancePatentCleanItemsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
expect(failed.find('.load-failure-bar').exists()).toBe(true)
expect(failed.find('.load-failure-bar').text()).toContain('无侵权数据加载失败')
})
it('切公司 Tab 重取并清掉上一家的筛选(company-tab-wiring 同口径)', async () => {
cleanApi.fetchDedupeTotalGroups.mockResolvedValue([{ id: 7, name: '甲组', leaderUserId: 9 }])
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 10 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
await textInputs[0].setValue('33874')
await textInputs[1].setValue('B0CLEAN')
const groupSelect = wrapper.findAll('select')[1]
await groupSelect.setValue('7')
const callsBefore = cleanApi.fetchAppearancePatentCleanList.mock.calls.length
useCompanyTabStore().setActiveId(2)
await flushPromises()
await flushPromises()
expect(cleanApi.fetchAppearancePatentCleanList.mock.calls.length).toBeGreaterThan(callsBefore)
const last = cleanApi.fetchAppearancePatentCleanList.mock.calls.at(-1)![0]
expect(last.companyId).toBe(2)
expect(last.taskId).toBe('', '切公司必须清掉上一家的任务号')
expect(last.asin).toBe('', '切公司必须清掉上一家的 ASIN')
expect(last.groupId).toBe('', '切公司必须清掉上一家选的分组')
expect(last.page).toBe(1)
expect(cleanApi.fetchDedupeTotalGroups).toHaveBeenLastCalledWith(2)
})
})
@@ -0,0 +1,115 @@
/**
* 公司 tab 条 × 平台 tab(2026-11-17 用户口径「亚马逊侧别再挂京东-团队,京东侧同理」)的挂载契约:
* 目录请求必须带 platform=当前平台;切平台 tab 重拉一份;跨平台旧选中不在新清单里 ⇒ 回落「id 最小启用公司」;
* 同平台 force 重拉(公司编辑保存后的 refresh)不跳选中。京东侧只有一家公司时 tab 条整体不画
* (visibleForOperator 的 length > 1 既有语义),但 activeId 仍落在那一家 ⇒ 各页取数照样按它收窄。
* 不用 readFileSync(source-pin-ratchet 对台账外新文件带读点即红),全部走真实挂载断言。
*
* 跑法:`npx vitest run tests/mount/company-tabs-platform.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import CompanyTabs from '@/layout/CompanyTabs.vue'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const companiesApi = vi.hoisted(() => ({
fetchCompanies: vi.fn(),
}))
vi.mock('@/api/companies', () => companiesApi)
vi.mock('vue-router', () => ({
useRoute: () => ({ meta: { menuKey: 'admin_group_manage' } }),
}))
const AMAZON_COMPANIES = [
{ id: 1, companyName: '厦门米椿花', status: 1, platform: 'amazon' },
{ id: 2, companyName: '德阳-团队', status: 1, platform: 'amazon' },
{ id: 3, companyName: '先锋-团队', status: 1, platform: 'amazon' },
]
const JD_COMPANIES = [{ id: 4, companyName: '京东-团队', status: 1, platform: 'jd' }]
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
window.localStorage.removeItem('admin-platform-tab')
pinia = createPinia()
setActivePinia(pinia)
const session = useAdminSessionStore()
session.user = { id: 1, username: 'root', role: 'super_admin' }
companiesApi.fetchCompanies.mockImplementation(async (platform?: string) =>
platform === 'jd' ? JD_COMPANIES : AMAZON_COMPANIES)
})
function tabTexts(wrapper: ReturnType<typeof mount>) {
return wrapper.findAll('.company-tab').map((b) => b.text())
}
describe('CompanyTabs × 平台 tab', () => {
it('亚马逊 tab(默认):目录请求带 platform=amazon,只画亚马逊公司的 tab', async () => {
const wrapper = mount(CompanyTabs)
await flushPromises()
expect(companiesApi.fetchCompanies).toHaveBeenCalledWith('amazon')
expect(tabTexts(wrapper)).toEqual(['厦门米椿花', '德阳-团队', '先锋-团队'])
expect(useCompanyTabStore().activeId).toBe(1)
wrapper.unmount()
})
it('切到京东 tab:重拉 platform=jd;京东侧仅一家 ⇒ tab 条不画,但 activeId 落在京东-团队(各页取数按它收窄)', async () => {
const wrapper = mount(CompanyTabs)
await flushPromises()
usePlatformTabStore().setActive('jd')
await flushPromises()
expect(companiesApi.fetchCompanies).toHaveBeenLastCalledWith('jd')
expect(wrapper.find('.company-tabs').exists()).toBe(false)
const tabStore = useCompanyTabStore()
expect(tabStore.companies.map((c) => c.companyName)).toEqual(['京东-团队'])
expect(tabStore.activeId).toBe(4)
expect(tabStore.requestCompanyId).toBe(4)
wrapper.unmount()
})
it('切回亚马逊:再拉 platform=amazon,旧选中(京东-团队)不在清单 ⇒ 回落 id 最小的启用公司', async () => {
const wrapper = mount(CompanyTabs)
await flushPromises()
usePlatformTabStore().setActive('jd')
await flushPromises()
usePlatformTabStore().setActive('amazon')
await flushPromises()
expect(tabTexts(wrapper)).toEqual(['厦门米椿花', '德阳-团队', '先锋-团队'])
expect(useCompanyTabStore().activeId).toBe(1)
wrapper.unmount()
})
it('同平台 force 重拉(公司保存后的 refresh):选中公司仍在 ⇒ 选中不跳;请求带当前平台', async () => {
const wrapper = mount(CompanyTabs)
await flushPromises()
const tabStore = useCompanyTabStore()
tabStore.setActiveId(2)
await tabStore.refresh()
await flushPromises()
expect(companiesApi.fetchCompanies).toHaveBeenLastCalledWith('amazon')
expect(tabStore.activeId).toBe(2)
expect(tabStore.companies).toHaveLength(3)
wrapper.unmount()
})
it('非超管不发目录请求:切平台 tab 也不发', async () => {
const session = useAdminSessionStore()
session.user = { id: 5, username: '公司管理员', role: 'admin' }
const wrapper = mount(CompanyTabs)
await flushPromises()
usePlatformTabStore().setActive('jd')
await flushPromises()
expect(companiesApi.fetchCompanies).not.toHaveBeenCalled()
wrapper.unmount()
})
})
@@ -0,0 +1,214 @@
/**
* 京东分类管理对话框(JdCategoryManageDialog)的挂载契约。
*
* 2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里,做一个搜索和添加 删除
* 编辑 分类名称即可」:V204 独立子菜单页(JdCategoryManagerPage,已删)整体并入本对话框,
* 从京东数据库页工具栏「分类管理」打开。原页面契约逐条承接:当前数据权限分组的
* 分类建/改名/删除;新增名称搜索(本地过滤)。商品归类不在这里(去「批量编辑分类」)。
* 权限口径(V203)不变:editable 才渲染写控件;同组普通号只读可看。
*
* 跑法:`npx vitest run tests/mount/jd-category-manage-dialog.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import JdCategoryManageDialog from '@/pages/jd/JdCategoryManageDialog.vue'
const jdApi = vi.hoisted(() => ({
fetchJdProductGroups: vi.fn(),
createJdProductGroup: vi.fn(),
updateJdProductGroup: vi.fn(),
deleteJdProductGroup: vi.fn(),
}))
const confirmMock = vi.hoisted(() => vi.fn())
vi.mock('@/pages/jd/jd-product-api.ts', () => jdApi)
vi.mock('@/components/admin-confirm', () => ({ openAdminConfirm: confirmMock }))
/** 分组 id 常量:默认作用域就这一个可见且可写的组(组长档形状)。 */
const GROUP_A = 11
function group(id: number, name: string, productCount = 0, sortOrder = 0) {
return { id, name, ownerGroupId: GROUP_A, sortOrder, productCount }
}
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
jdApi.fetchJdProductGroups.mockResolvedValue([])
confirmMock.mockResolvedValue(true)
})
async function mountDialog(editable = true): Promise<VueWrapper<Element>> {
const wrapper = mount(JdCategoryManageDialog, {
global: { plugins: [pinia] },
props: {
visible: true,
ownerGroupId: GROUP_A,
ownerGroupName: '甲组',
editable,
},
})
await flushPromises()
await flushPromises()
return wrapper
}
describe('京东分类管理对话框(V204 独立页 2026-11-17 并入京东数据库页)', () => {
it('打开即按当前分组取分类(ownerGroupId 必带);标题带当前分组名', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
expect(jdApi.fetchJdProductGroups).toHaveBeenCalledWith(GROUP_A)
expect(wrapper.get('.manage-modal').text()).toContain('分类管理')
expect(wrapper.get('.manage-modal').text()).toContain('甲组', '标题/上下文带当前分组名')
expect(wrapper.findAll('.option-row')).toHaveLength(1)
wrapper.unmount()
})
it('新建分类:落当前分组归属(ownerGroupId 必带),成功后清输入重取并通知父页刷新', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
await wrapper.get('.group-create input').setValue('上新区')
await wrapper.findAll('button').find((b) => b.text() === '新建')!.trigger('click')
await flushPromises()
expect(jdApi.createJdProductGroup).toHaveBeenCalledWith({ name: '上新区', sortOrder: 0, ownerGroupId: GROUP_A })
expect((wrapper.get('.group-create input').element as HTMLInputElement).value).toBe('')
expect(jdApi.fetchJdProductGroups).toHaveBeenCalledTimes(2, '成功后重取分类列表')
expect(wrapper.emitted('changed'), '写成功必须 emit changed 让父页刷筛选下拉').toBeTruthy()
wrapper.unmount()
})
it('搜索:按名称包含本地过滤(不发额外请求),命中后新建会清关键字', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3), group(8, '裤装', 1), group(9, '配饰', 0)])
const wrapper = await mountDialog()
const callsBefore = jdApi.fetchJdProductGroups.mock.calls.length
await wrapper.get('.search-input').setValue('裙')
await flushPromises()
expect(wrapper.findAll('.option-row')).toHaveLength(1, '「裙」只命中裙装')
expect(wrapper.findAll('.option-row')[0].text()).toContain('裙装')
expect(jdApi.fetchJdProductGroups.mock.calls.length).toBe(callsBefore, '搜索是本地过滤,不另发请求')
expect(wrapper.text()).not.toContain('裤装', '不匹配项不出现')
await wrapper.get('.group-create input').setValue('上新区')
await wrapper.findAll('button').find((b) => b.text() === '新建')!.trigger('click')
await flushPromises()
expect((wrapper.get('.search-input').element as HTMLInputElement).value).toBe('',
'新建成功清关键字(新分类不被旧搜索藏住)')
wrapper.unmount()
})
it('搜索无命中给显式空态文案(不是空列表静默)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
await wrapper.get('.search-input').setValue('不存在的分类')
expect(wrapper.get('.manage-empty').text()).toBe('没有匹配的分类')
wrapper.unmount()
})
it('改名:行内编辑后按 (id, {name, sortOrder}) 提交并 emit changed', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
await wrapper.findAll('button').find((b) => b.text() === '改名')!.trigger('click')
await wrapper.get('.rename-input').setValue('长裙')
await wrapper.findAll('button').find((b) => b.text() === '保存')!.trigger('click')
await flushPromises()
expect(jdApi.updateJdProductGroup).toHaveBeenCalledWith(7, { name: '长裙', sortOrder: 0 })
expect(wrapper.emitted('changed')).toBeTruthy()
wrapper.unmount()
})
it('删除:二次确认文案点名商品数(删除不删商品,只解挂归属),确认后调端点重取', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
await wrapper.findAll('button').find((b) => b.text() === '删除')!.trigger('click')
await flushPromises()
expect(confirmMock).toHaveBeenCalledTimes(1)
const options = confirmMock.mock.calls[0][0]
expect(options.title).toBe('删除分类')
expect(options.message).toContain('确定删除分类「裙装」吗')
expect(options.message).toContain('3 个商品回到未分类', '文案点名该分类下的商品数')
expect(options.danger).toBe(true)
expect(jdApi.deleteJdProductGroup).toHaveBeenCalledWith(7)
expect(jdApi.fetchJdProductGroups).toHaveBeenCalledTimes(2, '删除成功后重取列表')
expect(wrapper.emitted('changed')).toBeTruthy()
wrapper.unmount()
})
it('删除确认点取消就不发请求(防误删第一道闸)', async () => {
confirmMock.mockResolvedValue(false)
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
await wrapper.findAll('button').find((b) => b.text() === '删除')!.trigger('click')
await flushPromises()
expect(confirmMock).toHaveBeenCalledTimes(1)
expect(jdApi.deleteJdProductGroup).not.toHaveBeenCalled()
wrapper.unmount()
})
it('只读档(editable=false):无新建行、无搜索仍可用、无改名/删除按钮', async () => {
const wrapper = await mountDialog(false)
expect(wrapper.find('.group-create').exists()).toBe(false, '只读账号不渲染新建行')
expect(wrapper.findAll('button').some((b) => b.text() === '改名')).toBe(false)
expect(wrapper.findAll('button').some((b) => b.text() === '删除')).toBe(false)
expect(wrapper.get('.search-input').exists()).toBe(true, '搜索是读面,只读档保留')
wrapper.unmount()
})
it('不属于任何数据权限分组(ownerGroupId<=0):不发取数请求,空态直说', async () => {
const wrapper = mount(JdCategoryManageDialog, {
global: { plugins: [pinia] },
props: { visible: true, ownerGroupId: 0, ownerGroupName: '', editable: false },
})
await flushPromises()
await flushPromises()
expect(jdApi.fetchJdProductGroups).not.toHaveBeenCalled()
expect(wrapper.get('.manage-empty').text()).toBe('你还不属于任何数据权限分组')
expect(wrapper.find('.group-create').exists()).toBe(false)
wrapper.unmount()
})
it('本组暂无分类:可写档文案引导新建,只读档直说', async () => {
const writable = await mountDialog(true)
expect(writable.get('.manage-empty').text()).toBe('本组暂无分类,先新建一个')
writable.unmount()
const readonly = await mountDialog(false)
expect(readonly.get('.manage-empty').text()).toBe('本组暂无分类')
readonly.unmount()
})
it('加载失败:红条可见且重试真能重跑(取数页硬规矩)', async () => {
jdApi.fetchJdProductGroups.mockRejectedValueOnce(new Error('上游 502'))
const wrapper = mount(JdCategoryManageDialog, {
global: { plugins: [pinia] },
props: { visible: true, ownerGroupId: GROUP_A, ownerGroupName: '甲组', editable: true },
})
await flushPromises()
await flushPromises()
const bar = wrapper.find('.load-failure-bar')
expect(bar.exists()).toBe(true, '失败态必须可见(不是一闪而过的 toast)')
expect(bar.text()).toContain('分类列表加载失败')
expect(bar.text()).toContain('上游 502', '后端/网络原因要进文案')
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
await bar.find('button').trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.load-failure-bar').exists()).toBe(false, '重试成功后红条消失')
expect(wrapper.text()).toContain('裙装')
wrapper.unmount()
})
it('页面职责边界(反向钉):归类不在本对话框——不出现批量归类/删除勾选入口', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([group(7, '裙装', 3)])
const wrapper = await mountDialog()
expect(wrapper.findAll('button').some((b) => b.text() === '批量编辑分类')).toBe(false, '归类入口在京东数据库页')
expect(wrapper.text()).toContain('批量编辑分类', '但提示要指路(关掉本框去勾选商品归类)')
expect(jdApi.deleteJdProductGroup).not.toHaveBeenCalled()
wrapper.unmount()
})
})
@@ -0,0 +1,902 @@
/**
* 京东数据库页(v1.4 Phase 5)的挂载契约。
*
* 形态:panel-box + 筛选行(商品编码/标题关键字/类目/分组/同步起止 date 对)+
* 查询/重置 + 自绘明细表(点行开详情抽屉)+ OldPagination;
* 分组下拉 2026-11-16 用户口径「做成分组」上移进筛选行=带标签的表单控件(不再是工具栏裸下拉);
* 店铺分类弹窗 2026-11-17 用户口径下线:工具栏改「批量编辑分类」(勾选跨页累计+归入/移出);
* 同日第二刀「京东分类管理并到京东数据库分类编辑里」:V204 独立子菜单页下线
* (jd-category-manager-page.mount.test.ts 随之删除),建/改名/删分类+搜索收进工具栏
* 「分类管理」对话框(另见 jd-category-manage-dialog.mount.test.ts);
* 「清除勾选」按钮同日用户口径删除(勾选只在批量操作成功后自动清)。
* 公司维度 2026-11-16 整页摘除(「删除掉公司 tab,参考品牌数据库」):页面不消费公司 tab
* store、列表/类目下拉不带 company_id(反向钉在 company-tab-wiring「公司维度不得回流」)。
* 商品状态筛选/列与导出按钮已随 2026-11-15 客户口径从前端下线(后端端点保留);
* 店铺筛选与店铺列同日客户口径「店铺不需要」下线(后端 shop_name 参数同窗撤,店铺仍收详情抽屉)。
* 不用 readFileSync(source-pin-ratchet 对台账外新文件带读点即红),全部走真实挂载断言。
*
* 跑法:`npx vitest run tests/mount/jd-database-page.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import JdDatabasePage from '@/pages/jd/JdDatabasePage.vue'
import OldPagination from '@/components/OldPagination.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
const jdApi = vi.hoisted(() => ({
JD_PRODUCT_ENDPOINT: '/api/admin/jd-products',
JD_PRODUCT_GROUP_ENDPOINT: '/api/admin/jd-product-groups',
fetchJdProductList: vi.fn(),
fetchJdProductDetail: vi.fn(),
deleteJdProducts: vi.fn(),
fetchJdProductGroups: vi.fn(),
fetchJdCategoryScope: vi.fn(),
fetchJdProductCategories: vi.fn(),
createJdProductGroup: vi.fn(),
updateJdProductGroup: vi.fn(),
deleteJdProductGroup: vi.fn(),
updateJdProduct: vi.fn(),
batchAssignJdProductGroup: vi.fn(),
}))
const confirmMock = vi.hoisted(() => vi.fn())
vi.mock('@/pages/jd/jd-product-api.ts', () => jdApi)
vi.mock('@/components/admin-confirm', () => ({ openAdminConfirm: confirmMock }))
function item(id: number, over: Record<string, unknown> = {}) {
return {
id,
shopId: 3,
shopName: '旗舰自营店',
productCode: `JD-100${id}`,
skuId: `SKU-${id}`,
itemNum: `ITEM-${id}`,
skuCount: 12,
healthScore: 81,
title: '304不锈钢保温杯大容量便携',
brand: '锅宝',
categoryPath: '家居 > 厨具 > 保温杯',
// 价格用 number 形状(2026-11-16 实录:后端 BigDecimal 序列化成 JSON number,
// 字符串夹具曾把「解析层丢数字形状」这个真红藏住=生产库有价、界面全「-」)。
priceMin: 12.9,
priceMax: 15.9,
stockTotal: 500,
saleStatus: '上架中',
listTab: 'search',
jdCreatedAt: '2026-11-07 18:49:47',
jdOnlineAt: '2026-11-12 15:03:37',
jdUpdatedAt: '2026-11-13 14:06:07',
mainImageUrl: `https://img.example/main-${id}.jpg`,
attrCount: 6,
imageCount: 9,
groupId: 7,
groupName: '甲组',
syncedAt: '2026-11-12 09:00:00',
...over,
}
}
let pinia: Pinia
/** 分组 id 常量:默认作用域就这一个可见且可写的组(组长档形状),分类与行集都按它取。 */
const GROUP_A = 11
/** 分类作用域夹具(GET /scope 的归一形状):单组默认场景。 */
function singleGroupScope(editable = true) {
return {
platformSuperAdmin: false,
defaultGroupId: GROUP_A,
groups: [{ id: GROUP_A, name: '甲组', label: '甲组', editable }],
}
}
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
jdApi.fetchJdCategoryScope.mockResolvedValue(singleGroupScope())
jdApi.fetchJdProductGroups.mockResolvedValue([])
jdApi.fetchJdProductCategories.mockResolvedValue([])
confirmMock.mockResolvedValue(true)
})
async function mountWith(payload: unknown): Promise<VueWrapper<Element>> {
jdApi.fetchJdProductList.mockImplementation(() => Promise.resolve(payload))
const wrapper = mount(JdDatabasePage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
return wrapper
}
/** 批量编辑分类(2026-11-17 用户口径「店铺分类弹窗删了,加个批量编辑分类」):
* 勾选跨页累计记忆(翻页/重取不清)→ 对话框选目标分类归入或移出 → 按 (ids, groupId,
* ownerGroupId) 提交;成功后清勾选并重取。旧弹窗的「勾选翻页即清」口径同日废止。 */
describe('批量编辑分类(店铺分类弹窗 2026-11-17 下线后的替代入口)', () => {
it('勾选跨页记忆:第 1 页勾 1 行翻到第 2 页再勾 1 行,删除按累计 2 行提交;「清除勾选」按钮已删(2026-11-17 用户口径)', async () => {
jdApi.fetchJdProductList
.mockImplementationOnce(() => Promise.resolve({ items: [item(1)], total: 40, page: 1, pageSize: 20 }))
.mockImplementation(() => Promise.resolve({ items: [item(2)], total: 40, page: 2, pageSize: 20 }))
const wrapper = mount(JdDatabasePage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
const deleteBtn = () => wrapper.get('.jd-delete-btn')
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
expect(deleteBtn().text()).toContain('删除勾选(1)')
// 翻页:勾选不清(2026-11-17 口径「支持勾选翻页也要记住」)。
await wrapper.findAll('button').find((b) => b.text() === '下一页')!.trigger('click')
await flushPromises()
expect(deleteBtn().text()).toContain('删除勾选(1)', '翻页后第 1 页的勾选仍在累计集里')
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
expect(deleteBtn().text()).toContain('删除勾选(2)', '第 2 页再勾 1 行,累计 2 行')
expect(wrapper.findAll('button').some((b) => b.text() === '清除勾选')).toBe(false,
'「清除勾选」按钮 2026-11-17 用户口径删除(显式反悔口没了,勾选只在批量操作成功后自动清)')
// 累计勾选直达删除:跨页的行一起删(确认弹窗点名总数)。
jdApi.deleteJdProducts.mockResolvedValueOnce({ deleted: 2, imagesDeleted: 0, objectsDeleted: 0, objectsKept: 0, objectsSkipped: 0 })
await deleteBtn().trigger('click')
await flushPromises()
await flushPromises()
expect(confirmMock.mock.calls.at(-1)![0].message).toContain('确定删除勾选的 2 个商品吗', '确认文案点名累计总数')
// 跨页累计的 id 一起提交。
expect(jdApi.deleteJdProducts).toHaveBeenLastCalledWith([1, 2])
expect(deleteBtn().text()).toContain('删除勾选(0)', '批量删除成功后自动清勾选')
wrapper.unmount()
})
it('批量归入:未勾选时入口置灰,勾选后打开对话框选目标分类,按 (ids, groupId, ownerGroupId) 提交并清勾选重取', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([
{ id: 7, name: '甲组', sortOrder: 0, productCount: 3 },
{ id: 8, name: '乙组', sortOrder: 1, productCount: 1 },
])
jdApi.batchAssignJdProductGroup.mockResolvedValue(2)
const wrapper = await mountWith({ items: [item(1), item(2)], total: 2, page: 1, pageSize: 20 })
const editBtn = () => wrapper.findAll('button').find((b) => b.text() === '批量编辑分类')!
expect(editBtn().attributes('disabled')).toBeDefined('勾选 0 时置灰(与删除勾选同款常显口径)')
const boxes = wrapper.findAll('tbody input[type="checkbox"]')
await boxes[0].setValue(true)
await boxes[1].setValue(true)
expect(editBtn().attributes('disabled')).toBeUndefined()
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await editBtn().trigger('click')
await flushPromises()
const modal = wrapper.get('.batch-modal')
expect(modal.text()).toContain('批量编辑分类')
expect(modal.text()).toContain('已勾选 2 个商品(翻页累计)', '对话框点名累计勾选数')
expect(modal.text()).toContain('甲组', '标题/上下文带当前分组名')
expect(modal.findAll('.option-row')).toHaveLength(3, '两个分类+一个移出选项')
await modal.findAll('.option-row')[0].trigger('click')
const confirmBtn = modal.findAll('button').find((b) => b.text() === '归入「甲组」')
expect(confirmBtn, '确认按钮文案带目标分类名').toBeTruthy()
await confirmBtn!.trigger('click')
await flushPromises()
await flushPromises()
expect(jdApi.batchAssignJdProductGroup).toHaveBeenCalledWith([1, 2], 7, GROUP_A)
expect(document.body.textContent).toContain('已把 2 个商品归入「甲组」')
expect(wrapper.find('.batch-modal').exists()).toBe(false, '成功后对话框自动关闭')
expect(jdApi.fetchJdProductList.mock.calls.length).toBeGreaterThan(callsBefore, '成功后重取列表(groupName 变了)')
expect(wrapper.get('.jd-delete-btn').text()).toContain('删除勾选(0)', '成功后清勾选')
wrapper.unmount()
})
it('移出分类:选「移出分类」确认 → groupId 传 null(后端只解挂本组归属行)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 3 }])
jdApi.batchAssignJdProductGroup.mockResolvedValue(1)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
await wrapper.findAll('button').find((b) => b.text() === '批量编辑分类')!.trigger('click')
await flushPromises()
const modal = wrapper.get('.batch-modal')
await modal.find('.option-detach').trigger('click')
await modal.findAll('button').find((b) => b.text() === '移出分类')!.trigger('click')
await flushPromises()
await flushPromises()
expect(jdApi.batchAssignJdProductGroup).toHaveBeenCalledWith([1], null, GROUP_A)
expect(document.body.textContent).toContain('已把 1 个商品移出分类')
wrapper.unmount()
})
it('本组暂无分类:对话框只留提示不给提交(移出对未分类行是无谓操作),引导去工具栏「分类管理」新建', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([])
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
await wrapper.findAll('button').find((b) => b.text() === '批量编辑分类')!.trigger('click')
await flushPromises()
const modal = wrapper.get('.batch-modal')
expect(modal.text()).toContain('本组暂无分类')
expect(modal.text()).toContain('分类管理', '空态把维护入口指向工具栏「分类管理」(独立页 2026-11-17 并入本页)')
expect(modal.findAll('button').some((b) => b.text() === '移出分类' && b.attributes('disabled') === undefined)).toBe(false,
'无分类时移出不可提交')
expect(jdApi.batchAssignJdProductGroup).not.toHaveBeenCalled()
wrapper.unmount()
})
it('店铺分类弹窗已下线(反向钉):入口按钮与 .group-modal 都不再存在,分类筛选照常', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 1 }])
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.findAll('button').some((b) => b.text() === '店铺分类')).toBe(false, '「店铺分类」入口已删')
expect(wrapper.find('.group-modal').exists()).toBe(false)
expect(wrapper.get('[aria-label="筛选店铺分类"]').exists()).toBe(true, '分类筛选下拉是读面,保留')
wrapper.unmount()
})
})
/** 分类管理入口(2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里」):
* V204 独立子菜单页下线,工具栏「分类管理」打开 JdCategoryManageDialog(搜索+新建+
* 改名+删除);入口对所有人渲染(同组普通号只读可看),写控件由对话框按 editable 分档;
* 对话框 CRUD 成功 emit changed ⇒ 父页刷分类筛选下拉。 */
describe('分类管理入口(V204 独立页并入京东数据库页)', () => {
it('工具栏「分类管理」入口常显(勾选 0 也可用),点开渲染对话框且按当前分组取分类', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '裙装', sortOrder: 0, productCount: 3 }])
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
const manageBtn = () => wrapper.findAll('button').find((b) => b.text() === '分类管理')
expect(manageBtn(), '入口常显(不等勾选)').toBeTruthy()
expect(wrapper.find('.manage-modal').exists()).toBe(false, '未点开时不渲染对话框')
const callsBefore = jdApi.fetchJdProductGroups.mock.calls.length
await manageBtn()!.trigger('click')
await flushPromises()
const modal = wrapper.get('.manage-modal')
expect(modal.text()).toContain('分类管理')
expect(modal.text()).toContain('甲组', '标题带当前分组名')
expect(modal.get('.search-input').exists()).toBe(true, '搜索框是本对话框新能力')
expect(modal.text()).toContain('裙装')
expect(jdApi.fetchJdProductGroups.mock.calls.length).toBeGreaterThan(callsBefore,
'对话框打开时按当前分组自取列表')
wrapper.unmount()
})
it('对话框内删分类成功(emit changed)后父页重取分类下拉(筛选选项与商品数徽标同步刷新)', async () => {
// 取数按次序变形:页面首屏=裙装;对话框打开与 changed 后的重取=删后列表(只剩裤装)。
let groupFetchCount = 0
jdApi.fetchJdProductGroups.mockImplementation(() => {
groupFetchCount += 1
return groupFetchCount === 1
? Promise.resolve([{ id: 7, name: '裙装', sortOrder: 0, productCount: 3 }])
: Promise.resolve([{ id: 8, name: '裤装', sortOrder: 1, productCount: 1 }])
})
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.get('[aria-label="筛选店铺分类"]').text()).toContain('裙装', '首屏下拉含首取分类')
await wrapper.findAll('button').find((b) => b.text() === '分类管理')!.trigger('click')
await flushPromises()
const modal = wrapper.get('.manage-modal')
confirmMock.mockResolvedValue(true)
jdApi.deleteJdProductGroup.mockResolvedValueOnce(undefined)
await modal.findAll('button').find((b) => b.text() === '删除')!.trigger('click')
await flushPromises()
await flushPromises()
expect(jdApi.deleteJdProductGroup, '删除按钮属于当前列表行').toHaveBeenCalledWith(8)
// changed → 父页 loadGroupOptions:下拉按新列表重取(最后一次调用拿到删后列表)。
const select = wrapper.get('[aria-label="筛选店铺分类"]')
expect(select.text()).toContain('裤装', '下拉刷新出新一轮分类')
expect(select.text()).not.toContain('裙装', '删掉的分类不再出现在筛选下拉')
wrapper.unmount()
})
})
describe('京东数据库页(v1.4 Phase 5)', () => {
it('挂载后按首屏分页参数取列表(pageSize 默认 20、不带公司维度),行数=本页条数', async () => {
const wrapper = await mountWith({ items: [item(1), item(2), item(3)], total: 42, page: 1, pageSize: 20 })
expect(jdApi.fetchJdProductList).toHaveBeenCalledTimes(1)
const firstCall = jdApi.fetchJdProductList.mock.calls[0][0]
expect(firstCall.page).toBe(1)
expect(firstCall.pageSize).toBe(20)
// 公司维度 2026-11-16 整页摘除:入参层不再有 companyId 键(单参 toHaveProperty 才是「键不存在」的真判据)。
expect(firstCall).not.toHaveProperty('companyId')
expect(wrapper.findAll('tbody tr')).toHaveLength(3)
expect(wrapper.find('.jd-summary').text()).toContain('共 42 条京东商品')
})
it('行列字段与顺序(2026-11-15 用户口径;状态列+创建/修改两列 2026-11-16 客户口径「不需要采集/不要」下线仍收详情抽屉;操作置末「操作放最后一列」):勾选/分组/商品信息(图+标题+编码+货号+品牌·类目+SKU/信息分)/总库存/价格/同步/操作(7 列;店铺列 2026-11-15 下线)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
const cells = wrapper.findAll('tbody tr')[0].findAll('td')
expect(cells).toHaveLength(7)
expect(cells[0].find('input[type="checkbox"]').exists()).toBe(true, '第 1 列是勾选框')
expect(cells[1].text()).toBe('甲组', '第 2 列=分组(admin 专属)')
// 商品信息列=京麦同款合并布局:主图+信息分+标题+商品编码+货号+品牌·类目行+SKU 标签。
const info = cells[2]
expect(info.find('.jd-thumb').exists()).toBe(true, '商品信息列含主图')
expect(info.text()).toContain('304不锈钢保温杯')
expect(info.text()).toContain('JD-1001', '商品编码并入商品信息列')
expect(info.text()).toContain('ITEM-1', '货号并入商品信息列')
expect(info.text()).toContain('锅宝', '品牌并入商品信息列(京麦品牌·类目行)')
expect(info.text()).toContain('家居 > 厨具 > 保温杯', '类目随品牌·类目行上列表(京麦同款)')
expect(info.text()).toContain('12个SKU')
expect(info.text()).toContain('信息分 81')
expect(cells[3].text()).toBe('500', '第 3 数据列=总库存(京麦第 2 列)')
expect(cells[4].text()).toBe('12.9 ~ 15.9', '第 4 数据列=价格(京麦第 3 列;number 形状价格不许显示 -)')
expect(cells[5].text()).not.toBe('-', '第 5 数据列=同步时间(创建/修改两列 2026-11-16 下线,时间列只剩同步)')
expect(cells[6].text()).toContain('编辑', '第 6 数据列=操作(编辑/删除;2026-11-16「操作放最后一列」置末)')
expect(cells[6].text()).toContain('删除', '操作列含删除按钮')
// 表头字段名与顺序与京麦一致;品牌/类目不再是独立列(收进商品信息);店铺/状态/创建/修改列已下线。
const headerText = wrapper.find('thead').text()
for (const gone of ['品牌', '类目', '店铺', '上架时间 / 商品状态', '创建时间', '修改时间']) {
expect(headerText).not.toContain(gone, `${gone}不再是独立列(品牌/类目收进商品信息;店铺 2026-11-15 下线;状态列+创建/修改 2026-11-16 下线)`)
}
for (const head of ['商品信息', '总库存', '价格', '同步时间', '操作']) {
expect(headerText).toContain(head, `表头必须有「${head}」(京麦字段名)`)
}
expect(wrapper.find('.jd-thumb').exists()).toBe(true, '商品信息列渲染缩略图')
})
it('操作列删除按钮防冒泡且走确认弹窗:确认后调 deleteJdProducts,取消不动(2026-11-15 行级删除)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
// beforeEach 默认 confirm=true;本例先翻回 false 验「取消不动」。
confirmMock.mockResolvedValue(false)
const opsCell = wrapper.findAll('tbody tr')[0].findAll('td')[6]
await opsCell.findAll('button').find((b) => b.text() === '删除')!.trigger('click')
await flushPromises()
// 防冒泡:点删除不得顺手打开详情抽屉(抽屉的可视判据=.drawer 出现)。
expect(wrapper.find('.drawer').exists()).toBe(false, '删除按钮 @click.stop,点它不开详情抽屉')
expect(confirmMock).toHaveBeenCalledTimes(1, '删除必须过二次确认')
expect(jdApi.deleteJdProducts).toHaveBeenCalledTimes(0, '确认弹窗取消时不发删除请求')
// 确认后:deleteJdProducts 按 id 直删(公共库写侧无公司维度,2026-11-15 公共化)。
confirmMock.mockResolvedValue(true)
jdApi.deleteJdProducts.mockResolvedValueOnce({ deleted: 1, imagesDeleted: 0, objectsDeleted: 0, objectsKept: 0, objectsSkipped: 0 })
await wrapper.findAll('tbody tr')[0].findAll('td')[6].findAll('button').find((b) => b.text() === '删除')!.trigger('click')
await flushPromises()
expect(jdApi.deleteJdProducts).toHaveBeenCalledWith([1])
})
it('操作列编辑按钮防冒泡且打开编辑抽屉(抽屉自取详情回填,2026-11-15 行级编辑)', async () => {
// fetchJdProductDetail 的返回已由 parseJdProductDetail 归一成 {item, attrGroups, images, skus, attrJsonRaw}。
jdApi.fetchJdProductDetail.mockResolvedValue({
item: {
id: 1,
title: '304不锈钢保温杯大容量便携',
brand: '锅宝',
categoryPath: '家居 > 厨具 > 保温杯',
itemNum: 'ITEM-1',
priceMin: 12.9,
priceMax: 15.9,
stockTotal: 500,
saleStatus: '上架中',
groupId: 7,
groupName: '甲组',
productCode: 'JD-1001',
shopName: '旗舰自营店',
},
attrGroups: [],
images: [],
skus: [],
attrJsonRaw: '',
})
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
const opsCell = wrapper.findAll('tbody tr')[0].findAll('td')[6]
await opsCell.findAll('button').find((b) => b.text() === '编辑')!.trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.drawer').exists()).toBe(true, '编辑抽屉打开')
expect(wrapper.text()).toContain('编辑商品', '抽屉标题点商品')
// 抽屉按 id 自取详情回填(公共库详情无公司维度)。
expect(jdApi.fetchJdProductDetail).toHaveBeenCalledWith(1)
// 编辑抽屉的保存提示文案点名人工编辑锁后果(用户保存前看得见「采集不再覆盖」)。
expect(wrapper.text()).toContain('人工维护', '保存后果提示常驻(V199 人工编辑锁)')
})
it('商品信息列:主图无 URL 显示「无图」占位、healthScore 为空不出信息分行、skuCount 为空不出 SKU 标签', async () => {
const wrapper = await mountWith({
items: [item(1), item(2, { mainImageUrl: '', healthScore: null, skuCount: null })],
total: 2, page: 1, pageSize: 20,
})
const rowTexts = wrapper.findAll('tbody tr').map((tr) => tr.text())
expect(wrapper.findAll('img.jd-thumb')).toHaveLength(1, '只有有自有桶 URL 的行出真图(无图占位是 span,不冒充 img)')
expect(rowTexts[1]).toContain('无图')
expect(rowTexts[1]).not.toContain('信息分')
expect(rowTexts[1]).not.toContain('个SKU')
})
it('商品编码旁复制按钮:写入剪贴板且不冒泡开抽屉', async () => {
const writeText = vi.fn().mockResolvedValue(undefined)
Object.defineProperty(navigator, 'clipboard', { value: { writeText }, configurable: true })
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.find('.drawer-mask').exists()).toBe(false, '复制前抽屉未开')
await wrapper.findAll('.jd-copy-btn')[0].trigger('click')
expect(writeText).toHaveBeenCalledWith('JD-1001')
expect(wrapper.find('.drawer-mask').exists()).toBe(false, '点复制按钮不冒泡开抽屉')
})
it('分类读不到的那行展示「未分类」(不猜名字;2026-11-15「分组管理」改「店铺分类」只换措辞)', async () => {
const wrapper = await mountWith({ items: [item(1, { groupId: null, groupName: '' })], total: 1, page: 1, pageSize: 20 })
expect(wrapper.findAll('tbody tr')[0].findAll('td')[1].text()).toBe('未分类')
})
it('筛选生效:编码/关键字/分组/起止日期,查询回第一页重发(店铺筛选 2026-11-15 下线)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 3 }])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
expect(textInputs).toHaveLength(2, '商品编码+标题关键字两个文本筛选框(店铺/商品状态已下线)')
await textInputs[0].setValue('JD-1001')
await textInputs[1].setValue('保温杯')
await wrapper.get('[aria-label="筛选店铺分类"]').setValue('7')
const dateInputs = wrapper.findAll('input[type="date"]')
await dateInputs[0].setValue('2026-11-01')
await dateInputs[1].setValue('2026-11-09')
await wrapper.findAll('button').find((b) => b.text() === '查询')!.trigger('click')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({
productCode: 'JD-1001',
titleKeyword: '保温杯',
groupId: '7',
syncedFrom: '2026-11-01',
syncedTo: '2026-11-09',
page: 1,
})
// 单参 toHaveProperty 才是「键不存在」的真判据(第二参会稀释成值断言):
// 页面 load() 入参已不带这三个键(店铺/商品状态筛选下线、公司维度 2026-11-16 摘除)。
expect(last).not.toHaveProperty('shopName')
expect(last).not.toHaveProperty('saleStatus')
expect(last).not.toHaveProperty('companyId')
})
it('类目京麦同款级联面板(2026-11-16 真树重做):授权一级 3 个逐级下钻,点末级即查回第一页', async () => {
jdApi.fetchJdProductCategories.mockResolvedValue([
{ name: '艺考形体服', productCount: 120 },
{ name: '啦啦队服', productCount: 8 },
])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
expect(jdApi.fetchJdProductCategories).toHaveBeenCalledWith()
const trigger = wrapper.find('.cat-trigger')
expect(trigger.text()).toContain('全部类目', '未选时触发框显示占位「全部类目」')
expect(wrapper.find('.cat-panel').exists()).toBe(false, '面板初始不展开')
await trigger.trigger('click')
expect(wrapper.find('.cat-panel').exists()).toBe(true)
// 第一栏=京麦授权一级真树(2026-11-16 真机取证就 3 个:服饰内衣/母婴/运动户外)。
const firstCol = wrapper.findAll('.cat-col')[0]
expect(firstCol.text()).toContain('服饰内衣')
expect(firstCol.text()).toContain('母婴')
expect(firstCol.text()).toContain('运动户外')
// 点一级展开第二栏(非末级行点击=下钻)。
await firstCol.findAll('.cat-row').find((row) => row.text().includes('服饰内衣'))!.trigger('click')
let cols = wrapper.findAll('.cat-col')
expect(cols).toHaveLength(2, '点亮一级后第二栏出现(树内逐级下钻)')
expect(cols[1].text()).toContain('服饰配件')
expect(cols[1].text()).toContain('女装')
// 点二级展开第三栏(京麦同款三级末级,取证快照:服饰配件 13 个)。
await cols[1].findAll('.cat-row').find((row) => row.text().includes('服饰配件'))!.trigger('click')
cols = wrapper.findAll('.cat-col')
expect(cols).toHaveLength(3, '三级栏出现(末级行不再下钻)')
expect(cols[2].text()).toContain('腰带/腰链')
// 点末级=选中即查(按 category_path 等值过滤口径不变)、面板收起、触发框显示已选名。
await cols[2].findAll('.cat-row').find((row) => row.text().includes('腰带/腰链'))!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ category: '腰带/腰链', page: 1 })
expect(wrapper.find('.cat-panel').exists()).toBe(false, '选中后面板收起')
expect(wrapper.find('.cat-trigger').text()).toContain('腰带/腰链')
})
it('类目级联搜索与清选(2026-11-16 真树重做):树内末级命中+树外兜底段;「全部类目」行/触发框 × 都能清选重查', async () => {
jdApi.fetchJdProductCategories.mockResolvedValue([
{ name: '艺考形体服', productCount: 120 },
{ name: '已下架历史类目', productCount: 3 },
])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
await wrapper.find('.cat-trigger').trigger('click')
// 搜索态:树内末级按名称/路径命中(艺考形体服在树内=女装支末级)。
await wrapper.findAll('.cat-col')[0].find('.cat-search').setValue('艺考')
const searchCol = wrapper.find('.cat-col-search')
const visibleRows = searchCol.findAll('.cat-row')
expect(visibleRows).toHaveLength(1, '搜索「艺考」只命中树内末级「艺考形体服」')
expect(searchCol.text()).toContain('艺考形体服')
expect(searchCol.text()).not.toContain('已下架历史类目', '不匹配项不出现')
await visibleRows[0].trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ category: '艺考形体服', page: 1 })
// 树外兜底:已落库但京麦树里已没有的名字(历史行)从兜底段搜出可选。
await wrapper.find('.cat-trigger').trigger('click')
await wrapper.findAll('.cat-col')[0].find('.cat-search').setValue('已下架历史')
const fallbackCol = wrapper.find('.cat-col-search')
expect(fallbackCol.text()).toContain('已落库类目(树外历史)')
expect(fallbackCol.text()).toContain('已下架历史类目')
await fallbackCol.findAll('.cat-row').find((row) => row.text().includes('已下架历史类目'))!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ category: '已下架历史类目' })
// 点「全部类目」行=清选重查(category 入参回空串、query 层不下发,回第一页)。
await wrapper.find('.cat-trigger').trigger('click')
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await wrapper.find('.cat-row-all').trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBe(callsBefore + 1, '清选也要重查')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].category).toBe('')
// 触发框已选时出 × 清除按钮:点了同样清选。
await wrapper.find('.cat-trigger').trigger('click')
await wrapper.findAll('.cat-col')[0].find('.cat-search').setValue('艺考')
await wrapper.find('.cat-col-search').findAll('.cat-row')[0].trigger('click')
await flushPromises()
expect(wrapper.find('.cat-trigger').text()).toContain('艺考形体服')
const callsBeforeClear = jdApi.fetchJdProductList.mock.calls.length
await wrapper.find('.cat-clear').trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBe(callsBeforeClear + 1, '× 清除同样触发重查')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].category).toBe('')
})
it('不再显示独立分类与分类状态筛选;工具栏入口是「批量编辑分类」(弹窗 2026-11-17 下线)', async () => {
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
expect(wrapper.find('.jd-filter-row').text()).not.toContain('分类状态')
expect(wrapper.find('.jd-filter-row select').exists()).toBe(false)
expect(wrapper.findAll('button').some(button => button.text() === '批量编辑分类')).toBe(true)
expect(wrapper.findAll('button').some(button => button.text() === '店铺分类')).toBe(false, '「店铺分类」入口已删')
})
it('重置把筛选面回空并回第一页重取', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 1 }])
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
const select = wrapper.get('[aria-label="筛选店铺分类"]')
expect(select.text()).toContain('全部分类')
await select.setValue('7')
await wrapper.get('.cat-trigger').trigger('click')
await wrapper.get('.cat-search').setValue('艺考')
await wrapper.get('.cat-col-search .cat-row').trigger('click')
const textInputs = wrapper.findAll('.form-group input[type="text"]')
await textInputs[0].setValue('JD-1001')
await textInputs[1].setValue('保温杯')
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBeGreaterThan(callsBefore)
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ productCode: '', titleKeyword: '', groupId: '', category: '', page: 1 }, '重置后筛选全空、回第一页')
expect((select.element as HTMLSelectElement).value).toBe('')
})
it('翻页与改每页条数都重发请求,改条数回第一页', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 42, page: 2, pageSize: 20 })
await wrapper.findAll('button').find((b) => b.text() === '下一页')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList).toHaveBeenCalledTimes(2)
expect(jdApi.fetchJdProductList.mock.calls[1][0].page).toBe(3)
const sizeSelect = wrapper.find('.page-size-select')
await sizeSelect.setValue('50')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last.pageSize).toBe(50)
expect(last.page).toBe(1, '改每页条数后回第一页')
})
it('导出按钮已下线:筛选行不再出现「导出」(2026-11-15 客户口径「导出也不用」)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
const btn = wrapper.findAll('button').find((b) => b.text() === '导出')
expect(btn, '导出按钮必须已从前端移除').toBeUndefined()
expect(jdApi.fetchJdProductList).toHaveBeenCalledTimes(1, '下线导出不影响列表首屏')
})
it('点行打开详情抽屉:按 id 取详情(公共库无公司维度),attrGroups 分块渲染', async () => {
jdApi.fetchJdProductDetail.mockImplementation(() =>
Promise.resolve({
item: item(1),
attrGroups: [{ groupName: '规格', attrs: [{ key: 'capacity', label: '容量', value: '500ml' }] }],
images: [{ imageType: 'MAIN', attrName: '', sortNo: 1, url: 'https://img.example/main-1.jpg', byteSize: null, width: 800, height: 800 }],
skus: [],
attrJsonRaw: '',
}),
)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.find('.drawer-mask').exists()).toBe(false, '初始不显示抽屉')
await wrapper.findAll('tbody tr')[0].trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.drawer-mask').exists()).toBe(true)
expect(jdApi.fetchJdProductDetail).toHaveBeenCalledTimes(1)
expect(jdApi.fetchJdProductDetail).toHaveBeenCalledWith(1)
// 2026-11-16 客户口径「详情页的样式要和京麦商品详情一样」:顶部改「左图右信息」hero
// 布局(左侧主图大图+缩略图,右侧关键信息),「基本信息」块标题随 hero 化下线。
expect(wrapper.find('.detail-hero').exists()).toBe(true, '顶部左图右信息 hero 布局')
expect(wrapper.find('.hero-main').exists()).toBe(true, '左侧主图大图')
expect(wrapper.find('.hero-info').text()).toContain('价格区间')
expect(wrapper.find('.hero-info').text()).toContain('12.9 ~ 15.9', '价格走 decimalText(number/字符串都收)')
expect(wrapper.find('.drawer-mask').text()).toContain('规格')
expect(wrapper.find('.drawer-mask').text()).toContain('容量')
expect(wrapper.find('.drawer-mask').text()).toContain('500ml')
expect(wrapper.find('.drawer-mask').text()).toContain('主图')
const drawerText = wrapper.find('.drawer-mask').text()
expect(drawerText).toContain('货号')
expect(drawerText).toContain('ITEM-1')
expect(drawerText).toContain('信息分')
expect(drawerText).toContain('上架时间')
// B104:详情里全量可见(店铺/分组 2026-11-15 起也上了列表,抽屉仍保留)。
expect(drawerText).toContain('家居 > 厨具 > 保温杯')
expect(drawerText).toContain('SKU 数')
expect(drawerText).toContain('京东创建时间')
expect(drawerText).toContain('京东修改时间')
expect(drawerText).toContain('旗舰自营店')
expect(drawerText).toContain('甲组')
})
it('详情抽屉的销售属性=京麦那 12 行 SKU 矩阵:颜色/尺码两列维度 + 京东价 + 库存 + skuId', async () => {
const skuRows = [
{ skuId: '10238877506570', skuName: '花屿巷… 上衣 S', skuSeq: '1', price: 162, stock: 200, sortNo: 0,
saleAttrs: [{ name: '颜色', value: '上衣' }, { name: '尺码', value: 'S' }] },
{ skuId: '10238877506574', skuName: '花屿巷… 上衣 M', skuSeq: '2', price: 168, stock: 150, sortNo: 1,
saleAttrs: [{ name: '颜色', value: '上衣' }, { name: '尺码', value: 'M' }] },
{ skuId: '10238877506580', skuName: '花屿巷… 半裙 S', skuSeq: '3', price: 162, stock: 80, sortNo: 2,
saleAttrs: [{ name: '颜色', value: '半裙' }, { name: '尺码', value: 'S' }] },
]
jdApi.fetchJdProductDetail.mockImplementation(() =>
Promise.resolve({
item: item(1),
attrGroups: [],
images: [],
skus: skuRows,
attrJsonRaw: '',
}),
)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody tr')[0].trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.drawer-mask').text()).toContain('销售属性 / SKU 矩阵')
const headers = wrapper.findAll('.sku-table thead th').map((th) => th.text())
expect(headers).toEqual(['序号', '颜色', '尺码', '京东价', '库存', 'SKU ID', 'SKU 名称'],
'维度列从各 SKU 的 saleAttrs 派生(京麦「颜色/尺码」两列)')
const rows = wrapper.findAll('.sku-table tbody tr')
expect(rows).toHaveLength(3, '12 行矩阵按入库行数渲染')
const first = rows[0].findAll('td').map((td) => td.text())
expect(first).toEqual(['1', '上衣', 'S', '¥162', '200', '10238877506570', '花屿巷… 上衣 S'])
expect(rows[1].findAll('td').map((td) => td.text())[3]).toBe('¥168', '每行自己的京东价')
expect(wrapper.find('.drawer-mask').text()).toContain('3 个 SKU')
expect(wrapper.find('.drawer-mask').text()).toContain('库存 430', '汇总=各行库存之和')
})
it('旧行没有 SKU 矩阵时给可解释的空态(不渲染空表、不静默吞)', async () => {
jdApi.fetchJdProductDetail.mockImplementation(() =>
Promise.resolve({ item: item(1), attrGroups: [], images: [], skus: [], attrJsonRaw: '' }),
)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody tr')[0].trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.sku-table').exists()).toBe(false)
expect(wrapper.find('.drawer-mask').text()).toContain('暂无 SKU 矩阵')
})
it('删除:勾选两行点删除 → 二次确认点名数量与桶清理 → 批量端点按 id 直删(公共库无公司维度),成功后刷新并清勾选', async () => {
jdApi.deleteJdProducts.mockResolvedValue({ deleted: 2, imagesDeleted: 18, objectsDeleted: 16, objectsKept: 2, objectsSkipped: 0 })
const wrapper = await mountWith({ items: [item(1), item(2)], total: 2, page: 1, pageSize: 20 })
// 批量删除常显(2026-11-16 客户口径「不要勾选后才显示」):未勾选时就在,只是置灰。
expect(wrapper.find('.jd-delete-btn').exists()).toBe(true, '工具栏「删除勾选」常显')
expect(wrapper.find('.jd-delete-btn').attributes('disabled')).toBeDefined()
const boxes = wrapper.findAll('tbody input[type="checkbox"]')
await boxes[0].setValue(true)
await boxes[1].setValue(true)
expect(wrapper.find('.jd-delete-btn').attributes('disabled')).toBeUndefined('勾选后按钮可点')
await wrapper.find('.jd-delete-btn').trigger('click')
await flushPromises()
await flushPromises()
expect(confirmMock).toHaveBeenCalledTimes(1)
const options = confirmMock.mock.calls[0][0]
expect(options.title).toBe('删除京东商品')
expect(options.message).toContain('确定删除勾选的 2 个商品吗')
expect(options.message).toContain('jd-products 桶内图片文件一并删除', '确认弹窗必须点名「桶文件也会删」')
expect(options.danger).toBe(true)
expect(jdApi.deleteJdProducts).toHaveBeenCalledTimes(1)
expect(jdApi.deleteJdProducts).toHaveBeenCalledWith([1, 2])
expect(document.body.textContent).toContain('已删除 2 个商品')
expect(document.body.textContent).toContain('2 个共用图片保留', '共用对象计数要透出到反馈')
// 成功后重取列表并清勾选:常显按钮回到置灰(不再消失)。
expect(jdApi.fetchJdProductList.mock.calls.length).toBeGreaterThan(1)
expect(wrapper.find('.jd-delete-btn').exists()).toBe(true)
expect(wrapper.find('.jd-delete-btn').attributes('disabled')).toBeDefined()
})
it('删除:确认弹窗点取消就不发请求(防误删的第一道闸)', async () => {
confirmMock.mockResolvedValue(false)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
await wrapper.find('.jd-delete-btn').trigger('click')
await flushPromises()
expect(confirmMock).toHaveBeenCalledTimes(1)
expect(jdApi.deleteJdProducts).not.toHaveBeenCalled()
})
it('删除失败把后端「本次未删除任何数据」文案弹出来(整批拒绝的语义必须到界面)', async () => {
jdApi.deleteJdProducts.mockRejectedValue(new Error('桶内对象删除失败,本次未删除任何数据(jd-products/5/a.jpg):oss 5xx'))
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
await wrapper.find('.jd-delete-btn').trigger('click')
await flushPromises()
await flushPromises()
expect(document.body.textContent).toContain('本次未删除任何数据')
// 失败后勾选保留,用户可重试。
expect(wrapper.find('.jd-delete-btn').exists()).toBe(true)
})
it('空态与加载失败条(失败给重试,不把整页打死)', async () => {
const empty = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
const tip = empty.find('.empty-tip')
expect(tip.exists()).toBe(true)
expect(tip.text()).toContain('暂无京东商品数据')
empty.unmount()
jdApi.fetchJdProductList.mockRejectedValue(new Error('上游 502'))
const failed = mount(JdDatabasePage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
expect(failed.find('.load-failure-bar').exists()).toBe(true)
expect(failed.find('.load-failure-bar').text()).toContain('京东商品列表加载失败')
})
})
/** 写权限分档(2026-11-16 用户口径收窄商品行写;2026-11-17 弹窗下线后更新):
* 商品行写(编辑/删除/勾选批量删)只对平台超管渲染;分类写(批量编辑分类、分类管理)由
* scope 的每组 editable 决定(本组管理员/公司超管/平台超管)——同组普通号在本页只读,
* 分类维护入口=工具栏「分类管理」对话框(V204 独立页 2026-11-17 并入,只读可看)。
* 勾选列 2026-11-17 起对本组可写分类管理员开放(服务批量归类),商品行按钮仍只归平台超管。 */
describe('京东数据库写权限分档(商品行写=平台超管;分类写=本组 editable)', () => {
it('非超管且本组不可写:无勾选列、无操作列、无删除勾选、无批量编辑分类;列表/筛选/详情照常', async () => {
useAdminSessionStore().user = { id: 2, username: 'ops', role: 'admin' }
// 同组普通号:可见但不可写(editable=false)。
jdApi.fetchJdCategoryScope.mockResolvedValue(singleGroupScope(false))
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 1 }])
jdApi.fetchJdProductDetail.mockImplementation(() =>
Promise.resolve({ item: item(1), attrGroups: [], images: [], skus: [], attrJsonRaw: '' }),
)
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.findAll('tbody input[type="checkbox"]')).toHaveLength(0, '不可写分类的普通号没有勾选列')
expect(wrapper.find('.jd-delete-btn').exists()).toBe(false, '批量删除按钮不渲染')
expect(wrapper.findAll('button').some((b) => b.text() === '批量编辑分类')).toBe(false, '分类写入口不渲染(本组不可写)')
expect(wrapper.findAll('button').some((b) => b.text() === '分类管理')).toBe(true,
'分类管理入口是读面,普通号也能打开看(写控件由对话框按 editable 分档)')
expect(wrapper.find('thead').text()).not.toContain('操作', '操作列(编辑/删除)不渲染')
expect(wrapper.text()).toContain('只读:编辑/删除仅超级管理员可用', '只读提示必须看得见并区分两类写权限')
expect(wrapper.text()).toContain('分类在本页「分类管理」查看与维护', '提示把分类维护入口指向本页「分类管理」(独立页已并入)')
// 读面不受影响:筛选下拉、列表行、点行开详情都还在。
expect(wrapper.get('[aria-label="筛选店铺分类"]').exists()).toBe(true, '分类筛选是读面,保留')
expect(wrapper.findAll('tbody tr')[0].findAll('td')).toHaveLength(5, '普通号列表 5 列:分类/商品信息/总库存/价格/同步时间')
await wrapper.findAll('tbody tr')[0].trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.find('.drawer-mask').exists()).toBe(true, '点行仍可开只读详情抽屉')
expect(jdApi.fetchJdProductDetail).toHaveBeenCalledWith(1)
wrapper.unmount()
})
it('超管保留全部写入口(勾选列+操作列+删除勾选+批量编辑分类),且不显示只读提示', async () => {
// beforeEach 默认 super_admin;这里显式再钉一次,防默认值漂移把这条闸门变成恒绿。
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.findAll('tbody input[type="checkbox"]')).toHaveLength(1)
expect(wrapper.findAll('tbody tr')[0].findAll('td')).toHaveLength(7)
expect(wrapper.find('.jd-delete-btn').exists()).toBe(true)
expect(wrapper.findAll('button').some((b) => b.text() === '批量编辑分类')).toBe(true)
expect(wrapper.text()).not.toContain('只读:')
wrapper.unmount()
})
it('本组管理员(非平台超管):商品行按钮仍无,但勾选列随批量编辑分类放开(6 列形状)', async () => {
useAdminSessionStore().user = { id: 3, username: 'leader', role: 'admin' }
// 组长档形状:可见组可写 ⇒ editable=true;商品行写仍按 isSuperAdmin 判(不受 editable 影响)。
jdApi.fetchJdCategoryScope.mockResolvedValue(singleGroupScope(true))
jdApi.fetchJdProductGroups.mockResolvedValue([{ id: 7, name: '甲组', sortOrder: 0, productCount: 1 }])
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.findAll('tbody tr')[0].findAll('td')).toHaveLength(6, '管理员 6 列:勾选/分类/商品信息/总库存/价格/同步时间(无操作列)')
expect(wrapper.find('.jd-delete-btn').exists()).toBe(false, '批量删除(商品行写)仍只归平台超管')
expect(wrapper.find('thead').text()).not.toContain('操作')
const editBtn = wrapper.findAll('button').find((b) => b.text() === '批量编辑分类')
expect(editBtn, '本组管理员有批量编辑分类入口').toBeTruthy()
// 管理员可勾选并走一遍归类(2026-11-17 弹窗下线后唯一的归类路径)。
jdApi.batchAssignJdProductGroup.mockResolvedValue(1)
await wrapper.findAll('tbody input[type="checkbox"]')[0].setValue(true)
expect(editBtn!.attributes('disabled')).toBeUndefined('勾选后可点')
await editBtn!.trigger('click')
await flushPromises()
const modal = wrapper.get('.batch-modal')
await modal.findAll('.option-row')[0].trigger('click')
await modal.findAll('button').find((b) => b.text() === '归入「甲组」')!.trigger('click')
await flushPromises()
await flushPromises()
expect(jdApi.batchAssignJdProductGroup).toHaveBeenCalledWith([1], 7, GROUP_A)
wrapper.unmount()
})
})
describe('京东数据库分类按数据权限分组隔离(V203)', () => {
it('多组可见:筛选行出带标签的「分组」下拉,切换后分类下拉与列表一并用新组取', async () => {
jdApi.fetchJdCategoryScope.mockResolvedValue({
platformSuperAdmin: true,
defaultGroupId: 11,
groups: [
{ id: 11, name: 'A组', label: '甲公司 / A组', editable: true },
{ id: 12, name: 'B组', label: '甲公司 / B组', editable: true },
],
})
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
// 首屏就按默认组取(不是先不带 ownerGroupId 再补一次)。
expect(jdApi.fetchJdProductGroups).toHaveBeenCalledWith(11)
expect(jdApi.fetchJdProductList.mock.calls[0][0]).toMatchObject({ ownerGroupId: 11 })
const picker = wrapper.get('[aria-label="当前分组"]')
// 2026-11-16 用户口径「做成分组」:分组在筛选行里是带标签的表单控件(与其他筛选同壳同圆角),
// 不再是工具栏裸下拉——钉住形状,防止搬回工具栏或丢标签。
const groupField = (picker.element as HTMLSelectElement).closest('.form-group')
expect(groupField?.querySelector('label')?.textContent).toBe('分组')
expect(picker.findAll('option').map((o) => o.text())).toEqual(['甲公司 / A组', '甲公司 / B组'],
'跨公司组名由后端拼进 label,前端不解析公司字段')
await picker.setValue('12')
await flushPromises()
expect(jdApi.fetchJdProductGroups).toHaveBeenLastCalledWith(12)
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ ownerGroupId: 12, page: 1 },
'切组后列表按新组重取并回第一页')
wrapper.unmount()
})
it('只有一组:不出下拉(锁定显示组名),分类与行集仍按该组取', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 })
expect(wrapper.find('[aria-label="当前分组"]').exists()).toBe(false, '单组不渲染切换下拉')
expect(wrapper.get('.jd-group-locked').text()).toBe('甲组', '锁定芯片只放组名,「分组」二字在上方标签里(2026-11-16 口径)')
expect(jdApi.fetchJdProductList.mock.calls[0][0]).toMatchObject({ ownerGroupId: GROUP_A })
wrapper.unmount()
})
it('分组住进筛选行但仍是作用域不是筛选条件:重置只清筛选面,分组保持当前组', async () => {
jdApi.fetchJdCategoryScope.mockResolvedValue({
platformSuperAdmin: true,
defaultGroupId: 11,
groups: [
{ id: 11, name: 'A组', label: '甲公司 / A组', editable: true },
{ id: 12, name: 'B组', label: '甲公司 / B组', editable: true },
],
})
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 20 })
const picker = wrapper.get('[aria-label="当前分组"]')
await picker.setValue('12')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ ownerGroupId: 12 })
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect((picker.element as HTMLSelectElement).value).toBe('12', '重置不清当前分组(作用域语义,搬进筛选行也不变)')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ ownerGroupId: 12 },
'重置后的重取仍带当前分组')
wrapper.unmount()
})
it('不属于任何数据权限分组:分类全空、不给切换也不给批量归类入口', async () => {
jdApi.fetchJdCategoryScope.mockResolvedValue({ platformSuperAdmin: false, defaultGroupId: null, groups: [] })
const wrapper = await mountWith({ items: [item(1, { groupId: null, groupName: '' })], total: 1, page: 1, pageSize: 20 })
expect(wrapper.find('[aria-label="当前分组"]').exists()).toBe(false)
expect(wrapper.find('.jd-group-locked').exists()).toBe(false, '没有分组就没有可锁定的组名')
expect(wrapper.find('[aria-label="筛选店铺分类"]').text()).toContain('全部分类', '分类筛选只剩「全部分类」')
expect(wrapper.findAll('tbody tr')[0].findAll('td')[1].text()).toBe('未分类')
expect(wrapper.findAll('button').some((b) => b.text() === '批量编辑分类')).toBe(false, '没有分组就没有可写的分类面')
expect(jdApi.batchAssignJdProductGroup).not.toHaveBeenCalled()
wrapper.unmount()
})
})
@@ -0,0 +1,152 @@
/**
* 京东商品编辑抽屉「图片区」子组件 JdProductImageManager(2026-11-16 客户口径
* 「删除做成打叉的 icon 放图右上角,也要支持编辑替换本地的图」+替换+新增,B109-01
* 落地;从 JdProductEditDrawer 拆出成件后本测试直接挂子组件)的挂载契约。
*
* 形态:× 右上角标删(保存时一并删除,遮罩可点撤销,标删集合经 update:deleteIds 上抛);
* hover 替换条(multipart 立即生效,返回详情经 update:images 上抛);「+ 新增主图」入口
* (imageType=MAIN)。objectKey 服务端内容寻址生成——前端只传文件。
* 跑法:`npx vitest run tests/mount/jd-edit-drawer-images.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import JdProductImageManager from '@/pages/jd/JdProductImageManager.vue'
const jdApi = vi.hoisted(() => ({
uploadJdProductImage: vi.fn(),
}))
const feedbackMock = vi.hoisted(() => vi.fn())
vi.mock('@/pages/jd/jd-product-api.ts', () => ({
uploadJdProductImage: jdApi.uploadJdProductImage,
}))
vi.mock('@/components/admin-feedback-ui', () => ({ showAdminFeedback: feedbackMock }))
function image(id: number, imageType: string, url: string) {
return { id, imageType, attrName: null, sortNo: id, url, byteSize: 1024, width: null, height: null }
}
beforeEach(() => {
vi.clearAllMocks()
})
async function mountWith(images: ReturnType<typeof image>[]): Promise<VueWrapper<Element>> {
const wrapper = mount(JdProductImageManager, {
props: { productId: 9, images, disabled: false },
})
await flushPromises()
return wrapper
}
/** 把夹具文件塞进隐藏 file input 并触发 change。 */
async function chooseFile(wrapper: VueWrapper<Element>, name = 'a.png'): Promise<File> {
const input = wrapper.find('input[type="file"]')
const file = new File(['x'], name, { type: 'image/png' })
Object.defineProperty(input.element, 'files', { value: [file] })
await input.trigger('change')
await flushPromises()
await flushPromises()
return file
}
describe('京东商品编辑抽屉图片区子组件(×右上角+替换+新增,B109-01)', () => {
it('挂载回填图片区:每格右上角有 × 标记、hover 替换条存在、新增按钮存在(上传/替换暂未开放的旧文案下线)', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg'), image(12, 'DETAIL', 'https://img.example/b.jpg')])
const cells = wrapper.findAll('.image-cell')
expect(cells).toHaveLength(2)
expect(cells[0].find('.image-x').exists()).toBe(true, '右上角 × 删除标记')
expect(cells[0].find('.image-replace').exists()).toBe(true, 'hover 替换条')
expect(cells[0].find('.image-marked-mask').exists()).toBe(false, '未标删时无遮罩')
const addBtn = wrapper.find('.btn-add-image')
expect(addBtn.exists()).toBe(true)
expect(addBtn.text()).toContain('新增主图')
expect(wrapper.find('h4').text()).not.toContain('暂未开放', '「上传/替换暂未开放」旧文案下线')
})
it('点 × 标记删除(保存时一并删除):遮罩出现、update:deleteIds 上抛、计数文案更新;再点撤销恢复', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg'), image(12, 'MAIN', 'https://img.example/b.jpg')])
await wrapper.find('.image-cell .image-x').trigger('click')
let cell = wrapper.findAll('.image-cell')[0]
expect(cell.classes()).toContain('marked')
expect(cell.find('.image-marked-mask').exists()).toBe(true)
expect(wrapper.find('.delete-count').text()).toContain('已标记删除 1 张')
expect(wrapper.emitted('update:deleteIds')).toBeTruthy()
expect(wrapper.emitted('update:deleteIds')![0]).toEqual([[11]])
await cell.find('.image-marked-mask').trigger('click')
cell = wrapper.findAll('.image-cell')[0]
expect(cell.classes()).not.toContain('marked')
expect(wrapper.find('.delete-count').exists()).toBe(false)
expect(jdApi.uploadJdProductImage).not.toHaveBeenCalled()
})
it('hover 替换条选本地图:uploadJdProductImage 带 replaceImageId 调用,update:images 上抛新行集并置 saved', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg')])
const clickSpy = vi.spyOn(HTMLInputElement.prototype, 'click').mockImplementation(() => {})
await wrapper.find('.image-cell .image-replace').trigger('click')
expect(clickSpy).toHaveBeenCalled()
jdApi.uploadJdProductImage.mockResolvedValue({
item: { id: 9 },
attrGroups: [],
images: [image(11, 'MAIN', 'https://img.example/replaced.jpg')],
skus: [],
attrJsonRaw: '',
})
const file = await chooseFile(wrapper, 'b.png')
expect(jdApi.uploadJdProductImage).toHaveBeenCalledTimes(1)
expect(jdApi.uploadJdProductImage.mock.calls[0][0]).toBe(9)
expect(jdApi.uploadJdProductImage.mock.calls[0][1]).toBe(file)
expect(jdApi.uploadJdProductImage.mock.calls[0][2]).toEqual({ replaceImageId: 11 })
expect(wrapper.emitted('update:images')![0][0]).toEqual([image(11, 'MAIN', 'https://img.example/replaced.jpg')])
expect(feedbackMock).toHaveBeenCalledWith(expect.stringContaining('已替换'), 'success')
expect(wrapper.emitted('saved')).toBeTruthy()
clickSpy.mockRestore()
})
it('「+ 新增主图」入口:uploadJdProductImage 带 imageType=MAIN(objectKey 由服务端生成,前端不自造)', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg')])
const clickSpy = vi.spyOn(HTMLInputElement.prototype, 'click').mockImplementation(() => {})
await wrapper.find('.btn-add-image').trigger('click')
expect(clickSpy).toHaveBeenCalled()
jdApi.uploadJdProductImage.mockResolvedValue({
item: { id: 9 },
attrGroups: [],
images: [image(11, 'MAIN', 'https://img.example/a.jpg'), image(13, 'MAIN', 'https://img.example/new.jpg')],
skus: [],
attrJsonRaw: '',
})
await chooseFile(wrapper, 'c.png')
expect(jdApi.uploadJdProductImage.mock.calls[0][2]).toEqual({ imageType: 'MAIN' })
expect(wrapper.emitted('update:images')![0][0]).toHaveLength(2)
expect(feedbackMock).toHaveBeenCalledWith(expect.stringContaining('已新增'), 'success')
clickSpy.mockRestore()
})
it('上传失败:红条出现(requestErrorMessage 对非信封异常回通用文案)、不 update:images 不置 saved', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg')])
vi.spyOn(HTMLInputElement.prototype, 'click').mockImplementation(() => {})
await wrapper.find('.btn-add-image').trigger('click')
jdApi.uploadJdProductImage.mockRejectedValue(new Error('单张图片不能超过 10MB'))
await chooseFile(wrapper, 'big.png')
expect(wrapper.find('.drawer-failure').exists()).toBe(true, '失败红条出现')
expect(wrapper.emitted('update:images')).toBeFalsy()
expect(wrapper.emitted('saved')).toBeFalsy()
vi.restoreAllMocks()
})
it('行集变化清掉已不存在的标删 id:父级保存删行回填后,残留标删不再进 update:deleteIds', async () => {
const wrapper = await mountWith([image(11, 'MAIN', 'https://img.example/a.jpg'), image(12, 'MAIN', 'https://img.example/b.jpg')])
await wrapper.find('.image-cell .image-x').trigger('click')
expect(wrapper.emitted('update:deleteIds')!.at(-1)).toEqual([[11]])
// 父级保存成功回填:11 行已删、只剩 12 —— 标删集合里 11 被清掉
await wrapper.setProps({ images: [image(12, 'MAIN', 'https://img.example/b.jpg')] })
await flushPromises()
expect(wrapper.emitted('update:deleteIds')!.at(-1)).toEqual([[]])
expect(wrapper.find('.delete-count').exists()).toBe(false)
})
})
@@ -0,0 +1,155 @@
// P2-10(后管 AC/user-notice「只把中文给用户看」口径)。
//
// 评审实录:`RecordsSoftwareVersionPage.vue`/`RecordsTutorialPage.vue` 的 catch 直接写
// `error instanceof Error ? error.message : '上传失败'`,而 `src/api/http.ts` 的响应拦截器
// **不做 sanitize**(只挑 401/403/4011)⇒ `Broken pipe`、`Request failed with status code 403`
// 这类英文异常原文整段上屏。收口方式沿用本仓既有出口 `components/load-failure-model`
// 的 `loadFailureMessage(error, 本页兜底句)`(去重页四条写路径同一写法)。
//
// 跑法:npm run test:mount(tests/mount/**,vitest+jsdom)。
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import { readFileSync } from 'node:fs'
import { dirname, resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
import RecordsSoftwareVersionPage from '@/pages/records/RecordsSoftwareVersionPage.vue'
import RecordsTutorialPage from '@/pages/records/RecordsTutorialPage.vue'
import { loadFailureMessage } from '@/components/load-failure-model'
const here = dirname(fileURLToPath(import.meta.url))
const root = resolve(here, '../..')
const versionApi = vi.hoisted(() => ({
fetchSoftwareVersions: vi.fn(),
uploadSoftwareVersion: vi.fn(),
deleteSoftwareVersions: vi.fn(),
}))
const tutorialApi = vi.hoisted(() => ({
fetchTutorialPackages: vi.fn(),
uploadTutorialPackage: vi.fn(),
deleteTutorialPackages: vi.fn(),
}))
const confirmMock = vi.hoisted(() => vi.fn())
const feedbackMock = vi.hoisted(() => vi.fn())
const messageMock = vi.hoisted(() => ({ success: vi.fn() }))
vi.mock('@/pages/records/version-api.ts', () => versionApi)
vi.mock('@/pages/records/tutorial-api.ts', () => tutorialApi)
vi.mock('@/components/admin-confirm', () => ({ openAdminConfirm: confirmMock }))
vi.mock('@/components/admin-feedback-ui', () => ({ showAdminFeedback: feedbackMock }))
vi.mock('element-plus', () => ({ ElMessage: messageMock }))
/** el-upload 的桩:把页面传进来的 on-change 回调顶出来,等价于用户选了一个 .zip。 */
const uploadStub = {
props: ['onChange'],
template: '<button class="pick-zip" @click="onChange({ raw: fake })">选择文件</button>',
data: () => ({ fake: new File([new Uint8Array(16)], 'pkg.zip', { type: 'application/zip' }) }),
}
const stubs = {
'el-dialog': { template: '<div><slot /><slot name="footer" /></div>' },
'el-form': { template: '<form><slot /></form>' },
'el-form-item': { template: '<div><slot /></div>' },
'el-input': {
props: ['modelValue'],
emits: ['update:modelValue'],
template: '<input :value="modelValue" @input="$emit(\'update:modelValue\', $event.target.value)" />',
},
'el-upload': uploadStub,
'el-button': { template: '<button><slot /></button>' },
'el-progress': true,
'el-alert': { props: ['title'], template: '<div class="upload-msg">{{ title }}</div>' },
}
/** 后端/驱动层原文:一句中文都没有,正是过去直接上屏的那种。 */
const RAW_ENGLISH = 'Broken pipe: java.io.IOException at sun.nio.ch.FileDispatcherImpl.write0'
function clickButtonByText(wrapper: ReturnType<typeof mount>, text: string, last = false) {
const matches = wrapper.findAll('button').filter((node) => node.text().trim() === text)
const button = last ? matches[matches.length - 1] : matches[0]
if (!button) throw new Error(`找不到文案为「${text}」的按钮`)
return button
}
async function submitZipUpload(component: typeof RecordsSoftwareVersionPage, versionPlaceholder: string, submitText: string, openText = '上传新版本') {
const wrapper = mount(component, { global: { stubs } })
await flushPromises()
clickButtonByText(wrapper, openText)
const versionInput = wrapper.find(`input[placeholder="${versionPlaceholder}"]`)
if (versionInput.exists()) await versionInput.setValue('9.9.9')
await wrapper.get('.pick-zip').trigger('click')
await clickButtonByText(wrapper, submitText, true).trigger('click')
await flushPromises()
return wrapper
}
describe('P2-10 后管上传/加载失败只把中文交给界面', () => {
beforeEach(() => {
vi.clearAllMocks()
versionApi.fetchSoftwareVersions.mockResolvedValue({ items: [] })
tutorialApi.fetchTutorialPackages.mockResolvedValue({ items: [] })
confirmMock.mockResolvedValue(true)
})
it('真实出口对照:英文原文一律被换成中文,原因段不拼半截句', () => {
expect(loadFailureMessage(new Error(RAW_ENGLISH), '上传失败')).toBe('上传失败')
expect(loadFailureMessage(new Error('分片会话不存在或已过期'), '上传失败'))
.toBe('上传失败:分片会话不存在或已过期')
})
it('安装包上传失败:界面文案不含英文原文,原文只进 console', async () => {
const warned = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
versionApi.uploadSoftwareVersion.mockRejectedValue(new Error(RAW_ENGLISH))
const wrapper = await submitZipUpload(RecordsSoftwareVersionPage, '例如:1.0.0', '上传软件版本')
const shown = wrapper.get('.upload-msg').text()
expect(shown, '英文异常原文仍在上屏').not.toContain('Broken pipe')
expect(shown).toContain('上传失败')
expect(
warned.mock.calls.some((call) => String(call.join(' ')).includes(RAW_ENGLISH)),
'原文要留在 console,否则支持同学对着后端日志无从核对',
).toBe(true)
warned.mockRestore()
})
it('教程包上传失败:同一条中文出口,不得再直落 error.message', async () => {
vi.spyOn(console, 'warn').mockImplementation(() => undefined)
tutorialApi.uploadTutorialPackage.mockRejectedValue(new Error(RAW_ENGLISH))
const wrapper = await submitZipUpload(RecordsTutorialPage, '例如:v2026.09 或留空', '上传教程包', '上传教程包')
const shown = wrapper.get('.upload-msg').text()
expect(shown, '英文异常原文仍在上屏').not.toContain('Broken pipe')
expect(shown).toContain('上传失败')
})
it('列表加载失败:LoadFailureBar 的文案也是中文', async () => {
vi.spyOn(console, 'warn').mockImplementation(() => undefined)
versionApi.fetchSoftwareVersions.mockRejectedValue(new Error('Internal Server Error'))
const wrapper = mount(RecordsSoftwareVersionPage, { global: { stubs } })
await flushPromises()
const shown = wrapper.text()
expect(shown).not.toContain('Internal Server Error')
expect(shown).toContain('版本列表加载失败')
expect(feedbackMock).toHaveBeenCalled()
})
// 写法收口的台账:两页四条 catch(列表/删除×2/上传)都必须把错误交给同一个出口。
it('两页不得再留 error instanceof Error ? error.message 那套写法', () => {
for (const file of [
'src/pages/records/RecordsSoftwareVersionPage.vue',
'src/pages/records/RecordsTutorialPage.vue',
]) {
const source = readFileSync(resolve(root, file), 'utf-8')
expect(source, `${file} 仍直落 error.message`).not.toMatch(/error instanceof Error \? error\.message/)
expect(source.match(/loadFailureMessage\(error,/g)?.length ?? 0, `${file} 的失败出口没接上`)
.toBeGreaterThanOrEqual(4)
expect(source).toMatch(/import \{ loadFailureMessage \} from '@\/components\/load-failure-model'/)
}
})
})
@@ -0,0 +1,210 @@
/**
* 密钥管理列表页「余额两列」的界面侧判据(2026-11-05 B83)。
*
* 读数本身在 `user-secret-model.ts` 里被那颗纯函数尺子钉着;这一支管的是**接上去的形状**:
* ① 两列都在,且 `<th>` 数=每行 `<td>` 数=空态行的 colspan —— 加列忘改 colspan 是本仓常踩的残行,
* 历史上专门为此写过提交说明,所以这里把它钉成算术关系而不是逐个数字;
* ② 有数时 LLM 列给人民币、代理列给次数,两者不混;
* ③ 整轮没取到时两列都是 `—`,**不是 0**(一格 0 会被读成「这人欠费了」);
* ④ 非超管少一列「分组」时,上述三个数仍然彼此相等。
*
* 跑法:`npx vitest run tests/mount/user-secret-balance-columns.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import UserSecretsPage from '@/pages/account/UserSecretsPage.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
fetchAdminSecretBalances: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
clearUserSecretModule: vi.fn(),
}))
vi.mock('@/api/user-secrets', () => secretsApi)
function moduleCell(moduleKey: string, over: Record<string, unknown> = {}) {
return {
moduleKey, moduleLabel: moduleKey, channel: null,
masked: 'sk-f****9BgQ', full: '', exists: true, locked: false,
checkStatus: 'passed', checkCode: 'ok', checkMessage: '连通正常',
checkLatencyMs: 12, checkedAt: '2026-11-05T10:30:00', updatedAt: '2026-11-05T10:30:00',
...over,
}
}
function row(userId: number, over: Record<string, unknown> = {}) {
return {
userId,
username: `user${userId}`,
groups: [],
leaderUsername: '',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'longtaitou' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 'longtaitou' }),
proxy: moduleCell('proxy', { moduleLabel: '代理设置', channel: 'jikip' }),
status: 'passed',
statusMessage: '三项均检测通过',
createdAt: '2026-11-01T09:00:00',
updatedAt: '2026-11-05T10:30:00',
...over,
}
}
function llmCells(userId: number) {
return [
{
moduleKey: 'appearance-patent', moduleLabel: '外观专利密钥',
channel: 'longtaitou', channelLabel: '龙抬头',
available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
},
{
moduleKey: 'similar-asin', moduleLabel: '货源查询密钥',
channel: 'longtaitou', channelLabel: '龙抬头',
available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
},
].map((cell) => (userId === 7 ? cell : { ...cell, balance: '12.5', availableBalance: '10', frozen: null }))
}
function indexByHeader(wrapper: VueWrapper<Element>, header: string) {
const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
const index = headers.findIndex((label) => label.includes(header))
expect(index, `表头里找不到「${header}」`).toBeGreaterThanOrEqual(0)
return index
}
function cellText(wrapper: VueWrapper<Element>, header: string, rowIndex = 0): string {
const index = indexByHeader(wrapper, header)
return wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index].text().trim()
}
function cellTitle(wrapper: VueWrapper<Element>, header: string, rowIndex = 0): string {
const index = indexByHeader(wrapper, header)
const cell = wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index]
return cell.find('.balance-line').attributes('title') ?? ''
}
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
useCompanyTabStore().setActiveId(1)
})
async function mountWith(rowValues: unknown[], balances?: unknown) {
secretsApi.fetchUserSecretList.mockResolvedValue({
items: rowValues, total: rowValues.length, page: 1, pageSize: 15, groupOptions: [],
})
secretsApi.fetchAdminSecretBalances.mockResolvedValue(
balances === undefined
? { items: rowValues.map((item: any) => ({ userId: item.userId, llm: llmCells(item.userId), proxy: { available: true, surplus: '1234', balance: '56', scope: 'user', message: null } })), deniedUserIds: [], timedOutUserIds: [] }
: balances,
)
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
return wrapper
}
describe('余额两列接在密钥管理列表上', () => {
it('表头数=行内格数=空态 colspan(加列忘改 colspan 直接红)', async () => {
const wrapper = await mountWith([row(7)])
const headerCount = wrapper.findAll('thead th').length
const cellCount = wrapper.findAll('tbody tr')[0].findAll('td').length
expect(cellCount, '每行的 td 数必须等于表头列数').toBe(headerCount)
expect(headerCount).toBe(12)
const emptyWrapper = await mountWith([])
const colspan = Number(emptyWrapper.find('tbody td').attributes('colspan'))
expect(colspan, '空态行的 colspan 必须跟着列数走').toBe(headerCount)
})
it('非超管少一列分组时,三个数仍然彼此相等', async () => {
useAdminSessionStore().user = { id: 2, username: 'leader', role: 'admin' }
const wrapper = await mountWith([row(7)])
const headerCount = wrapper.findAll('thead th').length
expect(headerCount).toBe(11)
expect(wrapper.findAll('tbody tr')[0].findAll('td').length).toBe(headerCount)
const emptyWrapper = await mountWith([])
expect(Number(emptyWrapper.find('tbody td').attributes('colspan'))).toBe(headerCount)
})
it('LLM 列给人民币读数,按渠道折成一行(同一个钱不排两遍)', async () => {
const wrapper = await mountWith([row(7)])
expect(cellText(wrapper, 'LLM 余额')).toBe('龙抬头 ¥88.89')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('外观专利密钥')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('货源查询密钥')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('取数于 2026-11-05 10:30')
})
it('代理列给次数并说清是谁的池子,不套 ¥', async () => {
const wrapper = await mountWith([row(7)])
const text = cellText(wrapper, '代理余量')
expect(text).toContain('你的套餐')
expect(text).toContain('1234 次')
expect(text).not.toContain('¥')
})
it('两列各读各的:LLM 列里不出现次数、代理列里不出现金额', async () => {
const wrapper = await mountWith([row(7)])
expect(cellText(wrapper, 'LLM 余额')).not.toMatch(/\d+\s*次/)
expect(cellText(wrapper, '代理余量')).not.toContain('¥')
})
it('整轮没取到时两列都是 —,一格都不许是 0', async () => {
const wrapper = await mountWith([row(7)], { items: [], deniedUserIds: [7], timedOutUserIds: [] })
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
expect(cellText(wrapper, '代理余量')).toBe('—')
expect(cellText(wrapper, 'LLM 余额')).not.toContain('0.00')
})
it('超预算的行说「本轮未应答」,不冒充欠费', async () => {
const wrapper = await mountWith([row(7)], {
items: [{ userId: 7, llm: [], proxy: { available: false, surplus: null, balance: null, scope: null, message: '上游未在本轮时间预算内应答,稍后重试;这不代表余量为 0' } }],
deniedUserIds: [],
timedOutUserIds: [7],
})
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
expect(cellText(wrapper, '代理余量')).toBe('查不了')
expect(cellTitle(wrapper, '代理余量')).toContain('不代表余量为 0')
})
it('余额接口整个失败也不把整页判成加载失败', async () => {
secretsApi.fetchUserSecretList.mockResolvedValue({ items: [row(7)], total: 1, page: 1, pageSize: 15, groupOptions: [] })
secretsApi.fetchAdminSecretBalances.mockRejectedValue(new Error('上游 502'))
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
expect(wrapper.findAll('tbody tr')).toHaveLength(1)
expect(wrapper.find('.load-failure-bar').exists(), '列表主数据在,就不该把整页报成加载失败').toBe(false)
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
})
it('点「刷新余额」重取一轮,不动列表请求', async () => {
const wrapper = await mountWith([row(7)])
const listCalls = secretsApi.fetchUserSecretList.mock.calls.length
await wrapper.findAll('.filter-actions button').at(-1)!.trigger('click')
await flushPromises()
expect(secretsApi.fetchAdminSecretBalances).toHaveBeenCalledTimes(2)
expect(secretsApi.fetchUserSecretList).toHaveBeenCalledTimes(listCalls)
})
})
@@ -0,0 +1,209 @@
/**
* 密钥管理列表页的脱敏与货源标签判据(2026-11-02 后端 `SecretMasking.maskProxy` 收口的界面侧)。
*
* 跑真组件+真 pinia store,API 用假数据顶掉:夹具里那条 `full` **故意带着假账密**
* (形状等同收口前的旧回包),用来证明界面这一侧不会把原文渲染出来——后端不下发是必要条件,
* 但界面留着 `row.proxy.full || row.proxy.masked` 那种回落时,旧包/灰度包照样会漏。
*
* 假值一律 fakekey/fakepwd(本仓有尺子按长度+高熵认凭据,长十六进制串哪怕编的也会点红)。
*
* 跑法:`npx vitest run tests/mount/user-secret-proxy-mask.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import UserSecretsPage from '@/pages/account/UserSecretsPage.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
clearUserSecretModule: vi.fn(),
}))
vi.mock('@/api/user-secrets', () => secretsApi)
const FAKE_KEY = 'fakekey'
const FAKE_PWD = 'fakepwd'
/** 收口前的旧回包形状:整条青果提取链接原文,查询段里带着 key/pwd。 */
const LEGACY_PROXY_LINK = `https://overseas.proxy.qg.net/get?key=${FAKE_KEY}&pwd=${FAKE_PWD}`
/** 收口后后端实际下发的脱敏值。 */
const MASKED_PROXY = 'https://overseas.proxy.qg.net'
function moduleCell(moduleKey: string, over: Record<string, unknown> = {}) {
return {
moduleKey,
moduleLabel: moduleKey,
channel: null,
masked: 'abcd****wxyz',
full: '',
exists: true,
locked: false,
checkStatus: 'passed',
checkCode: '',
checkMessage: '',
checkLatencyMs: 12,
checkedAt: '2026-11-02T10:00:00',
updatedAt: '2026-11-02T10:00:00',
...over,
}
}
function row(over: Record<string, unknown> = {}) {
return {
userId: 7,
username: 'alice',
groups: [],
leaderUsername: '',
similarAsin: moduleCell('similar-asin'),
appearancePatent: moduleCell('appearance-patent'),
proxy: moduleCell('proxy', { masked: MASKED_PROXY }),
status: 'passed',
statusMessage: '',
createdAt: '2026-11-01T09:00:00',
updatedAt: '2026-11-02T10:00:00',
...over,
}
}
function pageOf(items: unknown[]) {
return { items, total: items.length, page: 1, pageSize: 15, groupOptions: [] }
}
/** 按表头文字取该行对应 <td> 的文本(不靠列序数:加列就会全体错位)。 */
function cellText(wrapper: ReturnType<typeof mount>, header: string): string {
const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
const index = headers.findIndex((label) => label.includes(header))
expect(index, `表头里找不到「${header}」`).toBeGreaterThanOrEqual(0)
return wrapper.findAll('tbody tr')[0].findAll('td')[index].text()
}
describe('密钥管理页:代理列脱敏+货源标签分域', () => {
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
useCompanyTabStore().setActiveId(1)
})
async function mountWith(proxyChannel: string | null, fullValue: string = LEGACY_PROXY_LINK) {
secretsApi.fetchUserSecretList.mockResolvedValue(pageOf([
row({
similarAsin: moduleCell('similar-asin', { channel: 'longtaitou' }),
appearancePatent: moduleCell('appearance-patent', { channel: 't8star' }),
proxy: moduleCell('proxy', { channel: proxyChannel, masked: MASKED_PROXY, full: fullValue }),
}),
]))
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
return wrapper
}
it('代理列不渲染 key/pwd:整棵树(含 title 属性)都没有这两个值', async () => {
const wrapper = await mountWith('qingguo')
const markup = wrapper.html()
expect(markup).not.toContain(FAKE_KEY)
expect(markup).not.toContain(FAKE_PWD)
expect(markup).not.toContain('key=')
expect(markup).not.toContain('pwd=')
// 脱敏值照常显示,页面不是把整列抹白了事
expect(cellText(wrapper, '代理设置')).toContain(MASKED_PROXY)
})
it('代理列即便拿到旧形状的回包也只显示 masked,不回落原文', async () => {
const wrapper = await mountWith('qingguo', LEGACY_PROXY_LINK)
expect(cellText(wrapper, '代理设置')).toContain(MASKED_PROXY)
expect(cellText(wrapper, '代理设置')).not.toContain('get?')
})
it('masked 为空时留占位符:不许把 full 当兜底渲染出来', async () => {
// 后端对识别不了的形状(如无 host 的脏值)会给出空 masked;
// 界面这一侧若写成 `masked || full`,脱敏就等于没做——这一支就是钉住那条回落。
secretsApi.fetchUserSecretList.mockResolvedValue(pageOf([
row({
proxy: moduleCell('proxy', { channel: 'qingguo', masked: '', full: LEGACY_PROXY_LINK }),
}),
]))
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
expect(cellText(wrapper, '代理设置')).toContain('—')
expect(cellText(wrapper, '代理设置')).not.toContain(FAKE_KEY)
expect(wrapper.html()).not.toContain(FAKE_KEY)
expect(wrapper.html()).not.toContain(FAKE_PWD)
})
it('代理行贴的是供应商,不是 LLM 渠道名;密钥行仍显示渠道名', async () => {
const wrapper = await mountWith('qingguo')
const proxyCell = cellText(wrapper, '代理设置')
expect(proxyCell).toContain('青果')
expect(proxyCell).not.toContain('龙抬头')
expect(proxyCell).not.toContain('贞贞')
expect(cellText(wrapper, '货源查询密钥')).toContain('龙抬头')
expect(cellText(wrapper, '外观专利密钥')).toContain('贞贞')
})
it('代理行的 channel 被写成 LLM 渠道值时也不许贴出渠道名(合表就是这么错的)', async () => {
const wrapper = await mountWith('longtaitou')
const proxyCell = cellText(wrapper, '代理设置')
expect(proxyCell).not.toContain('龙抬头')
// 认不出的货源留占位,而不是硬认下一个具体名字
expect(proxyCell).toContain('—')
// 同一行上的密钥列不受影响
expect(cellText(wrapper, '货源查询密钥')).toContain('龙抬头')
})
it('页面上没有把原文带出界面的旁路:无复制/导出整条代理链接的入口', async () => {
const wrapper = await mountWith('qingguo')
const labels = wrapper.findAll('button').map((button) => button.text().trim())
expect(labels.some((label) => /复制|导出/.test(label)), `出现复制/导出入口:${labels.join('/')}`).toBe(false)
})
it('「改代理」打开的是重填表单:三个输入位都空,不给原文预填', async () => {
const wrapper = await mountWith('qingguo')
const openButton = wrapper.findAll('button').find((button) => button.text().trim() === '代填代理')
expect(openButton, '行内应有「代填代理」入口').toBeDefined()
await openButton!.trigger('click')
await flushPromises()
const inputs = wrapper.findAll('.modal input[type="text"], .modal input[type="password"]')
expect(inputs.length, '弹窗里应有账密/链接输入位').toBeGreaterThan(0)
for (const input of inputs) {
expect((input.element as HTMLInputElement).value, '不得预填任何已有值').toBe('')
}
expect(wrapper.html()).not.toContain(FAKE_KEY)
expect(wrapper.html()).not.toContain(FAKE_PWD)
})
it('保存把现拼的链接与这一单的供应商一起发出去,界面不留原文', async () => {
secretsApi.saveUserSecretModule.mockResolvedValue(moduleCell('proxy', { channel: 'qingguo' }))
const wrapper = await mountWith('qingguo')
const openButton = wrapper.findAll('button').find((button) => button.text().trim() === '代填代理')
await openButton!.trigger('click')
await flushPromises()
const fields = wrapper.findAll('.modal input[type="text"], .modal input[type="password"]')
await fields[0].setValue(FAKE_KEY)
await fields[1].setValue(FAKE_PWD)
const saveButton = wrapper.findAll('.modal button').find((button) => button.text().trim() === '保存')
expect(saveButton, '弹窗里应有「保存」').toBeDefined()
await saveButton!.trigger('click')
await flushPromises()
expect(secretsApi.saveUserSecretModule).toHaveBeenCalledTimes(1)
const [userId, moduleKey, value, channel] = secretsApi.saveUserSecretModule.mock.calls[0]
expect(userId).toBe(7)
expect(moduleKey).toBe('proxy')
expect(value).toBe(`https://overseas.proxy.qg.net/get?key=${FAKE_KEY}&pwd=${FAKE_PWD}`)
expect(channel).toBe('qingguo')
// 写请求发完,界面上仍然看不到那两个值
expect(wrapper.html()).not.toContain(FAKE_KEY)
expect(wrapper.html()).not.toContain(FAKE_PWD)
})
})
@@ -0,0 +1,263 @@
/**
* 密钥管理列表页「检测结果分档」的界面侧判据(2026-11-02)。
*
* 现网证据:库里 uid=1 的 proxy 行是 `check_status=error / check_code=channel_busy`,
* 数据是对的、界面不认识这个码,于是渲染成「无法判定」——管理员分不清
* 「被自己的采集占着(等 3 分钟再点)」「密钥坏了」「欠费」这三种完全不同的处置。
*
* 这一支跑真组件+真 pinia store,API 用假数据顶掉,逐档核对:
* ① 药丸文字与配色类名(`is-retry` 是新档,既不红也不黄);
* ② 悬停详情里能看到后端 `check_message` 原文(措辞权威在后端,界面只搬运);
* ③ 一格上的两颗药丸分别取 `channel`(货源)与 `check_status`/`check_code`(状态)——
* 把状态当渠道渲染(或反过来)会在这里红。
*
* 夹具里的凭据一律假值(fakekey/fakepwd/sk-fake),本仓有尺子按长度+高熵认凭据。
*
* 跑法:`npx vitest run tests/mount/user-secret-status-band.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import UserSecretsPage from '@/pages/account/UserSecretsPage.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
fetchAdminSecretBalances: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
clearUserSecretModule: vi.fn(),
}))
vi.mock('@/api/user-secrets', () => secretsApi)
/** 后端那句人话(CHANNEL_BUSY_MESSAGE 的形状):措辞权威在后端,界面只原样透出。 */
const BUSY_MESSAGE = '通道正被你自己的采集占着,等约 3 分钟释放后再点检测'
const BALANCE_MESSAGE = '代理服务商余额不足,请充值后重试'
const MASKED_PROXY = 'https://overseas.proxy.qg.net'
function moduleCell(moduleKey: string, over: Record<string, unknown> = {}) {
return {
moduleKey,
moduleLabel: moduleKey,
channel: null,
masked: 'sk-f****9BgQ',
full: '',
exists: true,
locked: false,
checkStatus: 'passed',
checkCode: 'ok',
checkMessage: '连通正常',
checkLatencyMs: 12,
checkedAt: '2026-11-02T15:51:07',
updatedAt: '2026-11-02T15:51:07',
...over,
}
}
function row(over: Record<string, unknown> = {}) {
return {
userId: 7,
username: 'alice',
groups: [],
leaderUsername: '',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'longtaitou' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 't8star' }),
proxy: moduleCell('proxy', { moduleLabel: '代理设置', channel: 'qingguo', masked: MASKED_PROXY }),
status: 'passed',
statusMessage: '三项均检测通过',
createdAt: '2026-11-01T09:00:00',
updatedAt: '2026-11-02T15:51:07',
...over,
}
}
/** 表头文字定位列(不靠列序数:加列就会全体错位),返回该格里的药丸。 */
function pills(wrapper: VueWrapper<Element>, header: string) {
const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
const index = headers.findIndex((label) => label.includes(header))
expect(index, `表头里找不到「${header}」`).toBeGreaterThanOrEqual(0)
return wrapper.findAll('tbody tr')[0].findAll('td')[index].findAll('.wh-pill').map((pill) => ({
text: pill.text().trim(),
classes: pill.classes(),
title: pill.attributes('title') ?? '',
}))
}
function cellText(wrapper: VueWrapper<Element>, header: string): string {
const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
const index = headers.findIndex((label) => label.includes(header))
return wrapper.findAll('tbody tr')[0].findAll('td')[index].text()
}
describe('密钥管理页:检测结果按 check_code 分档渲染', () => {
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
useCompanyTabStore().setActiveId(1)
})
async function mountWith(rowValue: Record<string, unknown>) {
secretsApi.fetchUserSecretList.mockResolvedValue({ items: [rowValue], total: 1, page: 1, pageSize: 15, groupOptions: [] })
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
return wrapper
}
/** 现网 uid=1 那一行的形状:error + channel_busy。 */
function busyRow() {
return row({
status: 'error',
statusMessage: '存在无法判定的检测结果',
proxy: moduleCell('proxy', {
moduleLabel: '代理设置',
channel: 'qingguo',
masked: MASKED_PROXY,
checkStatus: 'error',
checkCode: 'channel_busy',
checkMessage: BUSY_MESSAGE,
}),
})
}
it('channel_busy 渲染成「无可用通道」+独立配色,不再掉进「无法判定」', async () => {
const wrapper = await mountWith(busyRow())
const proxyPills = pills(wrapper, '代理设置')
const statusPill = proxyPills[proxyPills.length - 1]
expect(statusPill.text).toBe('无可用通道')
expect(statusPill.classes).toContain('is-retry')
expect(cellText(wrapper, '代理设置')).not.toContain('无法判定')
// 供应商那颗药丸还在原位:改的是状态档,不是把货源档挤掉
expect(proxyPills[0].text).toBe('青果')
expect(proxyPills[0].classes).toContain('is-source')
})
it('整行只剩「等一等」那一族时,行级状态列补成「可重试」', async () => {
const wrapper = await mountWith(busyRow())
const rowPill = pills(wrapper, '状态')[0]
expect(rowPill.text).toBe('可重试')
expect(rowPill.classes).toContain('is-retry')
expect(rowPill.text).not.toBe('无法判定')
})
it('混进一格「不会自己好」的问题时,行级不许谎报可重试', async () => {
const wrapper = await mountWith({
...busyRow(),
appearancePatent: moduleCell('appearance-patent', {
moduleLabel: '外观专利密钥',
channel: 't8star',
checkStatus: 'error',
checkCode: 'tunnel_unverified',
checkMessage: '这条链接里没有可用于隧道验连的账密,请重新填写',
}),
})
expect(pills(wrapper, '状态')[0].text).toBe('无法判定')
expect(pills(wrapper, '外观专利密钥').at(-1)!.text).toBe('链接缺账密')
})
it('悬停能看到后端 check_message 原文:单格与行级 tooltip 都带上', async () => {
const wrapper = await mountWith(busyRow())
const proxyStatusTitle = pills(wrapper, '代理设置').at(-1)!.title
expect(proxyStatusTitle).toContain(BUSY_MESSAGE)
expect(proxyStatusTitle).toContain(MASKED_PROXY, '脱敏值仍然在同一条 tooltip 里')
const rowTitle = pills(wrapper, '状态')[0].title
expect(rowTitle).toContain('存在无法判定的检测结果', '后端行级摘要不动')
expect(rowTitle).toContain(`代理设置:${BUSY_MESSAGE}`, '运维判「是欠费还是被自己占着」就靠这句')
})
it('欠费(现网 21 行)保留自己那一档,不被新码表挤去「无法判定」', async () => {
const wrapper = await mountWith(row({
status: 'failed',
statusMessage: '存在检测失败的配置',
proxy: moduleCell('proxy', {
moduleLabel: '代理设置',
channel: 'qingguo',
masked: MASKED_PROXY,
checkStatus: 'failed',
checkCode: 'insufficient_balance',
checkMessage: BALANCE_MESSAGE,
}),
}))
const balancePill = pills(wrapper, '代理设置').at(-1)!
expect(balancePill.text).toBe('欠费')
expect(balancePill.classes).toContain('is-warn')
expect(pills(wrapper, '状态')[0].text).toBe('检测失败', '行级优先级是后端的:failed 永远压过 error')
expect(pills(wrapper, '代理设置').at(-1)!.title).toContain(BALANCE_MESSAGE)
})
it('密钥坏了与查不出是两档:invalid_key 红、空码/未知码才是「无法判定」', async () => {
const wrapper = await mountWith(row({
status: 'error',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'longtaitou', checkStatus: 'failed', checkCode: 'invalid_key', checkMessage: '密钥无效(401)' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 't8star', checkStatus: 'error', checkCode: '', checkMessage: '' }),
proxy: moduleCell('proxy', { moduleLabel: '代理设置', channel: 'qingguo', masked: MASKED_PROXY, checkStatus: 'error', checkCode: 'a_code_not_registered', checkMessage: '' }),
}))
expect(pills(wrapper, '货源查询密钥').at(-1)!.text).toBe('密钥失效')
expect(pills(wrapper, '货源查询密钥').at(-1)!.classes).toContain('is-blocked')
expect(pills(wrapper, '外观专利密钥').at(-1)!.text).toBe('无法判定')
expect(pills(wrapper, '代理设置').at(-1)!.text).toBe('无法判定')
})
it('没配与没检测不许冒充「无法判定」', async () => {
const wrapper = await mountWith(row({
status: 'unknown',
statusMessage: '存在尚未检测的配置',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', exists: false, checkStatus: 'unknown', checkCode: '', checkMessage: '' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 't8star', checkStatus: 'unknown', checkCode: '', checkMessage: '' }),
}))
expect(pills(wrapper, '货源查询密钥').at(-1)!.text).toBe('未配置')
expect(cellText(wrapper, '货源查询密钥')).toContain('未配置')
expect(pills(wrapper, '外观专利密钥').at(-1)!.text).toBe('未检测')
expect(pills(wrapper, '状态')[0].text).toBe('未检测')
})
it('一格上的两颗药丸不同源:货源取 channel、状态取 check_status/check_code', async () => {
// 把代理供应商值塞进 LLM 行的 channel:货源那颗药丸必须认不出(走「—」),
// 状态那颗仍按 check_code 出「鉴权被拒」——两值互不串门,才是「不同源」的正证。
const wrapper = await mountWith(row({
status: 'failed',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'qingguo', checkStatus: 'failed', checkCode: 'forbidden', checkMessage: '密钥被拒绝(403)' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 't8star', checkStatus: 'passed', checkCode: 'ok' }),
}))
const similarPills = pills(wrapper, '货源查询密钥')
expect(similarPills[0].text).toBe('—')
expect(similarPills[1].text).toBe('鉴权被拒')
// 反向:把状态词塞进渠道位也不会被认成货源
const llmPills = pills(wrapper, '外观专利密钥')
expect(llmPills[0].text).toBe('贞贞')
expect(llmPills[1].text).toBe('通过')
expect(llmPills[0].classes).toContain('is-source')
expect(llmPills[1].classes).toContain('is-allowed')
})
it('筛选项把 error 这一档的两个可能读法都点名(选了要能筛到无可用通道的行)', async () => {
const wrapper = await mountWith(busyRow())
const options = wrapper.findAll('.secrets-filter-row select')[0].findAll('option').map((option) => option.text().trim())
expect(options).toContain('无法判定/可重试')
expect(options).not.toContain('无法判定')
})
it('立即检测的 toast 用后端那句原文,不再硬写「无法判定」', async () => {
secretsApi.fetchUserSecretList.mockResolvedValue({ items: [busyRow()], total: 1, page: 1, pageSize: 15, groupOptions: [] })
secretsApi.checkUserSecret.mockResolvedValue([
{ moduleKey: 'proxy', checkStatus: 'error', checkCode: 'channel_busy', checkMessage: BUSY_MESSAGE, checkLatencyMs: 30, checkedAt: '2026-11-02T15:51:07', viaProxy: false },
])
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
const checkButton = wrapper.findAll('button').find((button) => button.text().trim() === '立即检测')
expect(checkButton, '行内应有「立即检测」入口').toBeDefined()
await checkButton!.trigger('click')
await flushPromises()
// ElMessage 真渲染进 body:读的是那一句后端原文,不是界面自己拼的「部分配置本次无法判定」
const shown = document.body.textContent ?? ''
expect(shown).toContain(BUSY_MESSAGE)
expect(shown).not.toContain('部分配置本次无法判定')
})
})
@@ -0,0 +1,107 @@
/**
* 用户管理页 × 平台 tab(V206)的挂载契约:
* 账号域三页两 tab 共用组件,列表请求必须带 platform=当前平台;切 tab 重取数;
* 「上架上限」列仅京东侧渲染(用户口径「不需要在亚马逊那边」),文案 0=不限/null=-。
* 不用 readFileSync(source-pin-ratchet 对台账外新文件带读点即红),全部走真实挂载断言。
*
* 跑法:`npx vitest run tests/mount/users-page-platform.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import UsersPage from '@/pages/account/UsersPage.vue'
import { usePlatformTabStore } from '@/stores/platform-tab'
import { useAdminSessionStore } from '@/stores/admin-session'
const usersApi = vi.hoisted(() => ({
fetchUserList: vi.fn(),
deleteUser: vi.fn(),
setUserDisabled: vi.fn(),
}))
vi.mock('@/api/users', () => usersApi)
vi.mock('@/api/companies', () => ({ fetchCompanies: vi.fn().mockResolvedValue([]) }))
vi.mock('@/pages/account/user-menu-auth-api', () => ({ loadUserMenuAuth: vi.fn() }))
function pageOf(total = 0) {
return {
items: [
{ id: 7, username: '京东号', role: 'normal', platform: 'jd' },
{ id: 8, username: '存量号', role: 'admin', jdPublishQuota: 0 },
{ id: 9, username: '老号', role: 'normal', jdPublishQuota: 800 },
{ id: 10, username: '没配号', role: 'normal' },
],
total,
page: 1,
pageSize: 10,
}
}
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
window.localStorage.removeItem('admin-platform-tab')
pinia = createPinia()
setActivePinia(pinia)
const session = useAdminSessionStore()
session.user = { id: 1, username: 'root', role: 'super_admin' }
usersApi.fetchUserList.mockResolvedValue(pageOf())
})
describe('UsersPage × 平台 tab(V206)', () => {
it('亚马逊 tab(默认):列表请求带 platform=amazon,无「上架上限」列', async () => {
const wrapper = mount(UsersPage)
await flushPromises()
expect(usersApi.fetchUserList).toHaveBeenCalledTimes(1)
const params = usersApi.fetchUserList.mock.calls[0][0] as Record<string, unknown>
expect(params.platform).toBe('amazon')
expect(params).toHaveProperty('companyId')
const headers = wrapper.findAll('thead th').map((th) => th.text())
expect(headers).not.toContain('上架上限')
// 亚马逊侧表头 9 列(存量表头,quota 列不渲染)
expect(headers.length).toBe(9)
wrapper.unmount()
})
it('切到京东 tab:重取数并带 platform=jd,「上架上限」列出现,文案 0=不限/null=-', async () => {
const wrapper = mount(UsersPage)
await flushPromises()
const platformTab = usePlatformTabStore()
platformTab.setActive('jd')
await flushPromises()
expect(usersApi.fetchUserList).toHaveBeenCalledTimes(2)
const params = usersApi.fetchUserList.mock.calls[1][0] as Record<string, unknown>
expect(params.platform).toBe('jd')
const headers = wrapper.findAll('thead th').map((th) => th.text())
expect(headers).toContain('上架上限')
expect(headers.length).toBe(10)
// quota 单元格:0=不限(存量号 8),null/缺省=-(京东号 7、没配号 10),800 原样
const quotaCells = wrapper.findAll('tbody tr').map((tr) => {
const tds = tr.findAll('td')
// 上架上限列在第 5 列(ID/用户名/角色/所属管理员/到期时间 之后)
return tds[5]?.text()
})
expect(quotaCells).toEqual(['-', '不限', '800', '-'])
wrapper.unmount()
})
it('切回亚马逊 tab:再次重取数且列消失(两 tab 各看各的数据面)', async () => {
const wrapper = mount(UsersPage)
await flushPromises()
const platformTab = usePlatformTabStore()
platformTab.setActive('jd')
await flushPromises()
platformTab.setActive('amazon')
await flushPromises()
expect(usersApi.fetchUserList).toHaveBeenCalledTimes(3)
const params = usersApi.fetchUserList.mock.calls[2][0] as Record<string, unknown>
expect(params.platform).toBe('amazon')
expect(wrapper.findAll('thead th').map((th) => th.text())).not.toContain('上架上限')
wrapper.unmount()
})
})
@@ -36,6 +36,8 @@ const OPS_MIN_COL_PX: Record<string, number> = {
'src/pages/asin/ProductCategoryPage.vue': 138,
'src/pages/asin/QueryAsinPage.vue': 138,
'src/pages/asin/SkipPricePage.vue': 138,
// 京东分类管理页(V204)2026-11-17 下线:CRUD 并入京东数据库页「分类管理」对话框
// (对话框无表格操作列,不进本表)。
'src/pages/records/DeviceLogsPage.vue': 138,
'src/pages/records/RecordsDigitalHumanVersionPage.vue': 287,
'src/pages/records/RecordsSoftwareVersionPage.vue': 77,
@@ -0,0 +1,93 @@
// AC-11(R4):后管版本/教程大档上传接线的「源码尺子」那一半。
//
// Pending Phase 4 激活。本尺子的前身只断言 `files/chunk` 出现在非注释行,而那一句匹配来自
// `version-api.ts`/`tutorial-api.ts` 里一对**全仓零引用的死常量**(SOFTWARE_VERSION_CHUNK_ENDPOINT/
// TUTORIAL_CHUNK_ENDPOINT)——把真调用 `uploadFileInChunks(…)` 删掉,尺子照样绿(评审 P2-6 假绿形状)。
// 现在判据钉在**真调用点**上:被接线的那个函数体里必须出现 `uploadFileInChunks(`,
// 且死常量不许回来(`CHUNK_ENDPOINT =` 一出现即红)。删调用必判红,加死常量也判红。
//
// 行为口径在 tests/pure/pending-phase4-大档上传接线.test.ts(vitest 真调 uploadSoftwareVersion/
// uploadTutorialPackage,删掉调用同一刻那一边也红);本文件只补"接线没被搬空"这一层。
//
// 跑法:npm test(node --test tests/*.test.ts)。
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { readFileSync } from 'node:fs'
import { dirname, resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
const here = dirname(fileURLToPath(import.meta.url))
const root = resolve(here, '..')
/** 把注释整段涂白(保行数):接线只写在注释里不算数。 */
function blankComments(source: string): string {
return source
.replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, ' '))
.replace(/\/\/[^\n]*/g, (line) => ' '.repeat(line.length))
}
/** 取 `function <name>(…) {…}` 的函数体:大括号配对,跳过字符串与模板串里的括号。 */
function functionBodyOf(source: string, name: string): string {
const code = blankComments(source)
const head = code.indexOf(`function ${name}(`)
assert.notEqual(head, -1, `找不到函数 ${name}()——接线被删了还是改名了?`)
const open = code.indexOf('{', head)
assert.notEqual(open, -1, `${name}() 没有函数体`)
let depth = 0
let index = open
let quote = ''
for (; index < code.length; index += 1) {
const char = code[index]
if (quote) {
if (char === '\\') index += 1
else if (char === quote) quote = ''
continue
}
if (char === '"' || char === "'" || char === '`') { quote = char; continue }
if (char === '{') depth += 1
else if (char === '}') {
depth -= 1
if (depth === 0) return code.slice(open + 1, index)
}
}
return code.slice(open + 1)
}
/**
* 两格共同判据(读盘点留在用例体内:把 readFileSync 挪进 helper 是本仓 source-pin 棘轮点名的"搬家不算改进"):
* ① 从 @/api/chunk-upload 把分片函数引进来;② 被接线的函数体里真的调它;
* ③ 阈值同源;④ 死常量不得回来。
*/
function assertChunkedWiring(source: string, file: string, wiredFunction: string): void {
assert.match(
source,
/import\s*\{[^}]*uploadFileInChunks[^}]*\}\s*from\s*'@\/api\/chunk-upload'/,
`AC-11:${file} 没有从 @/api/chunk-upload 引入分片函数`,
)
const body = functionBodyOf(source, wiredFunction)
assert.match(
body,
/uploadFileInChunks\s*\(/,
`AC-11:${file}::${wiredFunction}() 里没有真调用 uploadFileInChunks(…)(大档仍走一次 PUT 直传,512MB 断网从 0 重来)`,
)
assert.match(
body,
/CHUNK_UPLOAD_THRESHOLD/,
`AC-11:${wiredFunction}() 的选路阈值必须与 chunk-upload 同源,不得各自写死 8MB`,
)
assert.doesNotMatch(
source,
/CHUNK_ENDPOINT\s*=/,
`AC-11:${file} 又立了一个没人引用的 CHUNK_ENDPOINT 常量——它会顶掉本尺子的匹配来源,正是 P2-6 的假绿形状`,
)
}
test('后管安装包上传必须真的调分片通道', () => {
const file = 'src/pages/records/version-api.ts'
assertChunkedWiring(readFileSync(resolve(root, file), 'utf-8'), file, 'uploadSoftwareVersion')
})
test('后管教程包上传必须真的调分片通道', () => {
const file = 'src/pages/records/tutorial-api.ts'
assertChunkedWiring(readFileSync(resolve(root, file), 'utf-8'), file, 'uploadTutorialPackage')
})
@@ -0,0 +1,130 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import { toCreateUserRequest, createEmptyCreateUserForm } from '../src/pages/account/user-create-model.ts'
import {
fillEditUserForm,
toEditUserUpdateRequest,
validateEditUserForm,
} from '../src/pages/account/user-edit-model.ts'
import { toShopGroupCreatePayload, toShopGroupUpdatePayload } from '../src/pages/account/shop-group-model.ts'
import { toCompanyPayload } from '../src/api/companies-dto.ts'
/**
* 账号域三页按平台 tab 分列(V206,2026-11-17 用户口径「这些亚马逊这边也要有……数据都是新的
* 别把亚马逊的带过来」):users/company/biz_shop_manage_group 三表加 platform 列,存量默认亚马逊;
* 前端同一套组件两 tab 共显,请求带 platform=当前 tab,弹窗单选默认当前平台、可翻档归侧。
* 上架上限(jd_publish_quota)只属京东口径:编辑弹窗隐藏 + 校验/下发都跳过 + 列表列仅京东侧。
*/
// ---------- 纯函数:payload 的 platform 下发与翻档 ----------
test('建号 payload 恒带 platform:京东 tab 建的号默认归京东,单选翻档即改归属', () => {
const jd = toCreateUserRequest({ ...createEmptyCreateUserForm(), username: 'a', password: 'secret123', platform: 'jd' })
assert.equal(jd.platform, 'jd')
const amazon = toCreateUserRequest({ ...createEmptyCreateUserForm(), username: 'a', password: 'secret123' })
assert.equal(amazon.platform, 'amazon', '空表单缺省亚马逊(存量口径),后端 normalizeOrCreate 同口径兜底')
})
test('编辑回填 platform:行值 jd→jd,缺省/未知→amazon;请求体恒下发 platform(翻档即挪列)', () => {
const jdForm = fillEditUserForm({ id: 7, username: '京东号', role: 'normal', platform: 'jd' })
assert.equal(jdForm.platform, 'jd')
assert.equal(toEditUserUpdateRequest(jdForm).platform, 'jd')
const legacy = fillEditUserForm({ id: 8, username: '存量号', role: 'normal' })
assert.equal(legacy.platform, 'amazon', '旧负载没有 platform 时归亚马逊(存量默认),不许渲染成空串')
assert.equal(toEditUserUpdateRequest(legacy).platform, 'amazon', 'platform 恒下发:单选恒渲染,后端显式才落')
})
test('includeQuota=false(亚马逊侧编辑):不下发 jdPublishQuota,校验也跳过;platform 照常下发', () => {
const form = fillEditUserForm({ id: 3, username: '管理员', role: 'admin', jdPublishQuota: 800 })
const amazon = toEditUserUpdateRequest(form, { includeQuota: false })
assert.equal('jdPublishQuota' in amazon, false, '亚马逊侧不许把表单里的 quota 值带给后端(字段留在京东口径)')
assert.equal(amazon.platform, 'amazon')
// 亚马逊侧 quota 校验跳过:表单残留的非法值不再拦保存(该值根本不下发)。
form.jdPublishQuota = -1
assert.equal(validateEditUserForm(form, { includeQuota: false }).valid, true)
assert.equal(validateEditUserForm(form).valid, false, '京东侧(缺省 options)仍按原口径拦非法值')
})
test('分组 payload 的 platform:创建/更新显式下发,缺省(旧调用方)不带——后端 normalizeOrCreate 兜底', () => {
const created = toShopGroupCreatePayload('京东组', [2, 3], 9, 'jd')
assert.equal(created.platform, 'jd')
const createdLegacy = toShopGroupCreatePayload('旧组', [], 9)
assert.equal('platform' in createdLegacy, false, '不传 platform 的调用形状不变(重载式扩展)')
const updated = toShopGroupUpdatePayload('翻档组', [2], 'amazon')
assert.equal(updated.platform, 'amazon')
const updatedLegacy = toShopGroupUpdatePayload('旧组', [])
assert.equal('platform' in updatedLegacy, false)
})
test('公司 payload 的 platform:显式才下发(company-directory 的 deepEqual 形状不受存量影响)', () => {
const withPlatform = toCompanyPayload({ companyName: '福州数富', status: 1, remark: '', platform: 'jd' })
assert.equal(withPlatform.platform, 'jd')
const legacy = toCompanyPayload({ companyName: '厦门米椿花', status: 1, remark: '' })
assert.equal('platform' in legacy, false, '不带 platform 的草稿请求体形状不变')
})
// ---------- 源码钉:三页接线 + 弹窗默认平台 + quota 仅京东侧 ----------
test('UsersPage:列表请求带当前平台、切平台重取数、上架上限列仅京东侧渲染', () => {
const page = readSource('src/pages/account/UsersPage.vue')
assert.match(page, /platform: platformTab\.active/,
'列表请求必须带 platform=当前平台 tab(users.ts 从原始入参读,白名单构造不收它)')
assert.match(page, /watch\(\(\) => platformTab\.active/,
'切平台 tab 必须重取数:账号域三页两 tab 共用组件,列表按平台过滤')
assert.match(page, /:platform="platformTab\.active"/, '新建/编辑弹窗要拿到当前平台(默认平台 + quota 可见性)')
assert.match(page, /v-if="isJdSide" style="width: 110px">上架上限</,
'上架上限列只许京东侧渲染(用户口径「不需要在亚马逊那边」)')
assert.match(page, /quotaCellText/, 'quota 单元格文案走函数(null=-、0=不限、其余条数)')
assert.match(page, /const isJdSide = computed/, '京东侧判定单一出处')
})
test('GroupsPage:分组列表带平台、切平台重取数、编辑弹窗拿当前平台', () => {
const page = readSource('src/pages/account/GroupsPage.vue')
assert.match(page, /fetchShopGroups\(companyTab\.requestCompanyId, platformTab\.active\)/,
'分组列表同时收公司(钉住的取值口)与平台两个口径')
assert.match(page, /watch\(\(\) => platformTab\.active/, '切平台 tab 必须重取数')
assert.match(page, /:platform="platformTab\.active"/, '新建分组弹窗默认落当前平台')
})
test('CompaniesPage:公司列表带平台、切平台重取数、编辑弹窗拿当前平台', () => {
const page = readSource('src/pages/account/CompaniesPage.vue')
assert.match(page, /fetchCompanies\(platformTab\.active\)/, '公司列表按当前平台过滤')
assert.match(page, /watch\(\(\) => platformTab\.active/, '切平台 tab 必须重取数')
assert.match(page, /:platform="platformTab\.active"/, '新建公司弹窗默认落当前平台')
})
test('EditUserDialog:上架上限仅京东侧显示且不参与亚马逊侧提交;所属平台单选恒在', () => {
const dialog = readSource('src/pages/account/EditUserDialog.vue')
assert.match(dialog, /v-if="includeQuota && \(targetIsCompanySuperAdmin \|\| form\.role === 'admin'\)"/,
'quota 项必须叠上 includeQuota(京东侧)条件——只按角色判断会把该项带进亚马逊侧弹窗')
assert.match(dialog, /submitEditUser\(form, \{ includeQuota: includeQuota\.value \}\)/,
'提交必须透传 includeQuota:亚马逊侧校验与下发都跳过 quota')
assert.match(dialog, /validateEditUserForm\(form, \{ includeQuota: includeQuota\.value \}\)/,
'校验与下发同口径(校验过了但不下发 = 静默改值)')
assert.match(dialog, /v-model="form\.platform"/, '所属平台单选恒在:翻档是把记录挪到另一平台列表的唯一入口')
assert.match(dialog, /props\.platform === 'jd'/, 'includeQuota 取自页面透传的当前平台')
assert.match(dialog, /form\.platform = base\.platform/, '打开弹窗必须回填行值(旧负载缺省归亚马逊)')
})
test('CreateUserDialog/GroupEditorDialog/CompanyEditorDialog:新建默认当前平台、编辑回填行值', () => {
const create = readSource('src/pages/account/CreateUserDialog.vue')
assert.match(create, /form\.platform = props\.platform \?\? 'amazon'/, '建号默认当前平台 tab')
assert.match(create, /v-model="form\.platform"/, '所属平台单选在')
const group = readSource('src/pages/account/GroupEditorDialog.vue')
assert.match(group, /groupPlatform\.value = props\.platform \?\? 'amazon'/, '新建分组默认当前平台 tab')
assert.match(group, /props\.group\.platform === 'jd' \? 'jd' : 'amazon'/, '编辑分组回填行值')
assert.match(group, /createShopGroup\(groupName\.value, memberIds\.value, operatorId, groupPlatform\.value\)/,
'创建分组必须带平台')
assert.match(group, /updateShopGroup\(props\.group\.id, groupName\.value, memberIds\.value, groupPlatform\.value\)/,
'更新分组必须带平台(翻档归侧)')
assert.doesNotMatch(group, /companyTab/, '分组弹窗不读公司 tab(既有口径:候选按组长公司取人)')
const company = readSource('src/pages/account/CompanyEditorDialog.vue')
assert.match(company, /platform: props\.platform \?\? 'amazon'/, '新建公司默认当前平台 tab')
assert.match(company, /props\.company\.platform === 'jd' \? 'jd' : 'amazon'/, '编辑公司回填行值')
})
@@ -0,0 +1,134 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import type { AdminMenuNode } from '../src/types/admin.ts'
import {
BOTH_PLATFORM_MENU_KEYS,
JD_MENU_KEYS,
PLATFORM_TABS,
platformsOfMenuKey,
} from '../src/config/platform-scope.ts'
import { filterMenuTreeByPlatform, visiblePlatformsFor } from '../src/layout/platform-menu-filter.ts'
import { adminPages } from '../src/router/routes.ts'
/** 2026-11-16 用户定案「亚马逊/京东不混一起」:侧边栏顶部加平台 tab,京东侧=截图圈定
* 数据页(京东数据库/分类管理)。2026-11-17 用户口径「这些亚马逊这边也要有」:账号域三页
* (用户管理/分组管理/公司管理)改为双侧显示(BOTH_PLATFORM_MENU_KEYS),同一组件按当前
* tab 传 platform 过滤各自数据。tab 只做显示分组——菜单可见性仍由 session.menuTree(后端
* 按权限裁剪)决定,这里钉的是「分侧归属」与「空侧隐藏」两条形状。
* 辅助定义在所有 test 之前:node:test 的用例回调按声明序执行,挪到文件尾会踩 TDZ。 */
const node = (key: string, name: string, route?: string, children?: AdminMenuNode[]): AdminMenuNode => {
const out: AdminMenuNode = { key, name }
if (route) out.route = route
if (children) out.children = children
return out
}
/** 侧边栏实测形状的缩影:账号与权限(混编京东侧账号菜单与亚马逊侧配置/密钥菜单)+数据管理。 */
const TREE: AdminMenuNode[] = [
node('admin_group_account', '账号与权限', undefined, [
node('admin_columns', '菜单权限配置', '/account/menus'),
node('admin_users', '用户管理', '/account/users'),
node('admin_group_manage', '分组管理', '/account/groups'),
node('admin_user_secrets', '密钥管理', '/account/user-secrets'),
node('admin_user_secret_usage', '密钥用量统计', '/account/user-secret-usage'),
node('admin_companies', '公司管理', '/account/companies'),
]),
node('admin_group_data', '数据管理', undefined, [
node('admin_dedupe_total_data', '去重数据汇总', '/asin-center/registry'),
node('admin_invalid_asin_data', '品牌数据库', '/asin-center/invalid'),
node('admin_query_asin', '查询ASIN', '/asin-center/query'),
node('admin_appearance_patent_clean_items', '外观专利数据库', '/patent-center/clean-items'),
node('admin_jd_database', '京东数据库', '/jd-center/database'),
node('admin_product_categories', '商品类目', '/asin-center/categories'),
]),
]
function groupChildKeys(filtered: AdminMenuNode[], groupKey: string): string[] {
const group = filtered.find((item) => item.key === groupKey)
return (group?.children || []).map((child) => child.key)
}
test('menuKey 平台归属:京东独占即 [jd],双侧清单即两侧,其余(含分组 key 与未知 key)一律 [amazon]', () => {
for (const key of JD_MENU_KEYS) assert.deepEqual(platformsOfMenuKey(key), ['jd'], key)
for (const key of BOTH_PLATFORM_MENU_KEYS) assert.deepEqual(platformsOfMenuKey(key), ['amazon', 'jd'], key)
assert.deepEqual(platformsOfMenuKey('admin_query_asin'), ['amazon'])
assert.deepEqual(platformsOfMenuKey('admin_columns'), ['amazon'])
assert.deepEqual(platformsOfMenuKey('admin_group_account'), ['amazon'])
assert.deepEqual(platformsOfMenuKey('admin_jd_unknown_future'), ['amazon'])
assert.deepEqual(platformsOfMenuKey(''), ['amazon'])
})
test('京东 tab:账号与权限只余双侧三项,数据管理只余京东独占页(2026-11-17 分类管理并入京东数据库页后只剩数据库一页);顺序与 route 原样透传', () => {
const filtered = filterMenuTreeByPlatform(TREE, 'jd')
assert.deepEqual(filtered.map((item) => item.key), ['admin_group_account', 'admin_group_data'])
assert.deepEqual(groupChildKeys(filtered, 'admin_group_account'),
['admin_users', 'admin_group_manage', 'admin_companies'])
// 2026-11-17 晚用户口径「京东分类管理并到京东数据库分类编辑里」:分类管理子菜单
// (V204)下线,京东侧数据管理组只剩京东数据库一页。
assert.deepEqual(groupChildKeys(filtered, 'admin_group_data'), ['admin_jd_database'])
const jd = filtered[1].children![0]
assert.equal(jd.route, '/jd-center/database')
assert.equal(jd.name, '京东数据库')
})
test('亚马逊 tab:除京东独占页外全数保留(含 2026-11-17 回归的双侧账号域三页),分组结构不变', () => {
const filtered = filterMenuTreeByPlatform(TREE, 'amazon')
assert.deepEqual(groupChildKeys(filtered, 'admin_group_account'),
['admin_columns', 'admin_users', 'admin_group_manage', 'admin_user_secrets',
'admin_user_secret_usage', 'admin_companies'])
assert.deepEqual(groupChildKeys(filtered, 'admin_group_data'),
['admin_dedupe_total_data', 'admin_invalid_asin_data', 'admin_query_asin',
'admin_appearance_patent_clean_items', 'admin_product_categories'])
})
test('子项全归另一平台的分组整组隐藏(空分组不画);未知 key 默认归亚马逊侧', () => {
const mixed: AdminMenuNode[] = [
node('admin_group_shop', '店铺管理', undefined, [
node('admin_shop_manage', '店铺管理', '/shop-center/shops'),
node('admin_shop_keys', '店铺密钥管理', '/shop-center/keys'),
]),
node('admin_jd_database', '京东数据库', '/jd-center/database'),
node('admin_history', '生成记录', '/records/history'),
]
const jd = filterMenuTreeByPlatform(mixed, 'jd')
assert.deepEqual(jd.map((item) => item.key), ['admin_jd_database'],
'店铺管理组子项全在亚马逊侧 ⇒ 京东 tab 整组剪掉;生成记录未知 key 默认亚马逊')
const amazon = filterMenuTreeByPlatform(mixed, 'amazon')
assert.deepEqual(amazon.map((item) => item.key), ['admin_group_shop', 'admin_history'])
})
test('tab 显示依据:两侧都有可见页才画 tab 条,仅一侧授权时另一侧自动隐藏', () => {
assert.deepEqual(visiblePlatformsFor(TREE), ['amazon', 'jd'], '顺序固定随 PLATFORM_TABS')
const amazonOnly: AdminMenuNode[] = [
node('admin_group_data', '数据管理', undefined, [
node('admin_dedupe_total_data', '去重数据汇总', '/asin-center/registry'),
]),
]
assert.deepEqual(visiblePlatformsFor(amazonOnly), ['amazon'],
'只授权亚马逊侧(无京东数据库)的用户只看到亚马逊 tab')
const jdOnly: AdminMenuNode[] = [
node('admin_group_data', '数据管理', undefined, [node('admin_jd_database', '京东数据库', '/jd-center/database')]),
]
assert.deepEqual(visiblePlatformsFor(jdOnly), ['jd'])
assert.deepEqual(visiblePlatformsFor([]), [])
assert.deepEqual(visiblePlatformsFor(null), [])
})
test('平台 tab 定义与两份菜单清单钉死(防清单漂移):京东独占仅数据库一页、双侧共用账号域三页', () => {
assert.deepEqual(PLATFORM_TABS, [
{ id: 'amazon', label: '亚马逊' },
{ id: 'jd', label: '京东' },
])
// 2026-11-17 晚分类管理(admin_jd_category_manage)并入京东数据库页后从清单摘除。
assert.deepEqual([...JD_MENU_KEYS], ['admin_jd_database'])
assert.deepEqual([...BOTH_PLATFORM_MENU_KEYS].sort(),
['admin_companies', 'admin_group_manage', 'admin_users'])
})
test('两份清单的每一条都必须在路由注册表登记(同 company-menu-route 护栏形状:少登记=看得见点进去404)', () => {
const registered = new Set(adminPages.map((page) => page.menuKey))
for (const key of [...JD_MENU_KEYS, ...BOTH_PLATFORM_MENU_KEYS]) {
assert.ok(registered.has(key), `平台侧菜单 key "${key}" 未在 src/router/routes.ts 登记 menuKey`)
}
})
@@ -0,0 +1,226 @@
// P2-7/P2-8/P3-5(后管分片通道 AC-9/AC-11 精神)。
//
// 评审实录:`src/api/chunk-upload.ts` 每次调用都新 init 一个 upload_id ⇒ 紧随的 GET 必空、
// 放弃时又把会话 DELETE 掉,**等于根本没有续传**;逐片超时还按整包体积算(120s + MB×15s),
// 8MB 的片能拿到约 130 分钟。本文件按用户端 `shared/api/upload.ts` 的同一口径钉四件事:
// ① 同一文件身份复用 upload_id(不重新 init);② 瞬态失败不 DELETE、会话留在本地供下次续传;
// ③ 只有服务端确实说会话没了(404/「不存在或已过期」)才重开;④ 逐片超时按本片体积给。
//
// 跑法:npm run test:mount(tests/pure/** 与 tests/mount/** 同走 vitest)。
import { beforeEach, describe, expect, it, vi } from 'vitest'
const mocks = vi.hoisted(() => ({
post: vi.fn(),
get: vi.fn(),
delete: vi.fn(),
}))
// 只顶掉 http 实例,unwrap 用真的:会话回收在后端是 HTTP 200+success:false,
// 判因逻辑要吃真实解包语义(含中文文案把关),换桩会把这一半形状测漏。
vi.mock('@/api/http', async (importOriginal) => {
const actual = await importOriginal<{ unwrap: <T>(payload: unknown) => T }>()
return {
...actual,
http: { post: mocks.post, get: mocks.get, delete: mocks.delete },
}
})
import {
CHUNK_UPLOAD_PART_SIZE,
CHUNK_UPLOAD_THRESHOLD,
chunkSessionKeyOf,
partTimeoutOf,
uploadFileInChunks,
} from '@/api/chunk-upload'
const RESUMED_ID = 'r'.repeat(32)
const FRESH_ID = 'n'.repeat(32)
function axiosResponse(status: number, body: unknown) {
return { status, data: body }
}
function javaOk(body: unknown) {
return axiosResponse(200, { success: true, message: '', data: body })
}
function makeFile(name: string, bytes: number): File {
return new File([new Uint8Array(bytes)], name, { type: 'application/octet-stream' })
}
function seedSession(file: File, uploadId: string): void {
localStorage.setItem(chunkSessionKeyOf(file.name, file), JSON.stringify({
uploadId,
size: file.size,
lastModified: file.lastModified,
}))
}
function storedUploadId(file: File): string {
const raw = localStorage.getItem(chunkSessionKeyOf(file.name, file))
if (!raw) return ''
return String((JSON.parse(raw) as { uploadId?: unknown }).uploadId ?? '')
}
function postedUrls(): string[] {
return mocks.post.mock.calls.map(([url]) => String(url))
}
function partPosts(): Array<{ url: string; timeout: number }> {
return mocks.post.mock.calls
.filter(([url]) => /\/part\/\d+$/.test(String(url)))
.map(([url, , config]) => ({
url: String(url),
timeout: Number((config as { timeout?: unknown } | undefined)?.timeout ?? -1),
}))
}
function initCount(): number {
return postedUrls().filter((url) => url.includes('/chunk/init')).length
}
/** init/逐片/complete 一律成功;complete 返回拼装后的 fileKey。 */
function routePosts(uploadId: string) {
mocks.post.mockImplementation((url: string) => Promise.resolve(
String(url).includes('/chunk/init')
? javaOk({ upload_id: uploadId, total_parts: 2 })
: String(url).includes('/complete')
? javaOk({ fileKey: 'tmp/pkg.zip', originalFilename: 'pkg.zip', size: 1 })
: javaOk({ upload_id: String(url).split('/')[5], received_parts: 1 }),
))
}
describe('P2-7 后管分片必须真的续传', () => {
beforeEach(() => {
vi.clearAllMocks()
localStorage.clear()
routePosts(FRESH_ID)
})
it('同一文件身份复用 upload_id:探测成功就一条 init 都不许发', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(javaOk({ upload_id: RESUMED_ID, uploaded_parts: [0] }))
await uploadFileInChunks(file, file.name)
expect(initCount(), '会话还在服务端,重开 init 就是作废已传片').toBe(0)
expect(
partPosts().map((part) => part.url),
'第 0 片服务端已有,只补第 1 片',
).toEqual([`/api/files/chunk/${RESUMED_ID}/part/1`])
})
it('瞬态失败(分片打不出去):不 DELETE 会话,且本地仍留着 upload_id', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(javaOk({ upload_id: RESUMED_ID, uploaded_parts: [] }))
mocks.post.mockRejectedValue(new Error('Network Error'))
await expect(uploadFileInChunks(file, file.name)).rejects.toThrow(/Network Error/)
expect(mocks.delete.mock.calls, 'DELETE 会把已达片号一起清掉,下次只能从 0').length(0)
expect(storedUploadId(file), '会话要留给下一次(含刷新后)续传').toBe(RESUMED_ID)
})
it('探测 503:瞬态 ⇒ 保留原会话,不重开', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(axiosResponse(503, '<html>Bad Gateway</html>'))
await uploadFileInChunks(file, file.name)
expect(initCount()).toBe(0)
expect(partPosts().every((part) => part.url.includes(RESUMED_ID))).toBe(true)
})
it('探测超时(网络层错误):瞬态 ⇒ 同样保留原会话', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockRejectedValue(new Error('timeout of 30000ms exceeded'))
await uploadFileInChunks(file, file.name)
expect(initCount()).toBe(0)
expect(partPosts().every((part) => part.url.includes(RESUMED_ID))).toBe(true)
})
it('HTTP 404:会话确实没了 ⇒ 清状态重开', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(axiosResponse(404, { success: false, message: 'Not Found', data: null }))
await uploadFileInChunks(file, file.name)
expect(initCount(), '会话已回收,不重建就永远卡在同一个死会话上').toBe(1)
expect(partPosts().every((part) => part.url.includes(FRESH_ID))).toBe(true)
})
it('后端 HTTP 200+「分片会话不存在或已过期」(现网形状)⇒ 同样重开', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(axiosResponse(
200,
{ success: false, message: '分片会话不存在或已过期', data: null },
))
await uploadFileInChunks(file, file.name)
expect(initCount()).toBe(1)
expect(partPosts().every((part) => part.url.includes(FRESH_ID))).toBe(true)
})
it('拼装成功 ⇒ 本地会话清掉(同一文件再传要开新会话)', async () => {
const file = makeFile('pkg.zip', CHUNK_UPLOAD_PART_SIZE * 2)
seedSession(file, RESUMED_ID)
mocks.get.mockResolvedValue(javaOk({ upload_id: RESUMED_ID, uploaded_parts: [] }))
await uploadFileInChunks(file, file.name)
expect(storedUploadId(file), '完成后会话已拼装落库,本地不该留残号').toBe('')
})
})
describe('P2-8 逐片超时按本片体积', () => {
it('每片预算只看这一片有多大,不得按整包体积放大', async () => {
const file = makeFile('big.zip', CHUNK_UPLOAD_PART_SIZE * 5)
mocks.get.mockResolvedValue(javaOk({ upload_id: FRESH_ID, uploaded_parts: [] }))
routePosts(FRESH_ID)
await uploadFileInChunks(file, file.name)
const parts = partPosts()
expect(parts.length, '40MB=5 片').toBe(5)
// 整包口径会给出 120s + 40×15s = 720s;按片口径 8MB 片=300s。判红要留出余量差。
for (const part of parts) {
expect(part.timeout, `片 ${part.url} 的超时没有按本片体积算`).toBeGreaterThan(0)
expect(
part.timeout,
`片 ${part.url} 的超时 ${part.timeout}ms 是按整包体积算的(P2-8)`,
).toBeLessThanOrEqual(partTimeoutOf(CHUNK_UPLOAD_PART_SIZE))
}
expect(partTimeoutOf(CHUNK_UPLOAD_PART_SIZE), '8MB 片的预算不该超过 10 分钟')
.toBeLessThanOrEqual(600_000)
expect(partTimeoutOf(1), '再小的片也要有保底,不能给 0').toBeGreaterThanOrEqual(60_000)
})
it('init 与 complete 的预算不再随整包体积线性放大', async () => {
const file = makeFile('big.zip', CHUNK_UPLOAD_PART_SIZE * 5)
mocks.get.mockResolvedValue(javaOk({ upload_id: FRESH_ID, uploaded_parts: [] }))
routePosts(FRESH_ID)
await uploadFileInChunks(file, file.name)
const initCall = mocks.post.mock.calls.find(([url]) => String(url).includes('/chunk/init'))
const initTimeout = Number((initCall?.[2] as { timeout?: unknown } | undefined)?.timeout ?? -1)
expect(initTimeout, 'init 只发一条登记请求,按整包体积给 720s 是把失败拖到天荒地老').toBeLessThan(300_000)
})
})
describe('P3-5 阈值单点', () => {
it('后管这一侧的 8MB 只有一个出口:阈值由片大小派生', () => {
expect(CHUNK_UPLOAD_THRESHOLD, '阈值必须与片大小同源(P3-5 三处各写一遍的收口)')
.toBe(CHUNK_UPLOAD_PART_SIZE)
expect(CHUNK_UPLOAD_PART_SIZE).toBe(8 * 1024 * 1024)
})
})
@@ -0,0 +1,122 @@
// AC-11(R4):后管大档上传接线的「行为用例」那一半。
//
// Pending Phase 4 激活。9MB 安装包(跨分片阈值)调 uploadSoftwareVersion,
// 必须出现 POST /files/chunk/init;今天它走 presign → 一次 PUT 直传,
// 512MB 断网只能从 0 重来。本文件不出网,mock 掉 http 与 axios 直传实例。
import { beforeEach, describe, it, expect, vi } from 'vitest'
const mocks = vi.hoisted(() => ({
post: vi.fn(),
get: vi.fn(),
put: vi.fn(),
delete: vi.fn(),
directPut: vi.fn(),
}))
vi.mock('axios', () => ({
default: {
create: () => ({ put: mocks.directPut }),
},
}))
vi.mock('@/api/http', () => ({
http: { post: mocks.post, get: mocks.get, put: mocks.put, delete: mocks.delete },
unwrap: (value: unknown) => {
const envelope = value as { success?: boolean; data?: unknown; message?: string }
if (envelope && typeof envelope === 'object' && 'success' in envelope) {
if (!envelope.success) {
throw new Error(envelope.message || '请求失败')
}
return envelope.data
}
return value
},
}))
import { uploadSoftwareVersion } from '@/pages/records/version-api.ts'
import { uploadTutorialPackage } from '@/pages/records/tutorial-api.ts'
describe('AC-11 后管大档上传', () => {
// 会话跨尝试复用后,两格之间必须清态:残留的 upload_id 会让第二格跳过本该发生的 init。
beforeEach(() => {
vi.clearAllMocks()
localStorage.clear()
})
it('9MB 安装包必须走分片 init', async () => {
// 预签名与分片两套响应揉成一个超集:哪条实现路径先走都能拿到自己要的字段。
mocks.post.mockResolvedValue({
data: {
success: true,
data: {
upload_url: 'https://oss.example/put',
file_url: 'https://oss.example/pkg.zip',
version: '9.9.9',
object_key: 'client/versions/pkg.zip',
upload_id: 'a'.repeat(32),
uploaded_parts: [],
item: null,
},
},
})
mocks.get.mockResolvedValue({
data: { success: true, data: { upload_id: 'a'.repeat(32), uploaded_parts: [] } },
})
mocks.directPut.mockResolvedValue({})
const file = new Blob([new Uint8Array(9 * 1024 * 1024)], {
type: 'application/octet-stream',
})
await uploadSoftwareVersion('9.9.9', file)
const urls = mocks.post.mock.calls.map(([url]) => String(url))
expect(
urls.some((url) => url.includes('/files/chunk/init')),
`AC-11:9MB 安装包仍走 presign 直传,实际出口:${urls.join(', ')}`,
).toBe(true)
// P2-6:删掉 uploadFileInChunks(…) 真调用后,这一格必须跟着红——所以还要核对分片片确实发出去了。
expect(
mocks.post.mock.calls.filter(([url]) => /\/files\/chunk\/[^/]+\/part\/\d+$/.test(String(url))).length,
'AC-11:走分片就要真把片 POST 出去',
).toBe(2)
})
// P2-6:教程包那条道过去只有源码尺子覆盖(而尺子当时吃的是死常量),删掉真调用没人判红。
it('9MB 教程包必须走分片 init', async () => {
localStorage.clear()
mocks.post.mockResolvedValue({
data: {
success: true,
data: {
upload_url: 'https://oss.example/put',
file_url: 'https://oss.example/tutorial.zip',
version: '9.9.9',
object_key: 'client/tutorials/tutorial.zip',
upload_id: 'b'.repeat(32),
uploaded_parts: [],
item: null,
},
},
})
mocks.get.mockResolvedValue({
data: { success: true, data: { upload_id: 'b'.repeat(32), uploaded_parts: [] } },
})
mocks.directPut.mockResolvedValue({})
const file = new Blob([new Uint8Array(9 * 1024 * 1024)], {
type: 'application/octet-stream',
})
await uploadTutorialPackage(file, 'tutorial.zip', '9.9.9')
const urls = mocks.post.mock.calls.map(([url]) => String(url))
expect(
urls.some((url) => url.includes('/files/chunk/init')),
`AC-11:9MB 教程包仍走 presign 直传,实际出口:${urls.join(', ')}`,
).toBe(true)
expect(
mocks.directPut.mock.calls.length,
'AC-11:大档不该再走一次 PUT 直传',
).toBe(0)
})
})
+4 -1
View File
@@ -88,7 +88,10 @@ test('test_task_048_normal_role_wording_agrees_across_all_exits', () => {
const buttons = [...dialog.matchAll(/<el-radio-button\s+value="([a-z_]+)">([^<]*)</g)].map(
(m) => [m[1], m[2]] as const,
)
assert.deepEqual(buttons, [['normal', word], ['admin', '管理员']], '编辑用户弹窗的角色按钮文案')
// 2026-11-17 V206:弹窗新增「所属平台」单选(amazon/jd 两档)——角色按钮仍是前两枚,
// 平台按钮单独钉,四出口文案对平的意图不变。
assert.deepEqual(buttons.slice(0, 2), [['normal', word], ['admin', '管理员']], '编辑用户弹窗的角色按钮文案')
assert.deepEqual(buttons.slice(2), [['amazon', '亚马逊'], ['jd', '京东']], '所属平台单选两档(V206 翻档归侧的唯一入口)')
})
/**

Some files were not shown because too many files have changed in this diff Show More