# 地块版本历史 - 快速开始

## 🎯 快速访问

### 步骤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`

---

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