# 02-项目程序开发详细步骤

## 开发入口

前端页面：

```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```

SQL 脚本：

```text
sql/仓储管理_库存盘点_库存调拨.sql
```

## 第 1 步：梳理现有库存盘点页面

确认页面已有能力：

| 已有能力 | 说明 |
| --- | --- |
| 库存查询 | 调用 `仓储管理_库存盘点_查询` |
| 编辑库存 | 调用 `仓储管理_库存盘点_货位数量_编辑数据` |
| 库位下拉 | 调用 `仓储管理_库位_查询` |
| 新增物料存货 | 页面已有新增库存相关逻辑 |

确认表格已有字段：

```text
物料编码
物料流水号
物料名称
图号或型号
物料与货位流水号
类型
库存
货位流水号
货位名称
批次编号
```

## 第 2 步：增加表格调拨入口

在库存盘点表格操作列增加“调拨”按钮。

实现要求：

1. 原操作列宽度调整为可容纳“编辑”和“调拨”。
2. 行处于编辑状态时不显示调拨按钮。
3. 行不处于编辑状态时显示调拨按钮。

关键逻辑：

```html
<el-button v-if="!scope.row.edit" type="text" size="mini" @click="openTransfer(scope.row)">调拨</el-button>
```

## 第 3 步：增加调拨状态和表单对象

在 `data()` 中增加：

```js
transferDialogVisible: false,
transferLocationAdding: false,
transferSubmitting: false,
transferForm: {
  物料与货位流水号: '',
  物料流水号: '',
  物料名称: '',
  图号或型号: '',
  类型: '',
  原货位流水号: '',
  原货位名称: '',
  原库存数: 0,
  目标货位流水号: '',
  目标货位名称: '',
  新货位名称: '',
  调拨数量: 1,
  调拨备注: ''
}
```

## 第 4 步：增加库存调拨弹窗

新增 `el-dialog`，标题为：

```text
库存调拨
```

弹窗内容：

| 字段 | 控件 | 是否可编辑 |
| --- | --- | --- |
| 物料名称 | 文本 | 否 |
| 图号/型号 | 文本 | 否 |
| 原库位 | 文本 | 否 |
| 原库存数 | 文本 | 否 |
| 目标库位 | `el-select` | 是 |
| 新库位 | `el-input` | 是 |
| 调拨数量 | `el-input-number` | 是 |
| 调拨备注 | `el-input` | 是 |

## 第 5 步：打开调拨弹窗

新增方法：

```js
openTransfer(row)
```

处理内容：

1. 校验当前行是否有 `物料与货位流水号`。
2. 校验当前行库存是否大于 0。
3. 将当前行物料、库位、库存信息填入 `transferForm`。
4. 清空目标库位、新库位、备注。
5. 打开调拨弹窗。

## 第 6 步：选择目标库位

新增方法：

```js
handleTransferLocationChange(value)
```

处理内容：

1. 根据选择的 `货位流水号`，从 `storageLocation` 中找到货位名称。
2. 回填 `transferForm.目标货位名称`。

## 第 7 步：一键新建库位

新增方法：

```js
addTransferLocation()
```

处理流程：

1. 校验 `transferForm.新货位名称` 不能为空。
2. 调用 `仓储管理_库位_验证是否存在`。
3. 如果库位已存在，提示并按库位名称回填已有库位。
4. 如果库位不存在，调用 `仓储管理_库位_增加数据`。
5. 新增成功后调用 `getLocateName()` 刷新库位下拉。
6. 调用 `selectTransferLocation(locationName)` 回填目标库位。

## 第 8 步：提交库存调拨

新增方法：

```js
submitTransfer()
```

前端校验：

| 校验项 | 提示 |
| --- | --- |
| 目标库位为空 | 请选择目标库位 |
| 目标库位等于原库位 | 目标库位不能与原库位相同 |
| 调拨数量小于等于 0 | 调拨数量必须大于0 |
| 调拨数量大于原库存 | 调拨数量不能大于原库存数 |

提交参数：

| 序号 | 参数名 |
| --- | --- |
| 0 | 物料与货位流水号 |
| 1 | 物料流水号 |
| 2 | 原货位流水号 |
| 3 | 目标货位流水号 |
| 4 | 调拨数量 |
| 5 | 原库存数 |
| 6 | 调拨备注 |
| 7 | 操作者 |
| 8 | 类型 |

调用接口：

```js
var Data = this.CreateData('12', '仓储管理_库存盘点_库存调拨', param)
```

成功后：

1. 提示“调拨成功”。
2. 关闭调拨弹窗。
3. 调用 `searchTable()` 刷新列表。

## 第 9 步：后端脚本设计

脚本文件：

```text
sql/仓储管理_库存盘点_库存调拨.sql
```

脚本内容：

1. 如果 `库存盘点_调拨记录` 不存在，则创建该表。
2. 删除并重建存储过程 `dbo.仓储管理_库存盘点_库存调拨`。
3. 按 `@类型` 判断库存表：
   - `@类型 = N'通用件'` 使用 `库存管理_半成品与货位对照表`。
   - 其他类型使用 `库存管理_物料与货位对照表`。
4. 使用事务处理扣减、增加、新增目标记录、写入日志。
5. 出错时回滚并返回失败信息。

## 第 10 步：后端事务流程

```text
BEGIN TRAN
  锁定原库存记录
  校验原库存记录存在
  校验目标库位不等于原库位
  校验当前库存 >= 调拨数量
  扣减原库位库存
  查询目标库位同物料库存
  如果存在则增加目标库存
  如果不存在则新增目标库存记录
  写入库存盘点_调拨记录
COMMIT TRAN
```

失败处理：

```text
ROLLBACK TRAN
返回 result = 0 和 msg
```

## 第 11 步：数据库部署

部署目标：

```text
SQL Server: 192.168.1.27
Database: ERPTOOL_JY_20250826Back
```

部署对象：

```text
库存盘点_调拨记录
仓储管理_库存盘点_库存调拨
```

## 第 12 步：验证

验证项：

1. SQL 脚本编译通过。
2. 数据库对象存在。
3. 存储过程参数完整。
4. 前端模板解析通过。
5. 前端脚本解析通过。
6. 页面实际选择库存记录调拨。
7. 原库位库存减少。
8. 目标库位库存增加或新增。
9. 调拨记录写入。