# 采购计划功能完整指南

## 📋 功能概述

采购管理模块已完成以下三大核心功能的开发：

### 1. 智能采购建议 - 勾选保存功能 ✅
### 2. 采购计划 - 查看功能 ✅  
### 3. 采购计划 - 编辑功能 ✅

---

## 🎯 功能详细说明

### 一、智能采购建议 - 勾选保存

#### 功能特点
- **智能分析**: 系统根据库存状态、种植计划需求和市场行情自动生成采购建议
- **灵活勾选**: 用户可以自由勾选/取消勾选任意建议项
- **全选/取消全选**: 快速操作批量选择
- **实时统计**: 动态显示已选择的物料数量和预计总金额
- **可视化反馈**: 选中的物料卡片有绿色边框高亮显示

#### 操作步骤
1. 进入 **资产管理** → **采购管理** → **采购计划** 标签页
2. 点击右上角 **"智能生成采购建议"** 按钮
3. 系统自动分析并生成采购建议（默认全选所有物料）
4. 根据实际需求，勾选或取消勾选具体物料：
   - 点击物料卡片左侧的复选框进行单项选择
   - 点击右上角 **"全选"/"取消全选"** 按钮批量操作
5. 已选物料会有绿色边框高亮，未选物料为普通边框
6. 底部实时显示：已选择 X 项物料，预计总金额 ¥XXX
7. 填写计划名称等基本信息
8. 点击 **"创建采购计划 (X项)"** 按钮保存（仅保存勾选的物料）

#### 界面元素
```
┌─────────────────────────────────────────────┐
│ 建议采购物料清单 (7项)  已选择 5/7项 [全选] │
├─────────────────────────────────────────────┤
│ ☑ [1] 优质水稻种子  [高优先级]  ¥32,200    │  ← 已勾选（绿色边框）
│ ☑ [2] 复合肥        [中优先级]  ¥45,000    │  ← 已勾选（绿色边框）
│ ☐ [3] 尿素          [低优先级]  ¥12,000    │  ← 未勾选（普通边框）
│ ☑ [4] 吡虫啉        [高优先级]  ¥3,600     │  ← 已勾选（绿色边框）
│ ☐ [5] 除草剂        [中优先级]  ¥4,200     │  ← 未勾选（普通边框）
└─────────────────────────────────────────────┘
已选择 3 项物料，预计总金额 ¥80,800
```

#### 数据说明
- **高优先级**: 库存严重不足（低于安全库存50%）或价格上涨趋势
- **中优先级**: 库存不足或有种植需求
- **低优先级**: 其他正常采购需求

---

### 二、采购计划 - 查看功能

#### 功能特点
- **完整详情**: 展示计划的所有信息（基本信息、采购原因、市场分析、物料清单等）
- **只读模式**: 纯查看模式，不可编辑
- **清晰布局**: 信息分类展示，一目了然
- **状态展示**: 清楚显示计划当前状态和审批信息

#### 操作步骤
1. 在采购计划列表中，找到要查看的计划
2. 点击计划卡片右上角的 **眼睛图标 (👁)** 按钮
3. 弹出详情对话框，展示完整信息：
   - **基本信息**: 计划名称、编号、状态、创建人、审批人等
   - **采购原因**: 说明本次采购的背景和理由
   - **市场分析**: 当前市场行情分析（如有）
   - **物料清单**: 详细的采购物料列表，包含库存、需求、单价、金额等
   - **备注信息**: 其他补充说明
4. 查看完毕后点击 **"关闭"** 按钮

#### 界面示例
```
┌─ 采购计划详情 ─────────────────────────────────┐
│ 计划编号: PL-2024-001                          │
├────────────────────────────────────────────────┤
│ 【基本信息】                                   │
│ 计划名称: 春季水稻种植采购计划                 │
│ 计划状态: [已批准]                             │
│ 创建人: 张三    创建时间: 2024-03-01          │
│ 审批人: 李经理  审批时间: 2024-03-02          │
├────────────────────────────────────────────────┤
│ 【采购原因】                                   │
│ 春季水稻种植季节即将到来，根据种植计划...     │
├────────────────────────────────────────────────┤
│ 【市场分析】                                   │
│ 近期种子价格稳定，化肥价格小幅上涨5%...       │
├────────────────────────────────────────────────┤
│ 【采购物料清单】(5项)                         │
│ 序号 物料名称    类型  建议采购  单价   金额  │
│  1   优质水稻种子 种子  115袋   ¥280  ¥32,200 │
│  2   复合肥       化肥  250袋   ¥180  ¥45,000 │
│ ...                                            │
│ 合计:                              ¥185,000    │
└────────────────────────────────────────────────┘
```

