# 质检记录按生产批次折叠展示 - 前端联调方案 ## 涉及页面 - 质量管理 > 质检记录(`/qc/seed-quality-record`) ## 页面结构 1. 顶部页头与结果统计卡片保持原样。 2. 记录区域由「整表平铺」改为「按生产批次折叠」: - 每个生产批次为一张可折叠分组卡片,默认展开第一条。 - 卡片头部展示批次号、品种、加工单位、生产日期、最近检验时间,以及合格/不合格/处理中/待审核统计。 - 展开后展示该批次下的质检明细表(分页、勾选、批量操作仍可用)。 3. 底部为「批次分页」,按批次翻页;明细分页在每张卡片内部独立维护。 ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /mes/qc/seed-quality/batch-page | 新增:质检记录按生产批次分组分页(批次汇总) | | GET | /mes/qc/seed-quality/page | 原有:质检明细分页,新增两个可选过滤参数 | ### 1. 批次分组分页 `GET /mes/qc/seed-quality/batch-page` **请求参数(与明细分页一致,均可选):** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | pageNo | Integer | 否 | 批次页码,默认 1 | | pageSize | Integer | 否 | 每页批次数,默认 10,最大 100 | | code | String | 否 | 袋码(支持扫码内容,后端自动解析为袋码) | | batchCode | String | 否 | 生产批次号(模糊匹配) | | result | Integer | 否 | 检验结果:1 合格,2 不合格,0 处理中 | | workflowStatus | Integer | 否 | 流程状态,取值见下表 | **响应字段:** | 字段 | 类型 | 说明 | |------|------|------| | batchId | Long | 生产批次编号,未绑定批次时为空 | | batchCode | String | 生产批次号,未绑定时为空字符串 | | batchLabel | String | 批次展示名,未绑定时为「未绑定批次」 | | itemId | Long | 品种编号 | | itemCode | String | 品种编码 | | itemName | String | 品种名称 | | lineName | String | 加工单位(产线名称) | | produceDate | LocalDateTime | 生产日期 | | totalCount | Integer | 组内质检记录总数 | | passCount | Integer | 合格数量 | | failCount | Integer | 不合格数量 | | processingCount | Integer | 处理中数量 | | pendingRetestCount | Integer | 待复检/重新初检数量(10、50) | | pendingProcessReviewCount | Integer | 待初检审核数量(20、25) | | pendingCompanyReviewCount | Integer | 待复检审核数量(30、60) | | releasedCount | Integer | 已放行数量(40) | | scrappedCount | Integer | 已报废数量(70) | | lastInspectedAt | LocalDateTime | 组内最近检验时间,用于排序与展示 | **响应示例:** ```json { "code": 0, "data": { "list": [ { "batchId": 1024, "batchCode": "2026001", "batchLabel": "2026001", "itemCode": "SEED001", "itemName": "塔河4号", "lineName": "一号加工线", "produceDate": "2026-11-01 08:00:00", "totalCount": 120, "passCount": 80, "failCount": 10, "processingCount": 30, "pendingRetestCount": 5, "pendingProcessReviewCount": 15, "pendingCompanyReviewCount": 10, "releasedCount": 80, "scrappedCount": 10, "lastInspectedAt": "2026-11-05 09:30:00" } ], "total": 1 } } ``` ### 2. 明细分页新增参数 `GET /mes/qc/seed-quality/page` 在原有参数基础上新增: | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | exactBatchCode | String | 否 | 生产批次号精确匹配,展开某个批次时传入 | | unbound | Boolean | 否 | 仅查询未绑定生产批次的记录,展开「未绑定批次」时传 true | **响应字段无变化。** ## 接口调用时序 1. 页面加载或筛选查询:调用 `batch-page` 获取当前页批次汇总。 2. 默认展开第一条批次:调用 `page`,传 `exactBatchCode`(或 `unbound=true`)+ 当前筛选条件。 3. 展开其他批次:按需调用 `page`,每个批次维护独立的页码与每页条数。 4. 批次翻页:重新调用 `batch-page`。 5. 复检、审核、流程记录等操作沿用原接口,操作成功后重新加载批次汇总及已展开批次的明细。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | batchLabel | 批次卡片头 | 批次主标题,未绑定批次显示「未绑定批次」 | | itemName / lineName / produceDate / lastInspectedAt | 批次卡片头 | 副标题信息,缺失时隐藏 | | totalCount / passCount / failCount / processingCount | 批次卡片头 | 统计胶囊,始终展示 | | pendingProcessReviewCount / pendingCompanyReviewCount / pendingRetestCount / releasedCount / scrappedCount | 批次卡片头 | 状态标签,数量为 0 时隐藏 | | 质检编号、袋码、托盘码、检验结果、流程状态、不合格原因、检验时间、提交时间、操作 | 展开后的明细表 | 明细表内不再重复展示生产批次列 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 分组依据 | 按质检记录的 `batch_code` 分组,同一批次的所有袋码质检记录归为一组 | | 未绑定批次 | `batch_code` 为空的记录归入「未绑定批次」组,排在有批次记录之后 | | 排序 | 按组内最近检验时间倒序,其次按组内最大记录编号倒序 | | 筛选 | 袋码、批次号、检验结果、流程状态筛选同时作用于分组统计与明细 | | 统计口径 | 统计数量均基于当前筛选条件下的记录,不等于批次全部袋码数 | | 分页 | 批次分页与明细分页相互独立,批次分页改变后明细重新加载 | ## 注意事项 - 批次分组接口返回的是汇总数据,不包含明细;明细必须通过 `page` 接口按批次加载。 - 展开批次时不要复用「生产批次」模糊筛选值,必须使用 `exactBatchCode` 或 `unbound`,否则会串入其他批次数据。 - `processingCount` 为结果为空或 0 的记录数,与「处理中」展示口径一致。 - 勾选记录跨批次保留,批量操作仍按流程状态与生产批次分组呈现。 - 若后续新增质检记录字段,分组统计无需调整;若新增流程状态,需要同步补充统计字段与分组头标签。