From 8c38fc6b8998a4cb1661d0999a4e5aeb507169c1 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 4 Sep 2026 14:35:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=207070=20=E6=88=BF=E5=8A=A1?= =?UTF-8?q?=E5=88=97=E8=A1=A8/=E8=AF=A6=E6=83=85=E8=A1=A5=E4=BA=A7?= =?UTF-8?q?=E5=93=81=E7=B1=BB=E5=9E=8B=E6=A0=87=E7=AD=BE=20productType(?= =?UTF-8?q?=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...补产品类型标签-productType-修改接口-管理后台.md | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 changelogs-v2/2026-09/04_7070_房务列表-详情补产品类型标签-productType-修改接口-管理后台.md diff --git a/changelogs-v2/2026-09/04_7070_房务列表-详情补产品类型标签-productType-修改接口-管理后台.md b/changelogs-v2/2026-09/04_7070_房务列表-详情补产品类型标签-productType-修改接口-管理后台.md new file mode 100644 index 00000000..74cdc22f --- /dev/null +++ b/changelogs-v2/2026-09/04_7070_房务列表-详情补产品类型标签-productType-修改接口-管理后台.md @@ -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 个已有字段仅数据源切换、语义不变，无破坏性变更；请求侧无变更。 +- 兼容性结论：**向后兼容**（纯响应字段新增 + 已有字段取值口径不变）。 +- 网关验证：待测试环境部署后补充。