diff --git a/docs/superpowers/plans/2026-10-07-unified-protocol.md b/docs/superpowers/plans/2026-10-07-unified-protocol.md new file mode 100644 index 00000000..62872afa --- /dev/null +++ b/docs/superpowers/plans/2026-10-07-unified-protocol.md @@ -0,0 +1,506 @@ +# 统一协议单管理 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:** 细胞存储「采集协议单」与科研捐赠「捐赠协议单」共用一个壳页面(两个来源 Tab),日常只从细胞存储进入;科研捐赠侧协议单菜单(含一级空目录)隐藏,旧 audit 路由仍可进统一页。 + +**Architecture:** 对齐统一样本信息:`UnifiedProtocolPage` 用 `panel-pill-tabs` 切换来源;细胞存储 Tab 复用现有 `ProtocolAuditTab`;科研捐赠 Tab 从 `research-donation/audit/index.vue` 抽出为 `DonationProtocolTab`。两套 API/表不变。进页只认细胞存储采集协议单权限,两 Tab 始终可见。`query.tab` = `cell_storage` | `research_donation`。 + +**Tech Stack:** Vue 3 + Element Plus + vue-router(hash)/ FastAPI 固定菜单 `menu.py` / MySQL `sys_menu` 可选迁移 + +**Design Doc:** `docs/superpowers/specs/2026-10-07-unified-protocol-design.md` + +**Reuse:** `UnifiedSampleInfoPage.vue` 的 pill tabs + `query.tab` 写法;`ProtocolAuditTab.vue` 的 Tab 根结构;`ClinicalApplication` 父级 `meta.isHide: true` 隐藏空一级菜单的先例。 + +--- + +## File Structure Map + +### New files + +| File | Responsibility | +|------|----------------| +| `web-admin/src/views/cell-storage/protocol-audit/UnifiedProtocolPage.vue` | 双 Tab 壳;切换写 `query.tab`;按来源挂载子 Tab | +| `web-admin/src/views/cell-storage/protocol-audit/DonationProtocolTab.vue` | 原捐赠协议单列表/工具栏/弹窗逻辑(自 audit 页抽出) | +| `docs/sql/migrations/2026-10-07-hide-research-donation-protocol-menus.sql` | DB 菜单模式:隐藏捐赠协议相关菜单与空一级目录 | + +### Modified files + +| File | Change | +|------|--------| +| `web-admin/src/views/cell-storage/protocol-audit/index.vue` | 挂载 `UnifiedProtocolPage`;保留旧 `query.tab` 重定向 | +| `web-admin/src/views/research-donation/audit/index.vue` | 薄包装 → 同一壳,`default-source=research_donation` | +| `web-admin/src/router/modules/sqxp.ts` | 捐赠 list/audit `isHide: true`;一级 `ResearchDonation` `isHide: true` | +| `backend/app/api/menu.py` | 与 `sqxp.ts` 同步隐藏 | + +### Unchanged (explicit) + +- `ProtocolAuditTab.vue`、捐赠/采集 Form/View/Audit/Status 弹窗、两端 API CRUD、库表 +- 隐藏录入路由 `CellStorageProtocol` / `ResearchDonationList` 仍保留可直开 +- 样本信息统一页逻辑不改 + +--- + +### Task 1: 抽出 `DonationProtocolTab` + +**Files:** +- Create: `web-admin/src/views/cell-storage/protocol-audit/DonationProtocolTab.vue` +- Modify: (本 Task 不改路由页;audit 薄化在 Task 3) + +- [ ] **Step 1: 复制并改造组件外壳** + +从 `web-admin/src/views/research-donation/audit/index.vue` **整文件复制**到 +`web-admin/src/views/cell-storage/protocol-audit/DonationProtocolTab.vue`,然后按下列规则改(不要改业务逻辑): + +1. 去掉外层: + - `
` + - `
` / `
` +2. 根节点改为(与 `ProtocolAuditTab` 对齐): + +```vue + + + +``` + +3. `defineOptions`: + +```ts +defineOptions({ name: 'DonationProtocolTab' }) +``` + +4. 弹窗 import 路径从相对 `../list/` 改为别名(因文件已迁到 `protocol-audit/`): + +```ts +import DonationFormDialog from '@/views/research-donation/list/DonationFormDialog.vue' +import DonationViewDialog from '@/views/research-donation/list/DonationViewDialog.vue' +import DonationAuditDialog, { + type DonationAuditTarget +} from '@/views/research-donation/list/DonationAuditDialog.vue' +import DonationStatusChangeDialog, { + type DonationStatusChangeAction, + type DonationStatusChangeTarget +} from '@/views/research-donation/list/DonationStatusChangeDialog.vue' +``` + +其余 import(API、icons、`status-tag-registry`、`fullscreen-loading` 等)保持不变。 + +5. 原 `