From 2f5013a76aacf288f93de0a0d99d7be99b853b7c Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Sun, 4 Oct 2026 10:59:44 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8741=20=E4=BE=9B=E5=BA=94?=
 =?UTF-8?q?=E5=95=86=E6=B3=A8=E5=86=8C=E6=8F=90=E4=BA=A4=E6=A0=A1=E9=AA=8C?=
 =?UTF-8?q?=E8=AF=81=E4=BB=B6=E5=9B=BE=E7=89=87=E5=9C=B0=E5=9D=80=E5=B9=B6?=
 =?UTF-8?q?=E5=8E=BB=E6=8E=89=E5=BB=BA=E5=8D=95=E5=A4=B1=E8=B4=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Refs wx/HL#8741
---
 ...¡éªŒè¯�件图片地å�€å¹¶åŽ»æŽ‰å»ºå�•å¤±è´¥-修改接å�£-管ç�†å�Žå�°.md | 531 ++++++++++++++++++
 1 file changed, 531 insertions(+)
 create mode 100644 changelogs-v2/2026-10/04_8741_供应商注册�交校验�件图片地�并去掉建�失败-修改接�-管���.md

diff --git a/changelogs-v2/2026-10/04_8741_供应商注册�交校验�件图片地�并去掉建�失败-修改接�-管���.md b/changelogs-v2/2026-10/04_8741_供应商注册�交校验�件图片地�并去掉建�失败-修改接�-管���.md
new file mode 100644
index 00000000..72a069d8
--- /dev/null
+++ b/changelogs-v2/2026-10/04_8741_供应商注册�交校验�件图片地�并去掉建�失败-修改接�-管���.md
@@ -0,0 +1,531 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8741"
+title: "供应商注册�交：�件图片地��对直接返回 395065，状�与审批记录��出现「建�失败�"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "新增一�失败返回，�端按现有方�展示 message；状�展示�少了「建�失败�，若�端有按该文案�色或筛选的逻辑请一并去掉"
+updated_at: "2026-10-04"
+base: "dev-v3"
+---
+
+# 供应商: 注册�交校验�件图片地�，去掉「建�失败�状�
+
+> **�务**: hl-resource-service�hl-user-service
+> **PR**: #8758
+> **Issue**: #8741
+> **日期**: 2026-10-04
+> **影�范围**: 管�端供应商「�交审批�（注册审批）�供应商列表与详情的状��供应商审批记录
+
+---
+
+## ⚠� 关键�化
+
+- �交注册审批时，法人身份�人���国徽���业执照三张图片中任一张的地��是本平�图片�务器地�（�环境��，�文件中心�置），接�当场返回 `395065`「图片地��对�。供应商���稿，�产生审批记录。以�会先��，��建�业微信审批�失败��退回�稿，并显示「建�失败�。
+- 供应商列表�详情的状�展示���出现「建�失败�，原�显示「建�失败�的供应商显示「�稿�。供应商审批记录�审批记录列表的层级与状�文案中的「建�失败�也改为「�稿�。
+- �业微信审批�内容（�影�管�端接�）：「收款账户�显示银行� + 完整账�；「明细 → 结算信���个账户显示账户�称�账户类型�开户行�支行�账�；「注册资本�为纯数字时显示为数值加「万�（如 500 → 500万）。
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | �交供应商注册审批 | POST | `/admin/supplier/items/{supplierId}/submit` | 新增一�失败返回 | �件图片地��对时返回 395065 |
+| 2 | 供应商分页 | GET | `/admin/supplier/items/page` | 返回值文案�化 | `statusName` ��返回「建�失败�，改为「�稿� |
+| 3 | 供应商有界查询 | GET | `/admin/supplier/items/list` | 返回值文案�化 | �上 |
+| 4 | 供应商基本信� | GET | `/admin/supplier/items/{supplierId}/basic-info/view` | 返回值文案�化 | �上 |
+| 5 | 供应商审批记录 | GET | `/admin/supplier/items/{supplierId}/approval-history/page` | 返回值文案�化 | `approvalStatusName`�`chainLevelText` ��返回「建�失败�，改为「�稿� |
+| 6 | 审批记录列表 | GET | `/admin/supplier/items/approval-records/page` | 返回值文案�化 | `chainLevelText` ��返回「建�失败�，改为「�稿� |
+
+---
+
+## 三�接�详情
+
+### 1. �交供应商注册审批 `POST /admin/supplier/items/{supplierId}/submit`
+
+**VO**: `SupplierSubmitReqVO` → `SupplierApprovalCommandRespVO`
+
+#### 使用场景
+
+管�员把�稿供应商�交注册审批。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| supplierId | Path | Long | ✅ | 正整数 | �稿供应商 ID |
+| expectedUpdateTime | Body | String | ✅ | `yyyy-MM-dd HH:mm:ss` | �观�，�详情里的 updateTime |
+| legalRepresentativeIdCardFrontUrl | Body | String | - | �空时须为本平�图片地� | 法人身份�人�� |
+| legalRepresentativeIdCardBackUrl | Body | String | - | �空时须为本平�图片地� | 法人身份�国徽� |
+| licenseImageUrl | Body | String | - | �空时须为本平�图片地� | �业执照 |
+| 其余注册资料字段 | Body | - | - | �现有�交接� | 本次未改 |
+
+本平�图片地��管�端文件上传返回的地�（TEST 形如 `https://hlgl-test.oss-cn-beijing.aliyuncs.com/test/...`，正�环境�缀为 `prod`）。
+
+#### 出� `Result<SupplierApprovalCommandRespVO>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| approvalLogId | String | 审批记录 ID |
+| requestNo | String | 幂等请求� |
+| provider | String | 审批方�，�业微信为 `WECOM` |
+| approvalStatus | String | 审批状�，�交�为 `PENDING` |
+| approvalStatusName | String | 审批状�中文� |
+| spNo | String | �业微信审批��，异步建�完��为空 |
+| syncStatus | String | �步状� |
+| submittedAt | String | �交时间 |
+
+本次出���。
+
+#### 请求示例
+
+```json
+{
+  "expectedUpdateTime": "2026-10-03 11:31:05",
+  "fullName": "鄂温克�自治旗巴彦呼硕�原牧家�有�公�",
+  "legalRepresentativeIdCardFrontUrl": "https://hlgl-test.oss-cn-beijing.aliyuncs.com/test/other/2026/10/03/9c21c0b068c00baa227cfd450e6706ae.png",
+  "legalRepresentativeIdCardBackUrl": "https://hlgl-test.oss-cn-beijing.aliyuncs.com/test/other/2026/10/03/a1d6e23d67830251b1fdd251c6d885ad.png",
+  "licenseImageUrl": "https://hlgl-test.oss-cn-beijing.aliyuncs.com/test/other/2026/10/03/1f287826963710fa564639f4c0de8aac.png"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "approvalLogId": "2106260000000000001",
+    "provider": "WECOM",
+    "approvalStatus": "PENDING",
+    "approvalStatusName": "审核中",
+    "syncStatus": "REQUESTING"
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+本接�没有空数�。文件中心暂��用���到本平�图片地�时�放行，返回 `100903`「远程�务暂��用: 文件中心�，供应商���稿��产生审批记录，���试��。
+
+#### 错误�应
+
+```json
+{
+  "code": 395065,
+  "message": "图片地��对",
+  "success": false
+}
+```
+
+#### 业务边界
+
+- 鉴������观��必填校验与现有�交接�相�。
+- 三张�件图�校验�空的那几张；为空的维�现状（�上传该附件）。
+- 任一张�是本平�图片地�：返回 395065，本次�交的资料��存��产生审批记录�供应商�为�稿（零写入）。
+- 已有在途注册审批时���交，�按原规则返回在途结果。
+- 修正图片��直接�新�交。
+
+### 2. 供应商分页 `GET /admin/supplier/items/page`
+
+**VO**: `SupplierPageReqVO` → `PageResult<SupplierListItemRespVO>`
+
+#### 使用场景
+
+管�端供应商列表。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| keyword | Query | String | - | - | 编�/�称关键字 |
+| status | Query | String | - | 生命周期编� | 状�筛选，�� |
+| typeCode | Query | String | - | - | 供应商类型 |
+| creditLevel | Query | String | - | A/B/C/D | 信用等级 |
+| creatorId | Query | Long | - | - | 创建人 |
+| page | Query | Integer | - | ≥1 | 页� |
+| pageSize | Query | Integer | - | ≥1 | �页�数 |
+
+本次入���。
+
+#### 出� `Result<PageResult<SupplierListItemRespVO>>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| status | String | 生命周期编�，�� |
+| statusName | String | 展示�；明确建�失败的�稿供应商由「建�失败�改为「�稿� |
+
+其余字段��。
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/page?keyword=SUP260262&page=1&pageSize=20
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "data": { "list": [ { "supplierNo": "SUP260262", "status": "DRAFT", "statusName": "�稿" } ] }, "success": true }
+```
+
+#### 空数� / �级�应
+
+无数�时返回空列表或原有空值，本次��。
+
+#### 错误�应
+
+本次没有新增错误�，沿用现有错误返回，例如：
+
+```json
+{ "code": 395001, "message": "供应商�存在", "success": false }
+```
+
+#### 业务边界
+
+- 鉴�与数����分页与筛选��；�有状�展示�从「建�失败�改为「�稿�，`status` 编�与按状�筛选��。
+
+### 3. 供应商有界查询 `GET /admin/supplier/items/list`
+
+**VO**: `SupplierListReqVO` → `List<SupplierListItemRespVO>`
+
+#### 使用场景
+
+下拉或关�选择时有界查询供应商。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| keyword | Query | String | - | - | 编�/�称关键字 |
+| status | Query | String | - | 生命周期编� | 状�筛选，�� |
+| typeCode | Query | String | - | - | 供应商类型 |
+| resourceModule | Query | String | - | 与 resourceId �时传 | 资�模� |
+| resourceId | Query | Long | - | 与 resourceModule �时传 | 资� ID |
+| limit | Query | Integer | - | 默认 50，最多 200 | 返回�数 |
+
+本次入���。
+
+#### 出� `Result<List<SupplierListItemRespVO>>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| status | String | 生命周期编�，�� |
+| statusName | String | 展示�；明确建�失败的�稿供应商由「建�失败�改为「�稿� |
+
+其余字段��。
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/list?keyword=SUP260262
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "data": [ { "supplierNo": "SUP260262", "status": "DRAFT", "statusName": "�稿" } ], "success": true }
+```
+
+#### 空数� / �级�应
+
+无数�时返回空列表或原有空值，本次��。
+
+#### 错误�应
+
+本次没有新增错误�，沿用现有错误返回，例如：
+
+```json
+{ "code": 395001, "message": "供应商�存在", "success": false }
+```
+
+#### 业务边界
+
+- 鉴�与数����分页与筛选��；�有状�展示�从「建�失败�改为「�稿�，`status` 编�与按状�筛选��。
+
+### 4. 供应商基本信� `GET /admin/supplier/items/{supplierId}/basic-info/view`
+
+**VO**: `—（Path �数）` → `SupplierBasicInfoRespVO`
+
+#### 使用场景
+
+供应商详情与编辑页回显。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| supplierId | Path | Long | ✅ | 正整数 | 供应商 ID |
+
+本次入���。
+
+#### 出� `Result<SupplierBasicInfoRespVO>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| status | String | 生命周期编�，�� |
+| statusName | String | 展示�；明确建�失败的�稿供应商由「建�失败�改为「�稿� |
+
+其余字段��。
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/2105983859848060929/basic-info/view
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "data": { "supplierNo": "SUP260262", "status": "DRAFT", "statusName": "�稿" }, "success": true }
+```
+
+#### 空数� / �级�应
+
+无数�时返回空列表或原有空值，本次��。
+
+#### 错误�应
+
+本次没有新增错误�，沿用现有错误返回，例如：
+
+```json
+{ "code": 395001, "message": "供应商�存在", "success": false }
+```
+
+#### 业务边界
+
+- 鉴�与数����分页与筛选��；�有状�展示�从「建�失败�改为「�稿�，`status` 编�与按状�筛选��。
+
+### 5. 供应商审批记录 `GET /admin/supplier/items/{supplierId}/approval-history/page`
+
+**VO**: `SupplierApprovalHistoryPageReqVO` → `PageResult<SupplierApprovalHistoryRespVO>`
+
+#### 使用场景
+
+供应商详情页的审批记录。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| supplierId | Path | Long | ✅ | 正整数 | 供应商 ID |
+| bizType | Query | String | - | - | 审批类型 |
+| approvalStatus | Query | String | - | - | 审批状�编� |
+| action | Query | String | - | - | 业务动作 |
+| from / to | Query | String | - | `yyyy-MM-dd HH:mm:ss`，需�时传 | �交时间范围 |
+| sortBy / sortDirection | Query | String | - | 默认 submittedAt / DESC | 排� |
+| page | Query | Integer | - | ≥1 | 页� |
+| pageSize | Query | Integer | - | ≥1 | �页�数 |
+
+本次入���。
+
+#### 出� `Result<PageResult<SupplierApprovalHistoryRespVO>>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| approvalStatus | String | 审批状�编�，��（如 `FAILED`） |
+| approvalStatusName | String | 注册明确未建�由「建�失败�改为「�稿� |
+| chainLevelText | String | 注册明确未建�由「建�失败�改为「�稿� |
+
+其余字段��。
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/2105983859848060929/approval-history/page?page=1&pageSize=50
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "data": { "list": [ { "approvalStatus": "FAILED", "approvalStatusName": "�稿", "chainLevelText": "�稿", "actionName": "�交�稿" } ] }, "success": true }
+```
+
+#### 空数� / �级�应
+
+无数�时返回空列表或原有空值，本次��。
+
+#### 错误�应
+
+本次没有新增错误�，沿用现有错误返回，例如：
+
+```json
+{ "code": 395001, "message": "供应商�存在", "success": false }
+```
+
+#### 业务边界
+
+- 鉴��分页�筛选与行数��；�有注册明确未建�那一行的展示文案从「建�失败�改为「�稿�，`approvalStatus` 编���。
+
+### 6. 审批记录列表 `GET /admin/supplier/items/approval-records/page`
+
+**VO**: `SupplierApprovalLogPageReqVO` → `PageResult<SupplierApprovalLogPageItemRespVO>`
+
+#### 使用场景
+
+跨供应商的审批记录列表。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| supplierNo | Query | String | - | - | 供应商编� |
+| fullName | Query | String | - | - | 供应商�称 |
+| bizType | Query | String | - | - | 审批类型 |
+| approvalStatus | Query | String | - | - | 审批状�编� |
+| from / to | Query | String | - | `yyyy-MM-dd HH:mm:ss` | �交时间范围 |
+| page | Query | Integer | - | ≥1 | 页� |
+| pageSize | Query | Integer | - | ≥1 | �页�数 |
+
+本次入���。
+
+#### 出� `Result<PageResult<SupplierApprovalLogPageItemRespVO>>`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| approvalStatus | String | 审批状�编�，�� |
+| chainLevelText | String | 注册明确未建�由「建�失败�改为「�稿� |
+
+其余字段��。
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/approval-records/page?supplierNo=SUP260262&page=1&pageSize=50
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "data": { "list": [ { "supplierNo": "SUP260262", "approvalStatus": "FAILED", "chainLevelText": "�稿" } ] }, "success": true }
+```
+
+#### 空数� / �级�应
+
+无数�时返回空列表或原有空值，本次��。
+
+#### 错误�应
+
+本次没有新增错误�，沿用现有错误返回，例如：
+
+```json
+{ "code": 395001, "message": "供应商�存在", "success": false }
+```
+
+#### 业务边界
+
+- 鉴��分页�筛选与行数��；�有注册明确未建�那一行的展示文案从「建�失败�改为「�稿�，`approvalStatus` 编���。
+
+---
+
+## 四�契约约�与正确调用方�（接�类必写）
+
+### ✅ 正确 / � 错误 payload 对照
+
+| 场景 | payload |
+|------|---------|
+| ✅ 三张图都是文件上传返回的地� | `{ "licenseImageUrl": "https://hlgl-test.oss-cn-beijing.aliyuncs.com/test/other/2026/10/03/a.png", ... }` |
+| ✅ �张图为空 | `{ "legalRepresentativeIdCardBackUrl": null, ... }` |
+| � 外站地� | `{ "licenseImageUrl": "https://img.hlbe-travel.com/supplier/2026/1002/x.jpg" }` → 395065 |
+| � 其他环境的地�（如 TEST �交正�环境 `prod/` �缀地�） | `{ "licenseImageUrl": "https://hlgl-test.oss-cn-beijing.aliyuncs.com/prod/x.png" }` → 395065 |
+
+### 切�状�时的必�动作
+
+收到 395065 时，让用户�新上传三张�件图（用管�端文件上传返回的地�），�带最新 `expectedUpdateTime` �新�交。
+
+---
+
+## 五�数�库行为（涉�写�作时必写）
+
+| �交结果 | 供应商资料 | 供应商状� | 审批记录 |
+|----------|-----------|-----------|---------|
+| 图片地�都对 | 按�交内容�存 | 进入注册审核中 | 新增 1 � |
+| 任一张图片地��对（395065） | ��存（本次�交整体回滚） | ���稿 | �新增 |
+| 文件中心��用（100903） | ��存 | ���稿 | �新增 |
+
+---
+
+## 六�边界行为
+
+- 未登录 → 401（网关拦截）；无�� → 沿用现有错误。
+- 图片地�为空 → �校验该张，照原规则�交。
+- 文件中心��用 → 100903，�放行。
+- 历�上显示「建�失败�的供应商 → 现在直接显示「�稿�，�修正图片��新�交。
+
+---
+
+## 六.6�修改��对比（修改/删除类接�必写，新增跳过）
+
+### 字段级对比
+
+| 字段 | 改� | 改� |
+|------|------|------|
+| `statusName`（列表�详情） | 明确建�失败时为「建�失败� | 「�稿� |
+| `approvalStatusName`�`chainLevelText`（审批记录） | 「建�失败� | 「�稿� |
+| `chainLevelText`（审批记录列表） | 「建�失败� | 「�稿� |
+
+### 行为级对比
+
+| 行为 | 改� | 改� |
+|------|------|------|
+| �件图在外站时�交注册审批 | 接�先��，��建�业微信审批�失败，自动���退回�稿并显示「建�失败� | 接�当场返回 395065「图片地��对�，零写入 |
+| �业微信审批�「收款账户� | 银行� 尾�xxxx | 银行� 完整账� |
+| �业微信审批�「明细 → 结算信�� | 银行� 尾�xxxx | �个账户：账户�称�账户类型�开户行�支行�账� |
+| �业微信审批�「注册资本� | 原样（如 500） | 纯数字补「万�（如 500万），已带��的原样 |
+
+## 六.7�影�评估（修改/删除类必写）
+
+- **是�破���兼容**: �（新增一�失败返回；展示文案少了「建�失败�一��值）
+- **�端是�必须�步上线**: �
+- **�端 workaround 清�点**: 如有按「建�失败�文案�色�筛选或�示的逻辑，�以去掉
+
+## 七��影�范围（显�声明, 帮�端/QA 缩�排查�）
+
+- **仅影�**: 供应商注册「�交审批�接�；供应商状�展示�与审批记录文案中的「建�失败�
+- **零影�**:
+  - 供应商生命周期状�编��状�筛选�状�机
+  - �作中资料�更审批�状��更审批�收款账户审批
+  - 主档注册资本存值与管�端展示（「万��加在�业微信审批�上）
+
+---
+
+## 八�测试环境已验�
+
+TEST 已部署 dev-v3 `df99bfedf`（包��并�交 `a73f015e7`），� Gateway 实测：
+
+```
+SUP260262�SUP260260（�件图在外站）�新�交 → 395065「图片地��对�，�为�稿，审批记录�� 3 � ✓
+自造�稿 SUP260266 �把�业执照��外站地��交 → 395065，�为�稿��业执照未被改写�无审批记录 ✓
+两家列表与详情状�展示「�稿�，审批记录与审批记录列表无「建�失败�；供应商列表整表 256 家无「建�失败� ✓
+SUP260266 三张图为本平�地�时�交 → ��并生��业微信审批� 202610040008 ✓
+```
+
+---
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#8741](https://git.1814.love/wx/HL/issues/8741)
+- 关� PR: [wx/HL#8758](https://git.1814.love/wx/HL/pulls/8758)
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8741](https://git.1814.love/wx/HL/issues/8741)
+- **PR**: [#8758](https://git.1814.love/wx/HL/pulls/8758)
+- **Merge commit**: [a73f015e7](https://git.1814.love/wx/HL/commit/a73f015e7)
+
+### �系人
+
+- **�端负责人**: @lc