From 8f45e333f4d4eebb891225c0a8fe97a56813ef29 Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Sun, 23 Aug 2026 17:14:33 +0800
Subject: [PATCH] docs(supplier): align frontend changelog with template

---
 ...”商模å�—å‰�端è�”调接å�£æ±‡æ€»-修改接å�£-管ç�†å�Žå�°.md | 77 ++++++++++++++++++-
 1 file changed, 76 insertions(+), 1 deletion(-)

diff --git a/changelogs-v2/2026-08/23_6195_供应商模��端�调接�汇总-修改接�-管���.md b/changelogs-v2/2026-08/23_6195_供应商模��端�调接�汇总-修改接�-管���.md
index f692ab72..a2826c3f 100644
--- a/changelogs-v2/2026-08/23_6195_供应商模��端�调接�汇总-修改接�-管���.md
+++ b/changelogs-v2/2026-08/23_6195_供应商模��端�调接�汇总-修改接�-管���.md
@@ -12,13 +12,28 @@ frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "汇总 #6153�#6161-#6164�#6174�#6195�#6197�#6200�#6205 的当�管�端接�契约，新增�端�调版�文件 HTML；15 个接�已实现��调，SUP-ADM-010 �� 395032 失败关闭。"
+status_note: "汇总 #6153�#6161-#6164�#6174�#6195�#6197�#6200�#6205 的当�管�端接�契约，新增�端�调版�文件 HTML；16 个接�已实现��调，SUP-ADM-010 �� 395032 失败关闭。"
 updated_at: "2026-08-23"
 base: "dev-v3"
 ---
 
 # 供应商模��端�调接�汇总
 
+> **存放目录**: 二期 v3 → `changelogs-v2/2026-08/`
+> **�务**: `hl-resource-service`（8082）
+> **PR**: 供应商模��实现工�对应�并请求
+> **Issue**: #6195（汇总 #6153�#6161–#6164�#6174�#6197�#6200�#6205）
+> **日期**: 2026-08-23
+> **影�范围**: 管���供应商档案�账户和资�关�页�
+
+## ⚠� 关键�化
+
+本�目将已交付的供应商接�统一整�为�端�调契约；共 16 个接�。归档接� `SUP-ADM-010` 仅完���门�和失败关闭，清账�供方未接入时固定返回 `395032`，��按�功归档�程处�。
+
+## 一�背景
+
+本�目汇总已 TEST 验收并关闭的供应商工�，统一接�路径����字典和失败语义，���端继续使用旧版设计稿或��枚举。
+
 本�目为�端�调索引，�替代接��片中的完整请求��应�字段和错误�说明。完整契约�：[供应商模� API 接�规范 v2.1 �端�调版](../../api-docs/supplier/%E4%BE%9B%E5%BA%94%E5%95%86%E6%A8%A1%E5%9D%97%20API%20%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83-v2.1-%E5%89%8D%E7%AB%AF%E8%81%94%E8%B0%83%E7%89%88.html)。原始 v2.0 设计/生�基线�留�改。
 
 ## �更接�
@@ -42,12 +57,60 @@ base: "dev-v3"
 | SUP-ADM-049 | PUT | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/update` | `supplier:update` | 已实现 · ��调 |
 | SUP-ADM-050 | POST | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind` | `supplier:update` | 已实现 · ��调 |
 
