# 农具档案管理 - 快速测试指南

## 🎯 5分钟功能验证

### 1. 访问系统
1. 导航到：**资产管理** → **基础信息管理**
2. 点击"农具档案"标签页
3. 应该看到7条预置示例数据

### 2. 查看现有数据 📋

#### 验证列表显示
查看列表应包含：
- ✅ 农具名称和图标（蓝色拖拉机图标）
- ✅ 农具类型标签
- ✅ 状态标签（绿色/橙色/蓝色/红色）
- ✅ 编码和型号信息
- ✅ 购买信息（日期、价格）
- ✅ 价值信息（购买价格、当前价值）
- ✅ 折旧信息（折旧年限、折旧率）
- ✅ 使用信息（责任人、存放位置）
- ✅ 维护记录展示
- ✅ 设备图片展示
- ✅ 操作按钮（查看/编辑/删除）

#### 验证不同状态
检查不同状态的显示：
- **在用**（绿色）：TOOL-2024-001（东方红拖拉机）
- **维修**（橙色）：TOOL-2024-002（旋耕机）
- **闲置**（蓝色）：TOOL-2024-006（播种机）
- **报废**（红色）：TOOL-2024-007（老式拖拉机）

#### 验证折旧计算
检查 TOOL-2024-001（东方红拖拉机）：
- 购买价格：¥180,000
- 购买日期：2020-03-15
- 折旧年限：10年
- 当前价值：应显示折旧后的价值
- 折旧率：应显示百分比（约40%）

### 3. 测试查看详情 👁️

1. 找到 TOOL-2024-004（收割机）
2. 点击"眼睛"图标
3. **验证详情对话框包含**：
   - ✅ 标题："农具详情"
   - ✅ 基本信息卡片：
     * 编码：TOOL-2024-004
     * 名称：收割机
     * 类型：收获机械
     * 型号：4LZ-5
     * 状态：在用
   - ✅ 价值与折旧信息卡片：
     * 购买价格：¥220,000
     * 当前价值：约¥120,833
     * 折旧年限：12年
     * 累计折旧金额
     * 折旧率：约45%
   - ✅ 使用与存放信息卡片：
     * 责任人：赵六
     * 存放位置：3号仓库
     * 状态：在用
   - ✅ 维护记录卡片（2条）：
     * 2024-02-10 保养记录
     * 2023-08-15 维修记录
   - ✅ 设备图片卡片（3张）
   - ✅ 备注信息
   - ✅ 底部操作按钮（关闭/编辑）

4. 点击底部"编辑"按钮
5. **验证**：应跳转到编辑对话框，数据已填充

### 4. 测试新增功能 ➕

#### 新增大型设备
1. 点击"新增农具"按钮
2. 填写表单：
   ```
   农具名称：约翰迪尔拖拉机
   农具类型：大型农机
   型号：6B-1654
   购买日期：2024-08-15
   购买价格：320000
   折旧年限：12
   当前状态：在用
   责任人：张经理
   存放位置：1号仓库
   备注：新购置设备，配置GPS导航系统
   ```
3. 点击"保存"
4. **验证**：
   - ✅ 自动生成编码：TOOL-2024-008
   - ✅ 自动计算当前价值：应接近¥320,000（刚购买）
   - ✅ 列表中新增一条记录
   - ✅ 显示成功提示

#### 新增小型农具
1. 点击"新增农具"按钮
2. 填写表单：
   ```
   农具名称：镰刀
   农具类型：小型农具
   型号：标准型
   购买日期：2024-10-01
   购买价格：45
   折旧年限：3
   当前状态：在用
   存放位置：工具房
   备注：不锈钢材质
   ```
3. 点击"保存"
4. **验证**：
   - ✅ 自动生成编码：TOOL-2024-009
   - ✅ 当前价值接近¥45
   - ✅ 列表更新成功

#### 测试必填验证
1. 点击"新增农具"
2. 只填写名称和类型
3. 点击"保存"
4. **验证**：应提示"请填写所有必填项"

