docs(house): add order timeline and empty history handoff

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
+```
+
+验证结果：
+
+- 编译通过。
+- 目标单测通过。
+- 覆盖无需求历史空态、房务抢单、转单、释放、提交配房、修改配房、删除配房、清空配房、重新调整配房、提交房型需求写入订单记录。