生产管理系统前端 - 更新瓦力提交的产品原型到参考目录
This commit is contained in:
253
src/SOIL_DATA_CRUD_GUIDE.md
Normal file
253
src/SOIL_DATA_CRUD_GUIDE.md
Normal file
@@ -0,0 +1,253 @@
|
||||
# 土壤基础数据 - 新增/编辑/删除功能使用指南
|
||||
|
||||
## 功能概述
|
||||
|
||||
土壤基础数据管理系统现已完整支持采样点的**新增**、**编辑**、**删除**功能，提供完整的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
|
||||
**系统**: 智慧农业生产管理系统 - 地块信息管理 - 土壤基础数据
|
||||
Reference in New Issue
Block a user