# 细胞存储管理（2.2.6～2.2.10）Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 交付细胞存储管理一级菜单下 5 个页面及对应后端 API（方案 C），满足已定稿设计：`docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md` 与 OpenSpec 变更 `openspec/changes/cell-storage-protocol-modules/`。

**Architecture:** FastAPI 路由挂在 `/web/admin` 旁路扩展；SQLAlchemy Model 覆盖四张业务表；CRUD 层封装租户过滤与 camelCase 列表 DTO；Vue 页面复制 `system/unit` 列表骨架并按模块替换列与弹窗。

**Tech Stack:** Python 3.9、FastAPI、SQLAlchemy、Pydantic v2；Vue 3、Element Plus、pnpm、TypeScript。

---

## 文件映射（落地前对齐）

| 区域 | 路径 |
|------|------|
| 设计/契约 | `docs/superpowers/specs/2026-05-13-cell-storage-protocol-modules-design.md`，`openspec/changes/cell-storage-protocol-modules/` |
| Model | `backend/app/models/models.py` |
| CRUD | `backend/app/crud/collection_protocol.py`（或按职责拆分文件） |
| API | `backend/app/api/collection_protocol.py`，注册 `app/api/__init__.py`、`main.py` |
| 菜单 | `backend/app/api/menu.py` |
| 前端路由 | `web-admin/src/router/modules/sqxp.ts` |
| 前端 API | `web-admin/src/api/collection-protocol.ts`（命名以仓库惯例为准） |
| 页面 | `web-admin/src/views/cell-storage/{protocol,protocol-audit,payment-confirm,refund-confirm,installment-warning}/index.vue` |

---

## 执行清单（与 OpenSpec tasks.md 同步）

按顺序执行 `openspec/changes/cell-storage-protocol-modules/tasks.md` 中章节 **1 → 7**。每完成一节，将对应 `- [ ]` 改为 `- [x]`。

---

## Self-review（对照 spec）

| Spec capability | tasks.md 覆盖 |
|-----------------|---------------|
| cell-storage-collection-protocol | 1.x、2.x、5.1、3.x |
| cell-storage-protocol-audit | 1.x、2.x、5.2 |
| cell-storage-receipt-confirm | 1.x、2.x、5.3 |
| cell-storage-refund-confirm | 1.x、2.x、5.4 |
| cell-storage-installment-warning | 1.x、2.x、5.5 |

无占位：具体接口路径与状态码以实现对照 design.md 为准。

---

## Execution Handoff

Plan complete and saved to `docs/superpowers/plans/2026-05-13-cell-storage-protocol-modules.md`.

**Two execution options:**

1. **Subagent-Driven（推荐）** — 每个 task 派生子代理并在任务间复核  
2. **Inline Execution** — 本会话按 `openspec apply` 逐项实现（使用 executing-plans）

**Which approach?** 若未指定，默认本会话按 OpenSpec `tasks.md` 顺序实现。

下一步命令：`openspec instructions apply --change cell-storage-protocol-modules --json` 读取上下文文件后开始改代码。