docs(changelog): 房务订单列表户级表格补团号列交接件（前端优化，管理后台）

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

changelogs-v2/2026-09/27_frontend_房务订单列表户级表格补团号展示-前端优化-管理后台.md

@@ -0,0 +1,83 @@
+---
+schema: "hl-changelog/v2"
+ticket: "frontend"
+title: "房务订单列表户级表格补团号展示"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "前端优化"
+backend_status: "not_required"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "后端接口 GET /v3/admin/order/house-allocation/households 已返回团号字段 teamNo，前端户级表格 src/views/housekeeper/orders/HouseholdTable.vue 需补展示。2026-09-27 测试服实测：scope=all 全部状态第 1 页 100 行（total=104）都含 teamNo 键，55 行有值（如 26-8972），其余为 null；null 一律显示 -。"
+updated_at: "2026-09-27"
+base: "dev-v3"
+---
+
+# 房务订单列表：户级表格补团号展示
+
+> **页面**: 房务管家 › 订单列表（路由 `housekeeper/orders`）  
+> **表格文件**: `src/views/housekeeper/orders/HouseholdTable.vue`
+
+## 关键变化
+
+房务订单列表户级表格当前展示 9 列（订单号/客人/产品/出发日期/配房状态/认领人/定制师/订单金额/操作），**缺少团号**。数据已就绪：接口 `GET /v3/admin/order/house-allocation/households` 每行都带 `teamNo` 字段，前端只需加列展示。
+
+| 现象 | 根因 | 后端已给什么 |
+|---|---|---|
+| 户级表格没有团号 | 前端表格列定义未包含 `teamNo` | 所有行都带 `teamNo` 字段（实测第 1 页 100 行：55 行有值，其余为 null） |
+
+## 接口与字段
+
+**GET** `/v3/admin/order/house-allocation/households`
+
+**响应体中的团号字段**：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `teamNo` | String / null | 团号；可为 null，显示 `-` |
+
+- 团号在订单首次付款成功时生成（线上订金支付或线下收款登记首付款）；在那之前 `teamNo` 为 null，属正常状态，显示 `-`，不提示、不报错。
+- 主订单被软删的存量行，`orderNo` 与 `teamNo` 都为 null，同样用 `-` 兜底。
+
+## 前端需要做什么
+
+在 `src/views/housekeeper/orders/HouseholdTable.vue` 中：
+
+1. 在表格列定义（约 182～216 行）**加入团号列**，具体位置由前端定（可单独一列，或放在订单号下方作副行）。
+2. 渲染规则：`teamNo` 为 null 或空时显示 `-`，否则显示该值。
+3. 关键词搜索已支持按团号模糊匹配（keyword 对订单号/团号/客人/产品名做 OR），无需改搜索逻辑。
+
+## 验证方式
+
+改完后在测试服房务管家订单列表逐条核对：
+
+1. 户级表格新增团号列，显示正确。
+2. 有团号的行显示具体值（如 `26-8972`），`teamNo` 为 null 的行显示 `-`。
+   - 测试服上有一批「已付款」测试订单的 `teamNo` 也是 null：它们是经订单状态干预接口造的测试数据，该接口推进到已付款时不生成团号（后端缺口，已建单 wx/HL#8408）。这些行显示 `-` 就是正确结果，前端不需要特殊处理。
+3. 按团号搜索能正确筛选。
+
+## 不影响范围
+
+- 后端接口零改动。
+- 「团期」页签（`GroupBatchTable.vue`）展示的是团期号 `batchNo`，与本条无关。
+- 团期详情页不涉及。
+- 小程序、H5 不涉及。
+
+## 附：数据完整性验证
+
+2026-09-27 测试服（管理后台房务管家订单列表，scope=all 全部状态首页 100 行）：
+
+- **100 行都带 `teamNo` 键** ✓
+- **55 行有值**（形如 `26-8972`）✓
+- 其余 45 行为 null（其中 2 行是主订单软删的存量行，`orderNo` 也为 null）
+
+---
+
+## 联系人
+
+- **后端负责人**: @wx
+- **前端负责人**: @mmg