From 2cbdcfb13a4be84a0b720b6534953987ce2fb906 Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Mon, 24 Aug 2026 21:18:26 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E8=AE=B0=E5=BD=95=20#6273?=
 =?UTF-8?q?=20=E5=AE=A1=E6=89=B9=E7=BC=96=E5=8F=B7=E6=89=A9=E5=B1=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...•†å®¡æ‰¹è®°å½•è¡¥å……供应商编å�·-修改接å�£-管ç�†å�Žå�°.md | 117 ++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 changelogs-v2/2026-08/24_6273_供应商审批记录补充供应商编�-修改接�-管���.md

diff --git a/changelogs-v2/2026-08/24_6273_供应商审批记录补充供应商编�-修改接�-管���.md b/changelogs-v2/2026-08/24_6273_供应商审批记录补充供应商编�-修改接�-管���.md
new file mode 100644
index 00000000..ae6b90d8
--- /dev/null
+++ b/changelogs-v2/2026-08/24_6273_供应商审批记录补充供应商编�-修改接�-管���.md
@@ -0,0 +1,117 @@
+---
+schema: "hl-changelog/v2"
+ticket: "6273"
+title: "供应商审批记录补充供应商编�"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: "2026-08-24"
+status_note: "PR #6274 已�并 dev-v3，�并�交 588573ae4 已� Resource �实例滚动部署到 TEST。审批记录分页项新增当�供应商编� supplierNo；既有目标字段�脱�字段����分页和闭区间时间筛选����。管�端列展示和自然日边界组装�待�端交付。"
+updated_at: "2026-08-24"
+base: "dev-v3"
+---
+
+# 供应商审批记录补充供应商编�
+
+供应商详情的审批记录分页项新增当�供应商编� `supplierNo`，供管�端直接展示。此次是��兼容的�应扩展，�删除或�命�既有字段，也�改�查询���和脱�语义。
+
+## �更接�
+
+| 方法 | 路径 | �� | 行为�化 |
+|---|---|---|---|
+| GET | `/admin/supplier/items/{supplierId}/approval-records/page` | `supplier:approval:read` | ��分页记录新增 `supplierNo` |
+
+请求�数�分页外壳和排�规则�未�化。
+
+## 新增�应字段
+
+| 字段 | 类型 | 空值语义 | 说明 |
+|---|---|---|---|
+| `supplierNo` | String / null | 尚未生�编�的�稿返回 `null` | 当�供应商编�，直接�自供应商主体档案；�能从供应商 ID�审计 JSON 或展示摘�推导 |
+
+典型分页项如下；示例值仅说明字段结构：
+
+```json
+{
+  "supplierId": "2091715622923657217",
+  "supplierNo": "SUP2091715622923657217",
+  "supplierName": "示例供应商",
+  "supplierTypes": [],
+  "operationType": "UPDATE",
+  "targetType": "SUPPLIER",
+  "targetId": null,
+  "oldValueMasked": "统一社会信用代�：****",
+  "newValueMasked": "统一社会信用代�：****",
+  "changeReason": "�交注册��存完整表�",
+  "status": "�稿",
+  "operatorName": "示例管�员",
+  "operatorRole": "超级管�员",
+  "createTime": "2026-08-24 10:34:34"
+}
+```
+
+## ��兼容的字段与行为
+
+- `targetType` 和 `targetId` 继续返回；管�端�以��“目标类型�列，但�能把�端��等�于删除接�字段。
+- `oldValueMasked` 和 `newValueMasked` 继续返回脱��的业务摘�。管�端表头�简化为“�更��“�更��，但�得改为读�或展示未脱�数�。
+- `page`�`pageSize`�`operationType`�`status`�`from`�`to`�`sortBy` 和 `sortDirection` 的请求约���。
+- 查询�使用 `createTime >= from AND createTime <= to` 的闭区间语义；�务端�替客户端推导自然日边界。
+- 认�方��`supplier:approval:read` ���管�员数�范围�排��错误��Gateway 路由和统一 `Result<T>` 外壳�未�化。
+- �新增数�库 migration，�修改�置�Redis�MQ�审批状�机�审计写入或跨�务契约。
+
+## 管�端待办
+
+1. 在审批记录表格最��增加“供应商编��列，绑定 `supplierNo`；空值显示 `—`。
+2. ��“目标类型�列，但�留接�兼容字段，��求�端删除 `targetType`。
+3. 将“�更�（脱�）�“�更�（脱�）�表头改为“�更��“�更��；�元格�绑定 `oldValueMasked`�`newValueMasked`。
+4. 日期查询开始值组装为当天 `00:00:00`，结�值组装为当天 `23:59:59`，并在查询�件�化��置到第 1 页。
+
+若选择�一天，�能把开始和结�都�交为 `00:00:00`。例如查询 2026-08-24 应�交：
+
+```text
+from=2026-08-24 00:00:00
+to=2026-08-24 23:59:59
+```
+
+## 错误与边界语义
+
+| 场景 | 结果 |
+|---|---|
+| `from` 晚于 `to` | �数校验失败，消�为 `from�能晚于to` |
+| �传 `from` 或�传 `to` | �数校验失败，时间边界必须�对�交 |
+| 未认� | 统一�应 `code=401`�`success=false`；HTTP 状��能�为 200 |
+| 无读���或超出数�范围 | �务端拒�查询，�返回审批记录 |
+| 筛选结果为空 | 返回空分页，`records=[]`，�返回 `null` |
+
+## 验���
+
+- 自动化：供应商审批记录 Controller�投影和查询�焦测试 16 项零失败；Resource 全� 1954 项零失败，38 项仓库既有�件跳过。
+- 部署：TEST 部署任务 `32288c37` �功�退出� 0；`hl-resource-service` 的 8182�8082 �实例�次�动并�康。部署�务器 HEAD `435ae0a86` 包�目标�并�交 `588573ae4` 和功能�交 `9cf77177c`。
+- 真实 Gateway：使用现有有效超级管�员登录�查询 4 �审批记录，���返回当� `supplierNo`；`targetType`�`targetId`�`oldValueMasked` 和 `newValueMasked` �时�留，脱�摘��包�掩�。
+- 分页兼容：请求 `page=1&pageSize=2` 返回 2 �记录�总数 4，新增字段�改�分页外壳。
+- 时间边界：�一自然日 `00:00:00` 至 `23:59:59` 返回 4 �；旧�端把结�值�交为 `00:00:00` 时返回 0 �，�明日期问题�自客户端结�边界组装。
+- �数门�：��时间范围被拒�并返回 `from�能晚于to`。
+- 认�门�：��带 Authorization � TEST Gateway 查询，返回 HTTP 200�业务� `401`�`success=false`；该结果仅作为负�门�验�，�计作正�验收。
+- 清�：本次 TEST 验收�执行�读分页查询，未产生数�库�Redis�MQ�文件或外部业务副作用，无需测试数�清�。
+
+## 撤回
+
+1. 先�止�布或回退�赖 `supplierNo` 的管�端版本，���端字段回退�出现空列。
+2. 从最新 `dev-v3` 创建回退分支，执行 `git revert -m 1 --no-edit 588573ae4ae016829d90dbb365f5c8ec3df981f0`，�独立 PR �入。
+3. �新构建并滚动部署 `hl-resource-service`；无需��数�库��置�Redis 或 MQ，没有��逆数�影�。
+4. 回退�接�����返回 `supplierNo`；�测原有分页����数�范围�脱�字段�目标字段�排�和闭区间时间筛选。
+5. 撤回本 Changelog 时，以新的文档�交删除本文件或明确标记撤回，并通知管�端�止消费新增字段；���写已�布�交历�。
+
+## 关� / �系人
+
+- **Issue**: [#6273](https://git.1814.love:8443/wx/HL/issues/6273)
+- **PR**: [#6274](https://git.1814.love:8443/wx/HL/pulls/6274)
+- **�并�交**: [588573ae4](https://git.1814.love:8443/wx/HL/commit/588573ae4ae016829d90dbb365f5c8ec3df981f0)
+- **�端负责人**: @lc
+- **�端负责人**: @mmg