Files
zkxw/docs/superpowers/plans/2026-05-26-infusion-schedule-management.md
T
2026-05-26 19:04:27 +08:00

18 KiB
Raw Blame History

输注计划管理页面实施计划

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 使用中文文本"待输注",需改为 code dtz。迁移 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,
)

需要实现的核心函数:

  1. 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 列表
  2. update_infusion_status — 状态变更

    • 校验状态流转合法性
    • 更新 schedule 的 infusion_status
    • 同步更新所有关联 product 的 product_status
    • 如果变为 yqx,保存 cancel_reason
    • 如果变为 ywc,调用 _deduct_fee_on_complete
  3. _deduct_fee_on_complete — 完成时费用扣减

    • 复用 pilot_delivery.py 中 _deduct_fee_on_delivery 的逻辑
    • schedule → plan → application → service_order
    • 预付款型(yfk):扣渠道账户余额 + 更新订单余额
    • 购买型(gmcp):扣产品份数 + 更新订单产品持仓
    • 余额/份数不足时抛出 ValueError
  4. get_infusion_schedule_detail — 获取详情(含 products)

  5. 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-picker type="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-dialog width="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-input type="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 的位置,确认:

  1. 创建 schedule 时 infusion_status 默认为 'dtz'(Model 默认值已处理)
  2. 创建 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