Files

T

jacy 4d434c9c67 v3.5.4 规格主图、门店使用规则与收银台 logo

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-08-21 17:36:53 +08:00

杜康好客 · v3.5.4 商品规格（SPU + SKU）

2026-08-21 · mini-user / admin-web / h5-partner / API / Prisma
目标：商品详情页内可选销售规格；价格、权益、69 码、履约、上下架按 SKU；箱装按瓶当量起购与物流。

范围

#	项	交付
1	数据模型	`common_product_item` 升级为 SPU；新增 `spec_attr` / `spec_value` / `sku` / `sku_spec`；订单快照 `sku_id` / `sale_unit` / `bottles_per_unit`
2	存量迁移	每商品 1 个默认瓶装 SKU；SQL：`prisma/migrate-product-sku-v354.sql`；脚本：`prisma/backfill-product-skus.ts`
3	Catalog	列表附加 `specEnabled`/`saleUnit`；详情附加 `specAttrs`/`skus`/`defaultSkuId`；旧字段拍平保留
4	Trade	preview/create 可选 `skuId`；无 SKU 回落 SPU；有可售 SKU 用默认/唯一
5	Admin	`PUT /admin/products/:id/specs`、`PUT .../skus`；商品抽屉加宽；规格弹窗填写；每规格主图
6	mini-user	详情规格 chips；选规格切主图；确认页带 `skuId`；箱装数量文案
7	代下单	HQ / 合伙人可选规格 SKU
8	权益文案	「好客权益券」→「好客权益」；首页角标「享{amount}好客权益」（去掉门店 icon）
9	SKU 码	系统生成 `DK` + 6 位数字，后台不可填；每规格独立 69 码
10	规格主图	`common_product_sku.image_url` 可选；空则 C 端回落商品封面

不做：库存、把现有酒祖 10/15/20 合并为一个 SPU。

不改 /api/v1 前缀；只增字段，不删旧字段语义。
旧客户端不传 skuId：
- 有 ≥1 个可售 SKU → 用默认（或第一个）可售 SKU
- 没有任何可售 SKU（未回填）→ 回落 SPU 字段，照常下单（禁止再报「商品暂无可售规格」）
传入 skuId（新客户端选规格）→ 按该 SKU 校验。
旧 admin PUT /admin/products/:id 不传规格时：仅同步唯一默认 SKU（多规格时不同步，防误改）；不同步覆盖已生成的 DK 码。
SPU 上 sku_code / barcode_69 去掉唯一约束，唯一下沉到 common_product_sku；SPU 列保留为默认 SKU 冗余。
订单 sku_id 可空；无规格快照走商品 69 码 / 价格。

按顺序在目标环境库执行（先测试后生产）。本机 npx ts-node … 只改本地 .env 库，不会自动打线上。

规格表 server/dukang-api/prisma/migrate-product-sku-v354.sql
建 spec/sku 表，订单加 sku_id / sale_unit / bottles_per_unit。
回填默认 SKU
cd server/dukang-api && npx ts-node prisma/backfill-product-skus.ts
尚无 SKU 的商品各建 1 条默认瓶装 SKU（码用 DK）。

SKU 主图列 server/dukang-api/prisma/migrate-sku-image.sql

ALTER TABLE `common_product_sku`
  ADD COLUMN `image_url` VARCHAR(512) NULL AFTER `sort_order`;

SKU 码改 DK（生产须在服务器用 .env.production 的 DATABASE_URL）
npx dotenv -e .env.production -- npx ts-node prisma/rewrite-sku-codes-dk.ts
已是 DK+数字的不动；JZ-10 / QX-001 等会改。不改 69 码、订单、价格。

发票品类列（同批次）server/dukang-api/prisma/migrate-invoice-category.sql

ALTER TABLE `user_invoice`
  ADD COLUMN `invoice_category` VARCHAR(16) NOT NULL DEFAULT 'LIQUOR' AFTER `invoice_kind`;

common_product_spec_attr / common_product_spec_value
common_product_sku（sale_unit=BOTTLE|BOX，bottles_per_unit，image_url 可选）
common_product_sku_spec
user_order.sku_id / sale_unit / bottles_per_unit
user_invoice.invoice_category：LIQUOR 酒水类 / CATERING 餐饮类；票种 C 端固定增值税普通发票

位置	变更
门店详情等	「好客权益券」→「好客权益」
首页商品角标 `CouponBadge`	纯文案「享{amount}好客权益」，无门店 icon
商品详情	规格区与「好客权益」说明之间加大间距
待支付 / 收银台	顶部 logo 使用 `public/images/logo2.png`（杜康印章）
门店详情	「使用规则」四字红色，放在「门店详情」上面；门店详情正文限高，超出上下滚动
发票申请	票种写死增值税普通发票；类型选酒水类/餐饮类；申请备注；抬头邮箱必填打 `*`

其它页 BenefitFigure（我的/权益/核销等）仍保留门店核销图标，仅首页角标去 icon。