diff --git a/changelogs-v2/2026-08/26_6397_供应商注册合同聚合信息-修改接口-管理后台.md b/changelogs-v2/2026-08/26_6397_供应商注册合同聚合信息-修改接口-管理后台.md index a7a78c57..b76b0263 100644 --- a/changelogs-v2/2026-08/26_6397_供应商注册合同聚合信息-修改接口-管理后台.md +++ b/changelogs-v2/2026-08/26_6397_供应商注册合同聚合信息-修改接口-管理后台.md @@ -76,7 +76,7 @@ base: "dev-v3" 历史数据可能返回只读状态 `TERMINATED`;创建和提交请求不得发送该状态。 -## 1. 创建供应商注册草稿 +### 1. 创建供应商注册草稿 `POST /admin/supplier/items/add` `POST /admin/supplier/items/add` @@ -166,7 +166,7 @@ Content-Type: application/json 失败时不会留下供应商主体或部分合同。 -## 2. 提交供应商注册 +### 2. 提交供应商注册 `POST /admin/supplier/items/{supplierId}/submit` `POST /admin/supplier/items/{supplierId}/submit` @@ -263,7 +263,7 @@ Content-Type: application/json 该失败会回滚本次提交表单中的主体、资质、合同和审计变化,供应商仍保持原状态和原版本。 -## 3. 查询供应商基本信息 +### 3. 查询供应商基本信息 `GET /admin/supplier/items/{supplierId}/basic-info/view` `GET /admin/supplier/items/{supplierId}/basic-info/view` @@ -369,7 +369,7 @@ Authorization: Bearer - 历史只读状态 `TERMINATED` 仅可返回,创建/提交发送该状态会被拒绝。 - 越权:仅可信 `FINANCE`、`SUPER_ADMIN` 且拥有对应平台权限可写;普通 ADMIN 调用写接口返回越权错误。 -## 修改前后对比 +## 六.6、修改前后对比 | 场景 | 修改前 | 修改后 | |---|---|---| @@ -379,6 +379,13 @@ Authorization: Bearer | 账户区域标题 | 页面显示“初始账户” | 页面应显示“结算信息”,接口字段仍为 `initialAccounts` | | 页面区块顺序 | 资质后直接进入账户区域 | 资质证照 → 合同信息 → 结算信息 | +## 六.7、影响评估 + +- **管理端(admin)**:供应商注册/编辑页需新增「合同信息」表格并调整区块顺序;既有合同必须缓存并原样回传字符串 `contractId`,否则提交会整单回滚。 +- **同日修正(PR #6450)**:响应 `contracts[].amount` 由 Number 改为 String,前端 f2a4200d 按 Number 集成的解析处需改为字符串处理(展示直接渲染、运算前 `Number(...)`),影响面限于合同金额展示/计算处,请求提交不受影响。 +- **C 端(mp)**:不涉及,无影响。 +- **QA 排查面**:问题定位优先看「契约约束与正确调用方式」第 3、4 条(快照回传与空数组语义)与「关键变化」(amount 字符串化)。 + ## 四、契约约束与正确调用方式 1. 在“资质证照”区域之后新增“合同信息”表格,在合同之后显示原账户表格。