文件

T

changelog-filename-gate / validate (push) Failing after 1s

详情

docs(changelog): 应收台账加「全部/散客订单/团期」页签与行内查看按钮——前端动作指引（管理后台）

面向前端（mmg）的实施清单：顶部按 rowType 三态页签分流（必须走后端过滤），
行内「查看」按钮按 rowType 分流跳转（ORDER 跳订单详情用 id，GROUP_BATCH 跳出团详情用 groupBatchId）。
后端 #8504 已部署测试服，接口契约见同目录 29_8504 接口 changelog。

2026-09-29 13:57:12 +08:00

4.9 KiB

原始文件 Blame 文件历史

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

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	verified_at	target_release	status_note	updated_at	base
hl-changelog/v2	frontend	应收台账：加「全部 / 散客订单 / 团期」页签 + 行内「查看」按钮（按 rowType 分流跳转）	admin	yst	前端优化	deployed	not_required	required	mmg			v2.1	应收台账页加「全部/散客订单/团期」页签 + 行内查看按钮，后端 rowType 入参与跳转字段已就绪并部署测试服	2026-09-29	dev-v3

应收台账：加「全部 / 散客订单 / 团期」页签 + 查看按钮（管理后台）

本条是前端动作指引：告诉你要改哪个页面、加什么、怎么跳。接口字段级契约（请求参数 / 响应字段 / 枚举值 / 示例）见 #8504 接口 changelog changelogs-v2/2026-09/29_8504_应收台账加rowType入参-修改接口-管理后台.md，本条不重复抄字段表。后端已部署测试服，可直接联调。

一、背景

应收台账页 src/views/finance/receipt/receivable/index.vue（菜单「收款管理 / 应收台账」，#8369 已挂）当前是单列混合列表（订单行与团行混在一起）且没有查看入口。财务提了两个诉求：

顶部按行类型分流：能只看散客订单、或只看团期；
点行能直接跳进对应详情页，不用再手抄单号去别的页面查。

后端已就绪：GET /admin/finance/receipt/receivable/page 新增可选入参 rowType，且每行都带了 rowType / id / groupBatchId 三个跳转所需字段。本次是纯前端改动，等前端实施。

二、动作 1：顶部加页签「全部 / 散客订单 / 团期」

数据源：GET /admin/finance/receipt/receivable/page 新增可选入参 rowType
页签与传参映射：

页签	`rowType` 传值	含义
全部	不传（默认页签）	订单行 + 团行混合
散客订单	`rowType=ORDER`	只返回订单行
团期	`rowType=GROUP_BATCH`	只返回团行

⚠️ 必须走后端过滤：切页签时带 rowType 重新请求接口，不要拿到全量数据后在前端本地过滤—— 本地过滤会让分页 total 算错，翻页直接乱。
页签切换时重置到第 1 页再请求。

三、动作 2：行内加「查看」按钮，按 `rowType` 分流跳转

先看这一行的 rowType，再决定跳哪里、用哪个字段：

`rowType`	跳前端路由	用行内哪个字段	该路由对应的后端接口
`ORDER`	`/order-v2/detail/{id}`	行的 `id`（= 订单 ID）	`GET /v3/admin/order/{id}`
`GROUP_BATCH`	`/order-v2/batch/detail/{code}`	行的 `groupBatchId`（= 团期批次 ID）	`GET /v3/admin/order/group-batch/{groupBatchId}`

🔴 三条红线（踩了必 404）

🚫 必须先读 rowType 再决定跳哪——GROUP_BATCH 行绝不能拿 id 去跳订单详情：团行的 id 里装的是批次 ID 不是订单 ID，拿去查订单详情必 404。
团行跳转参数用独立的 groupBatchId 字段，别复用 id。
团期详情路由的参数名是 :code 不是 :id（页面叫「出团详情」）。

四、行内差异渲染

GROUP_BATCH 行的 customerName / customerPhone 恒为 null（团行没有单一客户概念）→ 显示「—」，不要渲染成「null」或空白。
orderStatusName / receivableStatusName 后端已翻译成中文，直接展示，不用前端再映射。

五、测试服联调

接口已部署测试服，网关地址 http://192.168.100.236:8080。
rowType 三态过滤（不传 / ORDER / GROUP_BATCH）与行内跳转字段已实测通过： ORDER 纯订单行、GROUP_BATCH 纯团行、分页 total 正确。
可直接联调，无需等后端部署。

六、验证检查清单

页签「全部 / 散客订单 / 团期」三态切换，请求分别不带 rowType / rowType=ORDER / rowType=GROUP_BATCH（Network 确认）
切页签时重置到第 1 页，分页 total 与当前页签数据一致（不是前端本地过滤）
「散客订单」页签点「查看」→ 跳 /order-v2/detail/{id}，id 为行内订单 ID，详情正常打开
「团期」页签点「查看」→ 跳 /order-v2/batch/detail/{code}，参数取行内 groupBatchId，出团详情正常打开
团行的客户姓名 / 手机号显示「—」，不出现 null 字样
状态列直接展示后端返回的中文名

七、关联

接口契约（入参 / 出参 / 枚举 / 示例，字段级）：#8504 changelog changelogs-v2/2026-09/29_8504_应收台账加rowType入参-修改接口-管理后台.md
Issue：wx/HL#8504
PR：wx/HL#8505

联系人

后端：yst ｜前端：mmg

4.9 KiB 原始文件 Blame 文件历史 Unescape Escape