# 自动加好友

## 📋 业务与功能

### 1.1 核心目标
> 通过自动加好友任务提升获客效率，支持任务配置、执行记录查询与管理。

### 1.2 功能清单
- **查询区域**：任务名称、托管员工、创建日期、任务状态、创建人
- **操作栏**：新建任务、导出、批量导入
- **任务列表**：
  - 字段：任务名称、托管员工、任务数据（成功/发送申请/失败/代执行/总数）、执行方式、任务状态、创建人、创建时间
  - 操作：详情、删除（二次确认）
- **新建任务**：
  - 选择托管员工（通讯录组件）
  - 任务名称
  - 申请话术
  - 客户手机号（换行输入多个）
  - 执行方式：定时执行（需选时间）、立即执行、手动执行
- **任务详情**：
  - **基础信息**：任务维度信息展示
  - **执行明细查询**：客户手机号、添加状态、添加好友员工
  - **执行明细列表**：
    - 客户手机号
    - 添加状态
    - 添加好友员工
    - 员工所属部门
    - 员工所属集运人员
    - 添加时间
    - 备注
  - **操作**：导出明细

### 1.3 交互要点
- **列表页**：
  - 顶部查询表单支持多维度筛选
  - 操作栏提供主要功能入口
  - 列表项点击“详情”进入二级页面
  - 删除操作需二次确认
- **新建页/弹窗**：
  - 员工选择支持多选
  - 手机号输入框支持多行文本
  - 定时执行选中时显示时间选择器
- **详情页**：
  - 包含基础信息展示区域
  - 独立的查询筛选区域
  - 数据表格展示每位客户的执行情况

---

## 📊 内容规划

### 2.1 信息架构
```
自动加好友
├── 任务列表页（首页）
│   ├── 查询区域
│   ├── 操作栏
│   └── 数据表格
└── 任务详情页（二级页）
    ├── 基础信息
    ├── 明细查询
    ├── 导出操作
    └── 明细表格
```

### 2.2 数据来源
- **数据类型**：任务数据、员工数据、执行记录
- **关键字段**：
  - `task_id`: 任务 ID
  - `details`: 执行明细列表
    - `phone`: 客户手机号
    - `status`: 添加状态
    - `staff`: 添加员工
    - `dept`: 部门
    - `manager`: 集运人员
    - `time`: 添加时间
    - `remark`: 备注

### 2.3 内容示例
- 明细记录：132****2444 | 添加中 | 客服七七 | 七台河 | - | | 已发送添加申请

---

## 🎨 布局与结构

### 3.1 整体布局
- **列表页**：
  - 顶部：查询表单（Grid布局）
  - 中部：操作按钮行
  - 主体：数据表格
- **详情页**：
  - 顶部：基础信息（Descriptions）
  - 中部：查询表单
  - 下部：导出按钮 + 数据表格

---

## ⚙️ Axure API 说明

### 5.1 事件列表（eventList）
| 事件名称 | Payload 类型 | 触发时机 | 说明 |
|---------|-------------|---------|------|
| `on_detail_export` | `string` | 详情页导出 | payload 为任务 ID |

### 5.3 数据项列表（dataList）
**数据结构**：
```typescript
{
  tasks: TaskItem[];
  details: {
    taskId: string;
    list: {
      phone: string;
      status: string;
      staff: string;
      dept: string;
      manager: string;
      time: string;
      remark: string;
    }[];
  }[];
}
```