---

### 三、采购计划 - 编辑功能

#### 功能特点
- **状态限制**: 只能编辑"草稿"或"已驳回"状态的计划
- **全面编辑**: 可修改计划名称、关联计划、原因、备注等信息
- **物料管理**: 可删除不需要的物料项
- **实时统计**: 自动计算并显示总金额
- **数据验证**: 确保必填项完整

#### 操作步骤
1. 在采购计划列表中，找到状态为"草稿"或"已驳回"的计划
2. 点击计划卡片右上角的 **铅笔图标 (✏)** 按钮
3. 在编辑对话框中修改信息：
   - **基本信息**: 修改计划名称、关联种植计划
   - **采购原因**: 更新采购理由
   - **备注**: 补充说明信息
   - **物料清单**: 点击垃圾桶图标删除不需要的物料
4. 底部实时显示物料数量和总金额
5. 点击 **"保存修改"** 按钮保存，或点击 **"取消"** 放弃修改

#### 状态限制说明
- ✅ **可编辑**: 草稿、已驳回
- ❌ **不可编辑**: 待审批、已批准、执行中、已完成

#### 界面示例
```
┌─ 编辑采购计划 ─────────────────────────────────┐
│ 计划编号: PL-2024-002 | 当前状态: 草稿         │
├────────────────────────────────────────────────┤
│ 【基本信息】                                   │
│ 计划名称: [农机设备维护用品采购___________]   │
│ 关联种植计划: [2024年春季计划____________]    │
│ 采购原因: [春季农机保养需求______________]    │
│ 备注: [_____________________________________] │
├────────────────────────────────────────────────┤
│ 【采购物料清单】(3项)                         │
│ 序号 物料名称  类型      采购量  单价  金额  操作│
│  1   机油     维护用品   60桶   ¥350  ¥21,000 [🗑] │
│  2   滤芯     维护用品   30个   ¥85   ¥2,550  [🗑] │
│  3   防冻液   维护用品   40桶   ¥120  ¥4,800  [🗑] │
│ 合计:                               ¥28,350    │
├────────────────────────────────────────────────┤
│ 共 3 项物料，合计 ¥28,350      [取消] [保存修改] │
└────────────────────────────────────────────────┘
```

---

## 🔄 完整业务流程

### 典型使用场景

```
1. 智能生成建议
   ↓
2. 勾选需要的物料（可部分选择）
   ↓
3. 创建采购计划（草稿状态）
   ↓
4. 编辑计划（修改信息、调整物料）
   ↓
5. 提交审批
   ↓
6. 审批通过
   ↓
7. 创建采购订单
   ↓
8. 订单执行...
```

---

## 💡 使用技巧

### 智能建议最佳实践
1. **优先处理高优先级物料**: 这些通常是库存严重不足或价格上涨的物料
2. **根据资金预算调整**: 如果预算有限，可以取消勾选低优先级物料
3. **考虑市场行情**: 价格下降趋势的物料可适当延后采购
4. **分批采购**: 可以将大计划拆分为多个小计划，分批执行

### 编辑计划建议
1. **驳回后修改**: 计划被驳回后，根据审批意见修改后重新提交
2. **草稿状态完善**: 先保存为草稿，逐步完善信息后再提交审批
3. **删除不需要的物料**: 如果某些物料暂时不需要，可以先删除，后续再创建新计划

### 查看计划用途
1. **审批参考**: 审批人员可通过查看功能了解详细信息
2. **执行依据**: 采购人员可查看计划详情进行采购执行
3. **历史追溯**: 事后可查看历史计划，总结经验

---

## 📊 数据统计

采购计划列表显示：
- **采购计划总数**: X 项
- **待审批计划**: X 项
- **已批准计划**: X 项
- **采购总额**: ¥X,XXX,XXX

智能建议显示：
- **高优先级物料**: X 项
- **中优先级物料**: X 项
- **低优先级物料**: X 项
- **预计总金额**: ¥X,XXX,XXX

---

