# 土壤基础数据 - 新增/编辑/删除功能使用指南

## 功能概述

土壤基础数据管理系统现已完整支持采样点的**新增**、**编辑**、**删除**功能，提供完整的CRUD操作。

## 📋 功能清单

### ✅ 新增采样点
- 完整的表单验证
- GPS地图选点功能
- 动态分层数据录入
- 支持添加/删除土层

### ✅ 编辑采样点
- 加载现有数据到表单
- 修改所有字段（包括GPS坐标）
- 修改分层数据
- 实时更新地图位置

### ✅ 删除采样点
- 确认对话框防止误删
- 删除所有相关数据
- Toast提示操作结果

## 🎯 使用方法

### 1. 新增采样点

#### 步骤：
1. 点击右上角 **"新增采样点"** 按钮
2. 填写基本信息：
   - **采样点编号** * (必填，如: SP004)
   - **所属地块** * (必填，如: 东区1号地)
   - **采样日期** * (必填，选择日期)
   - **采样人** * (必填，如: 张三)

3. 设置GPS坐标：
   - **方法1**: 在地图上点击选择位置
   - **方法2**: 手动输入纬度和经度
   - 地图会自动标记所选位置

4. 录入分层数据：
   - 默认提供3层（0-20cm、20-40cm、40-60cm）
   - 每层需填写：
     - 深度范围
     - pH值（0-14）
     - 有机质 (g/kg)
     - 全氮 (g/kg)
     - 有效磷 (mg/kg)
     - 速效钾 (mg/kg)
     - 含水量 (%)
   - 可点击 **"添加土层"** 增加新层
   - 可点击每层右上角的 **X** 删除该层（至少保留1层）

5. 点击 **"保存采样点"** 完成添加

#### 验证规则：
- ✅ 所有标记 * 的字段必须填写
- ✅ GPS坐标不能为 (0, 0)
- ✅ 必须在地图上选择实际位置或手动输入坐标
- ❌ 如果验证失败，会显示错误提示

### 2. 编辑采样点

#### 步骤：
1. 在采样点列表中找到要编辑的采样点
2. 点击该采样点卡片右侧的 **编辑按钮**（铅笔图标）
3. 编辑对话框会自动加载该采样点的所有数据：
   - 基本信息
   - GPS坐标（地图会显示当前位置）
   - 所有分层数据

4. 修改需要更改的字段：
   - 可以修改采样点编号、地块、日期、采样人
   - 可以在地图上重新选择GPS位置
   - 可以修改任意层的理化指标数据
   - 可以添加新土层或删除现有土层

5. 点击 **"更新采样点"** 保存修改

#### 特点：
- 🔄 所有现有数据都会预填充到表单中
- 📍 地图会自动定位到采样点的GPS坐标
- ✏️ 支持修改所有字段，包括坐标和分层数据
- 💾 验证规则与新增相同

### 3. 删除采样点

#### 步骤：
1. 在采样点列表中找到要删除的采样点
2. 点击该采样点卡片右侧的 **删除按钮**（垃圾桶图标）
3. 系统会弹出确认对话框：
   - 标题：**"确认删除采样点"**
   - 说明：此操作将删除该采样点的所有数据，包括分层信息和理化指标，且无法恢复

4. 选择操作：
   - 点击 **"取消"** - 取消删除，关闭对话框
   - 点击 **"确认删除"** - 执行删除操作

5. 删除成功后会显示提示："采样点已删除"

#### 安全措施：
- ⚠️ 双重确认机制，防止误删
- 🔒 删除后数据无法恢复
- 📢 操作结果即时反馈

### 4. 查看剖面数据

#### 步骤：
1. 点击采样点卡片右侧的 **"查看剖面"** 按钮
2. 弹出剖面数据对话框，显示：
   - 采样点基本信息
   - 完整的分层数据表格
   - 所有理化指标详情

#### 特点：
- 📊 以表格形式清晰展示所有分层数据
- 📋 包含所有理化指标的单位
- 👁️ 只读模式，不可编辑（需编辑请使用编辑功能）

## 💡 操作技巧

### GPS坐标选择
1. **地图选点优先**：在地图上点击最准确
2. **缩放地图**：使用鼠标滚轮或缩放按钮调整地图比例
3. **拖动地图**：找到精确位置再点击
4. **手动输入**：如果知道精确坐标，可直接输入（精确到小数点后6位）

