# 后台任务模块结构说明

## 模块结构

后台任务已按功能拆分为以下模块：

```
app/tasks/
├── __init__.py          # 统一导出入口
├── common.py            # 通用功能模块（简道云表单更新、工作流审批）
├── brand_tasks.py       # 品牌相关任务
├── delete_tasks.py      # 删除相关任务
└── customer_tasks.py    # 客户相关任务
```

## 模块说明

### common.py - 通用功能模块
包含所有任务共用的功能：
- `update_jiandaoyun()` - 更新简道云表单
- `approve_workflow()` - 工作流审批

### brand_tasks.py - 品牌任务模块
品牌相关的后台任务：
- `create_brand_background()` - 品牌批量创建

### delete_tasks.py - 删除任务模块
删除相关的后台任务：
- `delete_history_background()` - 删除历史维修记录
- `delete_customer_background()` - 删除客户信息
- `delete_car_background()` - 删除客户车辆信息

### customer_tasks.py - 客户任务模块
客户相关的后台任务：
- `modify_customer_info_background()` - 修改客户信息

## 向后兼容

原有的 `app.back_ground_tasks` 模块仍然可用，它现在作为向后兼容的入口，实际功能已拆分到 `app.tasks` 模块中。

## 添加新功能模块

如需添加新的功能模块，请按以下步骤：

1. 在 `app/tasks/` 目录下创建新的模块文件，例如 `new_feature_tasks.py`
2. 在新模块中实现相关功能函数
3. 在 `app/tasks/__init__.py` 中导入并导出新函数
4. 在 `app/back_ground_tasks.py` 中导入新函数以保持向后兼容

示例：

```python
# app/tasks/new_feature_tasks.py
from app.tasks.common import update_jiandaoyun, approve_workflow

def new_feature_background(data, cookies):
    # 实现新功能
    result = "执行结果"
    msg = update_jiandaoyun(data, result)
    if msg.get('msg'):
        approve_workflow(data)
```

```python
# app/tasks/__init__.py 中添加
from app.tasks.new_feature_tasks import new_feature_background

__all__ = [
    # ... 其他函数
    'new_feature_background',
]
```

## 使用方式

### 方式一：使用新的模块结构（推荐）
```python
from app.tasks import create_brand_background
from app.tasks.brand_tasks import create_brand_background  # 也可以直接导入
```

### 方式二：使用向后兼容的导入方式
```python
from app import back_ground_tasks
back_ground_tasks.create_brand_background(...)
```

两种方式都可以正常工作，代码执行逻辑完全一致。