96 行
3.6 KiB
Markdown
96 行
3.6 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "6951"
|
||
title: "财务系统参数设置（查询 + 改值）"
|
||
consumer: "admin"
|
||
author: "yst"
|
||
change_type: "新增接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "verified"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: "21540997"
|
||
target_release: ""
|
||
verified_at: "2026-09-09"
|
||
status_note: "后端已合 dev-v3（param 参数设置域）并部署测试服。参数键后端预置不开放增删，仅查询+按键改值，valueType 格式校验。"
|
||
updated_at: "2026-09-09"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 财务系统参数设置（查询 + 改值）
|
||
|
||
## 1. 接口背景
|
||
财务域「参数设置」：财务侧预置的业务参数（如封账日、限额、开关等），后端预置键不开放增删，管理后台只提供「查询全部 + 按键改值」两个端点。属 Epic 财务域 param 参数设置域。
|
||
|
||
## 2. 变更清单
|
||
| 类型 | 接口 | 说明 |
|
||
|---|---|---|
|
||
| 新增 | GET `/admin/finance/params` | 查询全部财务系统参数（不分页，一次返回全量预置键） |
|
||
| 新增 | PUT `/admin/finance/params/{paramKey}` | 按参数键修改参数值（valueType 格式校验） |
|
||
|
||
## 3. 接口详情
|
||
|
||
### 3.1 查询全部参数
|
||
- **路径**：`GET /admin/finance/params`
|
||
- **入参**：无
|
||
- **出参**：`Result<List<AccountParamRespVO>>`，元素字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| id | String | 参数ID（Long 序列化为字符串，防 JS 精度丢失） |
|
||
| paramKey | String | 参数键（预置，唯一） |
|
||
| paramValue | String | 参数值（字符串存储，按 valueType 解析） |
|
||
| valueType | String | 值类型：`DATE` / `BOOL` / `AMOUNT` / `STRING` |
|
||
| paramName | String | 参数中文名 |
|
||
| remark | String | 口径备注 |
|
||
| updatedByName | String | 最近操作人姓名快照 |
|
||
|
||
### 3.2 修改参数值
|
||
- **路径**：`PUT /admin/finance/params/{paramKey}`
|
||
- **路径参数**：`paramKey`（String，要修改的参数键）
|
||
- **入参**（AccountParamUpdateReqVO）：
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| paramValue | String | 是 | 新参数值（按 valueType 校验格式：DATE 须日期格式、BOOL 须 true/false、AMOUNT 须数值） |
|
||
| remark | String | 否 | 修改说明 |
|
||
|
||
- **出参**：`Result<AccountParamRespVO>`（返回改后完整参数行）
|
||
|
||
## 4. 枚举 / 数据字典
|
||
- `valueType`：`DATE`（日期）/ `BOOL`（布尔）/ `AMOUNT`（金额数值）/ `STRING`（字符串）
|
||
- 参数键 paramKey 由后端预置，前端不增删键，仅展示 + 改值。
|
||
|
||
## 5. 错误码
|
||
| 码 | 含义 |
|
||
|---|---|
|
||
| 598001 | 参数键不存在 |
|
||
| 598002 | 参数值与 valueType 格式不符 |
|
||
|
||
## 6. 示例
|
||
**典型：查询全部**
|
||
```
|
||
GET /admin/finance/params
|
||
→ { "code":200, "data":[ {"id":"...","paramKey":"close_day","paramValue":"25","valueType":"DATE","paramName":"封账日","remark":"...","updatedByName":"腰苏图"} ] }
|
||
```
|
||
**改值（金额）**
|
||
```
|
||
PUT /admin/finance/params/pay_limit {"paramValue":"50000.00","remark":"上调付款限额"}
|
||
→ 200，data.paramValue="50000.00"
|
||
```
|
||
**异常：值类型不符**
|
||
```
|
||
PUT /admin/finance/params/close_day {"paramValue":"abc"}
|
||
→ { "code":598002, "msg":"参数值与 valueType 格式不符" }
|
||
```
|
||
|
||
## 7. 注意事项
|
||
- 参数键为后端预置集合，PUT 仅改值，不新增/删除键。
|
||
- paramValue 一律字符串传输，前端按 valueType 渲染对应控件（日期/开关/数字输入）。
|
||
- 全部长整型 ID 已序列化为字符串。
|
||
|
||
## 8. 关联 / 联系人
|
||
- Issue：https://git.1814.love:8443/wx/HL/issues/6951
|
||
- Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
|
||
- 负责人：腰苏图（yst）
|