# 🚀 智能决策生成系统 - 快速入门指南

## 📋 核心概念（5分钟理解）

### 三大模块

```
🎯 业务融合 = 决策管理中心
   功能: 生成决策、管理决策、执行决策
   数据: 真实环境数据
   执行: 真实控制物联网设备
   
🧪 决策模拟 = 测试验证中心
   功能: 模拟测试决策效果
   数据: 测试数据
   执行: 不真实执行，只模拟
   
📝 决策日志 = 执行记录中心
   功能: 记录所有真实执行
   数据: 来自业务融合的执行记录
   用途: 查询、分析、追溯
```

### 关键区别

| | 业务融合 | 决策模拟 |
|---|---|---|
| **执行** | ✅ 真实执行 | ❌ 模拟执行 |
| **设备** | ✅ 控制设备 | ❌ 不控制 |
| **风险** | ⚠️ 有风险 | ✅ 无风险 |
| **日志** | ✅ 记录 | ❌ 不记录 |

---

## 🎯 业务融合 - 核心功能

### 功能1: 自动生成决策

**什么时候用？**
- 系统持续监测环境数据
- 发现异常情况（如土壤湿度低）
- 自动分析并生成决策

**怎么生成？**
```
步骤1: 收集数据
├─ 环境监测数据（温度、湿度等）
├─ 模型预测结果
└─ 历史记录

步骤2: AI分析
├─ 模型分析: 土壤湿度35%，低于标准
├─ 规则匹配: 触发"开花期灌溉规则"
├─ 上下文验证: 天气无雨，蒸发量大
└─ 融合计算: 综合置信度89%

步骤3: 生成决策
└─ "3号大棚灌溉决策"
    ├─ 推荐: 今晚17:00灌溉120升
    ├─ 执行步骤: 共5个步骤
    └─ 目标设备: 灌溉控制器-01, 水泵-A2
```

**特点**：
- ✅ 基于科学分析
- ✅ 有完整融合过程
- ✅ 有置信度评分

### 功能2: 手动添加决策

**什么时候用？**
- 遇到特殊情况
- 基于人工经验判断
- 临时性决策

**怎么添加？**
```
步骤1: 点击"手动添加决策"按钮

步骤2: 填写表单
├─ 决策名称: 人工病虫害防治决策
├─ 决策级别: 一般
├─ 执行模式: 手动执行 / 自动执行
├─ 推荐建议: 采用生物防治...
├─ 执行步骤: 
│   1. 采购药剂
│   2. 配制药液
│   3. 喷洒作物
└─ 目标设备: 喷雾设备-01

步骤3: 保存决策
└─ 决策添加到列表中
```

**特点**：
- ✅ 快速灵活
- ✅ 基于人工经验
- ✅ 可以编辑修改

### 功能3: 手动执行

**什么时候用？**
- 需要人工确认的决策
- 重要操作需要审批
- 临时性执行

**怎么执行？**
```
步骤1: 在决策列表中找到决策
└─ 例如: "人工病虫害防治决策"

步骤2: 点击"执行"按钮

步骤3: 查看二次确认对话框
├─ 决策信息: 名称、级别、置信度
├─ 目标设备: 将控制哪些设备
├─ 执行步骤: 将执行哪些操作
└─ ⚠️ 警告提示

步骤4: 点击"确认执行"

步骤5: 系统执行决策
├─ 控制物联网设备
├─ 按步骤执行操作
└─ 显示执行进度

步骤6: 查看执行结果
├─ 执行状态: 成功/失败
├─ 受影响设备
├─ 执行指标
└─ 后续建议

步骤7: 自动记录到决策日志
```

**安全机制**：
- ✅ 二次确认
- ✅ 显示详细信息
- ✅ 可以取消

### 功能4: 自动执行

**什么时候用？**
- 紧急情况需要快速响应
- 常规周期性操作
- 无人值守场景

