From 53b8c8b1150a547386654f8ed177723bcf048b24 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 5 Jul 2026 14:44:52 +0800
Subject: [PATCH] docs(house): keep requirement edit entry in all house stages

---
 ...·²é…�房å�Žç¼ºå°‘修改需求入å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 38 +++++++++++++------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/changelogs-v2/2026-07/18_订�详情已�房�缺少修改需求入�-�端待处�-管���.md b/changelogs-v2/2026-07/18_订�详情已�房�缺少修改需求入�-�端待处�-管���.md
index 2a5538f..ca776ba 100644
--- a/changelogs-v2/2026-07/18_订�详情已�房�缺少修改需求入�-�端待处�-管���.md
+++ b/changelogs-v2/2026-07/18_订�详情已�房�缺少修改需求入�-�端待处�-管���.md
@@ -1,4 +1,4 @@
-# 订�详情已�房�缺少“修改需求�入�（�端待处�）
+# 订�详情�宿需求任何房务阶段都应�留“修改需求�入�（�端待处�）
 
 - 日期：2026-07-03
 - 端：管���
@@ -6,24 +6,29 @@
 - 示例订�：`HL20260703140009401`
 - 订� ID：`2072923329412427777`
 - 当�状�：�宿已回�，�程节点展示“�房已完��
-- 当�结论：�端已支�已�置/已回��继续�出修改需求，�端需��留或补回入�。
+- 当�结论：�端已支��宿需求在任�房务阶段继续�出修改，�端需��留或补回入�。
 
 ## 现象
 
-在订�详情页的「行程安排�页签中，�宿安排已显示为“已回�/�房已完��，但页�上没有“修改需求�按钮。
+在订�详情页的「行程安排�页签中，�宿安排进入房务处��，页��应��“修改需求�按钮。
+
+已观察到的问题包括：
+
+- �房中/询房中：�端容易�展示“�系房务�，��“修改需求�。
+- 已�房/已回�/�房已完�：�端容易认为�程完�����改，��“修改需求�。
 
 截图�现�径：
 
 - 订�：`HL20260703140009401`
 - 页� URL：`/order-v2/detail/2072923329412427777`
 - 当��片�看到「�系房务�和「查看已�房�等入�。
-- 业务期望：�使房务已��置/回�完�，定制师�然�以�次�起“修改需求�。
+- 业务期望：��订�有�宿需求，定制师在�房中�询房中�待最终确认�已�房�已回�等房务阶段都�以�次�起“修改需求�。
 
 ## 业务�径
 
-�置完��也�以�出修改需求。
+�宿需求任何房务阶段都�以�出修改需求。
 
-“已�房 / �房已完���代表需求���调整。定制师在订�未进入�续��改阶段�，应��从�宿安排区域�起修改需求，用于触�房务�新处�。
+“�房中 / 询房中 / 待最终确认 / 已�房 / �房已完� / 已回��都�代表需求���调整。�端��用房务状�判断是���入�；修改需求入�应作为�宿安排的常驻动作，由�交接�和�端状�机处��续分支。
 
 ## 2026-07-05 补充�现
 
@@ -52,14 +57,16 @@ GET /v3/admin/order/2072923330129653762/itinerary
 
 这正是“�房已完�/已回��场景。该状�下��许定制师修改�宿需求，�端�能因为上述状���入�。
 
+补充�径：��是完���以改，�房中也�以改。�端会按最新 active 需求状�自动判断是�稿编辑还是完��调整。
+
 ## �端处��求
 
-请在订�详情�宿安排模�补回“修改需求�入�：
+请在订�详情�宿安排模�把“修改需求�作为常驻入�：
 
-1. 当订�存在�宿需求，且�宿�片处于已�房/已回�/�房完�展示�时，�显示“修改需求�按钮。
+1. 当订�存在�宿需求时，�宿�片应显示“修改需求�按钮。
 2. 点击“修改需求���用现有需求编辑/调整弹窗或跳转逻辑。
 3. �交�走现有�端需求�交/调整接�，�需�新增�端接�。
-4. ��因为 `roomControlStatus=DONE`�`houseStatus=CONFIRMED`�页�展示“�房已完��就��修改需求入�。
+4. ��因为 `roomControlStatus=PROCESSING/DONE`�`requirement.status=PROCESSING/DONE`�`houseStatus=CLAIMING/PENDING_FINALIZE/CONFIRMED`�页�展示“�房中/询房中/�房已完�/已回��就��修改需求入�。
 
 ## �端接�说明
 
@@ -75,7 +82,7 @@ PUT /v3/admin/order/{id}/hotel-requirement
 
 - 无 active 需求：首次�交。
 - active 需求待处�：编辑当�需求。
-- 已完�/已回�需求：�交修改需求，生�新版本或触�房务�新处�。
+- �房中/已抢�/已�询房/已�房/已回�需求：�交修改需求，生�新版本或触�房务�新处�。
 
 �端�需���入�和调用现有�交�程。
 
@@ -85,12 +92,21 @@ PUT /v3/admin/order/{id}/hotel-requirement
 �交/修改/调整房型需求（三分支自动判断：无 active=INIT_SUBMIT，PENDING=PENDING_EDIT，DONE=DONE_ADJUST）
 ```
 
-如果�端已��移到统一订�调整接�，也�以继续�用现有的“修改需求��交�程�交 `updates.hotelRequirement`；关键是页�入���因 `DONE / CONFIRMED / finalized=true / �房已完�` 被��。
+��实际分支：
+
+| 当� active 需求状� | �端分支 | �端�解 |
+|----------------------|----------|----------|
+| 无 active | `INIT_SUBMIT` | 首次�交�宿需求 |
+| `PENDING / PENDING_REVIEW` | `PENDING_EDIT` | 待处�需求编辑 |
+| `DONE / PROCESSING / REJECTED_*` | `DONE_ADJUST` | �房中或完��调整 |
+
+如果�端已��移到统一订�调整接�，也�以继续�用现有的“修改需求��交�程�交 `updates.hotelRequirement`；关键是页�入���因任何房务��程状�被��。
 
 ## 验收标准
 
 - `HL20260703140009401` 这类已�房订�，在�宿安排�片�看到“修改需求�入�。
 - `HL20260703140009570` 这类 `requirement.status=DONE`�页�显示“�房-已完��的订�，也能看到“修改需求�入�。
+- `requirement.status=PROCESSING` 或页�显示“�房中/询房中�的订�，也能看到“修改需求�入�。
 - 点击��打开现有需求编辑/调整弹窗。
 - �交修改�页�能看到新需求/修改记录，房务侧进入�新处�链路。
 - “�系房务�“查看已�房�等已有按钮��影�。