简道云V2.0

app/tasks/customer_tasks.py

@@ -1,6 +1,10 @@
 """
 客户相关后台任务模块
-包含修改客户信息等功能
+
+本模块包含客户相关的后台任务，包括：
+- 客户信息批量修改
+
+这些任务在后台线程中执行，不会阻塞主请求。
 """
 import logging
 import requests
@@ -15,16 +19,24 @@ logger = logging.getLogger('app')
 
 def modify_customer_info_background(data: Dict[str, Any], cookies: Dict[str, str], df: pd.DataFrame, save_path: str):
     """
-    修改客户信息后台任务。
-
-    此函数用于后台任务，用于修改会员信息。
-
+    修改客户信息后台任务
+    
+    在后台线程中批量修改客户信息，从 Excel 文件中读取客户手机号和修改信息。
+    执行完成后会更新简道云表单并自动提交工作流。
+    
     Args:
-        data (Dict[str, Any]): 前端请求发送过来的数据，包含文件信息和其他必要参数。
-        cookies (Dict[str, str]): 登录用户的Cookies。
-
+        data: 包含表单ID(api_key)、表单ID(entry_id)、数据ID(data_id)的字典
+        cookies: 用户登录 F6 系统的 cookies 信息
+        df: Excel 文件读取的内容，DataFrame 格式，第一列为客户手机号
+        save_path: Excel 文件保存的地址，执行完成后会删除此文件
+        
     Returns:
         None
+        
+    注意:
+        - 根据客户手机号匹配客户信息
+        - 执行完成后会自动删除上传的文件
+        - 执行结果会更新到简道云表单
     """
     df = df.where(pd.notnull(df), None)
     params = {