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

## 📋 功能概述

**物资档案**是农资农具管理系统的核心查看模块，提供对所有固定资产（农资、农具）的完整信息查看功能。

### ✅ 核心特点

1. **只读模式** - 仅供查看，确保数据安全
2. **数据来源** - 自动同步基础信息管理中的农资和农具档案
3. **完整信息** - 显示设备的所有关键字段和状态
4. **闭环管理** - 支持完整的生命周期：档案→调度→维修→折旧→报废

---

## 🎯 功能定位

### 在系统中的位置

```
农资农具管理
├── 📁 物资档案 ⭐（当前模块 - 仅查看）
├── 🔄 使用调度与状态
├── 🔧 维修保养
├── 📊 折旧计算
└── 🗑️ 报废处理
```

### 数据流向

```
基础信息管理
├── 农资档案管理 ─┐
└── 农具档案管理 ─┤
                  ├──→ 物资档案（本模块）─┬──→ 使用调度
                                        ├──→ 维修保养
                                        ├──→ 折旧计算
                                        └──→ 报废处理
```

---

## 📊 显示字段说明

### 主表格字段

| 序号 | 字段名称 | 数据类型 | 说明 | 示例 |
|------|---------|---------|------|------|
| 1 | **设备编号** | 文本 | 唯一标识符，可点击 | TOOL-2024-001 |
| 2 | **设备名称** | 文本 | 设备主名称 | 拖拉机 |
| 3 | **分类** | 标签 | 设备类型分类 | 动力机械、植保机械 |
| 4 | **型号/规格** | 文本 | 详细型号 | JD-6130M |
| 5 | **购买日期** | 日期 | YYYY-MM-DD | 2022-03-15 |
| 6 | **折旧年限** | 数字 | 预计使用年限 | 10年（已用31月） |
| 7 | **购买价值** | 金额 | 原始购买价格 | ¥280,000 |
| 8 | **当前价值** | 金额 | 扣除折旧后价值 | ¥224,000 |
| 9 | **使用时长** | 时间 | 累计使用小时数 | 1250h |
| 10 | **使用状态** | 状态标签 | 实时状态 | 空闲、使用中、维修中、已调度 |
| 11 | **存放位置** | 文本 | 当前位置 | 1号机库 |
| 12 | **责任人** | 文本 | 当前负责人 | 张师傅 |
| 13 | **序列号** | 文本 | 设备序列号 | JD2022031501 |
| 14 | **操作** | 按钮 | 查看详情 | 👁️ 按钮 |

### 详情对话框字段

#### 1. 基本信息区域
- 设备编号（蓝色高亮）
- 设备名称
- 设备分类（紫色标签）
- 型号规格
- 生产厂家
- 序列号

#### 2. 购买与价值信息（蓝色背景）
- 购买日期（带日历图标）
- 购买价格（蓝色，金额格式）
- 当前价值（绿色，金额格式）
- 累计折旧（橙色，金额格式）

#### 3. 折旧信息（橙色背景）
- 折旧年限
- 已使用时长（月）
- 年折旧额
- 折旧率（进度条+百分比）

#### 4. 使用状态（绿色背景）
- 当前状态（彩色标签）
- 累计使用时长（小时）
- 存放位置（带地图图标）
- 责任人（带用户图标）

#### 5. 维护信息（黄色背景，可选）
- 上次维护日期
- 下次维护日期

#### 6. 技术规格说明（可选）
- 详细的技术参数和规格说明

---

## 🎨 界面布局

### 页面结构

