60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
# 细胞存储管理（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` 读取上下文文件后开始改代码。
|