**怎么设置？**
```
方法1: 创建自动执行决策（手动添加时）
├─ 执行模式选择"自动执行"
├─ 设置触发条件:
│   ├─ 触发类型: 阈值触发
│   ├─ 字段: 土壤湿度
│   ├─ 操作符: <
│   └─ 值: 30
└─ 保存决策

方法2: 编辑现有决策
├─ 点击决策的"编辑"按钮
├─ 修改执行模式为"自动执行"
├─ 设置触发条件
└─ 保存修改
```

**自动执行流程**：
```
系统持续监测
└─ 土壤湿度传感器: 当前28%

条件判断
└─ 28% < 30%? 是！触发条件满足

自动执行
├─ 无需人工干预
├─ 立即执行决策
├─ 控制设备: 灌溉控制器-01, 水泵-A2
└─ 灌溉120升

记录日志
├─ 执行类型: 自动执行
├─ 触发条件: 土壤湿度28%<30%
├─ 执行时间: 2024-10-23 14:20:34
└─ 执行结果: 成功
```

**触发条件类型**：
```
① 阈值触发
   例如: 土壤湿度<30%, 温度>35℃
   
② 时间触发
   例如: 每天17:00, 每周一09:00
   
③ 事件触发
   例如: 温度突降>5℃, 湿度突增>20%
```

---

## 🧪 决策模拟 - 核心功能

### 什么是决策模拟？

**简单理解**：
```
就像玩游戏的"沙盒模式"
✅ 可以随便测试
✅ 不会影响真实环境
✅ 验证方案是否可行
```

### 使用场景

```
场景1: 验证新方案
├─ 问题: 想尝试新的灌溉策略，但不确定效果
└─ 方案: 用决策模拟先测试

场景2: 对比多个方案
├─ 问题: 有3个防治病虫害的方案，不知道选哪个
└─ 方案: 分别模拟，对比结果

场景3: 极端情况测试
├─ 问题: 如果遇到极端高温，应该怎么办？
└─ 方案: 模拟高温场景，验证决策
```

### 使用流程

```
步骤1: 创建模拟场景
├─ 进入"决策模拟"模块
├─ 点击"创建场景"
├─ 填写信息:
│   ├─ 场景名称: 高温干旱场景
│   ├─ 测试数据:
│   │   ├─ 温度: 35℃
│   │   ├─ 湿度: 20%
│   │   └─ 天气: 无降雨
│   └─ 预期决策: 灌溉决策
└─ 保存场景

步骤2: 运行模拟
├─ 选择场景: 高温干旱场景
├─ 点击"运行模拟"
└─ 等待模拟完成（通常2-3秒）

步骤3: 查看模拟结果
├─ 模拟决策: 建议立即灌溉120升
├─ 预期效果: 湿度提升至60%
├─ 资源消耗: 用水120升
├─ 风险评估: 低风险
└─ 推荐指数: ★★★★★

步骤4: 结果对比（可选）
├─ 创建多个场景
├─ 分别运行模拟
├─ 在"结果对比"Tab中对比
└─ 选择最优方案

步骤5: 应用到生产（可选）
├─ 确认方案可行后
├─ 点击"应用到生产环境"
└─ 在业务融合中创建真实决策
```

### ⚠️ 重要提示

```
❌ 模拟不会真实执行！
   - 不会控制物联网设备
   - 不会影响实际生产
   - 不会记录到决策日志
   
✅ 模拟结果仅供参考
   - 用于验证方案可行性
   - 用于对比不同方案
   - 真实执行请在业务融合中操作
```

---

## 📝 决策日志 - 核心功能

### 什么是决策日志？

**简单理解**：
```
就像一本"执行记录簿"
✅ 记录每次执行的详细信息
✅ 可以随时查询
✅ 可以追溯分析
```

### 记录什么？

```
手动执行记录:
├─ 执行ID: exec_1729659180
├─ 决策名称: 人工病虫害防治决策
├─ 执行类型: 👤 手动执行
├─ 操作人: 张三
├─ 执行时间: 2024-10-23 13:15:20
├─ 执行结果: ✅ 成功
├─ 受影响设备: 喷雾设备-01
├─ 执行指标: 喷洒面积5亩，用药3kg
└─ 备注: 病虫害已得到控制

自动执行记录:
├─ 执行ID: exec_1729659234
├─ 决策名称: 3号大棚灌溉决策
├─ 执行类型: ⚡ 自动执行
├─ 触发条件: 土壤湿度<30%
├─ 触发时环境: 湿度28%, 温度32℃
├─ 执行时间: 2024-10-23 14:20:34
├─ 执行结果: ✅ 成功
├─ 受影响设备: 灌溉控制器-01, 水泵-A2
└─ 执行指标: 灌溉量120升, 湿度35%→62%
```

