生产管理系统前端 - 更新瓦力提交的产品原型到参考目录
This commit is contained in:
413
src/TRACK_PLAYBACK_ACCESS_GUIDE.md
Normal file
413
src/TRACK_PLAYBACK_ACCESS_GUIDE.md
Normal file
@@ -0,0 +1,413 @@
|
||||
# 🗺️ 作业轨迹查看 - 访问指南
|
||||
|
||||
## 📍 如何查看作业轨迹
|
||||
|
||||
系统中有 **2个地方** 可以查看作业轨迹：
|
||||
|
||||
---
|
||||
|
||||
## 方式1: 轨迹回放功能 ⭐⭐⭐⭐⭐ (推荐)
|
||||
|
||||
### 📍 访问路径
|
||||
|
||||
```
|
||||
农机管理 → 管理与调度 → 轨迹回放
|
||||
```
|
||||
|
||||
### 🎯 详细步骤
|
||||
|
||||
1. **进入农机管理模块**
|
||||
```
|
||||
点击顶部导航栏 "农机管理"
|
||||
```
|
||||
|
||||
2. **进入管理与调度**
|
||||
```
|
||||
在左侧菜单中找到 "管理与调度" 分组
|
||||
```
|
||||
|
||||
3. **点击轨迹回放**
|
||||
```
|
||||
点击 "轨迹回放" 菜单项
|
||||
```
|
||||
|
||||
### ✨ 功能特点
|
||||
|
||||
**已有功能**:
|
||||
- ✅ 选择农机
|
||||
- ✅ 选择日期
|
||||
- ✅ 选择时间段（上午/下午/全天）
|
||||
- ✅ 播放控制（播放、暂停、快进、快退）
|
||||
- ✅ 倍速播放（0.5x, 1x, 2x, 4x, 8x）
|
||||
- ✅ 进度条控制
|
||||
- ✅ 实时参数显示（速度、已作业面积、作业速率、发动机转速）
|
||||
|
||||
**功能说明**:
|
||||
- 动画式重现农机移动路径
|
||||
- 同步显示该时刻的作业参数
|
||||
- 支持调速播放、暂停控制
|
||||
- 用于评估作业规范性
|
||||
- 分析漏耕、重耕问题
|
||||
|
||||
**当前状态**:
|
||||
- ⚠️ 地图轨迹区域为占位符，需要集成真实地图API
|
||||
- ⚠️ 使用模拟数据展示功能
|
||||
|
||||
---
|
||||
|
||||
## 方式2: 实时位置追踪（历史轨迹）⭐⭐⭐⭐
|
||||
|
||||
### 📍 访问路径
|
||||
|
||||
```
|
||||
农机管理 → 设备监控 → 实时位置
|
||||
```
|
||||
|
||||
### 🎯 详细步骤
|
||||
|
||||
1. **进入农机管理模块**
|
||||
```
|
||||
点击顶部导航栏 "农机管理"
|
||||
```
|
||||
|
||||
2. **进入设备监控**
|
||||
```
|
||||
在左侧菜单中找到 "设备监控" 分组
|
||||
```
|
||||
|
||||
3. **点击实时位置**
|
||||
```
|
||||
点击 "实时位置" 菜单项
|
||||
```
|
||||
|
||||
### ✨ 功能特点
|
||||
|
||||
**已有功能**:
|
||||
- ✅ 实时位置显示
|
||||
- ✅ 地图标记和聚合
|
||||
- ✅ 农机状态快照
|
||||
- ✅ 标准地图和卫星地图切换
|
||||
- ✅ 农机位置自动追踪
|
||||
- ✅ 支持历史轨迹回放
|
||||
- ✅ 轨迹导出（GPX/KML格式）
|
||||
|
||||
**当前状态**:
|
||||
- ✅ 完整的地图功能
|
||||
- ✅ 实时位置追踪
|
||||
- ✅ 高德地图集成
|
||||
|
||||
---
|
||||
|
||||
## 🎨 界面展示
|
||||
|
||||
### 轨迹回放页面
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────┐
|
||||
│ 农机作业轨迹回放 │
|
||||
│ 动画式重现历史作业轨迹 │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 回放设置 │
|
||||
│ ┌────────────────────────────────────────┐ │
|
||||
│ │ 选择农机 │ 日期 │ 时间段 │ │
|
||||
│ │ 约翰迪尔.. │ 2025-10-17 │ 全天 ▼ │ │
|
||||
│ └────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ 轨迹回放 │
|
||||
│ ┌────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ 地图轨迹回放区域 │ │
|
||||
│ │ │ │
|
||||
│ │ • 动画显示农机移动路径 │ │
|
||||
│ │ • 同步显示作业参数 │ │
|
||||
│ │ • 标注漏耕、重耕区域 │ │
|
||||
│ │ │ │
|
||||
│ └────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ 播放控制 │
|
||||
│ 08:00:00 ━━━━━━━━●━━━━━━━━━━ 18:00:00 │
|
||||
│ ◀◀ ▶ ▶▶ [1x ▼] │
|
||||
│ │
|
||||
│ 当前参数 │
|
||||
│ ┌──────┬──────┬──────┬──────┐ │
|
||||
│ │速度 │面积 │速率 │转速 │ │
|
||||
│ │15.2 │12.5 │7.8 │1850 │ │
|
||||
│ │km/h │亩 │亩/时 │RPM │ │
|
||||
│ └──────┴──────┴──────┴──────┘ │
|
||||
│ │
|
||||
└────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 功能对比
|
||||
|
||||
| 功能项 | 轨迹回放 | 实时位置 |
|
||||
|--------|---------|---------|
|
||||
| **地图显示** | ⚠️ 占位符 | ✅ 高德地图 |
|
||||
| **历史轨迹** | ✅ 支持 | ✅ 支持 |
|
||||
| **播放控制** | ✅ 完整 | ⚠️ 基础 |
|
||||
| **倍速播放** | ✅ 5档 | ❌ 无 |
|
||||
| **实时参数** | ✅ 4项 | ✅ 多项 |
|
||||
| **轨迹导出** | ❌ 无 | ✅ GPX/KML |
|
||||
| **适用场景** | 详细回放 | 实时监控 |
|
||||
|
||||
---
|
||||
|
||||
## 💡 使用建议
|
||||
|
||||
### 场景1: 查看历史作业轨迹
|
||||
|
||||
**推荐**: 实时位置追踪
|
||||
|
||||
**理由**:
|
||||
- ✅ 有完整的地图显示
|
||||
- ✅ 可以导出轨迹数据
|
||||
- ✅ 功能完善稳定
|
||||
|
||||
**步骤**:
|
||||
```
|
||||
1. 农机管理 → 设备监控 → 实时位置
|
||||
2. 选择要查看的农机
|
||||
3. 查看历史轨迹
|
||||
4. 导出轨迹数据（可选）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 场景2: 详细回放和分析
|
||||
|
||||
**推荐**: 轨迹回放功能
|
||||
|
||||
**理由**:
|
||||
- ✅ 播放控制更完整
|
||||
- ✅ 支持倍速播放
|
||||
- ✅ 实时参数同步显示
|
||||
- ✅ 专注于回放分析
|
||||
|
||||
**步骤**:
|
||||
```
|
||||
1. 农机管理 → 管理与调度 → 轨迹回放
|
||||
2. 选择农机、日期、时间段
|
||||
3. 点击播放按钮
|
||||
4. 调整播放速度
|
||||
5. 观察参数变化
|
||||
6. 分析作业质量
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 场景3: 评估作业质量
|
||||
|
||||
**推荐**: 组合使用
|
||||
|
||||
**最佳实践**:
|
||||
```
|
||||
1. 先在 "实时位置" 查看整体轨迹
|
||||
2. 发现问题区域后
|
||||
3. 切换到 "轨迹回放"
|
||||
4. 详细回放分析问题原因
|
||||
5. 查看该时刻的作业参数
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 技术说明
|
||||
|
||||
### 轨迹回放组件
|
||||
|
||||
**文件位置**: `/components/machinery/scheduling/TrackPlayback.tsx`
|
||||
|
||||
**核心功能**:
|
||||
```typescript
|
||||
- 播放控制: isPlaying, setIsPlaying
|
||||
- 播放速度: 0.5x, 1x, 2x, 4x, 8x
|
||||
- 进度控制: progress slider
|
||||
- 参数显示: 速度、面积、速率、转速
|
||||
```
|
||||
|
||||
**当前状态**:
|
||||
- ⚠️ 地图区域为占位符
|
||||
- ✅ 播放控制完整
|
||||
- ✅ UI界面完整
|
||||
|
||||
---
|
||||
|
||||
### 实时位置组件
|
||||
|
||||
**文件位置**: `/components/machinery/monitoring/RealtimeLocation.tsx`
|
||||
|
||||
**核心功能**:
|
||||
```typescript
|
||||
- 高德地图集成
|
||||
- 实时位置显示
|
||||
- 历史轨迹回放
|
||||
- 轨迹导出（GPX/KML）
|
||||
```
|
||||
|
||||
**当前状态**:
|
||||
- ✅ 完整的地图功能
|
||||
- ✅ 轨迹数据管理
|
||||
- ✅ 导出功能
|
||||
|
||||
---
|
||||
|
||||
## 🎯 快速访问
|
||||
|
||||
### 方式1: 轨迹回放
|
||||
|
||||
```
|
||||
路径: /machinery/scheduling/playback
|
||||
菜单: 农机管理 → 管理与调度 → 轨迹回放
|
||||
```
|
||||
|
||||
### 方式2: 实时位置
|
||||
|
||||
```
|
||||
路径: /machinery/monitoring/location
|
||||
菜单: 农机管理 → 设备监控 → 实时位置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 操作演示
|
||||
|
||||
### 轨迹回放操作流程
|
||||
|
||||
```
|
||||
第1步: 选择回放设置
|
||||
┌────────────────────────────┐
|
||||
│ 农机: 约翰迪尔拖拉机 ▼ │
|
||||
│ 日期: 2025-10-17 │
|
||||
│ 时段: 全天 ▼ │
|
||||
└────────────────────────────┘
|
||||
|
||||
第2步: 播放控制
|
||||
┌────────────────────────────┐
|
||||
│ 08:00:00 ━━●━━━ 18:00:00 │
|
||||
│ ◀◀ ▶ ▶▶ [1x ▼] │
|
||||
└────────────────────────────┘
|
||||
|
||||
第3步: 观察参数
|
||||
┌──────┬──────┬──────┬──────┐
|
||||
│速度 │面积 │速率 │转速 │
|
||||
│15.2 │12.5 │7.8 │1850 │
|
||||
└──────┴──────┴──────┴──────┘
|
||||
|
||||
第4步: 分析作业
|
||||
- 观察轨迹路径
|
||||
- 检查参数变化
|
||||
- 发现问题区域
|
||||
- 评估作业质量
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题
|
||||
|
||||
### Q1: 为什么轨迹回放页面地图是占位符？
|
||||
|
||||
**A**: 轨迹回放功能的地图集成还在开发中，目前可以使用 "实时位置" 功能查看真实的地图轨迹。
|
||||
|
||||
---
|
||||
|
||||
### Q2: 如何导出轨迹数据？
|
||||
|
||||
**A**: 使用 "实时位置" 功能，该功能支持 GPX 和 KML 格式导出。
|
||||
|
||||
```
|
||||
1. 农机管理 → 设备监控 → 实时位置
|
||||
2. 选择农机
|
||||
3. 查看历史轨迹
|
||||
4. 点击导出按钮
|
||||
5. 选择格式（GPX/KML）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Q3: 轨迹回放和实时位置有什么区别？
|
||||
|
||||
**A**:
|
||||
|
||||
**轨迹回放**:
|
||||
- 专注于历史数据回放
|
||||
- 完整的播放控制
|
||||
- 倍速播放支持
|
||||
- 参数同步显示
|
||||
- 适合详细分析
|
||||
|
||||
**实时位置**:
|
||||
- 实时+历史双重功能
|
||||
- 完整的地图显示
|
||||
- 轨迹导出功能
|
||||
- 适合快速查看
|
||||
|
||||
---
|
||||
|
||||
### Q4: 可以同时查看多台农机的轨迹吗？
|
||||
|
||||
**A**: 目前 "实时位置" 功能支持同时显示多台农机的位置，但轨迹回放功能一次只能回放一台农机。
|
||||
|
||||
---
|
||||
|
||||
### Q5: 轨迹数据保存多长时间？
|
||||
|
||||
**A**: 根据系统配置，一般保存30-90天。具体时间可以在系统设置中查看或调整。
|
||||
|
||||
---
|
||||
|
||||
## 🚀 未来规划
|
||||
|
||||
### 轨迹回放增强 (计划中)
|
||||
|
||||
1. ✅ 集成真实地图API
|
||||
2. ✅ 多农机同时回放
|
||||
3. ✅ 3D轨迹显示
|
||||
4. ✅ 作业区域高亮
|
||||
5. ✅ 异常事件标注
|
||||
6. ✅ 质量评估叠加
|
||||
|
||||
### 实时位置增强 (计划中)
|
||||
|
||||
1. ✅ 轨迹聚类分析
|
||||
2. ✅ 热力图显示
|
||||
3. ✅ 作业效率统计
|
||||
4. ✅ 路径优化建议
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- **实时位置追踪**: `/REALTIME_LOCATION_TRACKING_COMPLETE.md`
|
||||
- **作业数据记录**: `/OPERATION_RECORD_STATUS_SUMMARY.md`
|
||||
- **地图显示状态**: `/MAP_DISPLAY_STATUS.md`
|
||||
|
||||
---
|
||||
|
||||
## ✅ 总结
|
||||
|
||||
### 当前可用功能
|
||||
|
||||
1. **轨迹回放** ⭐⭐⭐⭐
|
||||
- 路径: 农机管理 → 管理与调度 → 轨迹回放
|
||||
- 特点: 完整的播放控制
|
||||
- 状态: 地图占位符，其他功能完整
|
||||
|
||||
2. **实时位置** ⭐⭐⭐⭐⭐
|
||||
- 路径: 农机管理 → 设备监控 → 实时位置
|
||||
- 特点: 完整的地图和轨迹功能
|
||||
- 状态: 全功能可用
|
||||
|
||||
### 推荐使用
|
||||
|
||||
- **快速查看**: 使用 "实时位置"
|
||||
- **详细分析**: 使用 "轨迹回放"
|
||||
- **导出数据**: 使用 "实时位置"
|
||||
- **评估质量**: 组合使用两者
|
||||
|
||||
---
|
||||
|
||||
**创建时间**: 2025-10-17
|
||||
**状态**: ✅ **功能可用**
|
||||
**建议**: 优先使用"实时位置"功能查看真实地图轨迹！
|
||||
Reference in New Issue
Block a user