入库明细：复制首行属性 + 储物格起止批量填充

日期: 2026-07-28
状态: 已确认
范围: web-admin（前端为主，复用现有储物格列表接口）
关联模块: 生产任务产出（细胞产品）、细胞产品管理

1. 背景

生产任务「任务执行」→「产出（细胞产品）」新增弹窗中，入库明细按「入库份数」生成多行。业务侧常出现：

多行规格、预计细胞数量、活率相同，逐行填写费时
储物格需按盒内连续位置分配，且可能跨多个盒子

现有能力：每行独立远程下拉选格；表单内不可重复；已占用格置灰；支持「造血干一键填充」（与本需求无关）。

2. 目标

在新增入库明细区域提供两类快捷操作：

能力	说明
复制首行属性	将第 1 行的规格、预计细胞数量、活率复制到其余行
储物格起止批量填充	选择同盒起始格与结束格，填充当前仍为空的储物格行；支持多次执行以跨盒

编辑单条产出时不展示入库明细表，故不提供上述按钮。

3. 需求确认

维度	决策
储物格填充交互	起始 + 结束
份数与区间数量	区间可用格数 ≥ 空行数 N 时取前 N 格；不足则失败提示
区间内占用格	不允许；区间内任一占用则整段失败
跨盒	单次必须同盒；跨盒通过多次填充（每次只填空行）
已选储物格的行	不覆盖；只填 `storageSlotId` 为空的行
复制字段	仅 `specName`、`expectedCellCount`、`viability`
不复制	产品编码、代次、储物格
落地页面	① `TaskOutputProductDialog.vue` ② `cell-product/index.vue` 新增弹窗

4. 界面

4.1 入口位置

「入库明细」标题行右侧（product-lines-head），新增两个描边按钮（带图标，符合按钮图标规范）：

复制首行属性
批量填储物格

仅 !isEdit 且存在入库明细表时显示。

4.2 批量填储物格弹层

小型 el-dialog（或内嵌确认区），字段：

起始储物格：与现有行内一致的远程 el-select（可检索编号）
结束储物格：同上
提示文案：须同盒；区间内不可有占用格；只填充当前空行；可多次操作以跨盒

底栏：取消 / 确定（Close / Check 图标）。

遮罩无背景模糊；label-position="top"。

5. 行为细则

5.1 复制首行属性

若明细行数 < 2：提示「至少两行明细才能复制」
取第 1 行 specName、expectedCellCount、viability，写入第 2…n 行
成功提示：已复制到其余行

允许首行三字段为空（仍复制空值，便于统一清空）。

5.2 批量填储物格（单次）

N = 明细中 storageSlotId 为空的行数
若 N = 0 → 提示「没有可填充的空行」并结束

用户选择 startId、endId
若未选齐 → 校验提示

通过 facilityNodeId 判断 start、end 是否同盒
若不同盒 → 提示「起始与结束须在同一盒子内」

请求 fetchStorageSlotList({ facilityNodeId }) 获取同盒全部格子
按现有盒内排序（order_num / 行列，与 storage-slot-options 一致）排序

在有序列表中定位 start、end 下标
若找不到 → 提示格不存在
若 startIndex > endIndex → 交换或按「从起始到结束」失败提示（推荐：自动按较小下标到较大下标取闭区间，避免用户选反）

range = slots[from..to]（闭区间）
若 range 中任一格不可用（非空 / occupied）→ 提示「区间内存在已占用储物格，请调整起止范围」

fromFormUsed = 本表单所有行已选的 storageSlotId（含非空行）
availableInRange = range 中 id 不在 fromFormUsed 的格
（注：因只填空行，fromFormUsed 主要排除其他行已选；区间本身已要求全部空闲）

若 availableInRange.length < N → 提示「区间内可用储物格不足（需要 N 个，实际 M 个）」

将 availableInRange 前 N 个依次赋给空行（按明细行从上到下）
将选中格 ensure 进各行下拉 options，保证回显
成功提示：已为 N 行填充储物格

5.3 多次填充（跨盒）

用户可再次点击「批量填储物格」，对新的同盒起止重复 5.2。
每次 N 只统计当前仍为空的行，直至全部填完或用户停止。

5.4 与现有校验的关系

提交前仍走：

表单内储物格不可重复（validateUniqueStorageSlotIds）
行间重复选格自动清空的 watch 保持不变

批量填充赋值后不应触发「误清空」：一次写入互不重复的 id。

6. 技术方案

6.1 方案选择

前端计算区间（复用 GET /web/admin/storage-facility-slots?facilityNodeId=），不新增区间专用 API。

理由：单次限制同盒，盒内格数量通常有限；规则变更成本低。

6.2 代码落点

项	路径
生产任务产出弹窗	`web-admin/src/views/production/production-work-order/TaskOutputProductDialog.vue`
细胞产品新增	`web-admin/src/views/production/cell-product/index.vue`
可选抽取	`web-admin/src/utils/storage-slot-range-fill.ts`（排序、切区间、校验、取前 N）

两页 UI 与逻辑保持一致；优先抽公共函数避免分叉。

6.3 起止下标方向

采用：自动规范化闭区间（from = min(iStart,iEnd), to = max(...)）。
用户先选编号较大的格再选较小的格也能工作，减少操作摩擦。

6.4 起始/结束格的 facilityNodeId

远程下拉选项当前可能只有 id/name。实现时需保证能得到 facilityNodeId：

方案：选中后按 id ensure/fetch 补全；或扩展 select-options 返回 facilityNodeId（若响应已有则直接用，见 CRUD _slot_to_dict / select-options 已含该字段时可透出到前端 option 类型）。

7. 非目标

不改编辑态单条产出表单
不自动修改「入库份数」
不支持单次跨盒区间
不跳过区间内占用格（占用即失败）
不覆盖已填写的储物格
不改后端占用模型与提交接口契约

8. 验收要点

复制首行：两行以上时，其余行规格/细胞数/活率与首行一致；编码与储物格不变
同盒连续空格、空行数 ≤ 区间长度：空行被按序填满；已有格的行不变
跨盒：两次操作可分别填两盒，最终空行可全部填完
不同盒起止：失败提示，明细不变
区间含占用：失败提示，明细不变
可用格 < 空行：失败提示，明细不变
无空行时点批量填：提示无空行
提交时仍校验一格一物、表单内不重复
两处入口（任务产出 + 细胞产品新增）行为一致

9. 测试建议

手动：入库份数 5，先填 2 行手选格，再批量填同盒区间覆盖剩余 3 行
手动：份数 8，盒 A 填 5、盒 B 填 3
手动：故意选跨盒起止、区间含占用、区间过短，确认提示与数据未改
回归：造血干一键填充、产品编码生成、代次、提交占用冲突提示

2026-07-28-product-lines-batch-fill-design.md 7.1 KB История Исходник