From 1eb4246e3aaf1f595f6f99ede6e7ecc166a2ce22 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 22 Jul 2026 16:02:04 +0800
Subject: [PATCH] docs: hand off house detail team number (#5150)

---
 ...�•è¯¦æƒ…补充团å�·-修改接å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 changelogs-v2/2026-07/83_5150_房务订�详情补充团�-修改接�-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/83_5150_房务订�详情补充团�-修改接�-�端待处�-管���.md b/changelogs-v2/2026-07/83_5150_房务订�详情补充团�-修改接�-�端待处�-管���.md
new file mode 100644
index 0000000..25237ea
--- /dev/null
+++ b/changelogs-v2/2026-07/83_5150_房务订�详情补充团�-修改接�-�端待处�-管���.md
@@ -0,0 +1,85 @@
+# 房务订�详情：订�概�补充团�
+
+> **�务**: hl-order-service-v3
+> **PR**: [wx/HL#5151](https://git.1814.love:8443/wx/HL/pulls/5151)
+> **Issue**: [wx/HL#5150](https://git.1814.love:8443/wx/HL/issues/5150)
+> **日期**: 2026-07-22
+> **影�范围**: 管��� · 房务订�详情弹窗标题/订�概�
+
+---
+
+## 关键�化
+
+房务订�详情�应的 `data.order` 新增 `teamNo`。�端�直接显示订�当�团�；尚未生�团�时字段为 `null`，��以订��或其他值拼造团�。
+
+---
+
+## �更接�
+
+| 接� | 方法 | 路径 | �更类型 |
+|------|------|------|----------|
+| 房务订�详情 | GET | `/admin/house/orders/{orderId}` | �应字段扩展 |
+
+### 出� `Result<HouseOrderDetailRespVO>`
+
+| 字段路径 | 类型 | 是�新增 | 说明 |
+|----------|------|----------|------|
+| `data.order.teamNo` | `string/null` | 是 | 当�订�团�，�自 `order_main.team_no`；订金支付�生�，未生�时为 `null` |
+
+有团��应片段：
+
+```json
+{
+  "code": 200,
+  "data": {
+    "order": {
+      "orderId": "2044321098765432100",
+      "orderNo": "HL20260721171011648",
+      "teamNo": "26-0518",
+      "productName": "孔知悦"
+    }
+  },
+  "success": true
+}
+```
+
+尚未生�团�时：
+
+```json
+{
+  "code": 200,
+  "data": {
+    "order": {
+      "orderId": "2044321098765432100",
+      "orderNo": "HL20260721171011648",
+      "teamNo": null,
+      "productName": "孔知悦"
+    }
+  },
+  "success": true
+}
+```
+
+---
+
+## �端处�
+
+1. 房务订�详情弹窗标题建议按“订�详情 · 订�� · 团� · 产���展示。
+2. 团�读� `data.order.teamNo`；有值时显示，无值时��团�片段或显示统一空值��。
+3. ��用 `orderNo` 回退为团�，也��从列表缓存或历�快照读�团�。
+
+---
+
+## 边界与�影�范围
+
+- 本次仅新增�读�应字段，�修改入��状�机�房务��和�房�程。
+- 现有�应字段��兼容。
+- 无团�的存�订�正常返回 `teamNo: null`，无需数��移。
+- `D:/work2/hl-ui` 未修改，�端适�由管���项目�独处�。
+
+---
+
+## �端验�
+
+- `HouseDetailAggregatorTest` 覆盖有团��未生�团�两�场景。
+- 定�测试结果：77 tests passed。
-- 
2.43.0