# 农机维护记录示例数据 - 快速开始

## 📋 概述

本功能为农机全生命周期档案提供了**11条真实场景的维护记录示例数据**，涵盖4种维护类型，帮助用户快速了解和使用维护记录管理功能。

## 🎯 核心特性

### 1. 自动数据初始化
- ✅ 首次访问自动创建示例数据
- ✅ 已有数据时不重复初始化
- ✅ 可手动清除和重新初始化

### 2. 真实场景覆盖

| 维护类型 | 数量 | 典型场景 |
|---------|------|---------|
| **日常保养** | 4次 | 换油、润滑、清洁 |
| **定期维护** | 4次 | 季节性检修、系统调试 |
| **故障维修** | 4次 | 紧急抢修、部件更换 |
| **年检** | 1次 | 安全检测、合规检验 |

### 3. 完整数据结构
每条记录包含：
- 维护类型和时间
- 工时和费用
- 维护项目详情
- 使用的配件与耗材（含数量）
- 技术人员信息
- 详细备注
- 下次维护时间

## 🚀 快速开始

### 方法1：自动初始化（推荐）

系统首次运行时会自动初始化示例数据，无需手动操作。

### 方法2：手动初始化

```typescript
import { initializeMaintenanceMockData } from './lib/maintenanceMockData';

// 初始化示例数据
initializeMaintenanceMockData();
```

### 方法3：查看示例组件

```typescript
import { MaintenanceExamples } from './components/machinery/MaintenanceExamples';

function App() {
  return <MaintenanceExamples />;
}
```

## 📊 示例数据预览

### 示例1：日常保养
```yaml
设备: 约翰迪尔6B-1404拖拉机
类型: 日常保养
时间: 7天前
工时: 2小时
费用: ¥850

维护项目:
  - 更换机油、机油滤芯
  - 检查空气滤芯
  - 润滑各部位
  - 检查轮胎气压
  - 清洁设备外观

使用配件:
  - 液压油 × 15升
  - 机油滤芯 × 2个

技术人员: 李师傅
备注: 定期保养，设备运行正常，无异常发现
```

### 示例2：定期维护
```yaml
设备: 久保田PRO988Q收割机
类型: 定期维护
时间: 60天前
工时: 8小时
费用: ¥4,200

维护项目:
  - 更换刀片组件
  - 调整脱粒滚筒间隙
  - 清理筛网
  - 检查传动链条张紧度
  - 润滑各轴承点
  - 检查液压升降系统

使用配件:
  - 收割刀片 × 8片
  - 传动皮带 × 3条
  - 齿轮油 × 5升
  - 传动链条 × 1条

技术人员: 赵师傅、孙师傅
备注: 收获季节前全面检修，刀片已全部更换为新件
```

### 示例3：故障维修
```yaml
设备: 约翰迪尔6B-1404拖拉机
类型: 故障维修
时间: 20天前
工时: 6小时
费用: ¥1,560

故障现象: 液压系统漏油

维护项目:
  - 修复液压系统漏油问题
  - 更换损坏的油封和O型圈
  - 检查并紧固各连接部位
  - 清洗液压油箱
  - 补充液压油

使用配件:
  - 油封 × 3个
  - O型圈 × 5个
  - 液压油 × 8升

技术人员: 李师傅、张技师
备注: 发现液压油管接头处油封老化导致漏油，已更换新油封
```

### 示例4：年检
```yaml
设备: 约翰迪尔6B-1404拖拉机
类型: 年检
时间: 90天前
工时: 3小时
费用: ¥1,200

检查项目:
  - 年度安全检查
  - 排放检测
  - 噪音测试
  - 制动性能测试
  - 灯光系统检查
  - 安全装置检查

使用配件:
  - 刹车片 × 4片
  - 灯泡 × 2个

技术人员: 农机监理站-刘检验员
备注: 年检合格，年检证书编号：AJ-2024-001
```

## 📈 数据统计

```
总记录数: 11条
总费用: ¥15,990
总工时: 43.5小时
平均费用/次: ¥1,454

维护类型分布:
├─ 日常保养: 4次 (36%)
├─ 定期维护: 4次 (36%)
├─ 故障维修: 4次 (36%)
└─ 年检: 1次 (9%)

费用区间:
├─ 最高: ¥4,200 (收割机季前检修)
├─ 最低: ¥150 (播种机日常保养)
├─ 故障维修平均: ¥1,212
└─ 预防性维护平均: ¥1,603
```

## 🎨 可视化界面

### 统计卡片
```
┌─────────────┬─────────────┬─────────────┬─────────────┐
│ 维护记录    │ 总费用      │ 总工时      │ 平均费用    │
│    11       │ ¥15,990     │  43.5h      │  ¥1,454     │
└─────────────┴─────────────┴─────────────┴─────────────┘
```

### 维护类型分布
```
日常保养 ████████ 36%
定期维护 ████████ 36%
故障维修 ████████ 36%
年检     ██       9%
```

