# 客户管理 - 快速开始 🚀

## ⚡ 5秒钟访问指南

1. **启动服务器**（如果还没启动）
   ```bash
   npm run dev
   ```

2. **打开浏览器** → 登录系统

3. **点击顶部** "资产管理系统"

4. **点击菜单** "基础信息管理" → "客户管理"

---

## ✅ 已完成的功能

### 核心功能
- ✅ **新增客户** - 点击右上角"新增客户"按钮
- ✅ **编辑客户** - 点击客户卡片上的"编辑"按钮
- ✅ **删除客户** - 点击"删除"按钮（有业务校验）
- ✅ **查看详情** - 点击"查看详情"按钮

### 数据管理
- ✅ **客户类型** - 农户、合作社、企业
- ✅ **信用额度** - 总额度、已用、剩余（带进度条）
- ✅ **购买历史** - 完整记录和统计
- ✅ **客户等级** - VIP/优质/普通（自动评估）

### 业务功能
- ✅ **待付款订单** - 统计和显示
- ✅ **删除保护** - 有未完成订单无法删除
- ✅ **数据校验** - 必填字段验证

---

## 🎯 快速测试

### 1分钟测试流程：

```
1. 点击"新增客户" 
   → 填写"李四"、"农户"、"13900004444" 
   → 填写地址和信用额度 
   → 保存 ✅

2. 点击"查看详情"
   → 检查信息完整性 
   → 查看信用额度和购买记录 ✅

3. 点击"编辑"
   → 修改信用额度 
   → 保存 ✅

4. 点击"删除"（选择"张三农场"）
   → 确认删除 ✅
```

---

## 📋 新增客户必填字段

- ✅ 客户名称
- ✅ 客户类型（农户/合作社/企业）
- ✅ 联系人
- ✅ 联系电话
- ✅ 地址
- ✅ 信用额度

---

## 🎨 界面说明

### 客户卡片包含：
1. **头部** - 名称、类型、编码、操作按钮
2. **联系信息** - 电话、邮箱、地址
3. **信用额度** - 进度条 + 详细数据
4. **购买统计** - 金额、次数、等级
5. **购买记录** - 最近3条

### 详情对话框包含：
1. **基本信息** - 完整联系方式
2. **信用额度** - 使用率进度条
3. **统计卡片** - 3个关键指标
4. **购买历史** - 所有记录
5. **备注信息** - 如果有

---

## 🔍 客户等级说明

| 等级 | 条件 | 标签颜色 |
|------|------|---------|
| VIP客户 | 累计购买 ≥ ¥50万 | 紫色 |
| 优质客户 | 累计购买 ≥ ¥20万 | 蓝色 |
| 普通客户 | 累计购买 < ¥20万 | 灰色 |

---

## 💡 提示

- **删除保护**：有待付款订单的客户无法删除
- **自动编码**：新客户自动生成 CUS-XXX 编码
- **数据验证**：所有必填字段都有实时验证
- **实时计算**：信用额度、客户等级自动计算

---

## 📱 示例客户

系统预置了3个示例客户供测试：

1. **张三农场**（农户）- 优质客户
2. **绿源合作社**（合作社）- 优质客户，有待付款订单
3. **丰收农业公司**（企业）- VIP客户

---

**立即开始测试吧！** 🎉
