# 采购入库状态回写 - 前端联调方案

## 涉及页面

- 采购申请列表页
- 采购申请详情页
- 采购订单列表页
- 采购订单详情页

## 业务流程与数据带入

```
采购申请审批通过 → 生成采购订单(已审核) → 确认收货 → 生成到货通知单(待入库) → 执行入库
       ↓                    ↓                                           ↓
   order_id/order_no   request_item_id 关联                         in_status 回写
```

**状态回写流程：**
1. 入库单完成 → 回写采购订单明细入库数量（in_count）
2. 入库单完成 → 回写采购订单入库状态（in_status）
3. 入库单完成 → 回写采购申请明细入库数量（in_count）
4. 入库单完成 → 回写采购申请入库状态（in_status）

## 字段变更

### 采购申请新增字段

| 字段 | 类型 | 说明 |
|------|------|------|
| inStatus | Integer | 入库状态（0:未入库 1:部分入库 2:全部入库） |

### 采购申请明细新增字段

| 字段 | 类型 | 说明 |
|------|------|------|
| inCount | BigDecimal | 入库数量 |

### 采购订单明细新增字段

| 字段 | 类型 | 说明 |
|------|------|------|
| requestItemId | Long | 采购申请明细编号（系统自动关联） |

## 响应字段变更

### 采购申请详情响应新增

```json
{
  "inStatus": 0
}
```

### 采购申请明细响应新增

```json
{
  "items": [
    {
      "inCount": 0
    }
  ]
}
```

### 采购订单详情响应新增

无变化（`requestItemId` 为系统内部关联，前端无需展示）

## 字段展示规则

| 字段 | 展示位置 | 说明 |
|------|----------|------|
| 入库状态 | 采购申请列表、详情 | 使用标签展示：未入库/部分入库/全部入库 |
| 入库数量 | 采购申请明细表格 | 数值展示，保留6位小数 |

## 业务规则说明

| 场景 | 规则 |
|------|------|
| 采购申请入库状态 | 根据采购订单入库状态自动更新，无需手动操作 |
| 采购申请明细入库数量 | 根据采购订单明细入库数量累加更新 |
| 多次入库 | 支持部分入库，入库状态自动流转 |

## 入库状态枚举

| 值 | 名称 | 颜色建议 |
|----|------|----------|
| 0 | 未入库 | info（灰色） |
| 1 | 部分入库 | warning（橙色） |
| 2 | 全部入库 | success（绿色） |

## 注意事项

1. 入库状态由系统自动回写，无需手动维护
2. 一个采购申请对应一个采购订单，入库状态同步
3. 如果采购申请未指定供应商，审批通过后需要手动选择供应商生成订单