diff --git a/changelogs/2026-04/2026-04-13_product-v2_category_binding_fix.md b/changelogs/2026-04/2026-04-13_product-v2_category_binding_fix.md new file mode 100644 index 0000000..e3d415a --- /dev/null +++ b/changelogs/2026-04/2026-04-13_product-v2_category_binding_fix.md @@ -0,0 +1,52 @@ +# 产品v2 - 产品分类(category)字段绑定问题 + +**日期**: 2026-04-13 +**服务**: product-service-v2 +**类型**: 前端修复提醒 + +--- + +## 问题 + +前端"产品类型"选择器(亲子游、蜜月旅行、摄影之旅、深度体验、自驾越野)的值**没有发送到后端**,导致产品分类保存不上。 + +从请求payload截图确认:请求体中有 `productType: "CORE"` 但**没有 `category` 字段**。 + +## 原因 + +后端有两个独立字段: +- `productType` — 产品类型,值为 `CORE`/`GROUP`/`CUSTOM`(核心产品/小蒙马/私人定制) +- `category` — 产品分类,值为字典 `product_category` 的code + +前端的"产品类型"选择器实际对应的是后端的 **`category`** 字段,不是 `productType`。 + +## 前端需要修改 + +### 保存接口 `POST /admin/product/item/basic` + +请求体中增加 `category` 字段: + +```json +{ + "productId": "2043595351268519937", + "productType": "CORE", + "category": "family", // ← 这个字段!"产品类型"选择器的值 + "name": "6天5晚旷野版", + "lineId": "2043595259778166786", + ... +} +``` + +### 字段对照 + +| 前端UI标签 | 后端字段名 | 可选值(字典product_category) | +|-----------|-----------|------| +| 产品类型 | `category` | `family`=亲子游, `honeymoon`=蜜月旅行, `photography`=摄影之旅, `experience`=深度体验, `driving`=自驾越野 | + +### 详情回显 + +`GET /admin/product/item/{productId}` 返回中已包含 `category` 字段,前端读取后设置选择器选中状态即可。 + +## 后端已验证 + +通过API直接发送 `category: "family"` 已确认可以正常保存和回显,后端无需改动。