docs(changelog): 7070 房务列表/详情补产品类型标签 productType(管理后台)

2026-09-04 15:50:54 +08:00
@@ -0,0 +1,65 @@
+---
+schema: "hl-changelog/v2"
+ticket: "7070"
+title: "房务列表/详情补产品类型标签 productType"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "修改接口"
+backend_status: "tested"
+gateway_status: "pending"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: ""
+updated_at: "2026-09-04"
+base: "dev-v3"
+generated: "2026-09-04T14:30:35+08:00"
+---
+
+# 房务列表/详情补产品类型标签 productType
+
+> 房务各订单维度列表与详情新增/接通 `productType` 字段，供前端渲染「核心订单 / 线路订单 / 定制订单 / 团期订单」标签。
+
+## 关联 / 联系人
+
+### 链接
+
+- **Issue**: [#7070](https://git.1814.love:8443/wx/HL/issues/7070)
+- **PR**: [#7077](https://git.1814.love:8443/wx/HL/pulls/7077)
+- **Merge commit**: [cb8df55ee](https://git.1814.love:8443/wx/HL/commit/cb8df55ee)
+
+### 联系人
+
+- **后端负责人**: @wx
+
+## 变更接口
+
+| 方法 | 路径 | 变更 |
+|---|---|---|
+| GET | `/v3/admin/order/grab-pool/hotel-requirements` | 抢单池列表项 `productType` 数据源由 Product Feign 改直读 `order_main.product_type`（字段/类型/取值口径不变，消除 Feign 降级 null） |
+| GET | `/v3/admin/order/grab-pool/my-claims/hotel` | 我的接单列表项 `productType` 同上改直读（语义不变） |
+| GET | `/admin/house/orders/{orderId}` | 订单详情订单块 `productType` 同上改直读（语义不变） |
+| GET | `/v3/admin/order/todos` | 待办订单聚合行**新增** `productType` 字段 |
+| GET | `/admin/house/calendar/day` | 日历某天下钻单团项**新增** `productType` 字段（团期折叠取代表子订单） |
+| GET | `/v3/admin/house/reconciliation/monthly/hotel-orders` | 月度对账订单明细行**新增** `productType` 字段 |
+| GET | `/admin/house/orders/{orderId}/requirement-history` | 需求历史版本项**新增** `productType` 字段 |
+
+## 契约影响文件
+
+- `HouseGrabPageItemRespVO` / `HouseMyOrderItemRespVO` / `HouseOrderDetailRespVO`（`productType` 已有字段，数据源切换，取值口径不变）
+- `HouseTodoItemVO` / `DayTourItemVO` / `HotelReconciliationOrderVO` / `RequirementHistoryItem`（**新增** `productType` 可选响应字段，EXTEND 无破坏）
+
+## 前端/调用方动作
+
+- 上述列表行/详情按 `productType` 枚举渲染产品类型标签，映射：`CORE`=核心订单、`ROUTE`=线路订单、`CUSTOM`=定制订单、`GROUP`=团期订单。
+- `productType` 为 `null`（历史脏数据）时前端不渲染标签（空态不展示，勿显示默认文案）。
+- 标签颜色/样式由前端自定，本变更仅交付枚举值。
+
+## 验证证据
+
+- 定向测试：`HouseGrabServiceImplTest`(77) / `HouseDetailAggregatorTest`(86) / `HouseCalendarServiceTest`(21) / `HouseTodoServiceTest`(119) / `MonthlyReconciliationServiceTest`(12) 共 **315 通过，0 失败**。
+- 契约审查：frontend_api surface；Swagger2→OAS3/oasdiff 未配置（not_configured），已做源码级响应字段对比 fallback——4 个 VO 新增可选字段 EXTEND，3 个已有字段仅数据源切换、语义不变，无破坏性变更；请求侧无变更。
+- 兼容性结论：**向后兼容**（纯响应字段新增 + 已有字段取值口径不变）。
+- 网关验证：待测试环境部署后补充。