```
┌─────────────────────────────────────────────────────────┐
│ 🏷️ 标题：农资农具管理                                    │
│    副标题：固定资产全生命周期管理                         │
│                                        [前往基础信息] 🔗  │
├─────────────────────────────────────────────────────────┤
│ 📊 统计卡片（5个）                                        │
│ [设备总数] [使用中] [空闲] [维修中] [总价值]              │
├─────────────────────────────────────────────────────────┤
│ 📑 Tab切换                                               │
│ [物资档案⭐] [使用调度] [维修保养] [折旧计算] [报废处理]  │
├─────────────────────────────────────────────────────────┤
│ ℹ️ 功能说明卡片（绿色）                                   │
│ • 查看模式 • 固定资产管理 • 详细记录 • 状态跟踪 • 闭环管理│
├─────────────────────────────────────────────────────────┤
│ ℹ️ 数据来源提示（蓝色）                                   │
│ 本页面数据来自基础信息管理 → 农资/农具档案管理            │
│                                        [前往基础信息] 🔗  │
├─────────────────────────────────────────────────────────┤
│ 🔍 搜索筛选工具栏                                         │
│ [搜索框] [设备分类▾] [使用状态▾] [高级筛选] [导出]       │
├─────────────────────────────────────────────────────────┤
│ 📋 物资档案清单表格                          共 3 条记录   │
│ ┌─────────────────────────────────────────────────────┐ │
│ │设备编号│名称│分类│型号│日期│...│操作│                │ │
│ │--------|----|----|----|----|----|----│                │ │
│ │TOOL-001│拖拉机│动力│JD-6│...│...│👁️ │                │ │
│ │TOOL-002│喷雾器│植保│SP-3│...│...│👁️ │                │ │
│ │TOOL-003│收割机│收获│XG-9│...│...│👁️ │                │ │
│ └─────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│ 💰 统计汇总卡片（3个）                                    │
│ [总购买价值] [总当前价值] [累计折旧]                      │
└─────────────────────────────────────────────────────────┘
```

---

## 🎯 使用状态说明

### 状态类型与颜色

| 状态 | 标签颜色 | 含义 | 适用场景 |
|------|---------|------|---------|
| **空闲** | 🟢 绿色 | 可立即调度使用 | 设备完好，无任务 |
| **使用中** | 🔵 蓝色 | 正在执行作业任务 | 已分配任务，作业中 |
| **维修中** | 🟠 橙色 | 正在维修，暂不可用 | 故障或保养中 |
| **已调度** | 🟣 紫色 | 已分配任务但未开始 | 任务计划中 |
| **报废** | ⚫ 灰色 | 已停用报废 | 完成报废流程 |

---

## 🔧 功能操作指南

### 1. 查看物资列表

**步骤**：
1. 进入"农资农具管理"模块
2. 默认显示"物资档案"Tab
3. 自动显示所有固定资产列表

**列表内容**：
- ✅ 所有农资（种子、化肥、农药等）
- ✅ 所有农具（拖拉机、喷雾器、收割机等）
- ✅ 实时状态和位置信息
- ✅ 完整的财务信息

---

### 2. 搜索和筛选

#### 搜索功能
- **搜索范围**：设备编号、名称、型号
- **搜索方式**：实时搜索，输入即过滤
- **示例**：输入"拖拉机"或"TOOL-001"

#### 分类筛选
可选分类：
- 全部分类
- 动力机械（拖拉机等）
- 植保机械（喷雾器等）
- 收获机械（收割机等）
- 耕整机械
- 播种机械

#### 状态筛选
可选状态：
- 全部状态
- 空闲
- 使用中
- 维修中
- 已调度

#### 高级筛选（可扩展）
- 按购买日期范围
- 按价值范围
- 按使用时长
- 按责任人

---

### 3. 查看设备详情

**操作步骤**：
1. 在列表中找到目标设备
2. 点击右侧的"👁️"（眼睛）按钮
3. 弹出详情对话框

**详情对话框内容**：
- 📄 基本信息（6个字段）
- 💰 购买与价值信息（4个字段）
- 📊 折旧信息（4个字段，含进度条）
- 🎯 使用状态（4个字段）
- 🔧 维护信息（2个字段，可选）
- 📝 技术规格说明（可选）
- ℹ️ 数据来源提示

**操作**：
- ✅ 查看所有字段详情
- ✅ 复制设备编号等信息
- ❌ 无编辑功能（只读）
- 点击"关闭"按钮退出

---

### 4. 导出数据

