生产管理系统前端 - 更新瓦力提交的产品原型到参考目录

2025-10-23 10:57:14 +08:00
parent 83523dad64
commit 28229ce795
354 changed files with 147599 additions and 7892 deletions
--- a/src/MAINTENANCE_EXAMPLES_GUIDE.md
+++ b/src/MAINTENANCE_EXAMPLES_GUIDE.md
@@ -0,0 +1,527 @@
+# 农机维护记录示例数据指南
+
+## 概述
+
+本指南介绍了农机全生命周期档案中维护记录的示例数据，涵盖了实际生产中的各种维护场景，为系统使用者提供参考和最佳实践。
+
+## 数据初始化
+
+### 自动初始化
+
+系统会在首次访问维护记录功能时自动初始化示例数据（如果本地存储中没有记录）。
+
+### 手动初始化
+
+```typescript
+import { initializeMaintenanceMockData } from '../lib/maintenanceMockData';
+
+// 初始化示例数据
+initializeMaintenanceMockData();
+```
+
+### 清除数据（仅测试）
+
+```typescript
+import { clearMaintenanceRecords } from '../lib/maintenanceMockData';
+
+// 清除所有维护记录
+clearMaintenanceRecords();
+```
+
+## 示例数据覆盖场景
+
+### 1. 约翰迪尔拖拉机（耕地机械）
+
+#### 场景1：日常保养（7天前）
+```
+维护类型：日常保养
+工时：2小时
+费用：¥850
+
+维护项目：
+- 更换机油、机油滤芯
+- 检查空气滤芯
+- 润滑各部位
+- 检查轮胎气压
+- 清洁设备外观
+
+使用配件：
+- 液压油 × 15升
+- 机油滤芯 × 2个
+
+技术人员：李师傅
+备注：定期保养，设备运行正常，无异常发现
+```
+
+#### 场景2：定期维护（45天前）
+```
+维护类型：定期维护
+工时：4小时
+费用：¥2,380
+
+维护项目：
+- 更换空气滤芯、燃油滤芯
+- 检查刹车系统
+- 调整传动皮带
+- 检查液压系统
+- 校准作业深度传感器
+- 全面检查电气系统
+
+使用配件：
+- 空气滤芯 × 1个
+- 燃油滤芯 × 1个
+- 液压油 × 20升
+- 传动皮带 × 2条
+
+技术人员：王工
+备注：半年度定期维护，更换了老化的传动皮带
+```
+
+#### 场景3：故障维修（20天前）
+```
+维护类型：故障维修
+工时：6小时
+费用：¥1,560
+
+故障现象：液压系统漏油
+
+维护项目：
+- 修复液压系统漏油问题
+- 更换损坏的油封和O型圈
+- 检查并紧固各连接部位
+- 清洗液压油箱
+- 补充液压油
+
+使用配件：
+- 油封 × 3个
+- O型圈 × 5个
+- 液压油 × 8升
+
+技术人员：李师傅、张技师
+备注：发现液压油管接头处油封老化导致漏油，已更换新油封，测试正常
+```
+
+#### 场景4：年检（90天前）
+```
+维护类型：年检
+工时：3小时
+费用：¥1,200
+
+检查项目：
+- 年度安全检查
+- 排放检测
+- 噪音测试
+- 制动性能测试
+- 灯光系统检查
+- 安全装置检查
+
+使用配件：
+- 刹车片 × 4片
+- 灯泡 × 2个
+
+技术人员：农机监理站-刘检验员
+备注：年检合格，所有安全项目符合标准。年检证书编号：AJ-2024-001
+```
+
+### 2. 收割机（收获机械）
+
+#### 场景1：作业季前检修（60天前）
+```
+维护类型：定期维护
+工时：8小时
+费用：¥4,200
+
+维护项目：
+- 更换刀片组件
+- 调整脱粒滚筒间隙
+- 清理筛网
+- 检查传动链条张紧度
+- 润滑各轴承点
+- 检查液压升降系统
+- 更换磨损严重的传动带
+
+使用配件：
+- 收割刀片 × 8片
+- 传动皮带 × 3条
+- 齿轮油 × 5升
+- 传动链条 × 1条
+
+技术人员：赵师傅、孙师傅
+备注：收获季节前全面检修，刀片已全部更换为新件，脱粒系统调整到最佳状态
+```
+
+#### 场景2：作业中故障抢修（30天前）
+```
+维护类型：故障维修
+工时：5小时
+费用：¥1,850
+
+故障现象：异响，无法正常作业
+
+维护项目：
+- 更换损坏的传动轴承
+- 修复电气线路短路问题
+- 调整清粮风机
+- 紧固松动的螺栓
+
+使用配件：
+- 轴承 × 2个
+- 电线 × 10米
+- 螺栓螺母 × 20套
+
+技术人员：李师傅、王工（紧急出车）
+备注：收割作业中突发故障，传动轴承损坏导致异响。现场紧急更换轴承
+```
+
+#### 场景3：作业季后保养（10天前）
+```
+维护类型：日常保养
+工时：4小时
+费用：¥950
+
+维护项目：
+- 全面清理机身杂物和积尘
+- 更换机油和滤芯
+- 检查所有润滑点
+- 防锈处理
+- 存放准备
+
+使用配件：
+- 机油 × 18升
+- 机油滤芯 × 1个
+- 空气滤芯 × 1个
+- 防锈剂 × 2瓶
+
+技术人员：张师傅
+备注：收获季节结束后的保养，设备已清洗干净，关键部位已涂抹防锈剂
+```
+
+### 3. 播种机（播种机械）
+
+#### 场景1：播种前调试（50天前）
+```
+维护类型：定期维护
+工时：3小时
+费用：¥680
+
+维护项目：
+- 检查并调整排种器间距
+- 校准播种深度
+- 检查施肥装置
+- 清洗种子箱
+- 润滑传动部件
+- 调整镇压轮
+
+使用配件：
+- 排种轮 × 6个
+- 润滑脂 × 3kg
+
+技术人员：赵师傅
+备注：播种前例行调试，排种器调整到最佳状态，播种深度校准完成
+```
+
+#### 场景2：作业中保养（15天前）
+```
+维护类型：日常保养
+工时：2小时
+费用：¥150
+
+维护项目：
+- 清理种子箱残留
+- 检查排种器磨损情况
+- 润滑各活动部件
+- 紧固松动螺栓
+
+使用配件：
+- 润滑脂 × 1kg
+
+技术人员：李师傅
+备注：播种作业中的日常保养，设备运行正常，无异常磨损
+```
+
+#### 场景3：小修（5天前）
+```
+维护类型：故障维修
+工时：1.5小时
+费用：¥420
+
+故障现象：播种深度不一致
+
+维护项目：
+- 更换磨损的开沟器刀片
+- 调整施肥管道
+- 修复堵塞的排种孔
+
+使用配件：
+- 开沟器刀片 × 4个
+
+技术人员：张师傅
+备注：开沟器刀片磨损严重影响作业质量，现场更换新刀片
+```
+
+## 维护记录统计分析
+
+### 整体统计
+```
+总记录数：11条（示例）
+总费用：¥15,990
+总工时：43.5小时
+平均费用/次：¥1,454
+```
+
+### 按类型分布
+```
+日常保养：4次 (36%)
+定期维护：4次 (36%)
+故障维修：4次 (36%)
+年检：1次 (9%)
+```
+
+### 成本分析
+```
+最高单次费用：¥4,200（收割机季前检修）
+最低单次费用：¥150（播种机日常保养）
+故障维修平均费用：¥1,212
+预防性维护平均费用：¥1,603
+```
+
+## 维护记录最佳实践
+
+### 1. 记录完整性
+✅ **必填项**
+- 维护类型
+- 开始/结束时间
+- 工时
+- 维护项目
+- 费用
+- 技术人员
+
+✅ **建议填写**
+- 使用的配件与耗材（含数量）
+- 下次维护时间
+- 详细备注
+
+### 2. 维护项目描述
+```
+❌ 不好的描述：
+"保养"
+
+✅ 好的描述：
+"更换机油、机油滤芯，检查空气滤芯，润滑各部位，检查轮胎气压，清洁设备外观"
+```
+
+### 3. 配件与耗材记录
+```
+❌ 不完整：
+"更换了滤芯"
+
+✅ 完整记录：
+- 机油滤芯 × 2个
+- 空气滤芯 × 1个
+- 机油 × 15升
+```
+
+### 4. 备注信息
+```
+✅ 记录要点：
+- 发现的问题
+- 采取的措施
+- 设备状态
+- 特殊情况
+- 建议事项
+```
+
+### 5. 下次维护时间
+```
+日常保养：15-30天
+定期维护：90-180天
+故障维修：视情况而定
+年检：365天
+```
+
+## 维护类型选择指南
+
+### 日常保养
+- **频率**：15-30天
+- **特点**：常规保养，工时短，费用低
+- **典型项目**：换油、润滑、清洁、检查
+
+### 定期维护
+- **频率**：90-180天
+- **特点**：系统性维护，工时长，费用较高
+- **典型项目**：系统检修、部件更换、性能调整
+
+### 故障维修
+- **频率**：不定期
+- **特点**：针对性强，紧急性高
+- **典型项目**：部件更换、系统修复、故障排除
+
+### 年检
+- **频率**：365天
+- **特点**：法定要求，全面检查
+- **典型项目**：安全检查、性能测试、合规检验
+
+## 成本控制建议
+
+### 1. 预防性维护优先
+```
+预防性维护成本 < 故障维修成本
+
+示例：
+- 定期更换滤芯：¥200
+- 滤芯堵塞导致发动机损坏：¥5,000+
+```
+
+### 2. 建立维护计划
+```
+按时间：
+- 每15天：日常保养
+- 每3个月：定期维护
+- 每年：<E5B9B4><EFBC9A><EFBFBD>检
+
+按使用：
+- 每50小时：换油保养
+- 每200小时：系统检查
+- 每1000小时：大修
+```
+
+### 3. 配件库存管理
+```
+常用配件：
+- 机油、滤芯：常备
+- 易损件：备份
+- 专用件：按需采购
+```
+
+## 数据导出和报表
+
+### 维护记录导出格式
+```csv
+设备名称,维护类型,维护时间,工时,费用,技术人员,备注
+约翰迪尔拖拉机,日常保养,2025-10-09 08:00,2,850,李师傅,定期保养
+```
+
+### 月度维护报表
+```
+【2025年10月维护报表】
+
+设备总数：10台
+维护次数：8次
+总工时：28小时
+总费用：¥12,500
+
+按类型统计：
+- 日常保养：3次，¥2,400
+- 定期维护：2次，¥6,500
+- 故障维修：3次，¥3,600
+```
+
+## 使用维护示例组件
+
+### 在系统中查看示例
+
+1. **访问路径**：
+   ```
+   智能农机管理系统 > 农机全生命周期档案 > 维护记录示例
+   ```
+
+2. **功能特性**：
+   - 统计卡片：总数、费用、工时、平均费用
+   - 类型分布：可视化展示各类型占比
+   - 记录列表：按类型筛选，详细展示
+   - 配件清单：展示每次使用的配件
+
+3. **代码集成**：
+   ```tsx
+   import { MaintenanceExamples } from './components/machinery/MaintenanceExamples';
+   
+   function App() {
+     return <MaintenanceExamples />;
+   }
+   ```
+
+## 扩展功能
+
+### 1. 维护提醒
+```typescript
+// 检查即将到期的维护
+function getUpcomingMaintenance() {
+  const records = machineryStorage.getAllMaintenanceRecords();
+  const upcoming = records.filter(r => {
+    if (!r.nextMaintenanceTime) return false;
+    const days = getDaysBetween(new Date(), new Date(r.nextMaintenanceTime));
+    return days <= 7 && days >= 0;
+  });
+  return upcoming;
+}
+```
+
+### 2. 维护成本分析
+```typescript
+// 按设备分析维护成本
+function analyzeCostByMachinery() {
+  const records = machineryStorage.getAllMaintenanceRecords();
+  const costByMachinery = {};
+  
+  records.forEach(r => {
+    if (!costByMachinery[r.machineryId]) {
+      costByMachinery[r.machineryId] = 0;
+    }
+    costByMachinery[r.machineryId] += r.cost;
+  });
+  
+  return costByMachinery;
+}
+```
+
+### 3. 技术人员绩效
+```typescript
+// 统计技术人员工作量
+function getTechnicianPerformance() {
+  const records = machineryStorage.getAllMaintenanceRecords();
+  const performance = {};
+  
+  records.forEach(r => {
+    const techs = r.technician.split('、');
+    techs.forEach(tech => {
+      if (!performance[tech]) {
+        performance[tech] = { count: 0, hours: 0, cost: 0 };
+      }
+      performance[tech].count++;
+      performance[tech].hours += r.workHours;
+      performance[tech].cost += r.cost;
+    });
+  });
+  
+  return performance;
+}
+```
+
+## 注意事项
+
+1. **数据初始化**
+   - 仅在首次使用或数据为空时初始化
+   - 避免覆盖用户真实数据
+
+2. **配件物料关联**
+   - 确保配件ID正确关联到农资存储
+   - 如果配件不存在，不会显示
+
+3. **时间设置**
+   - 示例数据使用相对时间（如7天前）
+   - 确保时间逻辑合理
+
+4. **成本计算**
+   - 维护费用包含人工和配件
+   - 配件费用可从物料单价自动计算
+
+## 总结
+
+维护记录示例数据为系统使用者提供了：
+- ✅ 完整的维护场景覆盖
+- ✅ 规范的记录格式
+- ✅ 实用的最佳实践
+- ✅ 详尽的成本分析
+- ✅ 便捷的数据初始化
+
+通过学习这些示例，用户可以快速掌握农机维护记录的管理方法，建立科学的维护体系，有效控制维护成本，延长设备使用寿命。