#### 测试数值验证
1. 点击"新增农具"
2. 填写基本信息，但购买价格输入"-100"
3. 点击"保存"
4. **验证**：应提示数值错误

### 5. 测试编辑功能 ✏️

#### 基本编辑
1. 找到 TOOL-2024-002（旋耕机，维修状态）
2. 点击"编辑"图标
3. 修改信息：
   ```
   当前状态：从"维修"改为"在用"
   责任人：从"李四"改为"王工"
   备注：添加"液压系统已修复，测试正常"
   ```
4. 点击"更新"
5. **验证**：
   - ✅ 状态标签从橙色变为绿色
   - ✅ 责任人更新为"王工"
   - ✅ 备注信息已更新
   - ✅ 显示"农具信息已更新"

#### 测试折旧重算
1. 找到 TOOL-2024-005（铁锹）
2. 点击"编辑"图标
3. 修改折旧年限：从 3 改为 5
4. 点击"更新"
5. **验证**：
   - ✅ 当前价值重新计算
   - ✅ 折旧率相应变化

### 6. 测试删除功能 🗑️

1. 找到刚才新增的"镰刀"
2. 点击"删除"图标
3. **验证确认对话框**：应显示"确定要删除这条农具记录吗？"
4. 点击"确定"
5. **验证**：
   - ✅ 记录从列表中移除
   - ✅ 显示"删除成功"提示

6. 再次删除刚才新增的"约翰迪尔拖拉机"
7. 确认删除
8. **验证**：列表恢复到原始状态

### 7. 测试自动编码 🔢

1. 连续新增3条农具
2. **验证编码规则**：
   - 第1条：TOOL-2024-008
   - 第2条：TOOL-2024-009
   - 第3条：TOOL-2024-010
3. 删除第2条
4. 再新增1条
5. **验证**：编号应为 TOOL-2024-011（继续递增）

### 8. 测试折旧计算准确性 🧮

#### 测试场景1：新购设备
1. 新增设备：
   ```
   购买日期：今天
   购买价格：100000
   折旧年限：10
   ```
2. **验证**：当前价值应为 ¥100,000（刚购买）

#### 测试场景2：使用1年
1. 新增设备：
   ```
   购买日期：去年今天（365天前）
   购买价格：100000
   折旧年限：10
   ```
2. **验证**：当前价值应为 ¥90,000（折旧1年）

#### 测试场景3：超过折旧年限
1. 编辑 TOOL-2024-007（老式拖拉机）
2. 查看详情
3. **验证**：
   - 购买日期：2010-03-20（14年多）
   - 折旧年限：10年
   - 当前价值：¥0（已完全折旧）
   - 折旧率：100%

### 9. 测试维护记录显示 🔧

1. 找到 TOOL-2024-001（东方红拖拉机）
2. 查看列表显示
3. **验证维护记录区域**：
   - ✅ 显示"最近维护记录:"标题
   - ✅ 显示1条维护记录
   - ✅ 包含：日期、类型、描述、费用

4. 点击查看详情
5. **验证详情中的维护记录**：
   - ✅ 完整的维护记录卡片
   - ✅ 显示记录条数
   - ✅ 每条记录包含完整信息
   - ✅ 紫色背景突出显示

6. 查看 TOOL-2024-004（收割机）的维护记录
7. **验证**：应显示2条维护记录

### 10. 测试图片显示 📷

1. 找到 TOOL-2024-001（东方红拖拉机）
2. 查看列表显示
3. **验证图片区域**：
   - ✅ 显示"设备图片:"标题
   - ✅ 显示2个图片占位符
   - ✅ 相机图标显示

4. 点击查看详情
5. **验证详情中的图片**：
   - ✅ 设备图片卡片
   - ✅ 显示图片数量：(2张)
   - ✅ 网格布局展示

6. 查看 TOOL-2024-004（收割机）的图片
7. **验证**：应显示3张图片占位符

### 11. 测试不同类型设备 🚜

