# 农具档案管理完整功能指南

## 📋 功能概述

农具档案管理系统实现了对从小型农具（如锄头、铁锹）到大型农机（如拖拉机、收割机）的全生命周期管理，包括完整的CRUD操作、自动折旧计算、维护记录管理、图片上传等功能。

## ✨ 核心功能

### 1. 农具分类管理

支持多种农具类型分类：
- **大型农机**：拖拉机、收割机等
- **耕作机械**：旋耕机、播种机等
- **植保机械**：喷雾器、喷药机等
- **收获机械**：收割机、脱粒机等
- **小型农具**：锄头、铁锹、镰刀等

### 2. 唯一编码系统

**自动生成规则：**
- 格式：`TOOL-年份-流水号`
- 示例：`TOOL-2024-001`, `TOOL-2024-002`, `TOOL-2024-003`
- 流水号：3位数字，自动递增
- 自动生成：创建时系统自动生成，无需手动输入

### 3. 基础信息管理

**所有农具通用属性：**
- ✅ 唯一编码（自动生成）
- ✅ 农具名称 *（必填）
- ✅ 农具类型 *（必填）：大型农机、耕作机械、植保机械、收获机械、小型农具等
- ✅ 型号 *（必填）：如 LX904, 1GQN-200
- ✅ 购买日期 *（必填）
- ✅ 购买价格 *（必填）：单位为元
- ✅ 折旧年限 *（必填）：单位为年
- ✅ 当前价值（自动计算）
- ✅ 当前状态 *（必填）：在用、维修、闲置、报废
- ⭕ 责任人：可指定设备责任人
- ✅ 存放位置 *（必填）：如 1号仓库、维修车间
- ⭕ 图片：支持多张设备图片
- ⭕ 维护记录：完整的保养和维修历史
- ⭕ 备注

### 4. 折旧管理系统 💰

**自动折旧计算：**

采用**直线折旧法（平均年限法）**，系统自动计算当前价值：

```
当前价值 = 购买价格 - (购买价格 ÷ 折旧年限 × 已使用年数)
```

**计算示例：**
- 购买价格：180,000元
- 折旧年限：10年
- 购买日期：2020-03-15
- 当前日期：2024-10-21
- 已使用年数：4.61年
- 年折旧额：18,000元/年
- 累计折旧：82,980元
- **当前价值：97,020元**

**折旧特点：**
1. ✅ 实时计算：基于当前日期自动计算
2. ✅ 精确到天：计算精度到天，更准确
3. ✅ 残值保护：当前价值不会低于0
4. ✅ 自动更新：编辑时自动重新计算

**折旧相关数据展示：**
- 购买价格
- 当前价值
- 累计折旧金额
- 折旧率（百分比）

### 5. 状态管理

**四种状态：**

| 状态 | 颜色 | 说明 | 适用场景 |
|------|------|------|---------|
| 在用 | 🟢 绿色 | 正常使用中 | 日常作业设备 |
| 维修 | 🟠 橙色 | 维修保养中 | 故障或保养设备 |
| 闲置 | 🔵 蓝色 | 暂不使用 | 非作业季节设备 |
| 报废 | 🔴 红色 | 已报废 | 超期或损坏严重 |

**状态切换：**
- 可随时通过编辑功能修改状态
- 状态变更应及时记录原因

### 6. 完整CRUD功能

#### 新增农具 ➕

1. 点击"新增农具"按钮
2. 填写表单：
   ```
   农具名称：东方红拖拉机
   农具类型：大型农机
   型号：LX904
   购买日期：2020-03-15
   购买价格：180000
   折旧年限：10
   当前状态：在用
   责任人：张三
   存放位置：1号仓库
   备注：定期保养，状态良好
   ```
3. 系统自动：
   - 生成唯一编码：TOOL-2024-XXX
   - 计算当前价值
   - 计算折旧信息
4. 点击"保存"
5. 列表自动更新

#### 查看详情 👁️

