70 行
2.8 KiB
Markdown
70 行
2.8 KiB
Markdown
# fix(product-v2): /mp/product/{id} 支持定制产品(CUSTOM)
|
||
|
||
> **服务**: hl-product-service-v2
|
||
> **PR**: #900
|
||
> **Issue**: #898
|
||
> **日期**: 2026-04-19
|
||
> **前端是否需要改动**: **无需改动**（后端行为修复，前端原调用方式继续有效）
|
||
|
||
---
|
||
|
||
## 一、背景
|
||
|
||
前端小程序调 `GET /mp/product/{id}` 查询定制产品详情时一直返回 `code=404 "产品不存在或已下架"`。例如 `GET /mp/product/2043696016590327809`（定制产品"7天6晚草原VIP私定"）。
|
||
|
||
**根因（后端侧）**：原接口硬校验 `status=PUBLISHED`，但定制产品（`productType=CUSTOM`）的状态流转是 `DRAFT → COMPLETED → ORDERED`，根本不经过 PUBLISHED。
|
||
|
||
**前端感知**：定制产品详情页进不去、白屏、或者前端做过类似"CUSTOM 改调 `/mp/custom/product/{id}`"的 workaround。
|
||
|
||
---
|
||
|
||
## 二、变更接口
|
||
|
||
| # | 接口 | 方法 | 路径 | 变更类型 | 前端改动 |
|
||
|---|------|------|------|---------|---------|
|
||
| 1 | 小程序产品详情 | GET | `/mp/product/{id}` | **行为修复**：CUSTOM 产品不再 404，返回完整详情 | 无需 |
|
||
| 2 | 定制产品专属详情 | GET | `/mp/custom/product/{id}` | 无变化 | 无需 |
|
||
|
||
**请求/响应结构完全不变**，仅扩大了状态白名单。
|
||
|
||
---
|
||
|
||
## 三、状态可见性矩阵（修复后）
|
||
|
||
| productType | status | `/mp/product/{id}` 返回 |
|
||
|-------------|--------|------------------------|
|
||
| CORE / GROUP | DRAFT / PENDING_REVIEW / COMPLETED | 404 |
|
||
| CORE / GROUP | PUBLISHED | 200 完整详情 |
|
||
| **CUSTOM** | DRAFT / PENDING_REVIEW | 404 |
|
||
| **CUSTOM** | **COMPLETED / ORDERED** | **200 完整详情（本次修复）** |
|
||
|
||
---
|
||
|
||
## 四、前端行动项
|
||
|
||
**无需任何代码改动**。可评估清理以下历史 workaround：
|
||
|
||
| 可移除的 workaround | 原因 |
|
||
|--------------------|------|
|
||
| 根据 productType 分发调用 `/mp/product/{id}` 或 `/mp/custom/product/{id}` | 现在 `/mp/product/{id}` 统一支持所有 productType |
|
||
| CUSTOM 产品详情页特殊 catch 404 显示"产品不存在"文案 | 后端已正确返回 |
|
||
| 任何针对"定制产品详情不可用"的 UI 兜底 | 不再必要 |
|
||
|
||
**保留**：`/mp/custom/product/{id}` 仍是定制产品的专属入口（带 refund policies enrich 等特化逻辑），适合"已完成定制"详情场景继续用。
|
||
|
||
---
|
||
|
||
## 五、测试环境已验证
|
||
|
||
```
|
||
GET /mp/product/2043696016590327809 (CUSTOM + COMPLETED) → 200 "7天6晚草原VIP私定" ✓
|
||
GET /mp/product/2045424500610125825 (CORE + PUBLISHED) → 200 "E2E-核心版本-V1" ✓
|
||
GET /mp/product/2045486260364996609 (任意 + DRAFT) → 404 ✓
|
||
```
|
||
|
||
---
|
||
|
||
## 六、响应字段
|
||
|
||
与原 `MpProductDetailRespVO` 完全一致，不新增/删除/改名任何字段。CUSTOM 产品组装时，无相关数据的子表字段（如班期、价格日历）自然为 null/空集。
|