# 06-决策记录

## 决策记录说明

本文记录库存调拨功能中的关键决策。后续变更时，优先查阅本文，避免重复争论已经确定的技术和业务选择。

## ADR-001：不做完整调拨单流程

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 库存调拨只做库存盘点组件内轻量调拨 |
| 原因 | 用户明确场景是盘点时快速把库存从原库位调到目标库位，并支持一键新建库位 |
| 影响 | 不新增独立调拨单页面、不做审批、不做打印 |
| 后续变更条件 | 如果业务要求调拨审批、打印、跨仓库流转，再新增独立调拨单模块 |

## ADR-002：使用后端原子存储过程完成调拨

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 新增 `仓储管理_库存盘点_库存调拨`，由一个事务完成扣减和增加 |
| 原因 | 前端拆成两次请求会出现只扣不加、只加不扣、并发负库存风险 |
| 影响 | 前端只提交一次调拨请求，库存一致性由数据库保证 |
| 后续变更条件 | 如果未来迁移到后端服务层，也必须保留事务边界 |

## ADR-003：调拨数量使用 FLOAT

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | `@调拨数量`、库存记录字段按 `float` 处理 |
| 原因 | 现有库存表 `货位存量` 使用 `float`，库存可能存在小数 |
| 影响 | 调拨支持小数库存 |
| 后续变更条件 | 若未来统一库存数量精度，应迁移为 decimal 并同步所有库存过程 |

## ADR-004：以后端当前库存为准

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 前端传 `原库存数` 只作参考，后端必须重新查询并锁定当前库存 |
| 原因 | 多人同时操作时，前端库存可能已过期 |
| 影响 | 可以避免并发调拨造成负库存 |
| 后续变更条件 | 无。库存扣减类业务都应遵守该规则 |

## ADR-005：区分普通物料和通用件库存表

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 根据 `@类型 = N'通用件'` 选择库存表 |
| 原因 | 现有系统中通用件使用 `库存管理_半成品与货位对照表`，普通物料使用 `库存管理_物料与货位对照表` |
| 影响 | 前端必须传 `类型` 参数 |
| 后续变更条件 | 如果后续统一库存表，可移除分支 |

## ADR-006：目标库位不存在同物料库存时新增记录

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 目标库位已有同物料库存则累加，没有则新增库存记录 |
| 原因 | 盘点调拨常见场景是将物料拆分到新库位 |
| 影响 | 调拨过程需要同时处理 update 和 insert |
| 后续变更条件 | 如果业务规定必须先建库存记录，再调拨，可改为无记录时报错 |

## ADR-007：原库位库存为 0 时保留记录

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 调拨后原库位库存为 0，不物理删除库存记录 |
| 原因 | 保留历史库位关系，便于追溯，也符合盘点页库存可编辑为 0 的现状 |
| 影响 | 查询页面是否显示 0 库存由查询条件控制 |
| 后续变更条件 | 如果业务要求隐藏 0 库存，优先改查询，不建议删除记录 |

## ADR-008：一键新建库位复用现有接口

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 复用 `仓储管理_库位_验证是否存在` 和 `仓储管理_库位_增加数据` |
| 原因 | 系统已有库位校验和新增能力，不重复造接口 |
| 影响 | 新库位创建逻辑与现有库位维护规则保持一致 |
| 后续变更条件 | 如果库位维护规则变化，应统一改库位接口 |

## ADR-009：新增轻量调拨记录表

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 新增 `库存盘点_调拨记录` |
| 原因 | 旧库存修改记录无法完整表达“从哪个库位调到哪个库位” |
| 影响 | 后续可以按记录追溯调拨数量、原库位、目标库位、操作人 |
| 后续变更条件 | 如需要调拨单，可在该记录基础上扩展主从表 |

## ADR-010：暂不生成 PDF 和截图

| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 当前阶段只保留 Markdown 和命令/数据库证据 |
| 原因 | 功能尚需页面真实数据联调，截图/PDF 应在最终页面验收时生成 |
| 影响 | `05-验收证据.md` 中页面截图、PDF、report_id 暂为空 |
| 后续变更条件 | 页面实测完成后补充截图或 PDF 验收材料 |