1. 点击"眼睛"图标
2. 弹出详情对话框，分区显示：
   - **基本信息卡片**：编码、名称、型号、类型、状态
   - **价值与折旧信息卡片**：
     * 购买价格
     * 当前价值
     * 折旧年限
     * 累计折旧金额
     * 折旧率
   - **使用与存放信息卡片**：责任人、存放位置、状态
   - **维护记录卡片**：完整的保养和维修历史
   - **设备图片卡片**：多张设备图片展示
   - **备注信息**
3. 可直接点击"编辑"按钮跳转到编辑

#### 编辑农具 ✏️

1. 点击"编辑"图标
2. 表单自动填充当前数据
3. 修改需要更新的字段
4. 系统自动重新计算当前价值
5. 点击"更新"
6. 信息更新成功

**注意事项：**
- 编码不可修改（保持唯一性）
- 修改购买日期、购买价格或折旧年限会自动重算当前价值
- 维护记录和图片在详情中管理

#### 删除农具 🗑️

1. 点击"删除"图标
2. 弹出确认对话框
3. 确认后从列表移除
4. 显示删除成功提示

**警告：**
⚠️ 删除操作不可恢复，请谨慎操作！

### 7. 维护记录管理 🔧

**维护记录类型：**
- **保养**：定期保养维护
- **维修**：故障维修
- **检查**：安全检查

**维护记录字段：**
- 日期
- 类型（保养/维修/检查）
- 描述：详细的维护内容
- 费用：维护成本
- 技术员：负责人

**显示位置：**
1. 列表视图：显示维护记录条数
2. 列表视图：展示最近2条记录
3. 详情对话框：完整展示所有维护记录

**示例：**
```
日期：2024-01-15
类型：保养
描述：更换机油和滤芯
费用：¥800
技术员：李维修
```

### 8. 图片管理 📷

**图片功能：**
- ✅ 支持多张图片上传（当前为占位符）
- ✅ 图片列表展示
- ✅ 图片计数显示
- ⭕ 图片预览（待实现）
- ⭕ 图片下载（待实现）

**图片用途：**
- 设备外观照片
- 设备铭牌照片
- 维修前后对比照
- 设备使用场景

**显示位置：**
1. 列表视图：显示图片缩略图
2. 详情对话框：网格展示所有图片

### 9. 责任人管理 👤

**责任人功能：**
- 指定设备责任人
- 明确管理责任
- 方便追溯管理

**责任人职责：**
- 日常使用和保管
- 定期检查维护
- 异常情况上报
- 维护记录填写

### 10. 存放位置管理 📍

**位置类型：**
- 仓库编号：1号仓库、2号仓库等
- 功能区域：维修车间、工具房等
- 临时位置：作业现场等
- 特殊区域：报废区等

**位置管理：**
- 清晰标识存放位置
- 便于快速查找设备
- 优化仓储管理

## 📊 示例数据

系统预置7条示例数据，覆盖各种类型和状态：

| 编码 | 名称 | 类型 | 状态 | 购买价格 | 当前价值 | 折旧率 |
|------|------|------|------|---------|---------|-------|
| TOOL-2024-001 | 东方红拖拉机 | 大型农机 | 在用 | ¥180,000 | ¥108,000 | 40% |
| TOOL-2024-002 | 旋耕机 | 耕作机械 | 维修 | ¥12,000 | ¥7,500 | 37.5% |
| TOOL-2024-003 | 喷雾器 | 植保机械 | 在用 | ¥3,500 | ¥2,800 | 20% |
| TOOL-2024-004 | 收割机 | 收获机械 | 在用 | ¥220,000 | ¥120,833 | 45% |
| TOOL-2024-005 | 铁锹 | 小型农具 | 在用 | ¥60 | ¥56 | 6.7% |
| TOOL-2024-006 | 播种机 | 耕作机械 | 闲置 | ¥18,000 | ¥13,500 | 25% |
| TOOL-2024-007 | 老式拖拉机 | 大型农机 | 报废 | ¥85,000 | ¥0 | 100% |

## 🎯 使用场景

### 场景1：购置新设备入库

