cavin/smart-crop-ui
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5d34bc3643c86a09fdb42a690fa55a044843fd90
smart-crop-ui/src/SOIL_DATA_CRUD_GUIDE.md

7.7 KiB
Raw Blame History

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

功能概述

土壤基础数据管理系统现已完整支持采样点的新增、编辑、删除功能，提供完整的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 系统: 智慧农业生产管理系统 - 地块信息管理 - 土壤基础数据