### 记录列表
```
🔧 日常保养 | 约翰迪尔拖拉机
   更换机油、机油滤芯，检查空气滤芯...
   💰 ¥850  ⏱ 2小时  👤 李师傅  📅 7天前
   
📅 定期维护 | 久保田收割机
   更换刀片组件，调整脱粒滚筒间隙...
   💰 ¥4,200  ⏱ 8小时  👤 赵师傅、孙师傅  📅 60天前
```

## 🔧 API使用

### 获取所有维护记录
```typescript
import { machineryStorage } from './lib/machineryStorage';

const records = machineryStorage.getAllMaintenanceRecords();
```

### 获取特定设备的维护记录
```typescript
const machineryRecords = machineryStorage.getMaintenanceRecords('machinery-1');
```

### 获取统计信息
```typescript
import { getMaintenanceStatistics } from './lib/maintenanceMockData';

const stats = getMaintenanceStatistics();
console.log(stats);
// {
//   total: 11,
//   byType: { '日常保养': 4, ... },
//   totalCost: 15990,
//   totalWorkHours: 43.5,
//   ...
// }
```

### 清除示例数据（仅测试）
```typescript
import { clearMaintenanceRecords } from './lib/maintenanceMockData';

clearMaintenanceRecords();
```

## 📁 文件结构

```
lib/
  ├── maintenanceMockData.ts      # 维护记录示例数据核心
  └── mockData.ts                 # 集成初始化

components/machinery/
  └── MaintenanceExamples.tsx     # 示例数据展示组件

文档/
  ├── MAINTENANCE_EXAMPLES_GUIDE.md    # 详细使用指南
  └── MAINTENANCE_EXAMPLES_README.md   # 快速开始（本文件）
```

## 💡 使用场景

### 1. 新用户学习
- 查看完整的维护记录示例
- 了解各类维护的标准流程
- 学习最佳实践

### 2. 系统演示
- 向客户展示功能
- 培训新员工
- 系统测试

### 3. 数据模板
- 作为录入参考
- 复制成本标准
- 建立维护规范

## ✅ 最佳实践

### 1. 记录完整性
```
✅ 详细的维护项目描述
✅ 准确的配件使用数量
✅ 清晰的问题和处理过程
✅ 合理的下次维护时间设置
```

### 2. 成本核算
```
✅ 分别记录人工和配件费用
✅ 配件单价从物料库自动获取
✅ 定期分析维护成本趋势
✅ 识别高成本设备和项目
```

### 3. 预防性维护
```
✅ 建立维护计划表
✅ 提前7天提醒维护
✅ 记录预防性维护效果
✅ 减少故障维修次数
```

## 🔍 查看示例的3种方式

### 方式1：在农机详情页查看
```
1. 进入"智能农机管理系统"
2. 点击任意农机查看详情
3. 切换到"维护记录"标签页
4. 可以看到该农机的所有维护记录
```

### 方式2：使用示例展示组件
```
1. 导入 MaintenanceExamples 组件
2. 可以看到所有设备的维护记录
3. 支持按类型筛选
4. 显示统计分析
```

### 方式3：通过代码访问
```typescript
// 获取所有维护记录
const allRecords = machineryStorage.getAllMaintenanceRecords();

// 获取统计信息
const stats = getMaintenanceStatistics();

// 分析数据
console.table(allRecords);
```

## 📚 扩展阅读

- **MAINTENANCE_EXAMPLES_GUIDE.md** - 完整使用指南
- **MAINTENANCE_MATERIALS_UPDATE.md** - 配件与耗材功能说明
- **CHANGE_HISTORY_GUIDE.md** - 变更历史功能说明

## 🆘 常见问题

### Q: 示例数据会覆盖我的真实数据吗？
A: 不会。初始化函数会检查是否已有数据，有数据时不会重复初始化。

### Q: 如何重新加载示例数据？
A: 调用 `clearMaintenanceRecords()` 清除数据，然后调用 `initializeMaintenanceMockData()` 重新初始化。

### Q: 配件物料ID在哪里定义？
A: 在 `lib/materialStorage.ts` 中定义。如果物料不存在，配件名称不会显示。

### Q: 可以修改示例数据吗？
A: 可以。示例数据保存在 localStorage 中，可以在界面上编辑或删除。

### Q: 示例数据的时间是固定的吗？
A: 不是。时间是相对的（如"7天前"），会根据当前时间动态计算。

## 🎯 下一步

1. ✅ 浏览示例数据，了解功能
2. ✅ 为自己的设备添加真实维护记录
3. ✅ 建立维护计划和提醒机制
4. ✅ 定期分析维护成本和效果
5. ✅ 优化维护流程，降低成本

---

**更新时间**: 2025年10月16日  
**版本**: 1.0.0  
**维护者**: 系统管理员

## 反馈与支持

如有问题或建议，请联系系统管理员或查阅完整文档。
