From 89733533567f8ef0e882d97c252dce3f01dde833 Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Fri, 4 Sep 2026 20:09:22 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BA=A4=E4=BB=98=E4=BE=9B=E5=BA=94=E5=95=86?=
 =?UTF-8?q?=E4=BF=A1=E7=94=A8=E7=AD=89=E7=BA=A7=E4=B8=8E=E5=85=AC=E5=8F=B8?=
 =?UTF-8?q?=E8=B5=84=E6=96=99=E5=AD=97=E6=AE=B5=E5=A5=91=E7=BA=A6=EF=BC=88?=
 =?UTF-8?q?#7090=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...•†ä¿¡ç”¨ç­‰çº§ä¸Žå…¬å�¸èµ„料字段-修改接å�£-管ç�†å�Žå�°.md | 506 ++++++++++++++++++
 1 file changed, 506 insertions(+)
 create mode 100644 changelogs-v2/2026-09/04_7090_供应商信用等级与公�资料字段-修改接�-管���.md

diff --git a/changelogs-v2/2026-09/04_7090_供应商信用等级与公�资料字段-修改接�-管���.md b/changelogs-v2/2026-09/04_7090_供应商信用等级与公�资料字段-修改接�-管���.md
new file mode 100644
index 00000000..13afc6c6
--- /dev/null
+++ b/changelogs-v2/2026-09/04_7090_供应商信用等级与公�资料字段-修改接�-管���.md
@@ -0,0 +1,506 @@
+---
+schema: "hl-changelog/v2"
+ticket: "7090"
+title: "供应商信用等级与公�资料字段"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "�端已部署并通过 TEST；�端需在供应商新建和编辑表�接入信用等级�公开电�邮箱�公�类型和办公地�。"
+updated_at: "2026-09-04"
+base: "dev-v3"
+---
+
+# 供应商模�：信用等级与公�资料字段
+
+供应商新建�编辑和注册�交支� `creditLevel`�`publicEmail`�`companyType`�`officeAddress`，详情新增�三个字段回显。公�类型使用系统字典 `supplier_company_type`。
+
+## ⚠� 关键�化
+
+- 新建�略 `creditLevel` 时�端默认值由 B 改为 A；�选值�与供应商主列表筛选一致，为 A/B/C/D。
+- �有 `SUPER_ADMIN` �以显��交 `creditLevel`。其他角色�以展示详情值，但请求体必须�略该字段。
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|---|---|---|---|---|
+| 1 | 查询供应商基本信� | GET | `/admin/supplier/items/{supplierId}/basic-info/view` | �应新增字段 | 回显公开邮箱�公�类型和办公地� |
+| 2 | 查询供应商公�类型字典 | GET | `/admin/dict/data/supplier_company_type` | 新增字典数� | 返回固定的两个生效选项 |
+| 3 | 新建供应商�稿 | POST | `/admin/supplier/items/add` | 请求新增字段 | 支�信用等级和三个�选公�资料字段 |
+| 4 | 修改供应商资料 | PUT | `/admin/supplier/items/{supplierId}/update` | 请求新增字段 | 支�增�维护并�留�略字段 |
+| 5 | �交供应商注册 | POST | `/admin/supplier/items/{supplierId}/submit` | 请求新增字段 | 完整表���带新增字段进入审批 |
+
+## 三�接�详情
+
+### 1. 查询供应商基本信� `GET /admin/supplier/items/{supplierId}/basic-info/view`
+
+**VO**: `SupplierBasicInfoRespVO`
+
+#### 使用场景
+
+打开供应商详情或编辑页时读�当�字段值和并�版本。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| `supplierId` | Path | String | 是 | 正整数 ID | 供应商 ID |
+
+#### 出� `Result<SupplierBasicInfoRespVO>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.creditLevel` | String | 信用等级 A/B/C/D |
+| `data.publicEmail` | String/null | 公开电�邮箱 |
+| `data.companyType` | String/null | `supplier_company_type` çš„ `dictValue` |
+| `data.officeAddress` | String/null | 办公地� |
+| `data.updateTime` | String | 编辑请求使用的最新并�版本 |
+
+#### 请求示例
+
+```http
+GET /admin/supplier/items/2095000000000000001/basic-info/view
+Authorization: Bearer <token>
+```
+
+无请求体。
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "supplierId": "2095000000000000001",
+    "creditLevel": "A",
+    "publicEmail": "service@example.com",
+    "companyType": "1",
+    "officeAddress": "呼和浩特市示例办公地�",
+    "updateTime": "2026-09-04 20:04:19"
+  }
+}
+```
+
+#### 空数� / �级�应
+
+存�数�或新建时未填写三个�选资料字段，分别返回 `null`；接��使用默认文案代替空值。
+
+#### 错误�应
+
+```json
+{"code":395001,"message":"供应商�存在","data":null,"success":false}
+```
+
+#### 业务边界
+
+- 沿用供应商详情查看��；业务失败�能�使用 HTTP 200，必须检查�应体。
+- `companyType` 返回字典值，�返回中文标签；�端用字典接�翻译。
+- `creditLevel` �以展示给有详情��的用户，是��编辑按当�角色控制。
+
+### 2. 查询供应商公�类型字典 `GET /admin/dict/data/supplier_company_type`
+
+**VO**: `Result<List<SysDictDataRespVO>>`
+
+#### 使用场景
+
+供应商新建或编辑页加载公�类型下拉选项。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| `supplier_company_type` | Path | String | 是 | 固定字典类型 | ��改�中文�称 |
+
+#### 出� `Result<List<SysDictDataRespVO>>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data[].dictValue` | String | �交给供应商接�的值 |
+| `data[].dictLabel` | String | 下拉展示文案 |
+| `data[].sortOrder` | Number | ��展示顺� |
+| `data[].status` | String | 当��为 `ACTIVE` |
+
+#### 请求示例
+
+```http
+GET /admin/dict/data/supplier_company_type
+Authorization: Bearer <token>
+```
+
+无请求体。
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": [
+    {"dictValue":"1","dictLabel":"有�责任公�(自然人投资或控股)","sortOrder":10,"status":"ACTIVE"},
+    {"dictValue":"2","dictLabel":"国�控股","sortOrder":20,"status":"ACTIVE"}
+  ]
+}
+```
+
+#### 空数� / �级�应
+
+�端已�始化两个选项；若请求失败或返回空数组，表���用本地硬编�选项替代。
+
+#### 错误�应
+
+```json
+{"code":401,"message":"未登录或登录已过期","data":null,"success":false}
+```
+
+#### 业务边界
+
+- 下拉框展示 `dictLabel`，请求��交对应的 `dictValue`。
+- 当��法值严格为 `1`�`2`；���交中文标签。
+- 字典接�需�管�端真实登录�。
+
+### 3. 新建供应商�稿 `POST /admin/supplier/items/add`
+
+**VO**: `SupplierDraftSaveReqVO → SupplierWriteRespVO`
+
+#### 使用场景
+
+管�端供应商新建表��存完整�稿。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| `creditLevel` | Body | String | � | A/B/C/D；仅 `SUPER_ADMIN` �显��交 | �略时�端默认 A |
+| `publicEmail` | Body | String | � | 邮箱格�，最长 100 | 公开电�邮箱 |
+| `companyType` | Body | String | � | 生效的 `supplier_company_type` 值 | 公�类型 |
+| `officeAddress` | Body | String | � | 最长 500 | 录入方�与 `address` 一致 |
+| `fullName`�`taxNo` | Body | String | 是 | 沿用现有主体校验 | 供应商�称与主体�件� |
+| `types` | Body | Array | 是 | 至少 1 项 | 供应商类型完整集� |
+| 法人资料与 `contactPhone` | Body | String | 是 | 沿用现有格�校验 | 法人姓��身份�三字段和�系电� |
+| `establishDate`�`address` | Body | String | 是 | 日期�得晚于当天；地��空 | �立日期和注册地� |
+| `balance`�`paymentType`�`mainCooperation` | Body | 混� | 是 | 沿用现有规则 | 结算与�作资料 |
+| `licenseImageUrl` | Body | String | 是 | �空 | �业执照影� |
+| `contacts`�`initialAccounts` | Body | Array | 是 | 至少一��系人；当�一个�始账户 | ���项 |
+
+#### 出� `Result<SupplierWriteRespVO>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.supplierId` | String | 新供应商 ID |
+| `data.status` | String | 新建�功为 `DRAFT` |
+| `data.updateTime` | String | �续编辑使用的并�版本 |
+
+#### 请求示例
+
+```json
+{
+  "fullName": "示例供应商有�公�",
+  "taxNo": "91350211M000100Y46",
+  "types": [{"typeCode":"HOTEL"}],
+  "legalRepresentative": "张三",
+  "legalRepresentativeIdNo": "11010519491231002X",
+  "legalRepresentativeIdCardFrontUrl": "https://example.com/id-front.jpg",
+  "legalRepresentativeIdCardBackUrl": "https://example.com/id-back.jpg",
+  "contactPhone": "13800138000",
+  "establishDate": "2020-01-02",
+  "address": "呼和浩特市示例注册地�",
+  "creditLevel": "A",
+  "publicEmail": "service@example.com",
+  "companyType": "1",
+  "officeAddress": "呼和浩特市示例办公地�",
+  "balance": 0,
+  "paymentType": "1",
+  "mainCooperation": "酒店资��作",
+  "licenseImageUrl": "https://example.com/license.jpg",
+  "contacts": [{"contactName":"�四","contactPhone":"13800138001","contactRole":"contentBus","isPrimary":true}],
+  "initialAccounts": [{"accountType":"CORPORATE","bankName":"示例银行","accountNo":"6222000012345678"}]
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code":200,"message":"�功","success":true,
+  "data":{"supplierId":"2095000000000000001","status":"DRAFT","updateTime":"2026-09-04 20:04:19"}
+}
+```
+
+#### 空数� / �级�应
+
+�略 `publicEmail`�`companyType`�`officeAddress` 时�存为未填写，详情返回 `null`；无�级�功�应。
+
+#### 错误�应
+
+```json
+{"code":395002,"message":"无�执行该供应商写�作","data":null,"success":false}
+```
+
+#### 业务边界
+
+- `creditLevel` �略时�端固定默认 A；���按旧行为�设默认 B。
+- �有 `SUPER_ADMIN` �显��交 `creditLevel`；其他�创建供应商的角色必须�略该字段。
+- 三个公�资料字段��必填；显� `companyType` 必须命中当�生效字典。
+- �法邮箱�信用等级�公�类型或超过 500 字的办公地�返回业务� `400`，失败�创建�稿。
+
+### 4. 修改供应商资料 `PUT /admin/supplier/items/{supplierId}/update`
+
+**VO**: `SupplierUpdateReqVO → SupplierWriteRespVO`
+
+#### 使用场景
+
+编辑页按详情中的最新版本增��存供应商资料。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| `supplierId` | Path | String | 是 | 正整数 ID | 目标供应商 |
+| `expectedUpdateTime` | Body | String | 是 | `yyyy-MM-dd HH:mm:ss` | �详情最新 `updateTime` |
+| `creditLevel` | Body | String | � | A/B/C/D；仅 `SUPER_ADMIN` �显��交 | �略�留现值 |
+| `publicEmail` | Body | String | � | 邮箱格�，最长 100 | �略�留现值 |
+| `companyType` | Body | String | � | 生效的字典值 1/2 | �略�留现值 |
+| `officeAddress` | Body | String | � | 最长 500 | �略�留现值 |
+
+#### 出� `Result<SupplierWriteRespVO>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.supplierId` | String | 供应商 ID |
+| `data.status` | String | �存�的状� |
+| `data.updateTime` | String | �存�的新并�版本 |
+
+#### 请求示例
+
+```json
+{
+  "creditLevel": "B",
+  "publicEmail": "service@example.com",
+  "companyType": "2",
+  "officeAddress": "呼和浩特市示例办公地�",
+  "expectedUpdateTime": "2026-09-04 20:04:19"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code":200,"message":"�功","success":true,
+  "data":{"supplierId":"2095000000000000001","status":"DRAFT","updateTime":"2026-09-04 20:05:01"}
+}
+```
+
+#### 空数� / �级�应
+
+�略新增字段表示�留现值；接�没有空数��功或�级�功。
+
+#### 错误�应
+
+```json
+{"code":395014,"message":"数�已被他人修改，请刷新��试","data":null,"success":false}
+```
+
+#### 业务边界
+
+- �存�先读�详情并使用最新 `updateTime`；过期版本�写入任何字段。
+- �有 `SUPER_ADMIN` �显��交 `creditLevel`。其他角色�使值未改�也必须�略，�则返回 `395002`。
+- �略 `creditLevel` �会�置为 A；A �用于新建时的缺�值。
+- `companyType` 必须�交字典值；邮箱�公�类型和办公地�的失败校验��产生部分更新。
+
+### 5. �交供应商注册 `POST /admin/supplier/items/{supplierId}/submit`
+
+**VO**: `SupplierSubmitReqVO → SupplierApprovalCommandRespVO`
+
+#### 使用场景
+
+供应商完整注册表��存并�交审批。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|---|---|---|---|---|---|
+| `supplierId` | Path | String | 是 | 正整数 ID | �稿供应商 |
+| `expectedUpdateTime` | Body | String | 是 | 最新并�版本 | 防止覆盖并�编辑 |
+| `creditLevel` | Body | String | � | A/B/C/D；仅 `SUPER_ADMIN` �显��交 | �略�留�稿值 |
+| `publicEmail` | Body | String | � | 邮箱格�，最长 100 | �略�留�稿值 |
+| `companyType` | Body | String | � | 生效的字典值 1/2 | �略�留�稿值 |
+| `officeAddress` | Body | String | � | 最长 500 | �略�留�稿值 |
+| 完整注册资料 | Body | 混� | 是 | 沿用现有�交契约 | 主体�类型��系人�账户��业执照等 |
+
+#### 出� `Result<SupplierApprovalCommandRespVO>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.approvalLogId` | String | 审批记录 ID |
+| `data.provider` | String | 审批�供方 |
+| `data.approvalStatus` | String | 审批状� |
+| `data.submittedAt` | String | �交时间 |
+
+#### 请求示例
+
+```json
+{
+  "fullName": "示例供应商有�公�",
+  "taxNo": "91350211M000100Y46",
+  "types": [{"typeCode":"HOTEL"}],
+  "legalRepresentative": "张三",
+  "legalRepresentativeIdNo": "11010519491231002X",
+  "legalRepresentativeIdCardFrontUrl": "https://example.com/id-front.jpg",
+  "legalRepresentativeIdCardBackUrl": "https://example.com/id-back.jpg",
+  "contactPhone": "13800138000",
+  "establishDate": "2020-01-02",
+  "address": "呼和浩特市示例注册地�",
+  "creditLevel": "A",
+  "publicEmail": "service@example.com",
+  "companyType": "1",
+  "officeAddress": "呼和浩特市示例办公地�",
+  "balance": 0,
+  "paymentType": "1",
+  "mainCooperation": "酒店资��作",
+  "licenseImageUrl": "https://example.com/license.jpg",
+  "contacts": [{"contactName":"�四","contactPhone":"13800138001","contactRole":"contentBus","isPrimary":true}],
+  "initialAccounts": [{"accountType":"CORPORATE","bankName":"示例银行","accountNo":"6222000012345678"}],
+  "expectedUpdateTime": "2026-09-04 20:05:01"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code":200,"message":"�功","success":true,
+  "data":{"approvalLogId":"2095000000000000010","provider":"WECOM","approvalStatus":"PENDING","submittedAt":"2026-09-04 20:05:02"}
+}
+```
+
+#### 空数� / �级�应
+
+写接��功时返回审批��结果；失败时 `data` 为 `null`，�会以空对象表示�功。
+
+#### 错误�应
+
+```json
+{"code":395002,"message":"无�执行该供应商写�作","data":null,"success":false}
+```
+
+#### 业务边界
+
+- 新增�选字段�略时沿用既有“�留�稿值�语义，�会清空已�存资料。
+- 显� `creditLevel` ���许 `SUPER_ADMIN`；其他�交角色必须�略该字段。
+- 公�类型按�交时生效字典校验；校验失败�会进入审批。
+- 审批�幂等���主体确认和状�规则����。
+
+## 四�契约约�与正确调用方�（接�类必写）
+
+| 场景 | 正确调用 |
+|---|---|
+| 新建页� | 从主列表相�选项展示 A/B/C/D；�始选中 A |
+| �超级管�员 | �展示信用等级，但新建�编辑��交请求��略 `creditLevel` |
+| 公�类型 | 调字典接�，用 `dictLabel` 展示�用 `dictValue` �交 |
+| 编辑�存 | �带详情最新 `updateTime`；��交实际�许修改的字段 |
+| 注册�交 | 三个公�资料字段�略时�留�稿值，�需��拼接空值 |
+
+## 五�数�库行为
+
+| �端�交 | 外部�观察结果 |
+|---|---|
+| 新建�略 `creditLevel` | 详情返回 `creditLevel: "A"` |
+| 编辑或�交�略 `creditLevel` | �留已有等级 |
+| 新建�略三个公�资料字段 | 详情对应字段返回 `null` |
+| 填写三个公�资料字段 | �存�功�详情原值回显 |
+| 校验或��失败 | �产生部分字段写入 |
+
+## 六�边界行为
+
+- 业务失败�能�为 HTTP 200，必须�时检查 `code`�`success` 和 `message`。
+- `creditLevel` �接�大写 A/B/C/D；�法值返回业务� `400`。
+- `publicEmail` 最长 100，`officeAddress` 最长 500；超�或邮箱格��法返回业务� `400`。
+- `companyType` �接�当�生效字典值；字典��用或值失效时失败关闭。
+- 存�供应商三个新增资料字段没有自动推断或回填，详情�返回 `null`。
+
+## 六.5�枚举 / 数�字典
+
+### creditLevel
+
+**所属字段**: `SupplierDraftSaveReqVO.creditLevel / SupplierUpdateReqVO.creditLevel / SupplierBasicInfoRespVO.creditLevel` | **类型**: `String`
+
+| 值 | 中文 | 说明 |
+|---|---|---|
+| `A` | A 级 | 新建�略时的默认值 |
+| `B` | B 级 | 与主列表筛选共用 |
+| `C` | C 级 | 与主列表筛选共用 |
+| `D` | D 级 | 与主列表筛选共用 |
+
+### companyType（supplier_company_type）
+
+**所属字段**: `SupplierDraftSaveReqVO.companyType / SupplierUpdateReqVO.companyType / SupplierBasicInfoRespVO.companyType` | **类型**: `String`
+
+| 值 | 中文 | 说明 |
+|---|---|---|
+| `1` | 有�责任公�(自然人投资或控股) | 生效字典值 |
+| `2` | 国�控股 | 生效字典值 |
+
+## 六.6�修改��对比
+
+### 字段级对比
+
+| 字段 | 改� | 改� |
+|---|---|---|
+| `creditLevel` 请求 | 新建�编辑�能维护 | 新建�编辑��交�选；仅 `SUPER_ADMIN` �显��交 |
+| `publicEmail` | 无请求或详情字段 | �选�存并在详情回显 |
+| `companyType` | 无请求或详情字段 | �选�存并按系统字典回显 |
+| `officeAddress` | 无请求或详情字段 | �选�存并在详情回显 |
+
+### 行为级对比
+
+| 行为 | 改� | 改� |
+|---|---|---|
+| 新建�略信用等级 | 默认 B | 默认 A |
+| 编辑�略新增字段 | 无对应字段 | �留已有值 |
+| 公�类型选项 | 无集中契约 | 从 `supplier_company_type` 动�读� |
+
+## 六.7�影�评估
+
+- **是�破���兼容**: �。旧客户端�略新增字段��调用；新建信用缺�业务值由 B 调整为 A。
+- **�端是�必须�步上线**: 是。新建和编辑页需展示四个字段并接入公�类型字典。
+- **�端 workaround 清�点**: ��硬编�公�类型；���把新建缺�信用等级当作 B；� `SUPER_ADMIN` ���列化 `creditLevel`。
+
+## 七��影�范围
+
+- **仅影�**: 管���供应商新建�编辑�详情和注册�交表�。
+- **零影�**: 供应商主列表信用等级筛选选项�生命周期状�机�审批�程�账户�程和其他�端入�。
+
+## 八�测试环境已验�
+
+- 公�类型字典真实返回且仅返回两个约定的生效选项。
+- 真实新建�编辑和详情调用已�项�存并回读 A/B/C/D，以�公开邮箱�公�类型 1/2�办公地�。
+- 真实新建�略四个字段�，信用等级回读为 A，三个�选公�资料字段回读为 `null`。
+- 编辑�略 `creditLevel` ���既有等级；两�验收�稿�已通过业务删除接�清�。
+- 注册�交沿用�一请求字段���和�存逻辑，已通过�并�交的�端契约测试；TEST 未创建外部审批�。
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#7090](https://git.1814.love:8443/wx/HL/issues/7090)
+- 关� PR: [wx/HL#7107](https://git.1814.love:8443/wx/HL/pulls/7107)
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#7090](https://git.1814.love:8443/wx/HL/issues/7090)
+- **PR**: [#7107](https://git.1814.love:8443/wx/HL/pulls/7107)
+- **Merge commit**: [c1102d62ecb81c24596fba91bba6e704da6e85ff](https://git.1814.love:8443/wx/HL/commit/c1102d62ecb81c24596fba91bba6e704da6e85ff)
+
+### �系人
+
+- **�端负责人**: @lc