cavin/smart-crop-ui

Fork 0

Files

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

2025-10-23 10:57:14 +08:00

8.8 KiB

Raw Blame History

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

📋 概述

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

🎯 核心特性

1. 自动数据初始化

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

2. 真实场景覆盖

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

3. 完整数据结构

每条记录包含：

维护类型和时间
工时和费用
维护项目详情
使用的配件与耗材（含数量）
技术人员信息
详细备注
下次维护时间

🚀 快速开始

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

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

方法2：手动初始化

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

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

方法3：查看示例组件

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

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

📊 示例数据预览

示例1：日常保养

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

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

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

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

示例2：定期维护

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

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

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

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

示例3：故障维修

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

故障现象: 液压系统漏油

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

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

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

示例4：年检

设备: 约翰迪尔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使用

获取所有维护记录

import { machineryStorage } from './lib/machineryStorage';

const records = machineryStorage.getAllMaintenanceRecords();

获取特定设备的维护记录

const machineryRecords = machineryStorage.getMaintenanceRecords('machinery-1');

获取统计信息

import { getMaintenanceStatistics } from './lib/maintenanceMockData';

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

清除示例数据（仅测试）

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：通过代码访问

// 获取所有维护记录
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天前"），会根据当前时间动态计算。

🎯 下一步

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

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

反馈与支持

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

8.8 KiB Raw Blame History Unescape Escape