---
schema: "hl-changelog/v2"
ticket: "frontend"
title: "房务订单列表户级表格补团号展示"
consumer: "admin"
author: "wx(GIT)"
change_type: "前端优化"
backend_status: "not_required"
gateway_status: "not_required"
frontend_status: "verified"
frontend_owner: "mmg"
frontend_ref: "e3f8de237672691e6fc62d0ac7de3c747c733d14"
target_release: "v2.1"
verified_at: "2026-09-27"
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 一律显示 -。前端已交付(mmg 2026-09-27,ref e3f8de23):HouseholdTable 订单号后加独立团号列 width 100,teamNo||'-' mono 直显,scroll-x 1110→1210;spec 8 例全绿,已验证。"
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