docs: 说明供应商账户状态中文映射（#7137）

2026-09-06 10:04:25 +08:00
@@ -0,0 +1,61 @@
+---
+schema: "hl-changelog/v2"
+ticket: "7137"
+title: "供应商账户信息列表状态显示中文"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "前端缺陷"
+backend_status: "not_required"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "待前端补充账户状态中文映射；页面验收尚未完成。"
+updated_at: "2026-09-06"
+base: "dev-v3"
+---
+
+# 供应商：账户信息列表状态显示中文
+
+## 二、变更接口清单
+
+| # | 接口 | 方法 | 路径 | 变更类型 | 说明 |
+|---|---|---|---|---|---|
+| 1 | 账户信息列表 | GET | `/admin/supplier/items/{supplierId}/account-info/list` | 无接口变更 | 补充状态中文展示映射 |
+
+## 三、接口详情
+
+### 1. 账户信息列表 `GET /admin/supplier/items/{supplierId}/account-info/list`
+
+- 打开供应商详情的“账户信息”时调用；`supplierId` 为路径参数，无请求体。
+- 冻结字段：`data.bankAccounts[].status`，类型 `String`，值为账户状态码。
+- 成功须同时满足 HTTP 200、`code=200`、`success=true`。请求、响应和错误码均无变更。
+
+## 六.5、枚举 / 数据字典
+
+| 状态码 | 中文展示 | 值语义 |
+|---|---|---|
+| `DRAFT` | 草稿 | 初始账户尚未提交审批 |
+| `PENDING` | 待审批 | 账户审批处理中 |
+| `REJECTED` | 已驳回 | 审批驳回，账户不可用 |
+| `ACTIVE` | 有效 | 账户已审批生效 |
+| `DISABLED` | 已停用 | 账户停用 |
+
+## 前端动作与边界
+
+状态列按上述状态码显示中文，补齐 `DRAFT → 草稿`。业务判断继续使用原状态码；不把中文写回 `status`，不依赖账户响应中不存在的 `statusName`。
+
+## 八、测试环境已验证
+
+账户列表经 TEST Gateway 返回 HTTP 200、`code=200`、`success=true`。目标供应商当前账户为 `ACTIVE`；截图中的 `DRAFT` 场景尚未完成页面复验。
+
+## 当前状态
+
+待前端处理。#7137 保持开启，页面状态显示中文后再验收。
+
+## 关联 / 联系人
+
+- 工单：[HL #7137](https://git.1814.love:8443/wx/HL/issues/7137)
+- 后端负责人：@lc