Files
zkxw/docs/superpowers/specs/2026-06-11-qc-material-batch-inbound-design.md
T
2026-06-11 15:42:58 +08:00

539 lines
23 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 质检物料库 · 入库批次管理设计
> 日期: 2026-06-11
> 状态: 已确认(2026-06-11 补充)
> 父模块: 质量检测 → 质检物料库
> supersede: `docs/superpowers/specs/2026-05-20-qc-material-library-design.md` 中「不做批次管理」约束
## 1. 背景与目标
### 现状
质检物料库采用 **物资维度** 的简单库存模式:
- `biz_qc_material`:一种物资一行,汇总 `stock_qty`
- `biz_qc_material_usage`:变动流水,入库仅记录数量与时间
- 「物料列表」Tab 展示物资主数据;入库弹窗只有数量 + 入库时间
- 质检任务「填写检测结果」中物料使用按 **物料名称** 下拉选择(`materialId`)
### 客户诉求
1. 每次入库需记录:**入库日期、入库编号、货号、批号、厂家、单价、金额**
2. **同一物资可多次入库**,每批次的编号/货号/批号/厂家/单价/金额不同
3. 「物料列表」需展示上述批次信息(一行 = 一条入库批次)
4. 出库 / 质检任务扣减须 **手动选择具体入库批次**(入库编号),不再只按物资名称扣减
### 已确认决策
| 问题 | 选项 | 含义 |
|------|------|------|
| 出库/扣减批次策略 | **B** | 每次手动选择扣哪一批(按入库编号) |
| 物料列表展示粒度 | **A** | 一行 = 一条入库批次(同一物资可出现多行) |
| 入库编号来源 | **B** | 用户手工录入,系统做租户内唯一性校验 |
| 入库批次字段必填 | **是** | 货号、批号、厂家、单价(元)、金额(元)均必填(前端 + 后端校验) |
| 零库存批次展示 | **不隐藏** | 批次列表默认展示全部批次(含 `remaining_qty=0`),便于查看历史出库后的批次行 |
### 非目标
- 先进先出(FIFO)自动扣减
- 有效期 / 库位管理
- 出库放行「出库物料准备」台账改为批次级(仍为物资级台账,可后续扩展)
- 市场物料库 / 生产耗材 / 试剂模块同步改造
---
## 2. 数据模型
### 2.1 保留 `biz_qc_material`(物资目录)
职责:**物资主数据**,不再在列表 Tab 直接展示(无批次时不出现在批次列表)。
| 字段 | 说明 |
|------|------|
| material_code / material_name / spec_model / unit | 不变 |
| stock_qty | **汇总库存** = Σ 下属批次 `remaining_qty`(写入时同步维护) |
| warning_qty / status | 不变,预警仍按物资汇总库存判断 |
### 2.2 新增 `biz_qc_material_stock_batch`(入库批次 / 库存明细)
每次入库产生一条批次记录,是库存扣减的 **最小粒度**。
```sql
CREATE TABLE `biz_qc_material_stock_batch` (
`id` varchar(64) NOT NULL COMMENT '主键ID',
`material_id` varchar(64) NOT NULL COMMENT '关联 biz_qc_material.id',
`material_code` varchar(64) DEFAULT NULL COMMENT '物料编码快照',
`material_name` varchar(200) DEFAULT NULL COMMENT '物料名称快照',
`spec_model` varchar(200) DEFAULT NULL COMMENT '规格型号快照',
`unit` varchar(32) DEFAULT NULL COMMENT '单位快照',
`stock_in_no` varchar(64) NOT NULL COMMENT '入库编号(用户录入,租户内唯一)',
`stock_in_date` date NOT NULL COMMENT '入库日期',
`catalog_no` varchar(128) NOT NULL COMMENT '货号',
`batch_no` varchar(128) NOT NULL COMMENT '批号',
`manufacturer` varchar(200) NOT NULL COMMENT '厂家',
`unit_price` decimal(18,2) NOT NULL COMMENT '单价(元)',
`amount` decimal(18,2) NOT NULL COMMENT '金额(元)',
`in_qty` decimal(18,4) NOT NULL COMMENT '入库数量',
`remaining_qty` decimal(18,4) NOT NULL COMMENT '剩余数量',
`tenant_no` varchar(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号',
`order_num` int(11) DEFAULT NULL COMMENT '排序号',
`remark` varchar(512) DEFAULT NULL COMMENT '备注',
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人id',
`create_dept_id` varchar(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人id',
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
`del_flag` tinyint(4) NOT NULL DEFAULT '0' COMMENT '删除标记:0-正常 1-已删除',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_qc_batch_tenant_stock_in_no` (`tenant_no`, `stock_in_no`, `del_flag`),
KEY `idx_qc_batch_material` (`material_id`, `del_flag`),
KEY `idx_qc_batch_tenant_date` (`tenant_no`, `stock_in_date`, `del_flag`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='质检物料入库批次';
```
**字段规则:**
- `stock_in_no`:必填,trim 后租户内唯一(`del_flag=0` 维度)
- `catalog_no` / `batch_no` / `manufacturer` / `unit_price` / `amount`:**全部必填**;入库弹窗与批量入库每行均 required
- `amount`:打开弹窗时默认 `unit_price × in_qty` 自动计算;用户可手工改金额;改单价或数量时若用户未手工改过金额则重新计算
- `remaining_qty`:初始 = `in_qty`;出库/任务扣减时递减;撤销时回加;**为 0 时批次行仍保留并在列表中展示**
- 快照字段(material_code 等)在入库时从主表复制,后续主表改名不影响历史
### 2.3 扩展 `biz_qc_material_usage`(变动流水)
新增批次关联与快照字段:
| 新增字段 | 说明 |
|----------|------|
| `batch_id` | 关联 `biz_qc_material_stock_batch.id`(入库/出库/任务扣减均有值) |
| `stock_in_no` | 入库编号快照 |
| `catalog_no` | 货号快照 |
| `batch_no` | 批号快照 |
| `manufacturer` | 厂家快照 |
| `unit_price` | 单价快照 |
| `amount` | 金额快照(入库写正数;出库不写或写按量折算,见 3.3) |
| `stock_before` | 变动前库存(补齐,与耗材模块一致) |
`stock_after` 语义调整为 **物资汇总库存**(`biz_qc_material.stock_qty`),与现网一致;批次剩余量查批次表。
---
## 3. 业务流程
### 3.1 物资目录管理(不变)
```
新增物资 → 填写编码/名称/规格/单位/预警量 → stock_qty=0,尚无批次行
编辑 / 停用 / 删除(仅 stock_qty=0 且无未删批次时可删)
```
### 3.2 入库(单条 / 批量)
**入口(仅工具栏,行内无入库按钮):** 物料列表 Tab 工具栏「入库」「批量入库」。
**每条入库必填:**
- 关联物资(material_id)
- 入库编号(stock_in_no,手工,唯一校验)
- 入库日期(stock_in_date)
- 入库数量(in_qty > 0)
- 货号(catalog_no)、批号(batch_no)、厂家(manufacturer)、单价(unit_price)、金额(amount)— **全部必填**
**事务内:**
1. 校验 `stock_in_no` 租户唯一
2. INSERT `biz_qc_material_stock_batch`(remaining_qty = in_qty)
3. UPDATE `biz_qc_material.stock_qty += in_qty`
4. INSERT `biz_qc_material_usage`(change_type=in, source_type=manual_in, batch_id=…)
批量入库:同一事务,任一行失败全部回滚。
### 3.3 出库(单条 / 批量)
**入口(仅工具栏,行内无出库按钮):** 物料列表 Tab 工具栏「批量出库」(单条出库 = 批量出库弹窗内只填一行)。
**粒度:** 按 **入库批次** 出库(Q1=B);明细行选择 `batchId`(入库编号),非物资维度。
- 校验 `remaining_qty >= 出库数量`
- UPDATE 批次 `remaining_qty`
- UPDATE 物资 `stock_qty`
- INSERT usage(change_type=use, source_type=manual_out, batch_id=…)
**出库单头(整单共用):** 领用人(必填)、用途、备注、出库时间。
### 3.4 质检任务 · 物料使用(重点改造)
**现状:** `QcWorkOrderTaskSubList.vue` 按 `materialId` 选物料,禁止同一物料重复行。
**改造后:**
| 列 | 说明 |
|----|------|
| 入库编号 | 下拉选择 `batchId`,选项文案:`{stockInNo} / {materialName} / 批号:{batchNo} / 剩:{remainingQty}{unit}` |
| 物料名称 | 选中批次后自动带出(只读) |
| 规格型号 | 自动带出 |
| 批号 / 货号 / 厂家 | 自动带出(只读,便于核对) |
| 剩余数量 | 自动带出 |
| 用量 | 校验 `0 < qty <= remainingQty` |
| 备注 | 选填 |
**重复规则:** 同一 `batchId` 不可重复添加(原为同一 `materialId` 不可重复)。
**提交 API `materialUsages` 结构:**
```json
{
"batchId": "uuid",
"qty": 1.5,
"remark": "可选"
}
```
后端 `deduct_for_task`:
1. `revert_task_material_usages` 按 `batch_id` 回加 `remaining_qty` 与 `stock_qty`
2. 对每行 `SELECT batch FOR UPDATE`,校验剩余量
3. 扣减 `batch.remaining_qty` 与 `material.stock_qty`
4. 写 usage,快照 stock_in_no / batch_no 等
**查看态:** 任务查看弹窗、工单任务子表展示「入库编号、物料名称、批号、用量、单位」。
### 3.5 变动记录 Tab(`QcMaterialUsageTab.vue`)
变动记录是 **全量流水审计**,与批次列表互补:批次列表看「每批还剩多少」,变动记录看「每次入/出库发生了什么」。
**筛选区调整:**
| 筛选项 | 说明 |
|--------|------|
| 关键词 | 新增,placeholder「物料编码/名称/入库编号/批号/货号」;替代仅按物资下拉的单维筛选(保留「物料筛选」下拉可选) |
| 入库编号 | 新增独立输入框(可选,与关键词二选一或叠加,实现时 keyword 已覆盖即可) |
| 物料筛选 | 保留,按 `material_id` |
| 变动类型 | 保留:入库 / 出库 / 任务使用 |
| 时间范围 | 保留 |
**列表列调整(在物料编码/名称之后、变动类型之前插入批次列):**
| 列 | 说明 |
|----|------|
| 入库编号 | `stockInNo`;出库/任务类来自 usage 快照 |
| 入库日期 | 仅 `change_type=in` 时有值(`stockInDate`);出库/任务类显示「—」 |
| 货号 | `catalogNo` |
| 批号 | `batchNo` |
| 厂家 | `manufacturer` |
| 单价(元) | 入库行展示快照单价,`formatMoneyDisplay` |
| 金额(元) | 入库行展示快照金额;出库/任务类显示「—」或按业务不写 |
| 变动类型 | 不变 |
| 变动数量 / 变动前库存 / 变动后库存 | 不变;变动后库存仍为 **物资汇总** stock_after |
| 关联任务号 / 来源类型 / 领用人 / 用途 / 领用时间 | 不变 |
| 备注 / 操作人 / 变动时间 / 操作 | 不变 |
**查看弹窗(`SystemViewDialog`)调整:**
在「变动信息」区块增加字段:入库编号、入库日期(入库类)、货号、批号、厂家、单价、金额(入库类);出库/任务类展示入库编号 + 批号 + 货号 + 厂家(来自快照,便于追溯扣的是哪一批)。
**后端 `list_usages` / `_row_to_dict`:**
返回新增字段:`batchId`、`stockInNo`、`stockInDate`(入库类从批次表 join 或快照)、`catalogNo`、`batchNo`、`manufacturer`、`unitPrice`、`amount`;`stockBefore` 优先读库字段,无则 `stockAfter - changeQty` 兼容旧数据。
**API 筛选扩展:**
```
GET /qc-material-usages?keyword=&materialId=&changeType=&startTime=&endTime=&stockInNo=
```
`keyword` 匹配 material_code / material_name / stock_in_no / batch_no / catalog_no。
### 3.6 盘存关系
- **物料列表 Tab(批次列表)** = 全部入库批次(**含零库存**),按入库日期或 create_time 倒序;零库存行 `remaining_qty` 显示 0,仍可点「查看」追溯该批历史
- **变动记录 Tab** = 全量入/出库/任务扣减流水,按批次字段可筛选、可查看每次出库对应的入库编号
---
## 4. API 设计
### 4.1 批次列表(替代原物料列表 Tab 数据源)
```
GET /api/admin/web/admin/qc-material-batches
Query: page, pageSize, keyword(编码/名称/入库编号/批号/货号), materialId, status(物资状态)
Response: 分页,**默认返回全部批次(含 remaining_qty=0)**;每行含物资字段 + 批次字段 + 汇总 stockQty + 库存预警状态
```
### 4.2 批次下拉(质检任务 / 手动出库)
```
GET /api/admin/web/admin/qc-material-batches/options
Query: keyword, materialId(可选)
Filter: status=1 物资且 remaining_qty > 0
Response: [{ id, stockInNo, materialId, materialCode, materialName, specModel, unit, batchNo, catalogNo, manufacturer, remainingQty, label }]
```
保留 `GET /qc-materials/options` 供「新增入库时搜索物资」使用;**扣减场景改用 batches/options**。
### 4.3 入库
```
POST /api/admin/web/admin/qc-materials/{materialId}/stock-in
Body: {
stockInNo, stockInDate, catalogNo, batchNo, manufacturer,
unitPrice, amount, qty, remark?, stockInTime? // stockInTime 仍映射 create_time,stockInDate 为业务日期
}
```
```
POST /api/admin/web/admin/qc-material-batches/batch-stock-in
Body: {
stockInTime?, remark?,
items: [{ materialId, stockInNo, stockInDate, catalogNo, batchNo, manufacturer, unitPrice, amount, qty, remark? }]
}
```
### 4.4 出库
```
POST /api/admin/web/admin/qc-material-batches/{batchId}/stock-out
Body: { qty, receiver, purpose?, remark?, stockOutTime? }
```
批量出库 items 元素改为 `{ batchId, qty, remark? }`。
### 4.5 质检任务
```
POST /qc-tasks/{id}/complete-with-result
materialUsages: [{ batchId, qty, remark? }] // 替代 materialId
GET /qc-tasks/{id}/material-usages
返回含 batchId, stockInNo, batchNo, catalogNo, manufacturer, ...
```
### 4.6 物资 CRUD
`GET/POST/PUT/DELETE /qc-materials` 保留,供目录维护;列表 Tab 改调 batches 接口。
---
## 5. 前端改造
### 5.1 质检物料库 `qc-material/index.vue`
#### 5.1.1 工具栏与列表操作列
**工具栏(从左到右,「已选 N 项」在最前):**
| 按钮 | 类型 | 说明 |
|------|------|------|
| 新增物料 | primary | 维护物资目录(编码/名称/规格等) |
| 入库 | ghost | 打开 **单条入库** 弹窗,填写一条完整入库信息 |
| 批量入库 | ghost | 打开 **批量入库** 弹窗,列表模式多行录入 |
| 批量出库 | ghost | 打开 **批量出库** 弹窗,列表模式选批次并填数量 |
**移除行内「入库」「出库」按钮**;操作列仅保留:查看、编辑(物资)、删除(物资),或收拢至「更多」下拉(与现网 dropdown 一致)。行内 **不提供** 入/出库入口。
**列表列(批次明细):** 见 §4.1;含入库编号、入库日期、货号、批号、厂家、单价、金额、入库数量、剩余数量等;零库存批次仍展示。
#### 5.1.2 单条入库弹窗(工具栏「入库」)
- 标题:**物料入库**
- 宽度:约 720px,`dialog-form-layout`
- **表单模式**(非表格):一次提交一条批次
- 字段(除备注外均必填):
- 物资:远程搜索下拉(`materialId`,选物资目录)
- 入库编号、入库日期
- 货号、批号、厂家
- 单价(AmountInput)、金额(AmountInput,默认单价×入库数量)
- 入库数量
- 备注
- 可选:入库时间(`stockInTime`,映射 usage.create_time;默认可当前时间)
- 底部:取消 / 确认入库
#### 5.1.3 批量入库弹窗(工具栏「批量入库」)
- 标题:**批量入库**
- 宽度:约 1200px+(列多时可横向滚动 inner-table)
- **列表录入模式**:明细区为 `el-table`,**「新增一行」** 增加空行,每行 = 一条独立入库信息(不同入库编号/批号/厂家/单价/金额)
- 表头区(整单,可选):
- 入库时间(整单默认,行内未指定时用)
- 整单备注(行备注为空时作为默认)
- **明细表列(均可编辑,除自动带出列):**
| 列 | 说明 |
|----|------|
| 序号 | index |
| 物资 | 下拉/远程搜索选 `materialId`,带出编码/名称/规格/单位(只读列) |
| 入库编号 | 手工输入,行内唯一性提交时校验 |
| 入库日期 | date-picker |
| 货号 / 批号 / 厂家 | 输入 |
| 单价 / 金额 | AmountInput,行内联动 |
| 入库数量 | input-number |
| 备注 | 可选 |
| 操作 | 删除行 |
- 工具栏:**新增一行**(主按钮旁或明细区标题旁);不再使用「搜索添加一条物料」作为唯一入口(可保留搜索快速填充一行,但必须有「新增一行」)
- 至少 1 行方可提交;同一事务批量写入
#### 5.1.4 批量出库弹窗(工具栏「批量出库」;单条出库 = 只填一行)
- 标题:**批量出库**
- 宽度:约 1000px+
- **单头(整单共用,form-grid-2):**
| 字段 | 必填 |
|------|------|
| 出库时间 | 是 |
| 领用人 | 是(远程搜索用户) |
| 用途 | 否 |
| 备注 | 否(整单默认;行备注优先) |
- **明细列表模式**:**「新增一行」** 或搜索选择 **入库批次**(`batchId`,文案含入库编号/物料名/批号/剩余量);仅可选 `remaining_qty > 0` 的批次
- **明细表列:**
| 列 | 说明 |
|----|------|
| 序号 | index |
| 入库编号 | 选择批次后带出(或选择列即 batch) |
| 物料编码 / 名称 / 规格 / 单位 | 自动带出 |
| 批号 / 货号 / 厂家 | 自动带出(只读,便于核对) |
| 剩余数量 | 只读 |
| 出库数量 | input-number,max = 剩余数量 |
| 备注 | 可选 |
| 操作 | 删除行 |
- 同一 `batchId` 不可重复添加两行
- 单条出库:用户只新增 1 行即可,交互与批量相同
#### 5.1.5 移除的 UI
- 删除单条出库弹窗(原 `stockOutVisible` 行内触发)— 统一走批量出库弹窗
- 删除行内 `handleStockIn(row)` / `handleStockOut(row)` 及对应按钮
- 单条入库弹窗不再从行内打开;若保留 `stockInVisible` 组件,仅由工具栏「入库」打开且 **不预填** materialId(或支持预填,但不绑行操作)
#### 5.1.6 交互参考
- 布局与 class:`material-batch-stock-dialog`、`batch-stock-move-lines` 等沿用 `index.vue` / `production/consumable` 批量入出库弹窗
- 按钮须带图标(OpenSpec ui-conventions)
- 金额字段:`AmountInput` + `formatMoneyDisplay`
### 5.2 质检任务 `QcWorkOrderTaskSubList.vue`
- `MaterialUsageRow`:`batchId` 替代 `materialId` 为主键字段
- 下拉:`fetchQcMaterialBatchOptions`
- 校验:重复 batchId、用量 ≤ remainingQty
- 提交:`materialUsages: { batchId, qty, remark? }[]`
- 查看 slot / 父级 `index.vue` / `qc-task-view-dialog` 同步展示入库编号
### 5.3 变动记录 Tab `QcMaterialUsageTab.vue`(专项)
对照 §3.5,本 Tab 与批次列表 **同步改造**,不可遗漏:
1. **`api/qc-material-usage.ts`**:`QcMaterialUsage` 类型扩展 `batchId`、`stockInNo`、`stockInDate`、`catalogNo`、`batchNo`、`manufacturer`、`unitPrice`、`amount`;列表请求增加 `keyword` / `stockInNo` 参数
2. **筛选区**:增加「关键词」输入;hint 文案改为「按物料、入库编号、批号、变动类型和时间范围查询变动记录」
3. **表格列**:在物料名称后插入入库编号、入库日期、货号、批号、厂家、单价、金额列;金额/单价用 `formatMoneyDisplay`
4. **查看弹窗 `viewSections`**:补充上述批次字段
5. **路由联动**:自批次列表跳转变动记录时,除 `materialId` 外支持 `stockInNo` query 预填筛选
### 5.4 其他只读展示
| 文件 | 改动 |
|------|------|
| `qc-work-order/index.vue` | 物料使用子表增加入库编号、批号列 |
| `OutboundQcViewDialog.vue` | 同上 |
| `qc-task-view-dialog/index.vue` | 同上 |
**不在本次范围:** `OutboundReleaseMaterialDialog.vue`(台账模式,仍选物资)。
---
## 6. 数据策略:不迁移旧数据
**决策(2026-06-11):** 现有质检物料库数据 **不做迁移**,功能开发完成后由 DBA/实施人员在库中手动执行脚本。
### 6.1 交付物(代码完成后提供)
| 脚本 | 路径(计划) | 用途 |
|------|--------------|------|
| 清除旧数据 | `docs/sql/migrations/2026-06-11-qc-material-batch-clear-data.sql` | 软删或物理清理 `biz_qc_material` / `biz_qc_material_usage` 旧行(及上线前若已存在的批次表数据) |
| 新测试数据 | `docs/sql/migrations/2026-06-11-qc-material-batch-test-data.sql` | 插入物资目录、多条入库批次、若干变动记录,覆盖单物资多批次、零库存批次、入出库流水等验收场景 |
**清除脚本范围:**
- `biz_qc_material_usage`(变动记录)
- `biz_qc_material_stock_batch`(入库批次,新表)
- `biz_qc_material`(物资目录)
默认采用 **软删**(`del_flag=1`)或 **DELETE 全表**(脚本内注释说明,按环境选择);不在应用代码中自动清库。
**测试数据脚本内容(示意):**
- 2~3 种物资(不同规格/单位)
- 同一物资至少 2 条入库批次(不同入库编号、批号、厂家、单价、金额)
- 其中 1 条批次 `remaining_qty=0`(已出清,用于验证列表仍展示 + 变动记录可查)
- 对应 `biz_qc_material_usage` 入库/出库/(可选)任务扣减样例行
**执行顺序:** 先跑 DDL(`2026-06-11-qc-material-batch.sql`)→ 部署代码 → **清除旧数据** → **导入测试数据**。
---
## 7. 影响范围
### 后端
| 文件 | 改动 |
|------|------|
| `models/qc_material.py` | 新增 `BizQcMaterialStockBatch`;扩展 `BizQcMaterialUsage` |
| `crud/qc_material_stock_batch.py` | 新建:list/options/stock_in/stock_out |
| `crud/qc_material.py` | 入库/出库委托批次层;汇总 stock_qty 同步 |
| `crud/qc_material_usage.py` | deduct/revert 按 batch_id;`_row_to_dict` 扩展 |
| `api/qc.py` | 新路由 + 调整 complete-with-result Body |
| `docs/sql/migrations/2026-06-11-qc-material-batch.sql` | DDL + 迁移 |
### 前端
| 文件 | 改动 |
|------|------|
| `api/qc-material.ts` | 批次类型与 API |
| `api/qc-task-result.ts` | materialUsages 改 batchId |
| `qc-material/index.vue` | 列表/入出库弹窗 |
| `QcMaterialUsageTab.vue` | 筛选、列表列、查看弹窗、API 类型(见 §5.3) |
| `api/qc-material-usage.ts` | 类型与列表参数扩展 |
| `QcWorkOrderTaskSubList.vue` | 物料使用区核心改造 |
| `qc-work-order/index.vue` 等 | 查看态列 |
### 一致性
实现后运行 `python scripts/check_field_consistency.py` 覆盖新 CRUD。
---
## 8. 测试要点
1. 同一物资两次入库,列表两行,入库编号不同
2. 入库编号重复 → 400
3. 批次出库超 remaining_qty → 失败
4. 质检任务选批次 A 扣减 → 批次 A remaining 减、物资 stock_qty 减
5. 重新填写检测结果 → revert 回加批次 A
6. 同一任务不可重复选同一 batchId
7. 清除旧数据 + 导入测试数据后,列表与变动记录展示正确
8. 批次出清至 remaining_qty=0 后,物料列表仍可见该行;变动记录可查到该批次的出库流水
9. 入库缺少货号/批号/厂家/单价/金额任一项 → 前后端均拒绝
---
## 9. 已确认产品规则(2026-06-11)
| 项 | 结论 |
|----|------|
| 货号 / 批号 / 厂家 / 单价 / 金额 | **全部必填**(元字段用 AmountInput + formatMoneyDisplay) |
| 零库存批次 | **默认展示,不隐藏**;出库仅在批量出库弹窗中选批次,仅展示 `remaining_qty > 0` |
| 入出库入口 | **仅工具栏**;列表行内无入库/出库按钮 |
| 批量入库/出库 | **列表模式** +「新增一行」;出库单头含领用人/用途/备注/出库时间 |
| 金额与单价联动 | 默认 `单价 × 入库数量`;用户手工改金额后不再自动覆盖 |
| 变动记录 Tab | **必须同步改造**(§3.5、§5.3) |
| 旧数据 | **不迁移**;交付清除脚本 + 测试数据脚本,由人工在库中执行 |
---
Spec 已按上述确认更新。若无其他修改,可进入 `writing-plans` 编写分 Task 实施计划。