33 lines
2.4 KiB
Markdown
33 lines
2.4 KiB
Markdown
## 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`。
|