docs: define built-in currency demand data

master
chenyuan 4 weeks ago
parent 5b58192330
commit 36b248dc9d

@ -0,0 +1,30 @@
# 内置货币需求信息设计
## 目标
商业银行端的“查看货币需求信息”使用系统内置演示数据;前端无须提供任何查询参数。
## 数据模型
沿用 `issuance_bank_inventory` 作为内置库存配置表,并预置唯一演示记录:
- 当前库存余额49,950,000.00
- 库存预警阈值50,000,000.00
建议补充金额不落库,由后端按 `max(库存预警阈值 - 当前库存余额, 0)` 计算。
## 接口
`GET /api/v1/commercial-banks/issuance/inventory` 不再接受 `bankCode` 参数。接口直接读取唯一内置库存记录并返回余额、阈值和计算后的建议补充金额。
## 范围
- “更新”仅重新读取内置数据并刷新计算结果。
- 不增加管理员维护入口、不接入外部库存系统,也不修改发行申请本身使用的银行代码字段。
- 缺失内置记录时返回受控的资源不存在错误。
## 验收
- 无参数请求可得到原型中的三项数值。
- 前端传入 `bankCode` 不再是必需条件。
- 当余额高于阈值时,建议补充金额为 0.00。
Loading…
Cancel
Save