### 使用场景

```
场景1: 查询历史执行
问题: 上周三有没有浇水？
操作:
├─ 进入决策日志
├─ 筛选日期: 上周三
├─ 搜索决策: 灌溉
└─ 查看结果

场景2: 分析自动执行
问题: 自动执行的效果怎么样？
操作:
├─ 切换到"自动执行"Tab
├─ 查看执行列表
├─ 分析成功率
└─ 查看触发条件是否合理

场景3: 追溯问题
问题: 为什么昨天晚上设备启动了？
操作:
├─ 筛选时间: 昨天晚上
├─ 查看执行记录
├─ 查看触发条件
└─ 分析原因

场景4: 统计分析
问题: 哪些决策执行最频繁？
操作:
├─ 查看统计图表
├─ TOP10决策排行
├─ 设备使用频率
└─ 时间分布
```

### 筛选功能

```
按执行类型筛选:
├─ Tab: 全部日志
├─ Tab: 手动执行
└─ Tab: 自动执行

按其他条件筛选:
├─ 日期范围: 今天/本周/本月/自定义
├─ 决策名称: 灌溉/施肥/防治...
├─ 执行状态: 成功/失败/部分成功
├─ 操作人: 张三/李四...
└─ 设备: 灌溉控制器-01...
```

---

## 💡 最佳实践

### 1. 新方案测试流程

```
✅ 推荐做法:
1. 决策模拟: 创建场景，模拟测试
2. 分析结果: 查看预期效果
3. 对比方案: 如有多个方案，对比选择
4. 业务融合: 创建真实决策（手动添加）
5. 小范围试验: 先手动执行，观察效果
6. 推广应用: 效果好，可设置自动执行

❌ 不推荐:
直接在业务融合中执行未测试的方案
```

### 2. 自动执行设置建议

```
✅ 适合自动执行:
- 常规灌溉（触发条件明确）
- 温度调控（实时响应）
- 通风控制（及时调节）

❌ 不建议自动执行:
- 复杂决策（需要人工判断）
- 风险较高的操作
- 临时性处理

⚠️ 设置自动执行前:
1. 在决策模拟中充分测试
2. 设置合理的触发条件
3. 先小范围试运行
4. 定期检查决策日志
```

### 3. 日志查询习惯

```
建议养成习惯:
✅ 每天查看一次决策日志
✅ 关注自动执行记录
✅ 分析失败记录原因
✅ 定期导出重要日志

重点关注:
⚠️ 自动执行失败记录
⚠️ 频繁触发的自动执行
⚠️ 异常时间段的执行
```

---

## 🎓 典型案例

### 案例1: 智能灌溉（自动生成+自动执行）

```
背景:
- 种植番茄，对水分敏感
- 需要及时灌溉

解决方案:
1. 系统自动监测土壤湿度
2. 湿度<30%时，自动生成灌溉决策
3. 设置自动执行，触发条件: 湿度<30%
4. 每次自动执行后，记录日志
5. 定期查看日志，分析效果

效果:
✅ 及时响应，无需人工值守
✅ 避免干旱，提高产量
✅ 节省人力成本
```

### 案例2: 病虫害防治（手动添加+手动执行）

```
背景:
- 发现病虫害
- 需要人工判断防治方案

解决方案:
1. 技术员巡查发现早疫病
2. 手动添加决策: "早疫病生物防治"
3. 填写详细的执行步骤
4. 设置为手动执行
5. 准备就绪后，点击"执行"
6. 系统记录执行过程

效果:
✅ 快速响应突发情况
✅ 保留人工判断空间
✅ 执行过程可追溯
```

### 案例3: 新方案验证（决策模拟）

