diff --git a/changelogs/2026-04/2026-04-18-product-price-calendar-frontend-bug.md b/changelogs/2026-04/2026-04-18-product-price-calendar-frontend-bug.md new file mode 100644 index 0000000..15c2d20 --- /dev/null +++ b/changelogs/2026-04/2026-04-18-product-price-calendar-frontend-bug.md @@ -0,0 +1,223 @@ +# 前端 Bug 通知 — Step4 定价管理 新增价格区间不回显（前端只刷当前月） + +- **日期**: 2026-04-18 +- **类型**: 前端 Bug 修复指南（**不涉及后端代码改动，后端无需重启**） +- **涉及端**: 管理后台 hl-ui（产品编辑页 Step4 定价管理） +- **后端服务**: hl-product-service-v2（**后端已核实数据完全正确，无需改动**） +- **优先级**: P2 +- **关联任务**: backend 仓库 `docs/tasks/20260418_修复_产品定价新增价格区间不回显.md` + +--- + +## 一、问题描述 + +在产品编辑页 Step4「定价管理」tab 中： + +- **预期**：在已有 2026-04 平日价区间的情况下，新增一段不同月份（如 2026-05-07 → 2026-05-17）的价格区间，点"确认添加"后列表应立即回显新增区间 +- **实际**：点"确认添加"后**列表只显示原来 4 月那一条**，新增的 5 月区间**没有出现**，看起来"加不上" + +**复现路径**： +- 环境：测试服 `192.168.100.160` +- 产品 ID：`2045345825172639746`（游牧的森林-短途版，CORE 草稿） +- 页面：产品编辑 → Step4 定价管理 → 选"轻奢"档位 tab +- 前置：已有 2026-04-01 → 2026-04-30 平日价（成人 ¥4105 / 儿童 ¥1865） +- 操作：点 +添加区间 → 填 2026-05-07 → 2026-05-17 / 平日 / 轻奢 / 成人 ¥4725 / 儿童 ¥1725 → 确认添加 +- 结果：列表里看不到新加的 5 月区间 + +--- + +## 二、根因分析（后端已实证核实） + +### 1. 后端 POST 已成功写入 DB（实证 1：服务日志） + +测试环境 `hl-product-service-v2` 日志（`/opt/hulalv/logs/services/hl-product-service-v2/hl-product-service-v2-8083.log`）： + +``` +12:40:40 价格日历批量设置成功, productId=2045345825172639746, 日期范围=2026-05-02-2026-05-22, 记录数=21 +12:41:17 价格日历批量设置成功, productId=2045345825172639746, 日期范围=2026-05-09-2026-05-10, 记录数=2 +``` + +后端**全程零 ERROR / 零 WARN**，所有 batch 写入返回 200 成功。 + +### 2. DB 真实有 5 月数据（实证 2：数据库） + +`hl_product_service.product_price_calendar` 表实际记录： + +| range_id | 月份 | tier_seq | 日期范围 | 成人/儿童 | 条数 | deleted_at | +|----------|------|----------|----------|-----------|------|------------| +| 2045361705738719233 | 2026-04 | 1 | 4/1-4/30 | 4105/1865 | 30 | NULL | +| 2045361802451058689 | 2026-04 | 2 | 4/1-4/30 | 7777/1000 | 30 | NULL | +| 2045361847678160898 | 2026-05 | 2 | 5/2-5/22 | 4865/1865 | 21 | NULL | +| 2045362006457733121 | 2026-05 | 1 | 5/9-5/10 | 4695/1695 | 2 | NULL | + +5 月数据真实存在、未被软删。 + +### 3. 前端只 GET 当前月份（实证 3：网关访问日志） + +`hl-gateway-8080.log` 关键序列（保存 5 月区间前后）： + +``` +12:40:40.125 POST .../price-calendar/batch ← 写入 5/2-5/22 ✓ +12:40:40.379 GET .../price-calendar?month=2026-04 ← 刷新只查 4 月 ❌ +12:41:17.981 POST .../price-calendar/batch ← 写入 5/9-5/10 ✓ +12:41:18.239 GET .../price-calendar?month=2026-04 ← 刷新只查 4 月 ❌ +``` + +**整个会话前端从未发起 `month=2026-05` 的 GET 请求** → 后端有数据但前端从不拉取。 + +### 真因 + +前端 Step4 定价管理「保存价格区间」的成功回调里，只刷新当前选中月份的数据。当用户新增的区间落在**当前选中月之外的月份**（包括跨月、纯异月）时： +- POST batch 已正确入库 +- 但 GET 只请求当前月，新月份的数据不在响应里 +- 列表自然回显不出来 + +非后端 bug，**纯前端刷新策略问题**。 + +--- + +## 三、涉及接口契约（不变，仅供前端 AI 自包含参考） + +### 1. 批量保存价格区间 + +| 项 | 值 | +|----|----| +| 方法 | POST | +| 路径 | `/admin/product/item/{productId}/price-calendar/batch` | +| 鉴权 | 管理后台 token | + +**Request Body**（关键字段）： + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| `startDate` | string `yyyy-MM-dd` | 是 | 区间起始日 | +| `endDate` | string `yyyy-MM-dd` | 是 | 区间结束日 | +| `tierSeq` | int | 是 | 档位序号（1=经济 / 2=舒适 / 3=轻奢 / 4=高端 / 5=豪华） | +| `priceType` | string | 是 | `WEEKDAY` 平日 / `WEEKEND` 周末 / `HOLIDAY` 节假日 | +| `adultSellPrice` | decimal(12,2) | 是 | 成人售价 | +| `childSellPrice` | decimal(12,2) | 是 | 儿童售价 | +| `subChildDiscount` | decimal(12,2) | 否 | 小童优惠额 | +| `infantPrice` | decimal(12,2) | 否 | 幼童价 | +| `dailyStock` | int | 否 | 每日库存 | + +**Response**： +```json +{ + "code": 200, + "data": { + "rangeId": 2045361847678160898, + "recordCount": 21 + } +} +``` + +> 关键：响应里返回的 `rangeId` 可用于精确识别本次落库的区间，便于前端定位需要刷新哪些月。 + +### 2. 按月查询价格日历 + +| 项 | 值 | +|----|----| +| 方法 | GET | +| 路径 | `/admin/product/item/{productId}/price-calendar?month=yyyy-MM` | + +按月返回该月**全部档位**所有日期的明细（不按 tierSeq 过滤）。 + +**Response**： +```json +{ + "code": 200, + "data": [ + { + "date": "2026-05-07", + "tierSeq": 3, + "rangeId": 2045361847678160898, + "priceType": "WEEKDAY", + "adultSellPrice": 4725.00, + "childSellPrice": 1725.00, + "subChildDiscount": null, + "infantPrice": null, + "dailyStock": null + } + ] +} +``` + +--- + +## 四、前端修复建议（任选其一） + +### 方案 A（最小改动，推荐） + +保存成功后，根据**本次保存的区间起止日期**，计算覆盖的月份集合（同月 1 个，跨月 N 个），逐月 GET 并 merge 到本地状态。 + +伪代码： +```js +async function onBatchSaved(payload) { + // payload 是刚提交的请求体：{ startDate, endDate, tierSeq, ... } + const startMonth = payload.startDate.slice(0, 7); // "2026-05" + const endMonth = payload.endDate.slice(0, 7); // "2026-05" + const months = enumerateMonths(startMonth, endMonth); // ["2026-05"] 或跨月 ["2026-05","2026-06"] + + // 同时 fetch 当前选中月（保留原有视图刷新） + if (!months.includes(currentMonth.value)) months.push(currentMonth.value); + + const results = await Promise.all( + months.map(m => api.getPriceCalendar(productId, m)) + ); + // 把所有月份的明细合并到本地状态，按区间聚合显示 + mergeIntoLocalState(results.flatMap(r => r.data)); +} +``` + +并且，**保存成功后建议自动把月份选择器切换到新区间的起始月**（`startDate.slice(0,7)`），这样用户能立即看到刚加的区间，不用手动切月。 + +### 方案 B（粗暴但稳） + +保存成功后，无脑刷新「当前月 ± 6 个月」共 13 个月（或业务可见范围全部月份），用 `Promise.all` 批量 GET 后聚合。请求多但实现简单，适合日历视图用户经常切月的场景。 + +### 方案 C（最稳妥） + +保存成功后： +1. 清空本地所有缓存 +2. 把月份选择器切到 `payload.startDate.slice(0, 7)` +3. 触发该月份的 GET 拉取 + +用户视觉上"跳到新区间所在月"，能立即看到新数据。请求最少（只 1 次），但前端要做一次月份切换动画。 + +### 三方案对比 + +| 方案 | 请求数 | UX | 实现复杂度 | 推荐度 | +|------|--------|----|------------|--------| +| A | 1~N（按跨月数） | 留在原月 + 数据合并 | 低 | ★★★★★ | +| B | ~13 | 留在原月 + 全量刷新 | 极低 | ★★★ | +| C | 1 | 跳到新月 | 低 | ★★★★ | + +--- + +## 五、回归测试点（前端修完后自测） + +- [ ] 当前选中 4 月，新增 5 月区间，确认添加后能立即在列表/日历中看到新区间 +- [ ] 当前选中 5 月，新增 4 月区间，同上能立即看到 +- [ ] 跨月新增（如 5/28 → 6/3），确认添加后两个月的数据都能看到 +- [ ] 同月新增（4 月内 4/15 → 4/20），确认添加后能立即看到 +- [ ] 多次连续新增不同月的区间，每次都能立即回显 +- [ ] 新增成功后，月份选择器切换到任意月，数据都正确 + +--- + +## 六、后端是否有配合改动 + +**无**。 + +后端代码、接口路径、字段定义、返回结构、写入读取行为**完全不变**。**后端不会发版本，测试环境无需重启服务**。 + +--- + +## 七、可选优化（前端讨论后再决定，本次不做） + +如果前端觉得"逐月 GET 合并"太繁琐，后端可以增加一个新接口（不影响现有接口）： + +- `GET /admin/product/item/{productId}/price-calendar/ranges` —— 按 `range_id` 聚合返回区间列表（含 startDate/endDate/tierSeq/priceType/adultSellPrice/childSellPrice），不分月，一次拉完所有区间 +- 或者给现有 `GET .../price-calendar` 增加 `startDate` / `endDate` 可选参数支持任意日期范围查询 + +如有需求请前端在本 changelog 评论或单独提工单，后端再评估排期。**本次不强制做，前端先按方案 A/B/C 之一修即可解决问题**。