hl-api-changelog/changelogs-v2/2026-09/12_7587_供应商详情审批记录补充变更前后状态-修改接口-管理后台.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	7587	供应商详情审批记录补充变更前后状态	admin	lc(GIT)	修改接口	deployed	verified	verified	mmg	e3ff8510		2026-09-13	口径已由 #7607 更正（2026-09-13）：这三个字段现在表示审批链推进，本条描述的供应商生命周期流转语义作废，请以 #7607 条目为准；前端已直显 statusChangeText，该更正不需要前端再改代码。原始记录：PR #7588 已合并 dev-v3，合并提交 7b31f7628 由部署任务 7acf6380 精确发布到 TEST，并经真实 Gateway 身份对 40 个供应商的 166 条审批记录逐行验证。审批记录每行新增变更前后状态编码与中文文案，原有 13 个字段取值不变。 前端 2026-09-13 已交付(hl-admin e3ff8510):实证审批记录弹窗 SupplierApprovalRecordsModal 列定义未读 statusChangeText,在「动作」列后补「状态变化」列直显后端拼好的 statusChangeText(资料变更审批后端固定返占位 —,字段永不 null),不解析编码、不前端拼箭头。checkpoint 7 项全绿(含生产构建)。	2026-09-13	dev-v3

供应商详情审批记录补充变更前后状态

⚠️ 本条口径已作废（2026-09-13）：这三个字段现在表示的是审批链推进（「草稿 → 1级通过」「1级通过 → 2级通过」），不是下文描述的供应商生命周期流转。请以同目录 13_7607_供应商审批记录改按审批链推进显示并修正或签审批人-修改接口-管理后台.md 为准，下文仅保留作历史记录。

供应商详情「审批记录」列表每行新增本次审批的供应商状态变化，便于在表格中直接展示「暂停合作 → 黑名单」这类状态流转。不改变状态的审批返回占位符。

变更接口

方法	路径	行为变化
GET	/admin/supplier/items/{supplierId}/approval-history/page	records[] 新增 statusBefore、statusAfter、statusChangeText

原有 bizType、bizTypeName、applicantName、approvalStatus、approvalStatusName、action、actionName、chainLevel、chainLevelText、approverName、opinion、submittedAt、finishedAt 共 13 个字段的字段名、JSON 类型与取值均不变。

响应片段示例：

{
  "bizType": "STATUS_CHANGE",
  "bizTypeName": "供应商状态变更审批",
  "chainLevelText": "第1级通过",
  "statusBefore": "SUSPENDED",
  "statusAfter": "BLACKLIST",
  "statusChangeText": "暂停合作 → 黑名单"
}

字段语义

• statusChangeText：可直接展示的中文文案，形如「暂停合作 → 黑名单」；本次审批不改变供应商状态，或历史记录信息不足以判定时固定返回占位符 —（与该接口 opinion 的空值占位一致）。该字段始终有值，不会为 null。
• statusBefore / statusAfter：对应的生命周期状态编码，取值范围 DRAFT 草稿、VETTING 审核中、ACTIVE 合作中、SUSPENDED 暂停合作、BLACKLIST 黑名单、ARCHIVED 已归档。当 statusChangeText 为 — 时这两个字段为 null。
• 各业务类型的取值规则：建档审批为「草稿 → 合作中」；状态变更审批按业务子类型给出「暂停合作 → 黑名单」「黑名单 → 暂停合作」「暂停合作 → 已归档」「黑名单 → 已归档」；资料变更审批不改变状态，返回 —。
• 同一张审批单拆出的多个层级行（第 1 级、第 2 级……）三个字段取值相同。
• 该列表达的是本次审批申请要把供应商改成什么状态，与审批是否通过无关；审批结果仍由既有 approvalStatusName 表达，已驳回的申请同样显示其申请的目标状态。

管理端接入事项

1. 审批记录表格新增一列展示状态变化，取 statusChangeText 直接渲染即可，无需前端拼接箭头或翻译编码。
2. 需要按状态做筛选、着色或图标时使用 statusBefore / statusAfter 编码，不要解析中文文案。
3. 该列在资料变更审批行会显示 —，属于正常业务结果，不是数据缺失。
4. 暂停合作与恢复合作由后台直接改状态、不走审批，因此审批记录中不会出现这两类状态变化。

兼容性与未变化范围

• 本次是既有 GET 响应的向后兼容扩展，不新增接口、请求参数、业务错误码、Gateway 路由或权限点；分页、排序、筛选参数与语义不变。
• 不修改任何数据库数据与表结构，不新增 migration，不回填历史数据。
• 不改变审批链路、状态机、供应商变更记录接口（/change-records/page、/approval-records/page）与账户审批展示。
• 不修改配置、Redis、MQ 或跨服务写契约。
• 本工单只交付后端；管理端源码未在后端仓库修改，前端状态保持 pending，直至完成该列展示并提供验证提交。