**操作步骤**：
1. 点击工具栏的"导出"按钮
2. 选择导出格式（Excel/CSV）
3. 下载文件到本地

**导出内容**：
- 当前筛选条件下的所有设备
- 包含所有表格字段
- 格式化的金额和日期
- 可在Excel中进一步处理

---

### 5. 前往基础信息管理

如需新增或编辑设备信息：

**方式1**：点击右上角"前往基础信息"按钮
**方式2**：点击蓝色提示卡片中的"前往基础信息管理"按钮
**方式3**：在详情对话框底部点击提示中的链接

**跳转目标**：
- 基础信息管理 → 农资档案管理（农资类）
- 基础信息管理 → 农具档案管理（农具类）

---

## 📊 统计数据说明

### 顶部统计卡片（5个）

| 卡片 | 图标 | 计算方式 | 用途 |
|------|------|---------|------|
| **设备总数** | 📦 | 所有设备数量 | 资产规模总览 |
| **使用中** | ▶️ | 状态为"使用中"的数量 | 当前作业设备 |
| **空闲** | ⏸️ | 状态为"空闲"的数量 | 可调度资源 |
| **维修中** | 🔧 | 状态为"维修中"的数量 | 维护成本预警 |
| **总价值** | 💰 | 所有设备当前价值总和 | 资产价值评估 |

### 底部统计汇总（3个）

| 卡片 | 颜色 | 计算方式 | 说明 |
|------|------|---------|------|
| **总购买价值** | 🟢 绿色 | 所有设备购买价格总和 | 原始投资额 |
| **总当前价值** | 🔵 蓝色 | 所有设备当前价值总和 | 扣除折旧后价值 |
| **累计折旧** | 🟠 橙色 | 购买价值 - 当前价值 | 已损耗价值 |

---

## 🔗 与其他模块的关联

### 1. 基础信息管理（数据源）

**农资档案管理**：
- 种子、化肥、农药等农资的档案信息
- 新增/编辑后自动同步到物资档案

**农具档案管理**：
- 拖拉机、喷雾器、收割机等农具信息
- 新增/编辑后自动同步到物资档案

**数据同步**：
- 实时同步（或定时同步）
- 双向关联，数据一致

---

### 2. 使用调度与状态

**功能**：
- 查看设备实时状态
- 分配任务和责任人
- 更新设备位置

**数据流**：
物资档案 → 选择设备 → 调度使用 → 更新状态

---

### 3. 维修保养

**功能**：
- 创建维修工单
- 记录维修历史
- 更新维护日期

**数据流**：
物资档案 → 查看维护信息 → 创建工单 → 记录完成

---

### 4. 折旧计算

**功能**：
- 自动计算折旧
- 生成折旧报表
- 支持多种折旧方法

**数据流**：
物资档案 → 读取购买信息 → 计算折旧 → 更新当前价值

---

### 5. 报废处理

**功能**：
- 申请设备报废
- 审批流程
- 更新设备状态

**数据流**：
物资档案 → 选择设备 → 申请报废 → 审批 → 更新状态为"报废"

---

## 💡 使用技巧

### 1. 快速定位设备
- 使用设备编号搜索（最精确）
- 组合使用分类+状态筛选
- 记住常用设备的编号前缀

### 2. 批量导出分析
- 先筛选出需要的设备
- 导出Excel进行深度分析
- 可生成自定义报表

### 3. 状态监控
- 定期查看"维修中"数量
- 关注"空闲"设备，优化调度
- 跟踪"使用中"设备的位置

### 4. 价值评估
- 查看当前价值总和
- 对比累计折旧，评估损耗
- 为采购决策提供依据

### 5. 维护提醒
- 在详情中查看下次维护日期
- 提前安排维护计划
- 避免设备故障

---

## ⚠️ 注意事项

### 1. 只读限制
- ✅ 可以：查看所有信息
- ❌ 不可以：新增、编辑、删除
- 原因：确保数据来源统一，避免冲突

### 2. 数据来源
- 数据来自基础信息管理
- 修改必须在基础信息模块进行
- 修改后会自动同步到本模块

