87 行
2.9 KiB
Markdown
87 行
2.9 KiB
Markdown
# fix: 早鸟计划接口 VO 加 productNames / products 字段（解决列表显示"全部产品"、编辑页显示 ID 问题）
|
||
|
||
> **服务**: hl-order-service-v2
|
||
> **PR**: #925
|
||
> **Issue**: #916
|
||
> **日期**: 2026-04-19
|
||
> **前端是否需要改动**: **无需改动**（前端代码本来就期望这两个字段，之前是后端未返回导致 fallback）
|
||
|
||
---
|
||
|
||
## 一、背景
|
||
|
||
管理端早鸟计划页面之前存在两个 bug：
|
||
- **列表页**"适用产品"列显示"全部产品"（误导，实际已绑产品）
|
||
- **编辑弹窗**"适用产品"tag 显示产品 ID（如 `2045345825172639746`）
|
||
|
||
根因：后端 `EarlyBirdPlanVO` 只返 `productIds: List<Long>` 不带产品名，前端拿不到名字做 fallback。
|
||
|
||
## 二、变更接口
|
||
|
||
所有返回 `EarlyBirdPlanVO` 的接口均受益：
|
||
|
||
| 方法 | 路径 | 变更类型 |
|
||
|------|------|---------|
|
||
| GET | `/admin/order/early-bird/{id}` | 响应新增字段 |
|
||
| POST | `/admin/order/early-bird` | 同上 |
|
||
| PUT | `/admin/order/early-bird/{id}` | 同上 |
|
||
| GET | `/admin/order/early-bird` (列表/分页) | 响应 records 新增字段 |
|
||
|
||
（其他如 `/admin/order/early-bird/{id}/validate` `/match` 等同样收益）
|
||
|
||
## 三、新增字段
|
||
|
||
```json
|
||
{
|
||
"planId": "2045586012523864065",
|
||
"planName": "默认早鸟优惠",
|
||
"discountAmount": 100.00,
|
||
"minPeople": 1,
|
||
"productIds": ["2045345825172639746"],
|
||
"productNames": ["游牧的森林-短途版"], // ← 新增，列表列用
|
||
"products": [ // ← 新增，编辑弹窗 tag 用
|
||
{"productId": "2045345825172639746", "name": "游牧的森林-短途版"}
|
||
]
|
||
}
|
||
```
|
||
|
||
字段约定：
|
||
- `productNames` 与 `productIds` **下标对齐**
|
||
- 产品被删除时，对应位置填 `"产品[ID]已删除"`（而非 "全部产品" 误导）
|
||
- Feign 查失败时，全部填占位字符串
|
||
- 空的 productIds 保持空数组（前端按原逻辑显示 "全部产品"）
|
||
|
||
## 四、前端行动项
|
||
|
||
**无需改代码**。以下是预期的前端渲染逻辑（已跟代码对齐）：
|
||
|
||
```js
|
||
// 列表页
|
||
{ label: '适用产品', render: row => row.productNames?.length ? row.productNames.join('、') : '全部产品' }
|
||
|
||
// 编辑弹窗（优先用 products 结构化字段）
|
||
const tags = row.products?.length
|
||
? row.products
|
||
: row.productIds?.map(id => ({ productId: id, name: String(id) })) // fallback
|
||
```
|
||
|
||
修复后列表会直接显示 `"游牧的森林-短途版"`，编辑弹窗 tag 显示产品名称。
|
||
|
||
## 五、测试环境已验证
|
||
|
||
```bash
|
||
GET /admin/order/early-bird/2045586012523864065
|
||
→ {
|
||
"code":200,
|
||
"data":{
|
||
"productIds":["2045345825172639746"],
|
||
"productNames":["游牧的森林-短途版"],
|
||
"products":[{"productId":"2045345825172639746","name":"游牧的森林-短途版"}]
|
||
}
|
||
}
|
||
```
|
||
|
||
## 六、相关 Issue
|
||
- Issue #912 早鸟列表 GET `?page=...` 返 "参数类型错误: orderId" 仍待修（与本 PR 无关）
|
||
- Issue #917 一产品一早鸟唯一约束 仍待修
|