生产管理系统前端 - 更新瓦力提交的产品原型到参考目录
This commit is contained in:
372
src/MAINTENANCE_EXAMPLES_README.md
Normal file
372
src/MAINTENANCE_EXAMPLES_README.md
Normal file
@@ -0,0 +1,372 @@
|
||||
# 农机维护记录示例数据 - 快速开始
|
||||
|
||||
## 📋 概述
|
||||
|
||||
本功能为农机全生命周期档案提供了**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
|
||||
**维护者**: 系统管理员
|
||||
|
||||
## 反馈与支持
|
||||
|
||||
如有问题或建议，请联系系统管理员或查阅完整文档。
|
||||
Reference in New Issue
Block a user