18 KiB
输注计划管理页面实施计划
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: 新建独立的输注计划管理页面,管理所有输注计划的状态流转(待输注→已用户确认→已完成/已取消),支持编辑、取消原因录入、完成时自动扣减渠道服务订单余额或产品份数。
Architecture: 新增 infusion_status 字段到 biz_pilot_infusion_schedule 表(与现有 schedule_status 生产状态独立),新增后端 CRUD/API 和前端完整页面(模式 P02 列表多状态),遵循 openspec UI 规范。
Tech Stack: FastAPI + SQLAlchemy + Pydantic v2 (后端) · Vue 3 + Element Plus + Tailwind CSS 4 (前端) · MySQL 5.7
UI 模式选型: P02(列表多状态,操作按钮随状态变化),参考页 /#/demo/order,业务参考 pilot-service/checkup-management。
文件结构
| 操作 | 文件路径 | 职责 |
|---|---|---|
| 新建 | docs/sql/20260526_infusion_schedule_add_fields.sql |
数据库迁移 SQL |
| 修改 | backend/app/models/models.py (BizPilotInfusionSchedule) |
添加 infusion_status、cancel_reason 字段 |
| 新建 | backend/app/crud/pilot_infusion_schedule_mgmt.py |
输注计划管理 CRUD(列表 JOIN 查询、状态变更、扣减) |
| 新建 | backend/app/api/pilot_infusion_schedule_mgmt.py |
输注计划管理 API 路由 |
| 修改 | backend/app/api/__init__.py |
注册新路由 |
| 修改 | backend/app/api/pilot_application.py |
Bug Fix:创建时默认 infusion_status='dtz' |
| 修改 | web-admin/src/api/admin.ts |
添加输注计划管理 API 函数 |
| 修改 | web-admin/src/utils/status-tag-registry.ts |
添加 infusionStatusLabel/TagType |
| 新建 | web-admin/src/views/pilot-service/infusion-schedule-management/index.vue |
主列表页 |
| 新建 | web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleEditDialog.vue |
编辑弹窗 |
| 新建 | web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleViewDialog.vue |
查看弹窗 |
| 新建 | web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleCancelDialog.vue |
取消弹窗(输入原因) |
| 修改 | web-admin/src/router/modules/sqxp.ts |
添加路由 |
| 修改 | web-admin/src/App.vue |
panelTitleBarTextRules 添加标题 |
| 修改 | docs/web-admin-ui-pattern-index.md |
补充页面→模式映射 |
状态码定义
infusion_status(新增字段 — 输注状态)
| Code | 含义 | TagType | 说明 |
|---|---|---|---|
dtz |
待输注 | info |
默认值,创建时自动设置 |
yrqr |
已用户确认 | warning |
点击"用户已确认"按钮 |
yqx |
已取消 | danger |
点击"取消"按钮,需输入取消原因 |
ywc |
已完成 | success |
点击"完成"按钮,触发费用扣减 |
product_status(扩展 — 细胞产品状态,跟随 infusion_status 变化)
| Code | 含义 | TagType |
|---|---|---|
dtz |
待输注 | info |
yrqr |
已用户确认 | warning |
yqx |
已取消 | danger |
ywc |
已完成 | success |
注意:当前
product_status使用中文文本"待输注",需改为 codedtz。迁移 SQL 中需 UPDATE 现有数据。
状态流转规则
待输注(dtz) ──→ 已用户确认(yrqr) ──→ 已完成(ywc)
│ │
└──→ 已取消(yqx) │
└──→ 已取消(yqx) ←────────────────────┘
dtz→yrqr:点击"用户已确认"dtz→yqx:点击"取消"yrqr→ywc:点击"完成",触发扣减yrqr→yqx:点击"取消"ywc/yqx为终态,不可变更
Task 1: 数据库变更
Files:
-
Create:
docs/sql/20260526_infusion_schedule_add_fields.sql -
Step 1: 编写迁移 SQL
-- 20260526: 输注计划管理 — 添加输注状态字段
-- 1. biz_pilot_infusion_schedule 新增 infusion_status 和 cancel_reason
ALTER TABLE `biz_pilot_infusion_schedule`
ADD COLUMN `infusion_status` varchar(16) NOT NULL DEFAULT 'dtz' COMMENT 'dtz待输注 yrqr已用户确认 yqx已取消 ywc已完成' AFTER `schedule_status`,
ADD COLUMN `cancel_reason` varchar(512) DEFAULT NULL COMMENT '取消原因' AFTER `infusion_status`;
-- 2. biz_pilot_infusion_schedule_product 的 product_status 从中文文本改为 code
-- 先更新现有数据
UPDATE `biz_pilot_infusion_schedule_product` SET `product_status` = 'dtz' WHERE `product_status` = '待输注' OR `product_status` IS NULL;
ALTER TABLE `biz_pilot_infusion_schedule_product`
MODIFY COLUMN `product_status` varchar(32) DEFAULT 'dtz' COMMENT 'dtz待输注 yrqr已用户确认 yqx已取消 ywc已完成';
- Step 2: 在数据库执行 SQL
连接开发库执行上述 SQL,确认无报错。
- Step 3: 更新 zkxw.sql 全量备份(手动确认后)
记录变更到 docs/sql/ 目录。
Task 2: 后端 Model 更新
Files:
-
Modify:
backend/app/models/models.py(BizPilotInfusionSchedule 类,约 line 2892) -
Step 1: 在 BizPilotInfusionSchedule 模型中添加新字段
在 schedule_status 列定义之后添加:
# BizPilotInfusionSchedule 类中,schedule_status 字段之后添加:
infusion_status = Column('infusion_status', String(16), nullable=False, default='dtz', comment='dtz待输注 yrqr已用户确认 yqx已取消 ywc已完成')
cancel_reason = Column('cancel_reason', String(512), nullable=True, default=None, comment='取消原因')
- Step 2: 验证无 import 错误
Run: cd backend && source venv/bin/activate && python -c "from app.models.models import BizPilotInfusionSchedule; print('OK')"
Expected: OK
Task 3: 后端 CRUD
Files:
- Create:
backend/app/crud/pilot_infusion_schedule_mgmt.py
这个文件实现输注计划管理的核心业务逻辑。
- Step 1: 创建 CRUD 文件,实现列表查询(多表 JOIN)
关键:列表需要 JOIN 患者信息、渠道信息、申请单信息、方案信息。
"""输注计划管理 CRUD(独立管理页面用)"""
from __future__ import annotations
import uuid
from datetime import datetime, timedelta
from typing import Any, Dict, List, Optional
from sqlalchemy import and_, func, or_
from sqlalchemy.orm import Session
from app.models.models import (
BizChannelServiceOrder,
BizChannelServiceOrderProduct,
BizChannelAccount,
BizChannelAgreementProductPrice,
BizChannelProductQuota,
BizPilotApplication,
BizPilotInfusionPlan,
BizPilotInfusionSchedule,
BizPilotInfusionScheduleProduct,
BizPilotPatient,
)
from app.crud.pilot_service import (
_get_or_create_channel_account,
_reduce_channel_product_quota,
)
需要实现的核心函数:
-
list_infusion_schedules_mgmt— 多表 JOIN 分页查询- 查询
biz_pilot_infusion_schedule为主表 - LEFT JOIN
biz_pilot_infusion_plan→biz_pilot_application→biz_pilot_patient - 筛选条件:keyword(申请单号/患者姓名/渠道名称)、infusion_status、infusion_time 范围(默认最近 30 天)
- 返回字段包括:schedule 自身字段 + patientName/sex/age + channelName/applicationNo + plan 信息 + products 列表
- 查询
-
update_infusion_status— 状态变更- 校验状态流转合法性
- 更新 schedule 的
infusion_status - 同步更新所有关联 product 的
product_status - 如果变为
yqx,保存cancel_reason - 如果变为
ywc,调用_deduct_fee_on_complete
-
_deduct_fee_on_complete— 完成时费用扣减- 复用
pilot_delivery.py中_deduct_fee_on_delivery的逻辑 - schedule → plan → application → service_order
- 预付款型(yfk):扣渠道账户余额 + 更新订单余额
- 购买型(gmcp):扣产品份数 + 更新订单产品持仓
- 余额/份数不足时抛出 ValueError
- 复用
-
get_infusion_schedule_detail— 获取详情(含 products) -
update_infusion_schedule_mgmt— 编辑 schedule 和 products 信息
- Step 2: 实现所有 CRUD 函数
具体实现需参考:
-
pilot_delivery.py的_deduct_fee_on_delivery(line 174-327) — 扣减逻辑 -
pilot_checkup.py的list_pilot_checkup— 多表 JOIN 列表查询模式 -
pilot_application.py的_row_to_dict_schedule— schedule 序列化模式 -
Step 3: 验证 import
Run: cd backend && source venv/bin/activate && python -c "import app.crud.pilot_infusion_schedule_mgmt; print('OK')"
Expected: OK
Task 4: 后端 API
Files:
-
Create:
backend/app/api/pilot_infusion_schedule_mgmt.py -
Modify:
backend/app/api/__init__.py— 注册新路由 -
Step 1: 创建 API 路由文件
端点列表(前缀 /web/admin/pilot-infusion-schedule-mgmt):
# 1. 列表(分页 + 多表 JOIN)
@router.get("/list")
# 2. 详情
@router.get("/detail")
# 3. 更新状态(确认/取消/完成)
@router.put("/update-status")
# Body: { scheduleId, infusionStatus, cancelReason? }
# 4. 编辑(schedule 信息 + products)
@router.put("/update")
# Body: { id, cellType?, specText?, infusionTime?, infusionLocation?, infusionMethod?, products: [...] }
Pydantic schemas 内联在 API 文件中(与现有模式一致),使用 populate_by_name=True + alias 驼峰命名。
- Step 2: 注册路由到 __init__.py
在 backend/app/api/__init__.py 中,pilot 相关路由组内添加:
from app.api.pilot_infusion_schedule_mgmt import router as pilot_infusion_schedule_mgmt_router
# ...
api_router.include_router(pilot_infusion_schedule_mgmt_router, prefix="/web/admin", tags=["中试-输注计划管理"])
同时检查 app/main.py 是否需要额外注册。
- Step 3: 验证 API 注册
Run: cd backend && source venv/bin/activate && python -c "from app.main import app; routes = [r.path for r in app.routes]; print(any('pilot-infusion-schedule-mgmt' in str(r) for r in routes))"
Expected: True
Task 5: 前端 API 函数
Files:
-
Modify:
web-admin/src/api/admin.ts -
Step 1: 在 admin.ts 末尾添加输注计划管理 API 函数
参考现有函数风格(如 fetchPilotCheckupList),添加:
// ═══════════════════════════════════════════
// 输注计划管理
// ═══════════════════════════════════════════
/** 输注计划管理 - 列表 */
export function fetchInfusionScheduleMgmtList(params: any) {
return request({ url: '/web/admin/pilot-infusion-schedule-mgmt/list', method: 'get', params })
}
/** 输注计划管理 - 详情 */
export function fetchInfusionScheduleMgmtDetail(params: any) {
return request({ url: '/web/admin/pilot-infusion-schedule-mgmt/detail', method: 'get', params })
}
/** 输注计划管理 - 更新状态 */
export function updateInfusionScheduleStatus(data: any) {
return request({ url: '/web/admin/pilot-infusion-schedule-mgmt/update-status', method: 'put', data })
}
/** 输注计划管理 - 编辑 */
export function updateInfusionScheduleMgmt(data: any) {
return request({ url: '/web/admin/pilot-infusion-schedule-mgmt/update', method: 'put', data })
}
Task 6: 前端状态注册
Files:
-
Modify:
web-admin/src/utils/status-tag-registry.ts -
Step 1: 添加输注状态标签函数
在文件末尾(scheduleStatusTagType 之后)添加:
// ========== 中试服务 - 输注状态(infusion_status) ==========
export function infusionStatusLabel(status: string): string {
const map: Record<string, string> = {
dtz: '待输注',
yrqr: '已用户确认',
yqx: '已取消',
ywc: '已完成',
}
return map[status] || status || '-'
}
export function infusionStatusTagType(status: string): string {
const map: Record<string, string> = {
dtz: 'info',
yrqr: 'warning',
yqx: 'danger',
ywc: 'success',
}
return map[status] || 'info'
}
- Step 2: 更新 scheduleStatusLabel — 移除 yjf
修改现有 scheduleStatusLabel 函数,移除 yjf: '已交付':
export function scheduleStatusLabel(status: string): string {
const map: Record<string, string> = {
dsc: '待生产',
ysc: '已生产',
yqx: '已取消',
}
return map[status] || status || '-'
}
export function scheduleStatusTagType(status: string): string {
const map: Record<string, string> = {
dsc: 'info',
ysc: '',
yqx: 'danger',
}
return map[status] || 'info'
}
Task 7: 前端页面
Files:
- Create:
web-admin/src/views/pilot-service/infusion-schedule-management/index.vue - Create:
web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleEditDialog.vue - Create:
web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleViewDialog.vue - Create:
web-admin/src/views/pilot-service/infusion-schedule-management/ScheduleCancelDialog.vue
UI 模式: P02(列表多状态),参考 checkup-management/index.vue
- Step 1: 创建目录
mkdir -p web-admin/src/views/pilot-service/infusion-schedule-management
- Step 2: 创建主列表页 index.vue
遵循 openspec UI 规范,页面结构:
page-container>page-head>h1标题"输注计划管理"panel>panel-top>h2标题"输注计划"filter-block:关键词、输注状态(下拉)、输注时间范围(el-date-pickertype="daterange",默认最近 30 天)list-toolbar:已选 N 项el-table列:- 序号、申请单号、患者姓名、性别、年龄、渠道名称、细胞类型、规格、输注时间、输注地点、输注方式
- 生产状态(
schedule_status)— el-tag - 输注状态(
infusion_status)— el-tag - 操作列
fixed="right" min-width="400":- 编辑(dtz/yrqr 可编辑)
- 用户已确认(dtz→yrqr)
- 完成(yrqr→ywc)
- 取消(dtz/yrqr→yqx)
- 查看
弹窗组件:
-
ScheduleEditDialog.vue— 编辑输注计划和细胞产品信息,label-position="top",dialog-form-layout -
ScheduleViewDialog.vue— 只读查看详情,展示关联信息和产品列表 -
ScheduleCancelDialog.vue— 取消原因输入(简单弹窗,textarea + 确认/取消) -
Step 3: 创建 ScheduleEditDialog.vue
-
el-dialogwidth="800px" :close-on-click-modal="false" -
表单字段:细胞类型、规格、输注时间、输注地点、输注方式
-
内嵌可编辑产品表格:项目名称、细胞类型、规格、协议单价、实际单价、份数
-
使用
.dialog-form-layout+.form-grid-2布局 -
label-position="top" -
Step 4: 创建 ScheduleViewDialog.vue
-
展示完整信息:申请单信息、患者信息、输注方案信息、输注计划信息、产品列表
-
状态使用 el-tag
-
参考
SystemViewDialog模式 -
Step 5: 创建 ScheduleCancelDialog.vue
-
简单弹窗 width="500px"
-
el-inputtype="textarea" placeholder="请输入取消原因" maxlength="500" show-word-limit -
确认/取消按钮
Task 8: 前端路由
Files:
-
Modify:
web-admin/src/router/modules/sqxp.ts -
Modify:
web-admin/src/App.vue(panelTitleBarTextRules) -
Step 1: 添加路由
在 sqxp.ts 的 PilotService children 中,checkup-management 路由之后添加:
{
id: '80000000000000000000000000000012',
name: 'InfusionScheduleManagement',
path: 'infusion-schedule-management',
component: '/pilot-service/infusion-schedule-management/index',
meta: {
title: '输注计划管理',
keepAlive: true,
menuCode: 'pilot-service:infusion-schedule-management:list'
}
}
- Step 2: 更新 App.vue panelTitleBarTextRules
在 App.vue 的 panelTitleBarTextRules 正则中追加 输注计划 标题文案。
Task 9: Bug Fix — 新增时默认状态
Files:
-
Modify:
backend/app/crud/pilot_application.py— 查找创建 schedule 和 product 的位置 -
Modify:
backend/app/api/pilot_application.py— 如需在 API 层默认设置 -
Step 1: 定位创建 infusion schedule 的代码
在 pilot_application.py CRUD 中查找创建 BizPilotInfusionSchedule 和 BizPilotInfusionScheduleProduct 的位置,确认:
- 创建 schedule 时
infusion_status默认为'dtz'(Model 默认值已处理) - 创建 product 时
product_status默认为'dtz'(需确认代码是否显式设置)
如果代码中显式设置了 product_status='待输注',需改为 'dtz'。
- Step 2: 验证创建流程
通过 API 创建新的中试申请单,检查生成的 schedule 的 infusion_status 和 product 的 product_status 是否为 'dtz'。
Task 10: 更新文档
Files:
-
Modify:
docs/web-admin-ui-pattern-index.md -
Step 1: 补充页面→模式映射
在文档 §四中添加:
| 输注计划管理 | pilot-service/infusion-schedule-management | P02 | /#/pilot-service/infusion-schedule-management |
验证清单
- 数据库:新字段已添加,现有数据已迁移
- 后端:新 API 可通过 Swagger (/docs) 访问
- 后端:扣减逻辑在余额/份数不足时正确报错
- 前端:页面正常加载,列表展示多表 JOIN 数据
- 前端:状态流转按钮根据 infusion_status 动态显示/隐藏
- 前端:取消弹窗要求输入原因
- 前端:完成操作触发扣减,错误时前端提示
- Bug Fix:新创建的申请单中 schedule 和 product 默认状态为 dtz
- openspec:页面标题竖条装饰正常显示
- openspec:所有状态字段使用 el-tag 展示
- openspec:操作列 fixed="right",按钮带 el-icon