工单表合并重构实施计划

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: 将入库+临时工单表合并为单表（work_order_type 字段区分类型），彻底消除多表 JOIN 复杂度。

Architecture: 质检工单合并为 biz_qc_work_order（加 work_order_type），生产工单合并为 biz_production_work_order（加 work_order_type）。任务表保持不变（biz_qc_task / biz_production_task 的 order_source 保留）。前端每个工单类型一个页面，根据 work_order_type 条件展示不同字段。

Tech Stack: MySQL 5.7 DDL / Python 3.9 FastAPI SQLAlchemy / Vue 3 TypeScript Element Plus

影响文件清单

删除（合并后不再需要）

backend/app/models/models.py 中 BizTempQcWorkOrder、BizTempProductionWorkOrder 两个 class
backend/app/schemas/temp_qc_work_order.py
backend/app/schemas/temp_production_work_order.py
backend/app/crud/temp_qc_work_order.py
backend/app/crud/temp_production_work_order.py
web-admin/src/api/temp-qc-work-order.ts
web-admin/src/api/temp-production-work-order.ts
web-admin/src/views/quality-inspection/temp-qc-work-order/index.vue
web-admin/src/views/production/temp-production-work-order/index.vue
web-admin/src/router/modules/sqxp.ts 中临时工单路由条目

修改

docs/sql/ — 新建迁移 SQL
backend/app/models/models.py — 加 work_order_type，reception 字段改 nullable，删 temp model
backend/app/crud/qc_work_order.py — 合并临时工单的创建/配置/完成逻辑
backend/app/crud/production_work_order.py — 合并临时工单的创建/配置/完成逻辑
backend/app/crud/qc_task.py — 恢复 INNER JOIN（不再需要 LEFT JOIN + 子查询 hack）
backend/app/crud/production_task.py — 同上，简化批量查询
backend/app/api/qc.py — 合并临时工单 API 端点，删除 temp import
backend/app/api/production.py — 同上
backend/app/schemas/qc_work_order.py — 新增 work_order_type 字段
web-admin/src/api/qc-work-order.ts 或 business.ts — 新增临时工单 API
web-admin/src/views/quality-inspection/qc-work-order/index.vue — 支持临时工单创建/筛选
web-admin/src/views/production/production-work-order/index.vue — 同上

Task 1: DDL 迁移 SQL

Files:

Create: docs/sql/merge_work_order_tables.sql
[ ] Step 1: 编写迁移 SQL

-- ============================================================
-- 工单表合并迁移：入库+临时 → 单表 + work_order_type
-- Date: 2026-05-24
-- 执行顺序：必须先执行，再部署后端代码
-- ============================================================

-- 1. biz_qc_work_order: 加 work_order_type，现有数据全部设 inbound
ALTER TABLE biz_qc_work_order
  ADD COLUMN work_order_type VARCHAR(20) NOT NULL DEFAULT 'inbound'
  COMMENT '工单类型: inbound=入库, temporary=临时' AFTER work_order_no;

-- 2. biz_qc_work_order: reception 关联字段改为可空（临时工单不需要）
ALTER TABLE biz_qc_work_order
  MODIFY COLUMN reception_id VARCHAR(64) NULL COMMENT '样本接收ID',
  MODIFY COLUMN protocol_sample_id VARCHAR(64) NULL COMMENT '协议样本ID',
  MODIFY COLUMN collection_protocol_id VARCHAR(64) NULL COMMENT '采集协议ID',
  MODIFY COLUMN reception_source VARCHAR(20) NULL DEFAULT 'cell_storage' COMMENT '来源: cell_storage/research_donation';

