简道云fastapi

app/tasks/README.md

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