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

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	frontend	房务订单列表户级表格补团号展示	admin	wx(GIT)	前端优化	not_required	not_required	verified	mmg	e3f8de237672691e6fc62d0ac7de3c747c733d14	v2.1	2026-09-27	后端接口 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 例全绿,已验证。	2026-09-27	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