From 5b1659a048bbe0a60819227a83ba7377421b3c62 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 13 Jul 2026 15:32:59 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E6=96=B0=E5=BB=BA?=
 =?UTF-8?q?=E8=AE=A2=E5=8D=95=E5=8D=95=E6=88=BF=E5=B7=AE=E7=AE=97=E4=BB=B7?=
 =?UTF-8?q?=E5=8F=A3=E5=BE=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...•é¢„估价改用产å“�报价接å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 33 ++++++++++++++++---
 1 file changed, 28 insertions(+), 5 deletions(-)

diff --git a/changelogs-v2/2026-07/58_新建订�预估价改用产�报价接�-�端待处�-管���.md b/changelogs-v2/2026-07/58_新建订�预估价改用产�报价接�-�端待处�-管���.md
index fc9193e..174608a 100644
--- a/changelogs-v2/2026-07/58_新建订�预估价改用产�报价接�-�端待处�-管���.md
+++ b/changelogs-v2/2026-07/58_新建订�预估价改用产�报价接�-�端待处�-管���.md
@@ -8,14 +8,14 @@
 
 ## 1. 结论
 
-新建订�的预估总价必须在用户选择出�日期�，通过产��务报价接�计算。�止继续使用产�起价 `startPrice` 或 `儿童数 * 0.7` 在�端估算。
+新建订�的预估总价必须在用户选择出�日期�，通过产��务报价接�计算。�止继续使用产�起价 `startPrice` 或 `儿童数 * 0.7` 在�端估算。总价还必须包��端按当日�置和�人数奇�计算出的实际�房差。
 
 两个接��责��：
 
 | 接� | �责 |
 |---|---|
 | `GET /admin/product/item/{productId}/pricing-calendar` | 获��售日期；日期选择器按 `sellable` �用��售日期，�时�留该日价格/�期信�。 |
-| `POST /admin/product/item/{productId}/quote` | 按已选出�日期�档��四类人数执行��算价；预估总价直接展示�应 `grandTotal`。 |
+| `POST /admin/product/item/{productId}/quote` | 按已选出�日期�档��四类人数执行��算价，并处��房差；预估总价直接展示�应 `grandTotal`。 |
 
 `quote` �端会按产�类型读�正确价格�：CORE/CUSTOM 读�所选日期的 `product_price_calendar`，GROUP 读�所选日期的 `group_tour_batch`。�端���制价格日历计算规则。
 
@@ -25,7 +25,7 @@
 
 | �置 | 当�行为 | 问题 |
 |---|---|---|
-| `src/views/order-v2/new/components/Step2Info.vue` | `startPrice * (adultCount + childCount * 0.7)` | 起价�是所选日期价格，儿童价也�是�人价的固定比例。 |
+| `src/views/order-v2/new/components/Step2Info.vue` | `startPrice * (adultCount + childCount * 0.7)` | 起价�是所选日期价格，儿童价也�是�人价的固定比例，且完全�算�房差。 |
 | `src/views/order-v2/new/components/Step3Confirm.vue` | �次使用相�本地公� | 确认页会��展示错误金�。 |
 | `src/api/product/pricing.js` | 已有统一价格日历方法，无管�端报价方法 | 新建订��程没有调用现有报价接�。 |
 
@@ -92,21 +92,43 @@
 
 金�字段按字符串处�和展示，�止先转 JS `Number` ��长期�存。预估总价使用 `data.grandTotal`，��由��价在�端�新相加。
 
