From 03d3a05116f4b672617ce126885f2bfbc68bcc16 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 8 Jul 2026 15:58:27 +0800
Subject: [PATCH] docs(house): add order timeline and empty history handoff

---
 ...®¢å�•è®°å½•ä¸Žéœ€æ±‚历å�²ç©ºæ€�-å‰�端待处ç�†-管ç�†å�Žå�°.md | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 changelogs-v2/2026-07/48_4848_房务订�记录与需求历�空�-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/48_4848_房务订�记录与需求历�空�-�端待处�-管���.md b/changelogs-v2/2026-07/48_4848_房务订�记录与需求历�空�-�端待处�-管���.md
new file mode 100644
index 0000000..60c6f9a
--- /dev/null
+++ b/changelogs-v2/2026-07/48_4848_房务订�记录与需求历�空�-�端待处�-管���.md
@@ -0,0 +1,79 @@
+# ��端对接·管���】房务订�记录与需求历�空�
+
+> Issue: [wx/HL#4848](https://git.1814.love:8443/wx/HL/issues/4848)  
+> �务: `hl-order-service-v3`  
+> 日期: 2026-07-08  
+> 影�范围: 订�详情行程安排�订�记录�房务管家
+
+## 1. 结论
+
+- 订�尚未�交房型需求是正常空�，��作为业务错误返回。
+- `requirement-history` 无历�版本时返回 200 + 空列表，�端��弹出“该订�无需求历��错误�示。
+- 房务关键动作已�步写入订�“记录�时间线，现有房务内部�作日志��。
+
+## 2. 房型需求历�空�
+
+```http
+GET /v3/admin/house/orders/{orderId}/requirement-history
+Authorization: Bearer <token>
+```
+
+当定制师还没有�交房型需求时，�应改为：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "orderId": "2074746808742928386",
+    "orderNo": "HL20260708144600723",
+    "totalVersions": 0,
+    "returnedCount": 0,
+    "list": []
+  }
+}
+```
+
+�端处�建议：
+
+- `list=[]` 时展示空�，例如“尚未�交房型需求�。
+- ���弹错误 toast。
+- �有 HTTP 失败或 `success=false` �按错误处�。
+
+## 3. 订�记录新增事件
+
+订�记录时间线新增以下 `eventType`：
+
+| eventType | title | 说明 |
+| --- | --- | --- |
+| `HOTEL_REQUIREMENT_SUBMIT` | �交房型需求 | 定制师�交�修改或�新�交房型需求 |
+| `HOUSE_CLAIM` | 房务抢� | 房务从抢�池领�需求 |
+| `HOUSE_TRANSFER` | 房务转� | 房务转交或组长指派 |
+| `HOUSE_RELEASE` | 释放回池 | 房务释放回抢�池 |
+| `HOUSE_ASSIGNMENT_SUBMIT` | �交�房 | 新增或��房方案 |
+| `HOUSE_ASSIGNMENT_UPDATE` | 修改�房 | 修改�晚�房信� |
+| `HOUSE_ASSIGNMENT_DELETE` | 删除�房 | 删除�晚�房信� |
+| `HOUSE_ASSIGNMENT_CLEAR` | 清空�房 | 清空全部或�晚�房信� |
+| `HOUSE_REOPEN` | �新调整�房 | 已确认��新进入�房调整 |
+
+`HOTEL_DONE` �表示“最终确认 / �房完��。
+
+## 4. �端适�
+
+- 如果订�记录是通用 timeline 渲染，通常无需改。
+- 如果�端有 `eventType` 白���图标映射或文案映射，需�加入上表枚举。
+- 房务动作记录��留业务节点，�展示过细的字段 diff。
+
+## 5. �端验�
+
+```bash
+mvn -pl hl-order-service-v3 -am -DskipTests compile
+mvn -pl hl-order-service-v3 -am -Dtest=OrderLogEventTypeTest,HouseDetailAggregatorTest,HouseGrabServiceImplTest,HouseAssignmentServiceTest,RequirementServiceTest -DfailIfNoTests=false test
+```
+
+验�结果：
+
+- 编译通过。
+- 目标�测通过。
+- 覆盖无需求历�空��房务抢��转��释放��交�房�修改�房�删除�房�清空�房��新调整�房��交房型需求写入订�记录。