# 质检项合格范围配置(按产品维护)- 前端联调方案 ## 变更背景 原「质量管理 > 质检项合格范围配置」将所有产品共用纯度、净度、发芽率、水分四项固定配置。 现改为**按产品维护质检项**:每个质检项必须绑定一个产品(`mdm_item` 中的启用物料,本业务即种子品种), 同一产品下质检项编码唯一,可自由新增、编辑、删除、启停和排序。 历史四项数据自动迁移为**通用默认项**(`itemId` 为空),产品未配置专属项时回退使用,保证存量数据与流程不受影响。 ## 涉及页面 - 质量管理 → 质检项合格范围配置(路由 `mes/qc/seedRange/index`) - 质量管理 → 种子质检(桌面端,路由 `mes/qc/seedQuality/index`) - 质量管理 → 种子质检记录(桌面端,路由 `mes/qc/seedQuality/record`) - 移动端 → 种子质检(`/mobile/quality`) - 移动端 → 质检记录 / 批量检验与审核(`/mobile/quality-records`) ## 业务流程与数据带入 1. 配置页选择产品 → 列表只显示该产品已维护的质检项;产品未配置时显示空态并提示"质检时使用通用默认项"。 2. 质检页扫码(袋码 / 托盘码 / 生产批次码)→ 解析接口直接返回该产品的**生效质检项列表**(含编码、名称、单位、合格上下限)。 3. 质检页按返回的指标列表动态渲染输入项,不再固定四项、不再限制 0–100。 4. 提交时后端按"生效配置 / 原记录指标集合"校验指标数量与编码集合,前端不得自行增删指标。 5. 复检使用原质检记录的指标集合,配置后续变更不影响历史记录复检。 ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /mes/qc/seed-quality/ranges | 查询质检项配置(`itemId` 为空查通用默认项) | | GET | /mes/qc/seed-quality/ranges/effective | 查询指定产品生效的质检项 | | POST | /mes/qc/seed-quality/ranges | 新增质检项 | | PUT | /mes/qc/seed-quality/ranges/{id} | 修改质检项 | | DELETE | /mes/qc/seed-quality/ranges/{id} | 删除质检项 | | POST | /mes/qc/seed-quality/ranges/copy-default?itemId= | 复制通用默认项到指定产品 | **查询参数(GET /ranges):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | itemId | Long | 否 | 产品编号;不传查询通用默认项 | | keyword | String | 否 | 质检项名称/编码模糊匹配 | | status | Integer | 否 | 0 启用 1 停用 | **保存参数(POST / PUT):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | itemId | Long | 是 | 产品编号(启用状态的物料) | | indicatorCode | String | 是 | 编码,字母开头,仅字母/数字/下划线,最长 64;同一产品下唯一 | | indicatorName | String | 是 | 质检项名称 | | unit | String | 否 | 单位,默认 `%` | | minValue | BigDecimal | 是 | 合格下限,≥ 0 | | maxValue | BigDecimal | 是 | 合格上限,≥ 下限 | | sort | Integer | 否 | 排序,默认 0 | | status | Integer | 否 | 0 启用 1 停用,默认 0 | **响应字段(列表 / 生效列表):** | 字段 | 类型 | 说明 | |------|------|------| | id | Long | 主键 | | itemId | Long | 产品编号;为空表示通用默认项 | | indicatorCode | String | 编码 | | indicatorName | String | 名称 | | unit | String | 单位 | | minValue | BigDecimal | 合格下限 | | maxValue | BigDecimal | 合格上限 | | sort | Integer | 排序 | | status | Integer | 状态 | | updateTime | Date | 更新时间 | **响应示例:** ```json { "code": 0, "data": [ { "id": 1, "itemId": 1001, "indicatorCode": "purity", "indicatorName": "纯度", "unit": "%", "minValue": 95, "maxValue": 100, "sort": 10, "status": 0 } ] } ``` ## 质检接口响应新增字段 `/mes/qc/seed-quality/resolve`、`/retest-scope/resolve` 响应新增: | 字段 | 类型 | 说明 | |------|------|------| | itemId | Long | 产品编号 | | itemCode | String | 产品编码 | | itemName | String | 产品名称 | | indicators | Array | 生效质检项:`{ code, name, unit, minValue, maxValue }` | 质检记录分页新增 `itemId / itemCode / itemName`;指标明细新增 `indicatorName / unit`。 ## 生效规则 | 场景 | 规则 | |------|------| | 产品配置了启用的专属质检项 | 使用该产品的专属配置 | | 产品未配置任何专属质检项 | 回退使用通用默认项(`item_id` 为空且启用) | | 产品存在专属项但全部停用 | 视为未配置,回退通用默认项 | | 产品与通用默认项都为空 | 质检接口报错"该产品尚未配置质检项,请联系管理员维护" | | 指标校验 | 提交的指标编码集合必须与生效配置完全一致,数量、编码不得增删 | | 数值校验 | 实测值、上下限均 ≥ 0,下限 ≤ 上限;实测值在区间内判定合格 | | 复检 | 按原质检记录的指标集合校验,不使用当前配置 | ## 迁移步骤 1. 执行 `sql/mysql/mes_qc_seed_indicator_range_product_20261105.sql`(幂等,可重复执行)。 2. 脚本会把原四项标记为通用默认项(`item_id` 为空),不影响任何存量质检流程。 3. 各产品可在配置页通过"复制通用默认项"快速生成专属配置,再按需调整。 ## 注意事项 - 质检项编码在同一产品下唯一;编辑时编码不可修改,如需更换请删除后新增。 - 产品下拉只显示启用状态的物料,请确保待配置的种子品种已维护为启用物料。 - 前端不再对指标做 0–100 的硬性限制,改为非负 + 下限 ≤ 上限;请勿在前端自行过滤或补全指标。 - 移动端与桌面端均以解析接口返回的 `indicators` 为准,不再单独调用范围配置接口。 - 删除质检项只影响后续质检,历史记录中的指标名称/单位以快照形式保存,不受影响。