# 物资归还登记功能 - 快速测试指南

## 功能入口

**路径**: 资产管理系统 → 物资归还 → 归还登记

## 快速测试步骤

### 1. 查看待归还领用单

✅ **测试点**:
- 点击"归还登记"标签
- 查看"待归还领用单"列表
- 验证显示的领用单信息（领用单号、领用人、出库时间、物品清单、关联信息、状态）

📋 **期望结果**:
- 显示所有"未归还"和"部分归还"状态的领用单
- 每个领用单显示完整的物资清单和待归还数量
- 状态标记清晰（红色=未归还，黄色=部分归还）

### 2. 发起归还登记

✅ **测试点**:
- 点击待归还领用单的"登记归还"按钮
- 或点击顶部"新建归还登记"按钮

📋 **期望结果**:
- 打开归还登记对话框
- 如果从列表点击进入，自动加载选中的领用单信息
- 如果新建，显示领用单选择下拉框

### 3. 选择原领用单（如果是新建）

✅ **测试点**:
- 点击"选择原领用单"下拉框
- 查看可选择的领用单列表
- 选择一个领用单

📋 **期望结果**:
- 下拉框显示所有待归还的领用单
- 选择后自动加载：
  - 领用单基本信息（单号、领用人、出库时间、关联地块/任务）
  - 归还人信息（当前用户）
  - 归还物品清单（自动填充待归还物资）

### 4. 填写归还信息

✅ **测试点**:
- 查看自动带出的物资清单
- 每项物资包含：物资名称、借出数量、归还数量、物资状态、状态说明
- 修改"本次归还"数量（可部分归还）
- 选择"物资状态"：
  - ✅ 正常
  - ⚠️ 损坏
  - ❌ 遗失
  - 🔧 需要保养
- 填写"状态说明"（如：轮胎磨损）
- 填写"归还备注说明"

📋 **期望结果**:
- 物资清单完整显示，每项物资一个卡片
- 归还数量默认为待归还数量，可修改但不能超过借出数量
- 物资状态下拉框有图标标识，清晰易懂
- 状态说明和备注可以详细记录

###  5. 查看注意事项

✅ **测试点**:
- 滚动到对话框底部
- 查看"归还登记注意事项"卡片

📋 **期望结果**:
- 显示4条注意事项：
  - 如实登记
  - 损坏说明
  - 保养提醒
  - 验收流程
- 每条有对应图标，样式美观

### 6. 提交归还登记

✅ **测试点**:
- 确保至少选择了一个领用单
- 点击"提交归还登记"按钮

📋 **期望结果**:
- 如果未选择领用单：显示错误提示"请先选择领用单"
- 如果归还数量无效：显示错误提示"归还数量不能为0或超过借出数量"
- 如果验证通过：
  - 显示成功提示，包含生成的归还单号（格式：GH20241022XXXX）
  - 提示"等待仓库管理员验收"
  - 对话框自动关闭
  - 归还记录出现在"归还登记记录"列表中

### 7. 查看归还登记记录

✅ **测试点**:
- 提交后滚动到"归还登记记录"区域
- 查看新提交的归还记录

📋 **期望结果**:
- 显示完整的归还记录信息
- 包括：归还单号、关联领用单、归还人、登记时间、归还物品（含状态）
- 状态标记为"已登记"或"待验收"
- 可以点击"查看"按钮查看详情

## 边界情况测试

### 测试1: 无待归还领用单
- **场景**: 所有领用单都已归还
- **期望**: 待归还列表为空，显示提示信息

### 测试2: 部分归还
- **场景**: 借出5个，只归还3个
- **操作**: 修改归还数量为3
- **期望**: 成功提交，领用单状态变为"部分归还"

### 测试3: 物资损坏
- **场景**: 归还损坏的物资
- **操作**: 选择状态"损坏"，填写损坏原因
- **期望**: 成功提交，显示损坏标记

### 测试4: 物资遗失
- **场景**: 物资遗失无法归还
- **操作**: 归还数量改为0，状态选择"遗失"
- **期望**: 成功提交，记录遗失情况

### 测试5: 需要保养
- **场景**: 物资需要维护保养
- **操作**: 状态选择"需要保养"，填写保养说明
- **期望**: 成功提交，后续转入保养流程

## 功能验证清单

- [  ] 待归还领用单列表显示正确
- [  ] 新建归还登记对话框打开正常
- [  ] 从列表发起归还，自动加载领用单信息
- [  ] 新建时可以选择领用单
- [  ] 物资清单自动带出
- [  ] 归还数量可以修改且有验证
- [  ] 物资状态选择完整（4种状态）
- [  ] 状态说明和备注可以填写
- [  ] 注意事项显示清晰
- [  ] 提交验证逻辑正确
- [  ] 成功提交后生成归还单号
- [  ] 归还记录正确显示在列表中
- [  ] 可以查看归还详情
- [  ] 部分归还功能正常
- [  ] 各种物资状态记录正确

## 业务闭环验证

1. **领用** → **归还登记** → **验收** → **库存更新** → **完成闭环**

验证点：
- 归还登记后，状态变为"待验收"
- 仓库管理员可以在"归还处理"标签看到待验收记录
- 验收通过后，库存自动更新
- 在"领用记录关联核销"标签可以查询完整闭环记录

## 常见问题

**Q1: 提交时提示"请先选择领用单"**
- A: 确保已经从下拉框选择了一个领用单，或从列表点击"登记归还"进入

**Q2: 归还数量无法输入超过借出数量**
- A: 这是正常的验证逻辑，归还数量不能超过借出数量

**Q3: 找不到我的领用单**
- A: 只有"未归还"和"部分归还"状态的领用单才会出现在列表中

**Q4: 提交后看不到记录**
- A: 提交后记录会出现在"归还登记记录"区域，状态为"待验收"

---

**测试完成标志**: 能够成功完成从选择领用单 → 填写归还信息 → 提交登记 → 查看记录的完整流程

**最后更新**: 2024-10-22  
**版本**: v1.0