测试各种类型的设备显示是否正常：
- ✅ 大型农机：拖拉机、收割机
- ✅ 耕作机械：旋耕机、播种机
- ✅ 植保机械：喷雾器
- ✅ 小型农具：铁锹
- ✅ 收获机械：收割机

### 12. 测试状态流转 🔄

模拟设备生命周期：
1. 新设备：状态="在用"
2. 出现故障：编辑状态为"维修"
3. 维修完成：编辑状态为"在用"
4. 非作业季：编辑状态为"闲置"
5. 作业季开始：编辑状态为"在用"
6. 超期老化：编辑状态为"报废"

每次状态变更后验证：
- ✅ 状态标签颜色正确
- ✅ 状态文字正确
- ✅ 更新成功提示

## ✅ 完整性检查清单

### 基础功能
- [ ] 列表正常显示（7条数据）
- [ ] 状态颜色正确（绿/橙/蓝/红）
- [ ] 编码格式正确（TOOL-YYYY-XXX）
- [ ] 新增功能正常
- [ ] 编辑功能正常
- [ ] 删除功能正常
- [ ] 查看详情正常

### 折旧功能
- [ ] 自动计算当前价值
- [ ] 折旧率显示正确
- [ ] 累计折旧金额正确
- [ ] 编辑后重新计算
- [ ] 残值保护（不低于0）

### 数据验证
- [ ] 必填项验证有效
- [ ] 数值范围验证有效
- [ ] 日期格式验证有效
- [ ] 保存成功提示

### 详情展示
- [ ] 基本信息完整
- [ ] 价值信息完整
- [ ] 使用信息完整
- [ ] 维护记录展示
- [ ] 图片展示
- [ ] 备注展示

### 特殊功能
- [ ] 维护记录列表显示
- [ ] 维护记录详情显示
- [ ] 图片列表显示
- [ ] 图片详情显示
- [ ] 责任人信息显示
- [ ] 存放位置显示

## 🐛 常见问题排查

### 问题1：保存时提示"请填写所有必填项"
**检查**：确保所有标*的字段都已填写

### 问题2：折旧计算结果为0
**检查**：
- 购买日期是否超过折旧年限
- 这是正常情况（完全折旧）

### 问题3：当前价值显示异常
**刷新**：编辑后系统会自动重新计算

### 问题4：编码重复
**说明**：系统自动生成，不会重复

### 问题5：状态颜色不对
**检查**：确认状态选择正确

## 📸 预期效果

### 列表视图应包含：
1. 蓝色拖拉机图标
2. 农具名称和类型标签
3. 状态标签（颜色区分）
4. 编码和型号信息
5. 5列价值信息卡片（购买日期、价格、当前价值、年限、折旧率）
6. 3列使用信息卡片（责任人、位置、维护记录）
7. 图片展示区域
8. 维护记录展示区域
9. 操作按钮（查看/编辑/删除）

### 详情对话框应包含：
1. 6个信息卡片
2. 价值卡片显示完整折旧信息
3. 维护记录卡片（如有）
4. 图片卡片（如有）
5. 备注信息（如有）
6. 底部编辑按钮

### 表单对话框应包含：
1. 表单标题（新增/编辑）
2. 所有表单字段
3. 必填项标*
4. 状态下拉选择
5. 折旧计算说明卡片（蓝色背景）
6. 保存/取消按钮

## 🎉 测试完成

如果以上所有测试项都通过，说明农具档案管理系统功能完整，可以正常使用！

## 📋 测试报告模板

```
测试日期：____年__月__日
测试人员：____________
测试环境：____________

基础功能测试：
□ 新增 □ 编辑 □ 删除 □ 查看

折旧功能测试：
□ 自动计算 □ 准确性验证 □ 重新计算

数据验证测试：
□ 必填项 □ 数值验证 □ 日期验证

特殊功能测试：
□ 维护记录 □ 图片管理 □ 状态管理

问题记录：
1. ______________________________
2. ______________________________
3. ______________________________

测试结论：□ 通过 □ 不通过

备注：
_________________________________
_________________________________
```

---

**测试版本：** 1.0  
**最后更新：** 2024-10-21
