生产管理系统前端 - 更新瓦力提交的产品原型到参考目录
This commit is contained in:
125
src/FIELD_VERSION_QUICK_START.md
Normal file
125
src/FIELD_VERSION_QUICK_START.md
Normal file
@@ -0,0 +1,125 @@
|
||||
# 地块版本历史 - 快速开始
|
||||
|
||||
## 🎯 快速访问
|
||||
|
||||
### 步骤1:进入地块档案管理
|
||||
1. 点击顶部导航栏的 **"地块信息"** 标签
|
||||
2. 在左侧菜单选择 **地块档案管理 → 地块档案维护**
|
||||
|
||||
### 步骤2:查看版本历史
|
||||
1. 在地块列表中找到任意地块
|
||||
2. 点击该地块右侧的 **蓝色版本历史图标**(History图标)
|
||||
3. 版本历史对话框将弹出
|
||||
|
||||
## 📊 示例数据说明
|
||||
|
||||
系统已自动为前3个地块生成了**8条版本记录**,包括:
|
||||
|
||||
| 版本 | 变更类型 | 主要内容 | 操作人 |
|
||||
|------|----------|----------|--------|
|
||||
| V1 | 创建 | 初始创建地块 | 系统管理员 |
|
||||
| V2 | 属性更新 | 完善权属信息,更新面积 | 王芳 |
|
||||
| V3 | 属性更新 | 添加标签(高产田、水源充足) | 李明 |
|
||||
| V4 | 边界更新 | RTK重新测绘,边界更精确 | 测绘组-赵强 |
|
||||
| V5 | 属性更新 | 更新土壤类型,补充地形数据 | 农技员-孙莉 |
|
||||
| V6 | 属性更新 | 建设大棚,改变种植模式 | 张三 |
|
||||
| V7 | 属性更新 | 补充坡向信息 | 农技员-孙莉 |
|
||||
| V8 | 属性更新 | 更新联系电话 | 系统管理员 |
|
||||
|
||||
## 🔍 查看版本详情
|
||||
|
||||
在版本列表中,点击任一版本的 **"查看详情"** 按钮,可以看到:
|
||||
|
||||
- 📝 **变更字段**:哪些信息发生了变化
|
||||
- 🔄 **变更前后对比**:清晰看到修改内容
|
||||
- 👤 **操作人和时间**:谁在什么时候做了修改
|
||||
- 💬 **变更备注**:变更原因说明
|
||||
|
||||
## 💡 功能亮点
|
||||
|
||||
### 1. 自动记录
|
||||
所有地块的修改都会自动记录版本,无需手动操作
|
||||
|
||||
### 2. 完整追溯
|
||||
从创建到每一次修改,完整记录地块的演变历史
|
||||
|
||||
### 3. 清晰对比
|
||||
变更前后的值并排显示,一目了然
|
||||
|
||||
### 4. 多维统计
|
||||
- 总版本数
|
||||
- 各类型变更次数
|
||||
- 最后更新时间
|
||||
|
||||
### 5. 中文显示
|
||||
所有字段名都用中文显示,易于理解
|
||||
|
||||
## 🎨 颜色标识
|
||||
|
||||
版本类型通过颜色徽章区分:
|
||||
|
||||
- 🟢 **绿色** - 创建
|
||||
- 🔵 **蓝色** - 属性更新
|
||||
- 🟣 **紫色** - 边界更新
|
||||
- 🟠 **橙色** - 合并
|
||||
- 🔴 **红色** - 拆分
|
||||
|
||||
## 📌 实际应用场景
|
||||
|
||||
### 场景1:边界纠错
|
||||
地块测绘发现偏差,使用RTK重新测量后更新边界
|
||||
→ 版本历史中会记录边界点的变化和面积调整
|
||||
|
||||
### 场景2:权属变更
|
||||
承包人信息变化或新办理确权证
|
||||
→ 版本历史中会记录权属人、证书号等变化
|
||||
|
||||
### 场景3:用途调整
|
||||
从露地种植改为温室大棚
|
||||
→ 版本历史中会记录种植模式的变化
|
||||
|
||||
### 场景4:信息完善
|
||||
补充土壤检测结果、地形数据等
|
||||
→ 版本历史中会记录新增的属性信息
|
||||
|
||||
## 🛠️ 开发者工具
|
||||
|
||||
打开浏览器控制台(F12),可以执行以下操作:
|
||||
|
||||
### 查看版本数据
|
||||
```javascript
|
||||
// 查看某个地块的所有版本
|
||||
const versions = JSON.parse(localStorage.getItem('field_versions_1'));
|
||||
console.table(versions);
|
||||
```
|
||||
|
||||
### 重新生成示例数据
|
||||
```javascript
|
||||
// 清除并重新生成
|
||||
localStorage.removeItem('field_versions_1');
|
||||
// 刷新页面即可自动重新生成
|
||||
```
|
||||
|
||||
## ❓ 常见问题
|
||||
|
||||
### Q1: 为什么看不到版本历史?
|
||||
A: 只有前3个地块有示例数据。新创建的地块在首次编辑后才会有版本记录。
|
||||
|
||||
### Q2: 如何删除版本历史?
|
||||
A: 删除地块时,其版本历史会自动删除。
|
||||
|
||||
### Q3: 版本号会重复吗?
|
||||
A: 不会,版本号从1开始递增,永不重复。
|
||||
|
||||
### Q4: 可以恢复到历史版本吗?
|
||||
A: 当前版本支持查看历史,后续可扩展恢复功能。
|
||||
|
||||
## 📖 相关文档
|
||||
|
||||
- 详细功能说明:`FIELD_VERSION_SAMPLES_GUIDE.md`
|
||||
- 技术实现:查看 `/lib/fieldVersionManager.ts`
|
||||
- UI组件:查看 `/components/field/FieldVersionHistory.tsx`
|
||||
|
||||
---
|
||||
|
||||
**提示**:版本历史是地块管理的重要功能,能够帮助您追溯地块信息的变更历史,满足审计和质量管理需求。
|
||||
Reference in New Issue
Block a user