+### �房差�径
+
+| 字段/�件 | �径 |
+|---|---|
+| `singleRoomDiff` | 所选出�日期价格日历或 GROUP �期�置的�房差原值。 |
+| `singleRoomSurcharge` | 本次报价实际收�的�房差。�人数为奇数（1�3�5……）且�置了�房差时，收�一份 `singleRoomDiff`；�人数为�数时为 0。 |
+| `grandTotal` | 已包� `singleRoomSurcharge`，�端�止�把�房差加一次。 |
+| 人数范围 | 仅 `adultCount` �与奇�判断；儿童��童�幼童��与。 |
+
+测试环境�一产���一日期的实测结果：
+
+| 出�日期 | 人数 | �人�价 | �房差�置 | 实际�房差 | `grandTotal` |
+|---|---:|---:|---:|---:|---:|
+| `2026-06-30` | 1 �人 | `4000.00` | `1000.00` | `1000.00` | `5000.00` |
+| `2026-06-30` | 2 �人 | `4000.00` | `1000.00` | `0` | `8000.00` |
+
+�端预估价�片和确认页都直接展示 `grandTotal`。当 `singleRoomSurcharge > 0` 时，增加一行金�明细“�房差 +¥xxx�；为 0 时���该行。该明细�用于解释总价，�能�与二次计算。
+
 ## 4. �端处��求
 
 1. 未选择出�日期时，预估总价显示“请选择出�日期�或“待计算�，�得展示基于起价的金�。
-2. 选择出�日期�调用 `quote`；产��档��出�日期��人数�儿童数��童数�幼童数任一�化，都��新报价。
+2. 选择出�日期�调用 `quote`；产��档��出�日期��人数�儿童数��童数�幼童数任一�化，都��新报价。�人数�化时必须�新获� `singleRoomSurcharge`，�得仅在�端切�奇�。
 3. 请求期间展示明确加载�；连续修改人数时�短防抖，并用请求��或�消旧请求防止旧�应覆盖新结果。
 4. 报价失败时清空旧报价，��许退回 `startPrice`/`0.7` 本地估算；展示�端错误信�并阻止带�过期报价进入确认页。
 5. 第 4 步确认页�用与当�输入完全匹�的最新报价；若报价�赖项已�化或无有效报价，进入确认页��新调用一次。
 6. 删除 `Step2Info.vue` 和 `Step3Confirm.vue` 中 `childCount * 0.7` � `startPrice` 预估总价逻辑。
-7. `pricing-calendar` �用于�售日期�制，��删除；`quote` 是其�的��算价步骤。
+7. `grandTotal` 已��房差；�端�得��相加。`singleRoomSurcharge > 0` 时仅展示�房差明细。
+8. `pricing-calendar` �用于�售日期�制，��删除；`quote` 是其�的��算价步骤。
 
 ## 5. 验收清�
 
 - [ ] 未选出�日期时�展示金�，也�调用报价接�。
 - [ ] 选择 `2026-07-14`�`tierSeq=1`�2 �人 1 儿童�，样本产�预估总价显示 `11000.00`，��显示 `10800.00`。
 - [ ] �人/儿童/�童/幼童任一人数�化��新报价，页�结果与最�一次请求一致。
+- [ ] �房差�置为 `1000.00` 时，1 �人返回并显示 `singleRoomSurcharge=1000.00`�`grandTotal=5000.00`；2 �人返回 `singleRoomSurcharge=0`�`grandTotal=8000.00`。
+- [ ] �房差�按�人数奇�判断；儿童��童�幼童数��化�会被�端错误用于�房差判断。
+- [ ] 第 3 步和第 4 步在实际�房差大于 0 时显示�房差明细，但�会在 `grandTotal` 上�次累加。
 - [ ] 切�产��档�或日期�，旧报价立�失效并�新获�。
 - [ ] CORE/CUSTOM 按所选日期价格日历算价；GROUP �带所选�期 `batchId` �报价正确。
 - [ ] 报价接�失败时�展示旧金���使用本地比例兜底。
@@ -117,4 +139,5 @@
 - 当���已确认 `POST /admin/product/item/{id}/quote` 为管�端正�报价接�。
 - Knife4j 测试环境��文档已确认该接�存在。
 - 2026-07-13 �测试环境网关实调：价格日历与报价接��返回 `code=200`；上述样本 `grandTotal=11000.00`。
+- 2026-07-13 �测试环境网关补测�房差：`2026-06-30` �置�房差 `1000.00`，1 �人报价 `singleRoomSurcharge=1000.00`�`grandTotal=5000.00`；2 �人报价 `singleRoomSurcharge=0`�`grandTotal=8000.00`。
 - 本通知�修改 `hl-api-changelog`，未修改 `hl-ui` 或�端业务代�。