### 分层数据管理
1. **标准分层**：农业土壤一般采用 0-20cm、20-40cm、40-60cm 三层
2. **自定义分层**：可根据实际情况添加更多层或调整深度
3. **数据完整性**：建议每层的所有理化指标都填写完整
4. **数值范围**：
   - pH值：0-14（农业土壤通常在 4.5-8.5）
   - 有机质：通常 10-50 g/kg
   - 全氮：通常 0.5-2.5 g/kg
   - 有效磷：通常 5-50 mg/kg
   - 速效钾：通常 50-300 mg/kg
   - 含水量：0-100%

### 数据录入建议
1. **先基本后详细**：先填写必填项，再补充分层数据
2. **现场采集**：建议使用移动设备在采样现场直接录入
3. **GPS定位**：确保GPS坐标准确，便于后续空间分析
4. **及时保存**：填写完成后及时保存，避免数据丢失

## 🎨 界面元素说明

### 采样点列表卡片
每个采样点卡片显示：
- 📍 **左上角**：采样点编号 + 地块名称徽章
- 📊 **中间区域**：采样日期、采样人、分层数、表层pH值
- 🌿 **表层指标快览**：有机质、全氮、有效磷、速效钾、含水量
- 🔘 **右侧按钮**：
  - 蓝色"查看剖面"按钮（图层图标）
  - 灰色"编辑"按钮（铅笔图标）
  - 红色"删除"按钮（垃圾桶图标）

### 新增/编辑对话框
- **大对话框**：宽度6xl，支持滚动
- **三个主要区域**：
  1. 基本信息（2列网格）
  2. GPS坐标（地图选点器）
  3. 分层数据（可折叠卡片）
- **操作按钮**：
  - 左侧："取消"
  - 右侧：绿色"保存/更新采样点"

### 删除确认对话框
- **警告样式**：红色强调
- **清晰说明**：提示数据无法恢复
- **双按钮**：取消 / 确认删除

## 📱 响应式设计

- **桌面端**：完整功能，最佳体验
- **平板端**：自适应布局
- **移动端**：垂直排列，保持所有功能可用

## ⚡ 快捷操作

| 操作 | 快捷方式 |
|------|---------|
| 打开新增对话框 | 点击右上角"新增采样点" |
| 编辑采样点 | 卡片右侧铅笔图标 |
| 删除采样点 | 卡片右侧垃圾桶图标 |
| 查看剖面 | 卡片右侧"查看剖面"按钮 |
| 添加土层 | 对话框中"添加土层"按钮 |
| 删除土层 | 土层卡片右上角 X |

## 🔍 数据验证

### 新增/编辑时的验证
```
✅ 采样点编号不能为空
✅ 所属地块不能为空
✅ 采样日期不能为空
✅ 采样人不能为空
✅ GPS坐标必须选择（纬度和经度不能为0）
✅ 数值型字段自动验证（pH、有机质等）
```

### 删除时的验证
```
⚠️ 显示确认对话框
⚠️ 说明数据无法恢复
⚠️ 需要用户明确确认
```

## 🎯 最佳实践

### 1. 新增采样点时
- 使用有意义的编号规则（如：SP001, SP002）
- 在采样现场立即录入数据
- 使用地图选点功能确保坐标准确
- 完整填写所有理化指标
- 记录详细的采样日期和采样人

### 2. 编辑采样点时
- 仔细检查要修改的内容
- 如果修改GPS坐标，确认新位置是否正确
- 修改分层数据时注意单位
- 保存前再次确认所有修改

### 3. 删除采样点时
- 确认不再需要该数据
- 考虑是否需要先导出数据备份
- 仔细阅读删除确认提示
- 确认后数据无法恢复

## 🚀 后续增强建议

- [ ] 批量导入采样点数据
- [ ] 采样点数据历史版本管理
- [ ] 与实验室检测系统集成
- [ ] 移动端App支持离线录入
- [ ] 智能推荐采样密度
- [ ] 数据质量检查和异常值提醒

## 📞 技术支持

如遇到问题，请检查：
1. 是否所有必填字段都已填写
2. GPS坐标是否有效（不为0,0）
3. 数值是否在合理范围内
4. 浏览器控制台是否有错误信息

---

**版本**: v1.0.0
**最后更新**: 2025-10-18
**系统**: 智慧农业生产管理系统 - 地块信息管理 - 土壤基础数据