# 工单/任务编辑与生产结论 — 设计文档

> 日期: 2026-05-24  
> 状态: 已实现（2026-05-24）  
> 范围: 质检工单、生产工单、生产任务（web-admin + backend）

## 1. 背景

在工单融合（`work_order_type`: inbound / temporary）之后，列表侧缺少对**备注**与**生产任务结论**的维护入口。本变更补齐编辑能力，并复用既有 API/组件，控制改动面。

## 2. 已确认的产品决策

| 问题 | 决策 |
|------|------|
| 入库工单编辑备注：已完成状态是否可改？ | **可以**（任意工单状态均可改备注） |
| 临时生产工单「编辑信息」范围？ | **仅备注** |
| 生产任务结论「失败」是否触发业务副作用？ | **不触发**；v1 仅结果存储 |
| 结论字段编码？ | **拼音缩写**存库；界面展示**中文** |
| 生产任务列表：已完成任务是否可编辑基础信息？ | **不需要**（已完成任务不展示「编辑」） |

## 3. 功能清单

### 3.1 质检工单 — 入库 Tab

- 列表操作列增加 **「编辑」**（`EditPen`）。
- 弹窗字段：**仅备注**（`textarea`，max 512）。
- 任意 `work_order_status`（含 `ywc`）可保存。
- 与临时 Tab 的「编辑」（细胞产品 + 备注）区分：入库仅走备注弹窗。

### 3.2 生产工单 — 入库 Tab

- 列表增加 **「编辑」** → 仅备注弹窗（同上）。
- 任意工单状态可改备注。

### 3.3 生产工单 — 临时 Tab

- 列表增加 **「编辑」** → 仅备注弹窗（与入库共用交互）。
- 不包含改任务名称/工艺路线（任务级能力保留在「派发任务」「编辑任务」）。

### 3.4 生产任务 — 列表

- 列表增加 **「编辑」** → 复用 `EditTaskInfoDialog`（`taskName` / `description` / `remark`）。
- **显示条件**：`task_status` 为 `dpz` 或 `jxz`；`ywc` **不展示**编辑按钮。
- 后端可对 `ywc` 拒绝更新（双保险，可选）。

### 3.5 生产任务 — 完成任务结论

- 入口：任务执行弹窗 `TaskExecutionDialog` →「完成任务」。
- 流程：现有 I/O 校验通过 → 弹出**结论弹窗**（非简单 `confirm`）→ 提交完成。
- 结论（必填）：
  - 存库：`cg` = 成功，`sb` = 失败
  - 展示：成功 / 失败；Tag：`success` / `danger`
- 可选备注（`textarea`）。
- v1：**不**改变细胞产品入库、工单状态同步、通知等既有逻辑；仅写入 `conclusion`（及可选 `remark`）并置 `task_status=ywc`。

## 4. 数据模型

### 4.1 已有字段（无需 DDL）

- `biz_qc_work_order.remark`
- `biz_production_work_order.remark`
- `biz_production_task.remark` / `task_name` / `description`

### 4.2 新增字段

```sql
ALTER TABLE biz_production_task
  ADD COLUMN conclusion VARCHAR(16) NULL
  COMMENT '生产结论 cg=成功 sb=失败'
  AFTER completed_time;
```

- 迁移脚本：`docs/sql/production_task_conclusion.sql`
- 全量基线：同步 `docs/sql/zkxw.sql`

### 4.3 结论枚举

| 编码 | 中文标签 | Tag type |
|------|----------|----------|
| `cg` | 成功 | `success` |
| `sb` | 失败 | `danger` |

## 5. API 设计

### 5.1 质检工单 `PUT /web/admin/qc-work-orders/{id}`

**现状**：仅 `temporary` 可更新（`update_temp_qc_work_order`）。

**调整**：

- `inbound`：仅接受 `remark`（忽略 `cellProductId`）。
- `temporary`：保持 `cellProductId` + `remark`。
- 不校验工单是否已完成（备注始终可改）。

