# 自动删粉任务管理

## 📋 业务与功能

### 1.1 核心目标
优化自动删客任务流程，解决当前依赖人工导出导入 `onecode` 的低效问题。
实现运营人员自主创建任务，系统自动根据 `userid` 查询 `onecode`，并提供全流程的 RPA 执行追踪与异常上报。
之前的任务列表是导入一个文件作为一条任务，文件内容是userid和onecode

### 1.2 功能清单
- **任务列表页**：展示任务状态、进度与基本信息，支持筛选与管理操作。
- **新建任务**：
    - **方式选择**：优先选择任务方式（自动查询/导入文件）。
    - **自动查询**：需配置托管员工、删除范围（企业客户/单删/拉黑/时间范围）。
    - **导入文件**：上传本地 Excel/CSV 文件（包含 userid+onecode），无需选择员工与范围。
    - **通用配置**：设置执行方式（立即/定时）。异常通知 Webhook 已内置。
- **任务详情页**：展示任务创建信息、RPA 执行进度统计、详细执行日志（含成功/失败状态与原因）。
- **自动查询 Onecode**：后台自动根据配置查询目标客户 onecode，无需人工上传。
- **异常监控**：集成 Webhook 推送，实时上报执行异常。

### 1.3 交互要点
- **创建任务**：
    - **方式切换**：选择“导入文件”方式时，自动隐藏托管员工、删除范围等筛选条件。
    - **文件上传**：支持拖拽上传，自动解析文件行数作为预计删客数量。
    - **状态反馈**：提交后任务进入“查询中”状态，查询完成后自动转为“待执行/执行中”。
- **列表操作**：
    - 支持按状态（待执行/执行中/已完成/异常/暂停）筛选。
    - **批量操作**：
        - **批量暂停**：勾选多个“执行中”或“待执行”的任务，点击批量暂停，弹出确认弹窗，确认后暂停所有选中任务。
        - **批量启动**：勾选多个“暂停”或“异常”的任务，点击批量启动，弹出确认弹窗，确认后恢复/重试所有选中任务。
    - **单条操作**：
        - **暂停**：对“执行中”或“待执行”的任务，点击暂停，弹出确认提示，确认后暂停任务。
        - **启动**：对“暂停”或“异常”的任务，点击启动，弹出确认提示，确认后恢复/重试任务。
    - 快捷操作：查看详情、暂停、继续、删除。
- **详情查看**：
    - 实时刷新执行进度与日志。
    - 失败任务支持查看原因。

---

## 📊 内容规划

### 2.1 信息架构
```
自动删粉任务管理
├── 任务列表 (首页)
│   ├── 筛选栏 (任务名称/员工/状态/时间)
│   ├── 任务数据表格
│   └── 新建任务入口
├── 新建任务 (弹窗/抽屉)
│   ├── 方式选择 (自动查询/导入文件)
│   ├── 基础信息 (名称)
│   ├── 范围配置 (仅自动查询模式: 员工/客户类型/时间范围)
│   ├── 导入配置 (仅导入模式: 本地文件上传)
│   └── 执行配置 (立即/定时)
└── 任务详情页 (二级页)
    ├── 任务概览 (合并展示：创建信息/配置参数/执行进度)
    └── 执行明细 (客户列表/执行结果/失败原因)
```

### 2.2 数据来源
- **数据类型**：模拟任务数据与执行日志。
- **关键字段**：
    - `taskId`: 任务唯一标识
    - `taskName`: 任务名称
    - `staffList`: 托管员工列表 (userid + name)
    - `deleteScope`: 删除范围 (enterprise, singleOrBlocked, timeRange)
    - `status`: 状态 (DRAFT, ONECODE_QUERYING, PENDING, RUNNING, PARTIAL_FAILED, FINISHED, FAILED)
    - `progress`: 执行进度 (total, success, failed, pending)
    - `logs`: 执行日志列表

---

## 🎨 布局与结构

### 3.1 整体布局
- **布局模式**：标准后台管理布局 (参照antdesign的布局)。
- **列表页**：
    - 顶部：筛选查询栏 (Filter Bar)。
    - 中部：操作栏 (新建/批量操作)。
    - 主体：数据表格 (Table)，支持分页。
- **详情页**：
    - 顶部：面包屑导航 + 标题 + 状态标签 + 操作按钮。
    - 主体：
        - 概览卡片 (Descriptions)：展示任务配置与统计。
        - 明细表格 (Table)：展示具体执行记录。

### 3.2 响应式适配
- **桌面端**：完整展示表格列。
- **移动端**：表格转为卡片视图或通过横向滚动查看。

---

## 🎨 视觉规范

### 4.1 设计规范来源
**本设计基于**：
- [x] 主题设计系统：`/src/themes/antd-new/`
- [x] 内置设计指导：`/assets/docs/设计指导（简约）.md`

### 4.2 组件状态
- **状态标签**：
    - `DRAFT`/`PENDING`: Default/Processing (Blue)
    - `RUNNING`: Processing (Blue/Loading)
    - `FINISHED`: Success (Green)
    - `FAILED`/`PARTIAL_FAILED`: Error (Red)
    - `ONECODE_QUERYING`: Warning/Processing (Orange)