# 库存事务流水 - 前端联调方案

## 涉及页面

- 库存事务流水列表页面（新增）

## API

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /mes/wm/transaction/page | 分页查询库存事务流水 |

### 请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| itemId | Long | 否 | 物料ID |
| batchCode | String | 否 | 批次号，模糊匹配 |
| warehouseId | Long | 否 | 仓库ID |
| locationId | Long | 否 | 库区ID |
| areaId | Long | 否 | 库位ID |
| type | Integer | 否 | 事务类型（1-入库 2-出库） |
| bizType | Integer | 否 | 业务类型（126-自定义入库 127-自定义出库 等） |
| bizCode | String | 否 | 业务单号，模糊匹配 |
| materialStockId | Long | 否 | 库存记录ID |
| startTime | LocalDateTime | 否 | 开始时间 |
| endTime | LocalDateTime | 否 | 结束时间 |
| pageNo | Integer | 是 | 页码（继承自 PageParam） |
| pageSize | Integer | 是 | 每页条数（继承自 PageParam） |

### 响应字段

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 编号 |
| type | Integer | 事务类型（1-入库 2-出库） |
| typeName | String | 事务类型名称（入库/出库） |
| bizType | Integer | 业务类型 |
| bizTypeName | String | 业务类型名称（自定义入库/自定义出库/采购入库/销售出库 等） |
| bizCode | String | 业务单号 |
| itemId | Long | 物料ID |
| itemCode | String | 物料编码 |
| itemName | String | 物料名称 |
| quantity | BigDecimal | 变动数量（正数=入库，负数=出库） |
| batchId | Long | 批次ID |
| batchCode | String | 批次号 |
| warehouseId | Long | 仓库ID |
| warehouseName | String | 仓库名称 |
| locationId | Long | 库区ID |
| locationName | String | 库区名称 |
| areaId | Long | 库位ID |
| areaName | String | 库位名称 |
| transactionTime | LocalDateTime | 事务发生时间 |
| createTime | LocalDateTime | 创建时间 |

### 响应示例

```json
{
  "code": 0,
  "data": {
    "total": 100,
    "list": [
      {
        "id": 1,
        "type": 1,
        "typeName": "入库",
        "bizType": 126,
        "bizTypeName": "自定义入库",
        "bizCode": "STOCK_ADJUST_6",
        "itemId": 2,
        "itemCode": "ITEM001",
        "itemName": "螺丝",
        "quantity": 100,
        "batchId": 7,
        "batchCode": "T8811",
        "warehouseId": 1,
        "warehouseName": "成品仓",
        "locationId": 1,
        "locationName": "A区",
        "areaId": 1,
        "areaName": "A-01-01",
        "transactionTime": "2025-07-15 10:30:00",
        "createTime": "2025-07-15 10:30:00"
      }
    ]
  },
  "msg": "操作成功"
}
```

## 字段展示规则

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| typeName | 列表、详情 | 事务类型名称，使用标签展示（入库=绿色，出库=红色） |
| bizTypeName | 列表、详情 | 业务类型名称 |
| bizCode | 列表、详情 | 业务单号，可点击跳转到对应业务单据 |
| itemCode | 列表 | 物料编码 |
| itemName | 列表 | 物料名称 |
| quantity | 列表 | 变动数量，正数显示绿色，负数显示红色 |
| batchCode | 列表 | 批次号 |
| warehouseName | 列表 | 仓库名称 |
| locationName | 列表 | 库区名称 |
| areaName | 列表 | 库位名称 |
| transactionTime | 列表 | 事务发生时间，作为默认排序字段 |

## 搜索条件

| 条件 | 组件 | 说明 |
|------|------|------|
| 物料 | 物料选择器 | 选择物料后查询 |
| 批次号 | Input | 模糊匹配 |
| 仓库 | 下拉选择 | 选择仓库 |
| 库区 | 下拉选择 | 根据仓库联动 |
| 库位 | 下拉选择 | 根据库区联动 |
| 事务类型 | 下拉选择 | 入库/出库 |
| 业务类型 | 下拉选择 | 自定义入库/自定义出库 等 |
| 业务单号 | Input | 模糊匹配 |
| 时间范围 | DatePicker | 事务发生时间范围 |

## 业务规则说明

| 场景 | 规则 |
|------|------|
| 数据来源 | 库存事务流水由系统自动生成，不可人工创建、修改、删除 |
| 排序 | 默认按事务发生时间倒序排列 |
| 权限 | 需要 `mes:wm-transaction:query` 权限 |

## 注意事项

- 流水记录只读，不允许新增、修改、删除
- quantity 字段正数表示入库，负数表示出库，前端展示时可根据符号显示不同颜色
- bizCode 可作为跳转链接，点击后跳转到对应的业务单据详情页
- 业务类型较多，下拉选择框建议按使用频率排序（自定义入库、自定义出库放前面）