# 客户跟进功能说明

## 功能概述

新增的客户跟进功能允许您:
- 创建客户跟进记录
- 设置跟进时间
- 自动通过飞书机器人发送提醒

## 功能特性

### 1. 客户跟进表单
- **客户名称**: 从现有客户列表中选择
- **成交状态**: 未成交 / 已成交
- **客户级别**: 
  - A级 (重点客户)
  - B级 (潜在客户)
  - C级 (一般客户)
- **客户行业**: 手动输入
- **跟进时间**: 选择具体的日期和时间

### 2. 飞书通知
当到达设定的跟进时间后,系统会自动通过飞书机器人发送提醒消息。

消息格式:
```
客户跟进提醒
@所有人 请及时跟进"客户名称"
```

## 配置飞书 Webhook

### 步骤 1: 创建飞书机器人

1. 在飞书群聊中,点击右上角设置
2. 选择"群机器人" -> "添加机器人"
3. 选择"自定义机器人"
4. 设置机器人名称和描述
5. 复制生成的 Webhook URL

### 步骤 2: 配置环境变量

在启动服务器之前,设置环境变量:

```bash
export FEISHU_WEBHOOK_URL="https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx"
```

或者在 `.env` 文件中添加:

```
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx
```

### 步骤 3: 启动服务器

```bash
go run ./cmd/server/main.go
```

## 通知机制

- 系统每分钟检查一次是否有需要发送的跟进提醒
- 当跟进时间到达后,自动发送飞书通知
- 通知发送后,记录状态会更新为"已通知"
- 每条跟进记录只会发送一次通知

## 数据存储

跟进记录存储在 `./data/followups.json` 文件中。

## API 端点

- `GET /api/followups` - 获取跟进列表
- `POST /api/followups` - 创建跟进记录
- `GET /api/followups/:id` - 获取单个跟进记录
- `PUT /api/followups/:id` - 更新跟进记录
- `DELETE /api/followups/:id` - 删除跟进记录
- `GET /api/customers/list` - 获取客户名称列表

## 注意事项

1. 如果未配置 `FEISHU_WEBHOOK_URL`,通知功能将不可用,但其他功能正常工作
2. 确保服务器时区设置正确,以保证通知时间准确
3. 飞书机器人需要在对应的群聊中添加才能发送消息