From 36b248dc9d8d348cf115e1dc060a99c8f371f25c Mon Sep 17 00:00:00 2001
From: chenyuan <chenyuan@example.com>
Date: Tue, 4 Aug 2026 11:32:46 +0800
Subject: [PATCH] docs: define built-in currency demand data

---
 ...6-08-04-built-in-currency-demand-design.md | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-08-04-built-in-currency-demand-design.md

diff --git a/docs/superpowers/specs/2026-08-04-built-in-currency-demand-design.md b/docs/superpowers/specs/2026-08-04-built-in-currency-demand-design.md
new file mode 100644
index 0000000..ad69d82
--- /dev/null
+++ b/docs/superpowers/specs/2026-08-04-built-in-currency-demand-design.md
@@ -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。