This commit is contained in:
zlwu committed 2026-05-17 08:36:37 +08:00
1 parent 246ad2228e
commit 8e2dd8b9f0
186 files changed
+38821 -2571

No files matched your search

@@ -0,0 +1,32 @@
## Why
需求文档 `docs/中科兴皖需求V0.3.md` 中「细胞存储管理」下 2.2.6~2.2.10 尚未在 web-admin 与后端落地;业务依赖 `biz_collection_protocol` 及缴费/审核表。需要在租户隔离与既有 `/web/admin` 约定下交付列表、审核与财务确认、分期预警的最小可用闭环。
## What Changes
- 新增一级菜单 **细胞存储管理**及 5 个子路由页面(与 `sqxp.ts`、`backend/app/api/menu.py` 静态菜单对齐)。
- 后端新增采集协议单查询、审核写入、缴费明细财务确认、分期预警查询等 API;补充对应表的 SQLAlchemy Model 与 CRUD(方案 C:最小表集)。
- 前端新增 `views/cell-storage/**` 五个列表页(及必要弹窗),对接上述接口;样式对齐 Fresh Mint 与 CRUD 模板页。
- **不包含**:退费发起、协议单子表(采集信息/样本等)全量录入 UI;工作流引擎驱动本组菜单。
## Capabilities
### New Capabilities
- `cell-storage-collection-protocol`: 采集协议单列表与概要详情 API;Web 列表/详情(第一版以主表 + 缴费概要为主)。
- `cell-storage-protocol-audit`: 协议附件类审核(写入 `biz_protocol_audit`,不修改协议单状态);多条审核历史(A1);审核列表与提交。
- `cell-storage-receipt-confirm`: 财务收款确认列表(仅 `jfqrz`)与确认动作(`jfqrz`→`yjf`)。
- `cell-storage-refund-confirm`: 财务退费确认列表(仅 `tfqrz`)与确认动作(`tfqrz`→`ytf`);不包含退费发起。
- `cell-storage-installment-warning`: 分期应缴预警列表(仅 `dfj`、有分期序号;15 天内预警;逾期为应缴日早于今日)。
### Modified Capabilities
- (无)本变更为新增业务能力,不修改已归档基线 spec 的既有 REQUIREMENTS 表述。
## Impact
- **后端**:`backend/app/models/models.py`、`app/crud/`、`app/api/`(新建 `collection_protocol.py` 或合并至既有 router)、`app/api/__init__.py`、`app/main.py`。
- **前端**:`web-admin/src/router/modules/sqxp.ts`、`web-admin/src/api/*.ts`、`web-admin/src/views/cell-storage/**`。
- **菜单**:`backend/app/api/menu.py`。
- **数据库**:沿用既有 DDL,原则上不新增表;若需菜单种子则可选 `docs/sql/` 补丁脚本。
- **权威交叉**:`docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md`。