90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
# 后台任务模块结构说明
|
|
|
|
## 模块结构
|
|
|
|
后台任务已按功能拆分为以下模块：
|
|
|
|
```
|
|
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(...)
|
|
```
|
|
|
|
两种方式都可以正常工作，代码执行逻辑完全一致。
|
|
|