# 种子质检前端联调方案

## 涉及页面

- 种子质检提交页
- 种子质检记录页

## 业务流程与数据带入

1. 生产袋码或待检库存带入袋码、物料、批次信息。
2. 提交时仅传袋码、物料、批次和四项检测结果，仓库位置由后台配置决定。
3. 合格时由后端将WIP/待检库移入正式库存；不合格时删除袋码和对应库存台账，但保留质检审计数据。

## API

| 方法 | 路径 | 说明 |
|---|---|---|
| POST | `/mes/qc/seed-quality/submit` | 提交种子质检 |

请求参数包括 `code`、`itemId`、`batchCode`、`reason` 和 `indicators`。`indicators` 必须恰好包含 `purity`、`cleanliness`、`germination_rate`、`moisture`，每项包含 `value`、`minValue`、`maxValue`，数值不得为负且结果必须在边界内。

成功响应为质检主表编号。重复袋码提交会被拒绝。

## 字段展示规则

| 字段 | 展示位置 | 说明 |
|---|---|---|
| code | 列表、详情 | 袋码 |
| batchCode | 列表、详情 | 生产批次 |
| 四项指标 | 详情 | 展示实测值和合格上下限 |
| result | 列表、详情 | 合格或不合格 |
| reason | 详情 | 不合格原因 |
| inspectorId、inspectedAt | 详情 | 质检员和质检时间 |

## 业务规则说明

| 场景 | 规则 |
|---|---|
| 指标校验 | 四项指标必须齐全、不可重复，实测值必须在边界内 |
| 合格 | 生成MOVE_OUT和MOVE_IN，来源为WIP/待检库，目标为正式库存 |
| 不合格 | 删除袋码和对应库存台账，不调整生产批次数量，保留主表、指标、原因和事务审计 |
| 幂等 | 袋码已存在质检记录时拒绝再次提交 |
| 权限 | 需要 `mes:qc-seed-quality:submit` 权限 |

## 注意事项

- 前端不得传仓库、库区、库位参数，后台配置编码为后续配置服务预留。
- 不合格结果仍需展示，不能按业务删除质检主表及指标记录。