-- 3. 迁移临时质检工单数据到主表
INSERT INTO biz_qc_work_order (
  id, work_order_no, work_order_type, work_order_status,
  has_lab, has_third_party, third_party_fee_total,
  configured_time, configured_by,
  tenant_no, order_num, remark,
  create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
  id, work_order_no, 'temporary', work_order_status,
  has_lab, has_third_party, third_party_fee_total,
  configured_time, configured_by,
  tenant_no, order_num, remark,
  create_by, create_dept_id, create_time, update_by, update_time, del_flag
FROM biz_temp_qc_work_order;

-- 4. biz_production_work_order: 加 work_order_type
ALTER TABLE biz_production_work_order
  ADD COLUMN work_order_type VARCHAR(20) NOT NULL DEFAULT 'inbound'
  COMMENT '工单类型: inbound=入库, temporary=临时' AFTER work_order_no;

-- 5. biz_production_work_order: 加 configured_time/configured_by（临时工单需要）
ALTER TABLE biz_production_work_order
  ADD COLUMN configured_time DATETIME NULL COMMENT '配置时间' AFTER work_order_status,
  ADD COLUMN configured_by VARCHAR(64) NULL COMMENT '配置人' AFTER configured_time;

-- 6. biz_production_work_order: reception 关联字段改为可空
ALTER TABLE biz_production_work_order
  MODIFY COLUMN reception_id VARCHAR(64) NULL COMMENT '样本接收ID',
  MODIFY COLUMN protocol_sample_id VARCHAR(64) NULL COMMENT '协议样本ID',
  MODIFY COLUMN collection_protocol_id VARCHAR(64) NULL COMMENT '采集协议ID',
  MODIFY COLUMN reception_source VARCHAR(20) NULL DEFAULT 'cell_storage' COMMENT '来源';

-- 7. 迁移临时生产工单数据到主表
INSERT INTO biz_production_work_order (
  id, work_order_no, work_order_type, work_order_status,
  configured_time, configured_by,
  tenant_no, order_num, remark,
  create_by, create_dept_id, create_time, update_by, update_time, del_flag
)
SELECT
  id, work_order_no, 'temporary', work_order_status,
  configured_time, configured_by,
  tenant_no, order_num, remark,
  create_by, create_dept_id, create_time, update_by, update_time, del_flag
FROM biz_temp_production_work_order;

-- 8. 删除临时表（确认数据迁移成功后执行）
DROP TABLE IF EXISTS biz_temp_qc_work_order;
DROP TABLE IF EXISTS biz_temp_production_work_order;

[ ] Step 2: 手动执行前备份
```
mysqldump -u root -p zkxw biz_qc_work_order biz_temp_qc_work_order biz_production_work_order biz_temp_production_work_order > /tmp/work_order_backup_$(date +%Y%m%d).sql
```
Task 2: 后端 Model 更新

Files:
- Modify: backend/app/models/models.py
- [ ] Step 1: 更新 BizQcWorkOrder 模型
- 在 work_order_no 后加 work_order_type = Column(String(20), nullable=False, default="inbound")
- 将 reception_id、protocol_sample_id、collection_protocol_id 改为 nullable=True
- 将 reception_source 改为 nullable=True
- [ ] Step 2: 更新 BizProductionWorkOrder 模型
- 加 work_order_type = Column(String(20), nullable=False, default="inbound")
- 加 configured_time = Column(DateTime, nullable=True)
- 加 configured_by = Column(String(64), nullable=True)
- 将 reception_id、protocol_sample_id、collection_protocol_id 改为 nullable=True
- 将 reception_source 改为 nullable=True
- [ ] Step 3: 删除 BizTempQcWorkOrder 和 BizTempProductionWorkOrder 类
- [ ] Step 4: 验证 import
```
cd backend && source venv/bin/activate && python -c "from app.main import app; print('OK')"
```

Task 3: 后端 CRUD 合并 — 质检工单

Files:

Modify: backend/app/crud/qc_work_order.py
Delete: backend/app/crud/temp_qc_work_order.py
[ ] Step 1: 在 qc_work_order.py 中新增临时工单函数
- 将 temp_qc_work_order.py 中的 create_temp_qc_work_order、configure_temp_qc_work_order、list_temp_qc_work_orders、get_temp_qc_work_order_detail、try_complete_temp_qc_work_order、delete_temp_qc_work_order 合并进 qc_work_order.py
- 修改工单号生成逻辑：根据 work_order_type 选择前缀（inbound=ZJ，temporary=LSZJ）
- 修改 list 查询：加 work_order_type 过滤
- 修改 configure 逻辑：使用同一个 BizQcWorkOrder 模型
- 修改 task 生成：保持 order_source 逻辑不变
[ ] Step 2: 删除 temp_qc_work_order.py

Task 4: 后端 CRUD 合并 — 生产工单

Files:

Modify: backend/app/crud/production_work_order.py
Delete: backend/app/crud/temp_production_work_order.py
[ ] Step 1: 合并临时生产工单函数
- 同 Task 3 思路：将 temp 函数合并进主文件
- 工单号前缀：inbound=SC，temporary=LSSC
- 保留工艺路线克隆逻辑
- 保留 order_source 逻辑
[ ] Step 2: 删除 temp_production_work_order.py

Task 5: 后端 API + Schema 更新

Files:

Modify: backend/app/api/qc.py
Modify: backend/app/api/production.py
Modify: backend/app/schemas/qc_work_order.py
Delete: backend/app/schemas/temp_qc_work_order.py
Delete: backend/app/schemas/temp_production_work_order.py
[ ] Step 1: 更新 qc_work_order schema
- 在 QcWorkOrderCreateBody 中加 work_order_type: str = "inbound"
- 新增 TempQcWorkOrderCreateBody（remark only）或复用现有 schema
- 新增 QcWorkOrderConfigureBody（合并临时工单配置的 schema）
[ ] Step 2: 合并 qc.py API 端点
- 将临时质检工单的 5 个端点合并到现有工单端点
- 新增 POST /web/admin/qc-work-orders 支持 work_order_type 参数
- 新增 GET /web/admin/qc-work-orders 支持 work_order_type 过滤
- 新增 POST /web/admin/qc-work-orders/{id}/configure 端点（从 temp 端点移过来）
- 删除 temp 相关 import 和端点
[ ] Step 3: 合并 production.py API 端点
- 同上思路
[ ] Step 4: 删除 temp schema 文件
[ ] Step 5: 验证 import

Task 6: 恢复 qc_task.py 的简单 INNER JOIN

Files:

Modify: backend/app/crud/qc_task.py
[ ] Step 1: 恢复 list_tasks 为 INNER JOIN
- 将 outerjoin(BizQcWorkOrder, ...) 恢复为 join(BizQcWorkOrder, ...)
- 删除 BizTempQcWorkOrder import
- 删除临时工单子查询（temp_wo_sq）
- 删除临时工单后处理（temp_wo_ids、temp_wo_map、if/elif 分支）
- 恢复原来的 ORDER BY 子句（含 BizQcWorkOrder.work_order_no.desc()）
[ ] Step 2: 验证
```
cd backend && source venv/bin/activate && python -c "from app.crud.qc_task import list_tasks; print('OK')"
```
Task 7: 简化 production_task.py

Files:
- Modify: backend/app/crud/production_task.py
- [ ] Step 1: 简化 list_tasks 批量查询
- 删除 BizTempProductionWorkOrder import
- 删除临时工单子查询和批量补充逻辑
- 恢复为只查 BizProductionWorkOrder 的简单模式
Task 8: 前端 API + 页面合并

Files:
- Modify: web-admin/src/api/qc-work-order.ts 或 business.ts
- Modify: web-admin/src/api/production-work-order.ts 或 business.ts
- Modify: web-admin/src/views/quality-inspection/qc-work-order/index.vue
- Modify: web-admin/src/views/production/production-work-order/index.vue
- Delete: web-admin/src/api/temp-qc-work-order.ts
- Delete: web-admin/src/api/temp-production-work-order.ts
- Delete: web-admin/src/views/quality-inspection/temp-qc-work-order/index.vue
- Delete: web-admin/src/views/production/temp-production-work-order/index.vue
- Modify: web-admin/src/router/modules/sqxp.ts
- [ ] Step 1: 将临时工单 API 合并到主 API 模块
- 在 qc-work-order API 中新增 configure 端点调用
- 新增 work_order_type 参数支持
- 删除 temp API 文件
- [ ] Step 2: 更新 qc-work-order/index.vue
- 新增"工单类型"筛选（入库/临时）
- 新增创建时选择类型（入库走接收流程，临时直接创建）
- 新增配置检测弹窗（从 temp 页面移植）
- 条件显示 reception 相关列（仅入库类型显示样本编码、协议号等）
- [ ] Step 3: 更新 production-work-order/index.vue
- 同上思路
- [ ] Step 4: 更新路由 sqxp.ts
- 删除临时工单路由条目
- 主工单路由保持不变
- [ ] Step 5: 删除临时工单页面和 API 文件
- [ ] Step 6: 前端构建验证
```
cd web-admin && pnpm build
```

Task 9: 全局验证

[ ] Step 1: 后端 import 验证

cd backend && source venv/bin/activate && python -c "from app.main import app; print('OK')"

Step 2: 前端构建验证 bash cd web-admin && pnpm build

[ ] Step 3: 手动测试流程
- 创建入库质检工单 → 配置 → 生成任务 ✓
- 创建临时质检工单 → 配置 → 生成任务 ✓
- 质检任务列表显示两种来源 ✓
- 创建入库生产工单 → 配置 → 生成任务 ✓
- 创建临时生产工单 → 配置 → 生成任务 ✓

2026-05-24-merge-work-order-tables.md 12 KB Постоянна връзка История Директен файл

工单表合并重构实施计划

影响文件清单

删除（合并后不再需要）

修改

Task 1: DDL 迁移 SQL

Task 2: 后端 Model 更新

Task 3: 后端 CRUD 合并 — 质检工单

Task 4: 后端 CRUD 合并 — 生产工单

Task 5: 后端 API + Schema 更新

Task 6: 恢复 qc_task.py 的简单 INNER JOIN

Task 7: 简化 production_task.py

Task 8: 前端 API + 页面合并

Task 9: 全局验证

2026-05-24-merge-work-order-tables.md 12 KB

Постоянна връзка История Директен файл