+## 三�接�详情
+
+完整字段级请求��应�错误�和接�约���调版 HTML；本表为入�索引，��与 HTML 维护两份字段定义。
+
+## 四�契约约�与正确调用方�
+
+- 所有管�端请求必须� Gateway 并�带真实管�员认�；�得伪造 `X-Admin-Id`。
+- 字典接�返回的 `dictValue` �是业务�交值；�得�交中文标签或 `dictDataId`。
+- 更新��交�资�改绑和解绑必须�带�务端返回的并�时间字段。
+- `qualType`�`contactRole` 当�为自由文本，�按未确认字典拦截。
+
+## 五�数�库行为
+
+本�目�新增或修改数�库结构；供应商接�按既有事务�软删除�审计和�感字段脱�规则执行。
+
+## 六�边界行为
+
+- 未认�或无��：由 Gateway/�务端拒�，�产生业务写入。
+- 业务失败�能使用 HTTP 200，必须�时判断 `code`�`success` 和 `data`。
+- `SUP-ADM-010` 返回 `395032` 时�进入审批�状��移或审计写入。
+
+## 六.5�枚举 / 数�字典
+
+### 供应商类型（平�字典 `supplier_type`）
+
+**所属字段**: `typeCode` / `types[].typeCode` | **类型**: `String`
+
+�行时�用项�标签和排�以 `GET /admin/dict/data/supplier_type` 返回为准。
+
+### 供应商生命周期（平�字典 `supplier_lifecycle_status`）
+
+**所属字段**: `status` | **类型**: `String`
+
+�行时�用项�标签和排�以 `GET /admin/dict/data/supplier_lifecycle_status` 返回为准；字典项�是全部�跳转状�。
+
+## 六.7�影�评估
+
+- **是�破���兼容**: �
+- **�端是�必须�步上线**: 是，需按本�调契约接入
+- **�端 workaround 清�点**: 清�页�内硬编�的供应商类型和生命周期中文文案
+
+## 七��影�范围
+
+- **仅影�**: 管���供应商模�
+- **零影�**: �程�接��订��务�Fleet 业务数��Finance 清账能力
+
 ## 统一接入约�
 
 - 所有 `/admin/supplier/**` 请求必须� Gateway，认�级别为 `MANDATORY`；客户端�得使用自报 `X-Admin-Id` 或角色替代有效登录�。
 - �务端按�信管�员身份校验平���；����或按钮�构�授�。
 - Snowflake ID 按 JSON 字符串传输；`LocalDateTime` 使用 `yyyy-MM-dd HH:mm:ss`。
 - 供应商类型和生命周期状�从平�字典读�，业务请求��交 `dictValue`，�端�应写死中文标签。
+- 本次字典范围仅确认 `supplier_type` 与 `supplier_lifecycle_status`；两者的�行时�用项�标签和排�以 `/admin/dict/data/{dictType}` 返回为准，文档中的编�表�是契约基线，�是环境现状。
+- `qualType`�`contactRole` 暂�接入平�字典，��自由文本；�端�得按未确认候选值�字典校验或自行新增下拉选项。
 - 账��税��电�和�照��返回脱�值。`proofFileUrls` �能因��缺失而整个字段�返回。
 - 更新��交�资�改绑和解绑必须原样�带�应中的并�时间字段；收到 `395014` 或并�错误时�新查询���作。
 - 统一�应�能以 HTTP 200 承载业务失败，必须�时判断 `code`�`success` 和 `data`。
@@ -63,6 +126,18 @@ base: "dev-v3"
 - 自动化回归：Supplier �焦测试 `150/150`，Resource 全� `1906` 项零失败（38 项既有�件跳过），Gateway 供应商路由/JWT `8/8`，#6205 定� `5/5`。
 - 测试使用独立一次性 schema；测试数��临时账��Token 和临时�务已清�，原环境已��。
 
+## 八�测试环境已验�
+
+真实管�员� Gateway 完� 105 项 E2E 断言；Supplier �焦测试 `150/150`�Resource 全� `1906` 零失败�Gateway 供应商路由/JWT `8/8`�#6205 定� `5/5`。
+
+## ��相关历� PR
+
+本�目关�工��已�并�部署�TEST 验收并关闭；具体工�链接�下方关�工�清�。
+
+## ��相关文档
+
+- �调版接�文档：[供应商模� API 接�规范 v2.1 �端�调版](../../api-docs/supplier/%E4%BE%9B%E5%BA%94%E5%95%86%E6%A8%A1%E5%9D%97%20API%20%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83-v2.1-%E5%89%8D%E7%AB%AF%E8%81%94%E8%B0%83%E7%89%88.html)
+
 ## 关�工�
 
 - 主档与账户：[#6153](https://git.1814.love:8443/wx/HL/issues/6153)�[#6161](https://git.1814.love:8443/wx/HL/issues/6161)�[#6162](https://git.1814.love:8443/wx/HL/issues/6162)�[#6163](https://git.1814.love:8443/wx/HL/issues/6163)�[#6164](https://git.1814.love:8443/wx/HL/issues/6164)