# 种子质检双线流程(含经销商退货质检)- 前端联调方案 ## 涉及页面 - 种子质检提交页(`views/mes/qc/seedQuality/index.vue`) - 种子质检记录页(`views/mes/qc/seedQuality/record.vue`) - 销售退货单列表页(`views/wls/returnsales/index.vue`)及退货质检弹窗 ## 业务流程与数据带入 1. 加工部开销售入库:袋码入库后可扫码质检,托盘码每 48 袋或 100 袋生成,批次码带出整批袋数。 2. **一次种子质检提交即同时生成两条质检记录**:`qcLine=1`(加工部)与 `qcLine=2`(销售部),两条记录的指标、结论完全一致;后续复检、审批分别按质检线独立进行。 3. 初检合格直接进入本线领导 BPM 审批;初检不合格先复检,再进入本线领导审批。部门审批驳回后重新初检。 4. 两条线分别使用流程定义 `mes_seed_quality_line_approve`,businessKey 为 `质检线#生产批次号`;审批通过后进入公司质检待审状态。 5. 同一生产批次内所有袋的两条线都完成部门审批后,系统自动发起**一次**公司质检审批(流程定义 `mes_seed_quality_company_approve`,businessKey 为**生产批次号**)。公司审批**按批次发起、按袋落库**:每个袋两条线都为合格才放行入库,任一条不合格则该袋报废;驳回则整批两条线一起退回待复检。 6. 放行后产品正式入库,后续库管扫码出库、销售转移经销商、终端农户扫码溯源。 7. 经销商退货分支:销售退货单确认后发起退货质检 → 复检 → 销售部领导审批;不合格则退货单自动取消、不予退货并保留检验记录。 ## API | 方法 | 路径 | 说明 | |---|---|---| | GET | `/mes/qc/seed-quality/resolve` | 识别袋码/托盘码/批次码,返回待检清单与已有质检线 | | POST | `/mes/qc/seed-quality/submit-group` | 按袋码、托盘码、批次码提交初检,一次生成加工部、销售部两条记录 | | POST | `/mes/qc/seed-quality/submit` | 单袋提交初检,一次生成加工部、销售部两条记录 | | GET | `/mes/qc/seed-quality/page` | 质检记录分页(新增 `qcLine`、`bizType` 筛选与返回字段) | | GET | `/mes/qc/seed-quality/batch-page` | 按生产批次分组的质检汇总 | | POST | `/mes/qc/seed-quality/process-approve` | 初检审核(加工部/销售部领导;退货质检的销售部审批复用此接口) | | POST | `/mes/qc/seed-quality/process-approve-batch` | 批量初检审核 | | POST | `/mes/qc/seed-quality/company-approve` | 公司质检审批(按袋合并两条线处理) | | POST | `/mes/qc/seed-quality/company-approve-batch` | 批量公司质检审批(按袋码分组合并) | | POST | `/mes/qc/seed-quality/retest` | 单条记录复检/重新初检 | | POST | `/mes/qc/seed-quality/retest-batch` | 按记录 ID 批量复检 | | GET | `/mes/qc/seed-quality/retest-scope/resolve` | 按托盘码/批次码解析待复检与待审核清单 | | POST | `/mes/qc/seed-quality/retest-scope` | 按托盘码/批次码批量复检或重新初检 | | GET | `/mes/qc/seed-quality/return/resolve` | 解析经销商退货单待质检信息 | | POST | `/mes/qc/seed-quality/return/submit` | 提交经销商退货质检 | | POST | `/mes/qc/seed-quality/return/approve` | 经销商退货质检销售部领导审批 | ### 响应字段新增 **`/resolve`(`SeedQualityScan`)新增:** | 字段 | 类型 | 说明 | |---|---|---| | qualityIds | Number[] | 该袋已存在的全部质检记录编号 | | qualityLines | Object[] | 已存在质检线:`{ id, qcLine, workflowStatus }`(不含退货质检记录) | **`/page`(`SeedQualityRecord`)新增:** | 字段 | 类型 | 说明 | |---|---|---| | qcLine | Number | 质检线:1 加工部,2 销售部,0 未区分(历史数据) | | bizType | Number | 业务类型:1 生产入库质检,2 经销商退货质检 | | processInstanceId | String | 本线 BPM 流程实例 | | companyProcessInstanceId | String | 公司质检 BPM 流程实例 | | returnSalesId / returnSalesCode | Number / String | 关联销售退货单 | | retestedAt / processApprovedAt / lineFinishedAt | String | 复检、初检审核、本线完成时间 | | companySubmittedAt / companyApprovedAt | String | 公司审批发起、完成时间 | **请求参数新增:** `/page`、`/batch-page` 支持 `qcLine`、`bizType` 筛选。 **`/return/resolve` 响应:** | 字段 | 类型 | 说明 | |---|---|---| | returnSalesId / returnSalesCode / returnSalesStatus | Number / String / Number | 退货单信息 | | itemId / batchId / batchCode | Number / Number / String | 从退货单明细带出 | | indicators | Object[] | 该产品生效质检项 `{ code, name, unit, minValue, maxValue }` | | qualityId / result / workflowStatus | Number | 已存在质检记录时返回,用于禁止重复提交 | **`/return/submit` 请求:** | 参数 | 类型 | 必填 | 说明 | |---|---|---|---| | returnSalesId | Number | 是 | 销售退货单编号 | | indicators | Object[] | 是 | `{ code, value, minValue, maxValue }`,须覆盖全部生效质检项 | | reason | String | 不合格时必填 | 不合格原因 | ## 流程状态说明 | 状态值 | 含义 | 处理人/触发方式 | |---|---|---| | 10 | 待复检 | 加工部/销售部质检员 | | 20 | 待部门审批 | 本线领导 BPM 待办 | | 25 | 待部门不合格审批 | 本线领导 BPM 待办 | | 30 | 待公司质检审批 | 公司质检(双线部门审批完成后自动发起) | | 40 | 已放行 | 公司审批通过,库存转入合格库 | | 50 | 初检驳回待重检 | 本线领导驳回后 | | 60 | 待公司质检不合格处理 | 公司质检(双线部门审批完成后自动发起) | | 70 | 已报废 | 公司审批确认不合格 | 经销商退货质检复用同一组状态:初检合格 → 20(待销售部领导审批),不合格 → 10(待复检);复检后无论结论均进入 20 并发起销售部审批。审批通过且检验合格 → 40,退货单进入“待执行”;审批驳回或检验不合格 → 70,退货单取消。 ## BPM 流程定义 | 流程定义 key | businessKey | 流程变量 | |---|---|---| | `mes_seed_quality_line_approve` | `{qcLine}#{生产批次号}` | `qcLine`、`batchCode` | | `mes_seed_quality_company_approve` | 生产批次号 | `batchCode`、`code`(兼容旧流程)、`passed` | | `mes_seed_return_approve` | 销售退货单编号 | `returnSalesId`、`returnSalesCode`、`code` | - 流程监听器在流程结束(通过/驳回)时回写质检状态;取消(CANCEL)不改变业务状态。 - 若 BPM 流程定义未部署,发起流程会失败并记录日志;修复配置后可通过质检记录页的“重新发起审批”恢复。新双线记录不能使用人工审批接口。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |---|---|---| | qcLine | 记录列表、详情 | 加工部/销售部标签;历史数据显示“未区分” | | bizType | 记录列表 | 退货质检记录显示“退货”标签与退货单号 | | workflowStatus | 记录列表、详情 | 按业务类型展示:退货状态 20 显示“待销售部领导审批” | | returnSalesCode | 记录列表 | 退货质检关联的经销商退货单 | | processInstanceId / companyProcessInstanceId | 详情 | 展示对应的 BPM 审批实例(可跳转流程详情) | ## 业务规则说明 | 场景 | 规则 | |---|---| | 初检提交 | 每袋固定生成加工部、销售部两条记录,指标与结论完全一致 | | 重复提交 | 同一袋码已有任意一条生产入库质检记录时拒绝再次提交 | | 线条审批 | 每条线独立审批;BPM businessKey 按 `质检线#生产批次号` 归并,同批次同线条一次审批全部待审记录 | | 公司审批(BPM) | 按生产批次只发起一次:批次内所有生产入库质检记录都处于 30/60 时才发起;流程 businessKey 为生产批次号;流程完成后按袋落库,每个袋两条线都为 30 时放行,否则报废;驳回时整批两条线一起回到 10(待复检) | | 公司审批(人工接口) | 仍按袋处理:必须两条线都处于 30/60;两条线都为 30 时放行,否则报废;驳回时两条线一起回到 10(待复检) | | 库存流转 | 公司审批通过后整袋转入合格库;报废时不入合格库,保留质检与审批痕迹 | | 退货质检 | 退货单状态为草稿或待检验时可提交;不合格自动取消退货单并保留质检记录 | | 权限 | 初检提交 `mes:qc-seed-quality:submit`;复检 `mes:qc-seed-quality:retest`;本线/销售部审批 `mes:qc-seed-quality:process-approve`;公司审批 `mes:qc-seed-quality:company-approve` | ## 数据库变更 执行脚本:`sql/mysql/mes_seed_quality_dual_line_20261105.sql` - 新增字段:`qc_line`、`biz_type`、`process_instance_id`、`company_process_instance_id`、`line_finished_at`、`company_submitted_at`、`return_sales_id`、`return_sales_code`。 - 原唯一索引 `uk_code` 调整为 `uk_code_line(code, qc_line)`,允许同一袋码存在两条记录。 - 历史数据 `biz_type` 回填为 1(生产入库质检),`qc_line` 为 0(未区分)。 ## 注意事项 - 前端列表需按“袋码 + 质检线”展示,避免把同一袋的两条记录当成两袋统计;批次汇总接口已按袋码去重。 - 公司审批即使只选中一条线记录,后端也会处理整袋两条线,前端提示需说明“按袋合并处理”。 - 复检、初检审核按记录 ID 操作时只影响所选记录所在线条;需要双线一起处理请使用公司审批。 - 经销商退货质检入口位于“销售退货单”列表,仅“待检验”状态显示;提交后审批在“质检记录”页完成。 - 退货单被取消或质检不合格后,不得再次提交质检。