fix(goods): 商品展示名统一「品名 SKU」——剥 ASCII 型号限定词、纯款号补描述

左栏商品名显示成光款号(如 PLTK016)的根因是双层解析不一致:api 写路径按
首括号对解析产出「童装…(DTG180) PLTK016」,admin 展示解析按末括号取品名
误显示成 PLTK016。

- admin parseLinkName 对齐 api 首括号对解析 + 无 SKU 段中文品名守卫,
  cleanLinkName 剥离 ASCII 型号限定词(中文括号内容保留)
- api 新增 cleanGoodDisplayName/describePureSkuGoodName,接入 create/update/
  batchCreate(batchCreate 补上缺失的 normalize);纯款号按 SDS 分类名补描述
- 新增幂等存量修复脚本 fix:good-names(默认 dry-run,--apply 写库)
- 已执行:V2 栈 34 条限定词名、V1 栈 213 条原始链接名规范化,复跑幂等 0

Tests: api 22 suites/199 passed, admin 27 passed, tsc clean
This commit is contained in:
yeuimu
2026-09-03 01:27:26 +08:00
parent b81d944c38
commit 9eafac7204
10 changed files with 605 additions and 15 deletions
+17 -1
View File
@@ -207,7 +207,23 @@ curl -X POST /product-families/organize -H "$AUTH" # 后台「整理
**链接名称展示解析**:后台所有链接名展示位(左右树、族成员列表、配置/编辑弹窗、搜索候选)
统一解析为「品名 型号」(如 `美国(包邮)180g纯棉T恤成人款-DG001-单面印花`
`180g纯棉T恤成人款 DG001`),悬停 tooltip 保留原始全名;搜索同时匹配原始名与解析名
`utils/origin-name.ts#cleanLinkName`)。
`utils/origin-name.ts#cleanLinkName`)。解析按**首括号对**取品名(与 api 端
`origin-name.parser.ts#splitSegment1` 同构);无 SKU 段时仅当括号后品名含中文才视为
链接名——防止已规范化的「品名(型号限定词) SKU」(如 `童装…(DTG180 PLTK016`
被误解析成光款号。
**商品展示名规范化与存量修复(2026-09)**`goods.good_name` 统一存「品名 SKU」——
- 写路径(`goods.service.ts` create/update/batchCreate 经 `resolveGoodName`):
结构完整的原始链接名规范化为「品名 SKU」,品名内的 **ASCII 型号限定词**
(如 `DTG180`/`JSA002`,供应商或工艺型号)一律剥离(中文括号内容如
`(女款)`保留);清洗后仍为**纯款号**(如 `PLTK016`SDS 部分链接名只有款号)
时按主链接 SDS 分类名补描述(`PLTK016 童装纯色插肩短袖T恤`
`童装纯色插肩短袖T恤 PLTK016`);batchCreate 同样走规范化;自定义商品
createCustom/updateCustomContent)的人工命名不受影响;
- 存量修复脚本:`pnpm --filter @inkreach/api fix:good-names`(默认 dry-run 打印
旧名→新名清单,`-- --apply` 写库,幂等可重跑;`origin_goods.good_name` 为 SDS
纯镜像不动,只改 `goods.good_name`)。