```
背景:
- 想尝试新的施肥方案
- 不确定效果

解决方案:
1. 在决策模拟中创建场景
2. 设置测试数据（土壤养分、作物生长期等）
3. 模拟3个不同的施肥方案
4. 对比结果:
   - 方案A: 效果好，成本高
   - 方案B: 效果中等，成本适中
   - 方案C: 效果一般，成本低
5. 选择方案B
6. 在业务融合中创建真实决策
7. 先手动执行一次，观察效果
8. 效果良好，设置为自动执行

效果:
✅ 降低试错成本
✅ 科学选择方案
✅ 提高成功率
```

---

## ❓ 常见问题

### Q1: 决策模拟和业务融合有什么区别？

```
A: 最关键的区别是:
- 决策模拟: 不真实执行，只模拟结果
- 业务融合: 真实执行，会控制设备

举例:
- 模拟灌溉: 不会真的开启水泵
- 执行灌溉: 会真的开启水泵

建议:
✅ 新方案先在模拟中测试
✅ 确认可行后再在业务融合中真实执行
```

### Q2: 什么时候用自动执行，什么时候用手动执行？

```
A: 
自动执行适合:
✅ 触发条件明确（如湿度<30%）
✅ 需要快速响应（如温度突变）
✅ 常规周期性操作（如定时通风）

手动执行适合:
✅ 需要人工判断（如病虫害防治）
✅ 风险较高的操作
✅ 临时性决策

建议:
⚠️ 自动执行前先用模拟测试
⚠️ 自动执行后定期检查日志
```

### Q3: 决策日志可以删除吗？

```
A: 
建议不要删除，原因:
✅ 日志用于追溯分析
✅ 出现问题时可以回溯
✅ 统计分析需要历史数据

如果确实需要清理:
- 可以导出备份
- 只删除很久以前的日志
- 保留至少3-6个月的记录
```

### Q4: 如何查看自动执行的触发条件？

```
A: 
方法1: 在决策列表中查看
├─ 进入业务融合
├─ 找到自动执行的决策
└─ 卡片上会显示触发条件

方法2: 在决策日志中查看
├─ 进入决策日志
├─ 切换到"自动执行"Tab
├─ 查看执行记录
└─ 会显示触发时的条件和环境值
```

---

## 🎯 5分钟上手清单

### 第1分钟: 了解布局
```
✅ 进入"AI作物模型"系统
✅ 点击"智能决策生成"
✅ 查看3个子模块: 业务融合、决策模拟、决策日志
```

### 第2分钟: 查看现有决策
```
✅ 进入"业务融合"
✅ 查看决策列表
✅ 注意决策的来源（自动生成/手动添加）
✅ 注意执行模式（手动执行/自动执行）
```

### 第3分钟: 测试手动添加
```
✅ 点击"手动添加决策"按钮
✅ 填写一个简单的测试决策
✅ 保存并查看效果
```

### 第4分钟: 测试决策模拟
```
✅ 进入"决策模拟"
✅ 创建一个测试场景
✅ 运行模拟
✅ 查看结果
```

### 第5分钟: 查看决策日志
```
✅ 进入"决策日志"
✅ 查看历史执行记录
✅ 切换不同Tab（全部/手动/自动）
✅ 尝试筛选功能
```

---

## 📚 下一步

### 进阶学习
- [ ] 阅读完整文档: [DECISION_GENERATION_SYSTEM_OVERVIEW.md](./DECISION_GENERATION_SYSTEM_OVERVIEW.md)
- [ ] 查看实施方案: [DECISION_SYSTEM_RESTRUCTURE.md](./DECISION_SYSTEM_RESTRUCTURE.md)
- [ ] 了解技术细节: [FUSION_RESTRUCTURE_IMPLEMENTATION.md](./FUSION_RESTRUCTURE_IMPLEMENTATION.md)

### 实践建议
1. 先熟悉现有决策
2. 尝试创建模拟场景
3. 测试手动添加决策
4. 小范围试用自动执行
5. 定期查看决策日志

---

**创建时间**: 2024-10-23  
**适用人群**: 所有用户  
**预计阅读时间**: 15分钟