## ⚠️ 注意事项

1. **编辑权限**: 只能编辑草稿或已驳回的计划，已批准的计划不能修改
2. **至少选择一项**: 创建计划时必须至少勾选一项物料
3. **必填项**: 计划名称为必填项，提交前请确保填写
4. **删除物料**: 编辑时删除物料会立即生效，请谨慎操作
5. **数据实时性**: 智能建议基于当前库存和市场数据，建议及时执行

---

## 🎨 界面说明

### 按钮图标含义
- 👁 **查看**: 查看计划详情（只读模式）
- ✏ **编辑**: 编辑计划信息（仅草稿/已驳回可用）
- 👍 **批准**: 审批通过计划
- 👎 **驳回**: 驳回计划
- 🗑 **删除**: 删除物料项

### 状态颜色
- **草稿**: 灰色
- **待审批**: 橙色
- **已批准**: 绿色
- **已驳回**: 红色
- **执行中**: 蓝色
- **已完成**: 紫色

### 优先级颜色
- **高**: 红色 - 紧急，建议立即采购
- **中**: 黄色 - 重要，建议本月采购
- **低**: 蓝色 - 正常，可按计划采购

---

## 📝 示例数据

### 示例1: 春季种植采购计划
- **计划名称**: 春季水稻种植采购计划
- **关联计划**: 2024年春季水稻种植计划
- **物料数量**: 5项
- **预计金额**: ¥185,000
- **高优先级**: 2项（水稻种子、机油）
- **中优先级**: 2项（复合肥、农药）
- **低优先级**: 1项（除草剂）

### 示例2: 设备维护采购计划
- **计划名称**: 农机设备维护用品采购
- **关联计划**: 2024年春季设备保养计划
- **物料数量**: 3项
- **预计金额**: ¥42,000
- **高优先级**: 1项（机油库存不足）
- **中优先级**: 2项（滤芯、防冻液）

---

## 🔧 技术实现

### 核心功能
1. **复选框状态管理**: 使用 `selectedSuggestionIds` 数组追踪选中项
2. **全选/取消全选**: 一键操作所有复选框状态
3. **实时统计**: 根据选中项动态计算数量和金额
4. **视觉反馈**: 选中项添加绿色边框和背景高亮
5. **对话框管理**: 独立的查看、编辑对话框组件
6. **数据验证**: 提交前验证必填项和至少选择一项

---

## ✅ 功能验证清单

### 智能建议功能
- [x] 点击"智能生成采购建议"可正常打开对话框
- [x] 默认全选所有建议项
- [x] 可以勾选/取消勾选单个物料
- [x] 全选/取消全选按钮正常工作
- [x] 选中项有绿色边框高亮
- [x] 底部统计实时更新（已选数量、金额）
- [x] 未勾选任何项时，创建按钮禁用
- [x] 只保存勾选的物料到计划

### 查看功能
- [x] 点击眼睛图标可打开详情对话框
- [x] 显示所有计划信息（基本信息、原因、市场分析、物料清单）
- [x] 数据显示完整准确
- [x] 只读模式，不可编辑

### 编辑功能
- [x] 草稿状态的计划显示编辑按钮
- [x] 已驳回的计划显示编辑按钮
- [x] 其他状态的计划不显示编辑按钮
- [x] 点击编辑按钮打开编辑对话框
- [x] 可以修改基本信息
- [x] 可以删除物料项
- [x] 总金额实时计算
- [x] 保存后数据更新到列表

---

## 🎯 更新内容总结

本次更新为采购管理模块添加了三大核心功能：

1. **智能采购建议 - 勾选保存** (新增)
   - 支持复选框勾选单个物料
   - 支持全选/取消全选批量操作
   - 选中物料视觉高亮反馈
   - 实时统计已选数量和金额
   - 只保存勾选的物料

2. **采购计划 - 查看功能** (新增)
   - 完整展示计划详情
   - 只读模式不可编辑
   - 清晰的信息分类布局

3. **采购计划 - 编辑功能** (新增)
   - 支持草稿/已驳回计划编辑
   - 可修改基本信息
   - 可删除物料项
   - 实时计算总金额
   - 数据验证保障

---

## 📞 支持

如有问题或建议，请联系开发团队。

---

**文档版本**: v1.0  
**更新日期**: 2024-03-15  
**作者**: 智慧农业开发团队