### 3. 权限控制
- 根据用户角色显示不同功能
- 某些敏感信息可能需要特殊权限
- 遵守企业数据安全规范

### 4. 数据准确性
- 定期核对设备实际状态
- 及时更新位置和责任人
- 确保折旧计算准确

---

## 🔄 数据更新流程

### 新增设备流程

```
基础信息管理
  ↓
农资/农具档案管理
  ↓
点击"新增"
  ↓
填写设备信息
  ↓
保存
  ↓
自动同步 ──→ 物资档案（本模块）
  ↓
立即可见
```

### 修改设备流程

```
物资档案（本模块）
  ↓
点击"前往基础信息"
  ↓
农资/农具档案管理
  ↓
找到设备，点击"编辑"
  ↓
修改信息
  ↓
保存
  ↓
自动同步 ──→ 物资档案（本模块）
  ↓
信息更新
```

### 状态更新流程

```
物资档案
  ↓
查看设备
  ↓
前往"使用调度"Tab
  ↓
分配任务/更新状态
  ↓
保存
  ↓
状态更新 ──→ 物资档案
  ↓
实时反映
```

---

## 📈 使用场景示例

### 场景1：资产盘点
**目标**：年终盘点所有固定资产

1. 进入物资档案
2. 导出完整设备列表
3. 打印或在线核对
4. 更新实际状态和位置
5. 标记异常设备

### 场景2：设备调度
**目标**：为春耕作业分配设备

1. 查看设备状态，筛选"空闲"
2. 查看设备位置和责任人
3. 前往"使用调度"Tab
4. 分配任务和责任人
5. 更新为"使用中"状态

### 场景3：维护计划
**目标**：制定本月维护计划

1. 查看设备详情，关注"下次维护日期"
2. 筛选即将到期的设备
3. 前往"维修保养"Tab
4. 创建维护工单
5. 安排维护人员

### 场景4：采购决策
**目标**：评估是否需要购买新设备

1. 查看设备总数和使用情况
2. 分析"使用中"占比
3. 查看"维修中"频率
4. 对比当前价值和折旧
5. 为采购提供数据支持

### 场景5：报废申请
**目标**：申请老旧设备报废

1. 查看设备详情，确认使用年限
2. 查看当前价值和折旧率
3. 前往"报废处理"Tab
4. 填写报废申请
5. 提交审批流程

---

## 🛠️ 技术实现说明

### 折旧计算逻辑

```typescript
const calculateDepreciation = (equipment: Equipment) => {
  // 计算已使用月数
  const monthsUsed = Math.floor(
    (new Date().getTime() - new Date(equipment.purchaseDate).getTime()) 
    / (1000 * 60 * 60 * 24 * 30)
  );
  
  // 年折旧额
  const annualDepreciation = equipment.purchasePrice / equipment.depreciationYears;
  
  // 累计折旧
  const accumulatedDepreciation = (annualDepreciation / 12) * monthsUsed;
  
  // 当前价值
  const currentValue = equipment.purchasePrice - accumulatedDepreciation;
  
  // 折旧率
  const depreciationRate = (accumulatedDepreciation / equipment.purchasePrice) * 100;
  
  return {
    monthsUsed,
    annualDepreciation,
    accumulatedDepreciation,
    currentValue,
    depreciationRate,
  };
};
```

### 状态颜色映射

```typescript
const getStatusColor = (status: EquipmentStatus) => {
  switch (status) {
    case '空闲': return 'bg-green-100 text-green-700';
    case '使用中': return 'bg-blue-100 text-blue-700';
    case '维修中': return 'bg-orange-100 text-orange-700';
    case '已调度': return 'bg-purple-100 text-purple-700';
    case '报废': return 'bg-gray-100 text-gray-700';
    default: return 'bg-gray-100 text-gray-700';
  }
};
```

---

## 📝 数据结构

### Equipment 接口

