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

2025-10-23 10:57:14 +08:00
parent 83523dad64
commit 28229ce795
354 changed files with 147599 additions and 7892 deletions
--- a/src/ISSUE_MANAGEMENT_ACCESS_GUIDE.md
+++ b/src/ISSUE_MANAGEMENT_ACCESS_GUIDE.md
@@ -0,0 +1,206 @@
+# 问题管理功能访问指南
+
+## 🎯 快速访问
+
+### 访问路径
+
+```
+首页
+ └─ 智能农机管理系统（顶部导航栏第1个Tab）
+     └─ 驾驶员档案（左侧菜单第2项）
+         └─ 驾驶员任务管理
+             ├─ 任务管理（Sub-Tab）
+             └─ 问题管理（Sub-Tab）⭐ 新功能
+```
+
+### 详细步骤
+
+#### 步骤1: 登录系统
+- 打开系统首页
+- 输入账号密码登录
+- 或使用手机号验证码登录
+
+#### 步骤2: 进入智能农机管理系统
+- 点击顶部导航栏的**"智能农机管理系统"**（第1个绿色Tab）
+
+#### 步骤3: 打开驾驶员档案菜单
+- 在左侧菜单栏找到**"驾驶员档案"**（第2大项）
+- 点击展开驾驶员档案的子菜单
+
+#### 步骤4: 进入驾驶员任务管理
+- 点击**"驾驶员任务管理"**子菜单项
+- 页面会显示任务管理界面
+
+#### 步骤5: 切换到问题管理
+- 在页面顶部找到Tab切换栏
+- 点击**"问题管理"** Tab
+- 即可进入问题管理界面
+
+## 📍 界面位置示意
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ 🌱 [智能农机] [地块信息] [农事操作] ...          👤 消息 │ ← 顶部导航
+├─────────┬───────────────────────────────────────────────┤
+│ 📂 农机档案│                                             │
+│ 👤 驾驶员档案│                                           │
+│  ├─ 信息  │   ┌─────────────────────────────────┐      │
+│  └─ 任务 ◀│   │ [任务管理] [问题管理] ⭐        │      │
+│         │   ├─────────────────────────────────┤      │
+│ 🔧 负载管理│   │                                 │      │
+│         │   │  问题管理界面                    │      │
+│ 📡 实时监控│   │                                 │      │
+│         │   │  [统计卡片]                     │      │
+│ ⚠️ 故障预警│   │  [筛选工具]                     │      │
+│         │   │  [问题列表]                     │      │
+│ 🎯 精准作业│   │                                 │      │
+│         │   └─────────────────────────────────┘      │
+│ 📊 数据分析│                                            │
+│         │                                            │
+│ 📅 管理调度│                                            │
+│         │                                            │
+│ 🛡️ 安全防护│                                            │
+└─────────┴────────────────────────────────────────────┘
+    ↑
+  左侧菜单
+```
+
+## 🎨 视觉识别
+
+### 顶部导航栏
+- **位置**: 页面最顶部
+- **颜色**: 绿色背景
+- **标识**: "智能农机管理系统" - 第1个Tab
+
+### 左侧菜单
+- **位置**: 页面左侧
+- **图标**: 👤 驾驶员图标
+- **文字**: "驾驶员档案" → "驾驶员任务管理"
+
+### Tab切换栏
+- **位置**: 主内容区顶部
+- **样式**: 下划线样式的Tab
+- **选项**: 
+  - "任务管理" - 原有功能
+  - "问题管理" - ⭐ 新功能（右侧）
+
+## 🔑 快捷方式
+
+### 浏览器地址栏
+虽然系统使用状态管理而非真实路由，但可以记住以下路径标识：
+```
+activeTab = 'machinery'
+activePath = '/machinery/driver/task'
+```
+
+### 菜单快速定位
+1. **顶部导航**: 第1个Tab（智能农机管理系统）
+2. **左侧菜单**: 第2组（驾驶员档案）
+3. **子菜单**: 第2项（驾驶员任务管理）
+4. **内部Tab**: 第2个Tab（问题管理）
+
+## 📝 功能检查清单
+
+访问问题管理后，你应该能看到：
+
+- [ ] 页面顶部有"问题管理"标题
+- [ ] 下方有"查看和处理任务执行中上报的问题"副标题
+- [ ] 4个统计卡片（问题总数/待处理/处理中/已解决）
+- [ ] 筛选工具栏（状态/类型/搜索框）
+- [ ] 问题列表表格
+
+如果看到以上内容，说明已成功进入问题管理功能！
+
+## ❓ 常见问题
+
+### Q1: 找不到"驾驶员任务管理"菜单项？
+**A**: 
+1. 确认已选中顶部的"智能农机管理系统" Tab
+2. 确认左侧菜单已展开"驾驶员档案"
+3. 如果菜单是收起状态，点击左侧的展开按钮
+
+### Q2: 点击后看不到"问题管理" Tab？
+**A**: 
+1. 确认已进入"驾驶员任务管理"页面
+2. 查看页面顶部是否有Tab切换栏
+3. 如果只看到任务列表，刷新页面试试
+
+### Q3: "问题管理" Tab 是灰色无法点击？
+**A**: 
+这种情况不应该发生，如果出现请：
+1. 刷新浏览器页面
+2. 清除浏览器缓存
+3. 检查是否有JavaScript错误
+
+### Q4: 进入后列表是空的？
+**A**: 
+这是正常的，说明：
+1. 系统中还没有上报的问题
+2. 可以从"任务管理" Tab 的任务中上报问题
+3. 系统已有3条样例问题数据（待处理1条，已解决2条）
+
+### Q5: 样例数据在哪里？
+**A**: 
+样例问题数据包含在任务样例数据中：
+1. 清空 localStorage（F12 → Application → Local Storage → Clear All）
+2. 刷新页面
+3. 系统会自动初始化12条任务样例（包含3条问题）
+
+## 🎓 首次使用建议
+
+### 第一次访问
+1. **先查看统计**: 了解当前有多少问题
+2. **尝试筛选**: 测试状态和类型筛选
+3. **查看详情**: 点击"查看"按钮了解问题详情
+4. **尝试处理**: 找一个待处理问题，体验处理流程
+
+### 了解样例数据
+访问 `/components/machinery/driver/TASK_SAMPLE_DATA.md` 查看：
+- 12条任务样例说明
+- 3条问题样例详情
+- 数据结构说明
+
+### 学习使用技巧
+访问 `/components/machinery/driver/ISSUE_MANAGEMENT_GUIDE.md` 了解：
+- 详细功能说明
+- 使用场景示例
+- 最佳实践建议
+
+## 📱 移动端访问
+
+如果使用移动设备访问：
+1. 左侧菜单会自动适配为抽屉式
+2. 统计卡片会垂直排列
+3. 表格会支持横向滚动
+4. Tab切换栏保持水平布局
+
+## 🔧 开发者信息
+
+### 相关组件
+- **入口组件**: `/components/machinery/driver/DriverTaskManagement.tsx`
+- **问题管理**: `/components/machinery/driver/IssueManagement.tsx`
+- **任务管理**: `/components/machinery/driver/DriverTask.tsx`
+
+### 路由配置
+- **系统Tab**: `machinery`
+- **菜单路径**: `/machinery/driver/task`
+- **组件渲染**: `DriverTaskManagement`
+
+### 数据存储
+- **存储位置**: `localStorage`
+- **存储Key**: `smart_agriculture_driver_tasks`
+- **数据格式**: JSON
+
+## 📞 技术支持
+
+如果遇到问题：
+1. 查看浏览器控制台是否有错误
+2. 确认系统版本是否为 v1.2+
+3. 参考详细文档排查问题
+
+---
+
+**文档版本**: v1.0  
+**创建日期**: 2025-10-16  
+**适用版本**: 系统 v1.2+  
+**更新内容**: 问题管理功能访问指南