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