```typescript
interface Equipment {
  id: string;                    // 唯一标识
  code: string;                  // 设备编号
  name: string;                  // 设备名称
  category: string;              // 设备分类
  model: string;                 // 型号规格
  manufacturer: string;          // 生产厂家
  purchaseDate: string;          // 购买日期
  purchasePrice: number;         // 购买价格
  depreciationYears: number;     // 折旧年限
  usageHours: number;            // 使用时长（小时）
  currentValue: number;          // 当前价值
  status: EquipmentStatus;       // 使用状态
  location?: string;             // 存放位置
  assignedTo?: string;           // 责任人
  lastMaintenanceDate?: string;  // 上次维护日期
  nextMaintenanceDate?: string;  // 下次维护日期
  specifications?: string;       // 技术规格说明
  serialNumber?: string;         // 序列号
}
```

### EquipmentStatus 类型

```typescript
type EquipmentStatus = '空闲' | '使用中' | '维修中' | '已调度' | '报废';
```

---

## ✅ 功能检查清单

### 核心功能
- [x] 显示完整的设备列表
- [x] 显示所有必需字段
- [x] 搜索和筛选功能
- [x] 查看设备详情（只读）
- [x] 导出数据功能
- [x] 统计数据展示
- [x] 状态颜色区分
- [x] 折旧自动计算
- [x] 数据来源提示
- [x] 跳转到基础信息管理

### 数据完整性
- [x] 设备编号
- [x] 设备名称
- [x] 设备分类
- [x] 型号规格
- [x] 购买日期
- [x] 折旧年限
- [x] 购买价值
- [x] 当前价值
- [x] 使用时长
- [x] 使用状态
- [x] 存放位置
- [x] 责任人
- [x] 序列号

### 用户体验
- [x] 界面美观清晰
- [x] 只读模式明确标识
- [x] 提示信息完整
- [x] 操作流程流畅
- [x] 响应速度快
- [x] 移动端适配

---

## 🎓 培训要点

### 对管理员
1. 理解数据来源机制
2. 掌握完整的生命周期流程
3. 定期检查数据准确性
4. 指导用户正确使用

### 对普通用户
1. 知道这是只读模块
2. 学会搜索和筛选设备
3. 理解设备状态含义
4. 知道如何跳转到编辑功能

---

## 🔐 权限说明

### 建议权限设置

| 角色 | 查看 | 搜索 | 导出 | 详情 | 编辑 |
|------|------|------|------|------|------|
| **管理员** | ✅ | ✅ | ✅ | ✅ | ⚠️ 在基础信息模块 |
| **仓库管理** | ✅ | ✅ | ✅ | ✅ | ⚠️ 在基础信息模块 |
| **普通员工** | ✅ | ✅ | ❌ | ✅ | ❌ |
| **临时工** | ✅ | ✅ | ❌ | ❌ | ❌ |

---

## 📞 支持与反馈

### 常见问题
1. **Q**: 为什么不能编辑设备信息？
   **A**: 这是只读模块，请前往基础信息管理进行编辑

2. **Q**: 设备信息多久更新一次？
   **A**: 实时同步（或根据配置定时同步）

3. **Q**: 如何添加新设备？
   **A**: 前往基础信息管理 → 农资/农具档案管理 → 新增

4. **Q**: 折旧是如何计算的？
   **A**: 采用直线法：（购买价格/折旧年限）× 已使用月数/12

5. **Q**: 可以导出哪些数据？
   **A**: 可导出当前筛选条件下的所有设备信息

### 技术支持
- 📧 Email: support@example.com
- 📱 电话: 400-XXX-XXXX
- 💬 在线客服: 工作日 9:00-18:00

---

## 📅 更新日志

### v1.0.0 (2024-10-22)
- ✅ 完成物资档案查看功能
- ✅ 实现完整字段显示
- ✅ 添加搜索和筛选
- ✅ 实现详情对话框（只读）
- ✅ 添加统计数据展示
- ✅ 实现折旧自动计算
- ✅ 添加数据来源提示
- ✅ 集成导出功能

---

**文档版本**: v1.0.0  
**最后更新**: 2024-10-22  
**维护人员**: 系统开发团队  
**状态**: ✅ 生产就绪
