Mimingguang
74cfa39a13
changelog-filename-gate / validate (push) Failing after 2s
HouseholdTable 订单号后加独立团号列 width 100,teamNo||'-' 直显,scroll-x 1110→1210;spec 8 例全绿。
84 行
3.7 KiB
Markdown
84 行
3.7 KiB
Markdown
---
|
||
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
|