zkxw/openspec/changes/cell-storage-protocol-modules/proposal.md

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。