jdy_fastapi/app/tasks/README.md

后台任务模块结构说明

模块结构

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

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 中导入新函数以保持向后兼容

示例：

# 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)

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

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

使用方式

方式一：使用新的模块结构（推荐）

from app.tasks import create_brand_background
from app.tasks.brand_tasks import create_brand_background  # 也可以直接导入

方式二：使用向后兼容的导入方式

from app import back_ground_tasks
back_ground_tasks.create_brand_background(...)

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