1. 点击"新增农具"
2. 填写设备基本信息
3. 拍照上传设备图片（预留功能）
4. 指定责任人和存放位置
5. 保存后自动生成编码和计算价值

### 场景2：设备维护保养

1. 在列表中找到需要维护的设备
2. 点击查看详情
3. 在维护记录中添加新记录（预留功能）
4. 填写维护类型、描述、费用等信息
5. 保存维护记录

### 场景3：设备状态变更

1. 设备送修：编辑状态改为"维修"
2. 维修完成：编辑状态改回"在用"
3. 季节性闲置：编辑状态为"闲置"
4. 超期报废：编辑状态为"报废"

### 场景4：设备资产盘点

1. 导出农具列表（预留功能）
2. 逐一核对实物和账面信息
3. 更新责任人和存放位置
4. 更新设备状态
5. 补充维护记录

### 场景5：折旧核算

1. 查看设备列表
2. 查看每个设备的当前价值
3. 统计累计折旧金额
4. 生成折旧报表（预留功能）
5. 用于财务核算

## 💡 最佳实践

### 1. 编码管理
- ✅ 使用系统自动生成的编码
- ✅ 不要手动修改编码
- ✅ 编码具有唯一性和可追溯性

### 2. 折旧管理
- ✅ 准确填写购买日期和价格
- ✅ 合理设置折旧年限
- ✅ 定期核对当前价值
- ✅ 大型设备建议10-12年
- ✅ 小型农具建议3-5年

### 3. 状态管理
- ✅ 及时更新设备状态
- ✅ 维修时标记为"维修"
- ✅ 非作业季标记为"闲置"
- ✅ 超期设备标记为"报废"

### 4. 维护记录
- ✅ 每次维护都要记录
- ✅ 详细描述维护内容
- ✅ 准确记录维护费用
- ✅ 标注技术员信息

### 5. 责任人管理
- ✅ 每台设备指定责任人
- ✅ 责任人变更及时更新
- ✅ 建立责任追溯机制

### 6. 图片管理
- ✅ 新设备入库拍照
- ✅ 维修前后拍照记录
- ✅ 铭牌信息拍照备案
- ✅ 定期更新设备照片

## 📋 数据字段说明

### 必填字段
- 农具名称
- 农具类型
- 型号
- 购买日期
- 购买价格
- 折旧年限
- 当前状态
- 存放位置

### 选填字段
- 责任人
- 备注

### 自动字段
- 唯一编码（系统生成）
- 当前价值（系统计算）
- 创建日期（系统记录）

### 关联数据
- 维护记录列表
- 图片列表

## 🔄 自动化功能

1. **自动编码生成**：按格式自动生成唯一编码
2. **自动折旧计算**：基于购买信息实时计算
3. **自动数据验证**：必填项和数值范围验证
4. **自动状态更新**：根据操作自动更新状态
5. **自动日期记录**：记录创建时间

## 📝 注意事项

1. ⚠️ 折旧计算基于直线法，实际可能需要其他折旧方法
2. ⚠️ 当前价值为理论计算值，实际价值可能不同
3. ⚠️ 删除操作不可恢复，请谨慎删除
4. ⚠️ 责任人变更应记录交接信息
5. ⚠️ 报废设备建议保留档案一段时间
6. ⚠️ 大型设备建议购买保险
7. ⚠️ 定期进行资产盘点

## 🚀 访问路径

导航路径：**资产管理 → 基础信息管理 → 农具档案**

## 🔮 功能规划

### 近期规划
- [ ] 图片上传功能
- [ ] 维护记录添加功能
- [ ] 二维码生成和打印
- [ ] 数据导入导出

### 远期规划
- [ ] 移动端扫码盘点
- [ ] 维护提醒功能
- [ ] 租赁管理功能
- [ ] 保险管理功能
- [ ] 折旧方法可选
- [ ] 资产评估功能

## 📞 技术支持

如遇问题，请联系系统管理员或查阅系统帮助文档。

---

**版本：** 1.0  
**更新日期：** 2024-10-21  
**文档维护：** 系统管理员
