Files
smart-crop-ui/src/FIELD_VERSION_QUICK_START.md

3.8 KiB
Raw Blame History

地块版本历史 - 快速开始

🎯 快速访问

步骤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可以执行以下操作

查看版本数据

// 查看某个地块的所有版本
const versions = JSON.parse(localStorage.getItem('field_versions_1'));
console.table(versions);

重新生成示例数据

// 清除并重新生成
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

提示:版本历史是地块管理的重要功能,能够帮助您追溯地块信息的变更历史,满足审计和质量管理需求。