### 5.2 生产工单 `PUT /web/admin/production-work-orders/{id}`（新增）

- Body：`{ remark?: string }`
- 入库/临时均可更新备注；任意 `work_order_status`。
- CRUD：`update_production_work_order(db, wo_id, tenant_no, user_id, remark=...)`

### 5.3 生产任务 `PUT /web/admin/production-tasks/{id}/status`

**扩展 Body**（完成时）：

```json
{
  "taskStatus": "ywc",
  "conclusion": "cg",
  "remark": "可选"
}
```

- `taskStatus=ywc` 时 **`conclusion` 必填**，且必须为 `cg` | `sb`。
- `remark` 可选；若传入则更新任务 `remark`（与完成备注合并策略：写入 `remark` 字段）。
- `jxz` / `dpz` 状态变更逻辑不变。

### 5.4 列表/详情响应

- `biz_production_task` 序列化增加：`conclusion`、`conclusionLabel`（后端映射中文）。

## 6. 前端设计

### 6.1 共用组件（建议）

`components/business/work-order-remark-dialog/index.vue`（可选抽取）

- Props：`visible`, `title`, `initialRemark`, `loading`
- Emit：`submit(remark)`, `update:visible`
- 规范：`dialog-form-layout`、`label-position="top"`、底栏 Close/Check

若不抽取，各页内联单字段弹窗亦可（最小 diff）。

### 6.2 页面改动

| 页面 | 文件 | 改动 |
|------|------|------|
| 质检工单 | `views/quality-inspection/qc-work-order/index.vue` | 入库 Tab「编辑」+ 备注弹窗；`handleEditRemark` |
| 生产工单 | `views/production/production-work-order/index.vue` | 入库/临时 Tab「编辑」+ 备注弹窗 |
| 生产任务 | `views/production/production-task/index.vue` | `EditTaskInfoDialog`；`v-if` 非 `ywc` |
| 任务执行 | `useTaskStepEditor.ts` + 新 `CompleteProductionTaskDialog.vue` | 完成前结论弹窗 |
| API | `qc-work-order.ts`, `production-work-order.ts`, `production-task.ts` | 新增/扩展类型 |

### 6.3 生产任务列表（可选增强）

- 增加列「生产结论」：`ywc` 行展示 `el-tag`；未完成显示 `—`。

### 6.4 UI 规范

- 操作列 `fixed="right"`，宽度预留（质检约 +60px，生产工单约 +60px，生产任务约 +80px）。
- 结论 Tag 遵循 OpenSpec ui-conventions（状态/结论字段用 `el-tag`）。

## 7. 权限

- 质检：沿用 `biz:qcWorkOrder:list`（现有 PUT）。
- 生产工单/任务：沿用 `require_admin_or_super_admin`。

## 8. 不在本期范围

- 结论为 `sb` 时禁止产出、回滚库存、消息通知。
- 已完成生产任务的基础信息编辑。
- 质检任务完成结论（已有 `tg`/`btg` 流程，不改动）。

## 9. 实施顺序

1. DDL + Model `BizProductionTask.conclusion`
2. 后端：QC 工单 PUT 扩展、生产工单 PUT 新增、完成任务 conclusion 校验
3. 前端 API 类型
4. 质检/生产工单备注编辑 UI
5. 生产任务列表编辑（非 ywc）
6. 完成任务结论弹窗 + 列表结论列（可选）
7. `scripts/check_field_consistency.py`（若扩展 schema）
8. `./scripts/update-graph.sh backend` + `frontend`

## 10. 验收要点

- [ ] 入库质检工单：任意状态可改备注并列表刷新
- [ ] 临时质检工单：原编辑（产品+备注）不受影响
- [ ] 入库/临时生产工单：任意状态可改备注
- [ ] 生产任务：`dpz`/`jxz` 可编辑基础信息；`ywc` 无编辑按钮
- [ ] 完成任务：必须选成功/失败；完成后详情/列表可见中文结论
- [ ] 失败结论不改变细胞产品/工单等下游行为