From 3aea7c686f82a4ea31ed59af0cf96f65c647ad87 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 27 Sep 2026 09:56:16 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=88=BF=E5=8A=A1=E8=AE=A2?= =?UTF-8?q?=E5=8D=95=E5=88=97=E8=A1=A8=E6=88=B7=E7=BA=A7=E8=A1=A8=E6=A0=BC?= =?UTF-8?q?=E8=A1=A5=E5=9B=A2=E5=8F=B7=E5=88=97=E4=BA=A4=E6=8E=A5=E4=BB=B6?= =?UTF-8?q?=EF=BC=88=E5=89=8D=E7=AB=AF=E4=BC=98=E5=8C=96=EF=BC=8C=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E5=90=8E=E5=8F=B0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 (1M context) --- ...单列表户级表格补团号展示-前端优化-管理后台.md | 83 +++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 changelogs-v2/2026-09/27_frontend_房务订单列表户级表格补团号展示-前端优化-管理后台.md diff --git a/changelogs-v2/2026-09/27_frontend_房务订单列表户级表格补团号展示-前端优化-管理后台.md b/changelogs-v2/2026-09/27_frontend_房务订单列表户级表格补团号展示-前端优化-管理后台.md new file mode 100644 index 00000000..ad76dc73 --- /dev/null +++ b/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