refactor: 优化代码注释和文档字符串格式

style: 统一代码风格和格式

docs: 完善函数和方法的文档字符串

refactor(base_model): 移除冗余的表名和表参数生成方法

refactor(constant): 更新返回码注释格式

refactor(router_class): 添加路由处理器的详细文档

refactor(database): 完善数据库连接函数的文档

refactor(security): 添加认证类和方法的详细文档

refactor(validator): 更新验证器函数的文档格式

refactor(serialize): 优化序列化工具类的文档

refactor(response): 完善响应类的文档字符串

refactor(dependencies): 添加依赖函数的详细文档

refactor(initialize): 完善初始化脚本的文档

refactor(plugin): 添加生命周期和中间件注册的文档

refactor(service): 完善服务层方法的文档

refactor(controller): 添加控制器方法的详细文档

refactor(crud): 完善CRUD操作的文档字符串

refactor(schema): 简化模型类并移除冗余字段

refactor(param): 更新查询参数类的注释格式

refactor(template): 优化代码生成模板的格式

refactor(console): 添加控制台输出功能的实现

refactor(util): 完善工具函数的文档字符串

backend/app/api/v1/module_common/file/controller.py

@@ -18,6 +18,16 @@ async def upload_controller(
     file: UploadFile,
     request: Request,
 ) -> JSONResponse:
+    """
+    上传文件
+    
+    参数:
+    - file (UploadFile): 上传的文件
+    - request (Request): 请求对象
+    
+    返回:
+    - JSONResponse: 包含上传文件详情的JSON响应
+    """
     result_dict = await FileService.upload_service(base_url=str(request.base_url), file=file)
     logger.info(f"上传文件成功 {result_dict}")
     return SuccessResponse(data=result_dict, msg="上传文件成功")
@@ -28,7 +38,17 @@ async def download_controller(
     file_path: str = Body(..., description="文件路径"), 
     delete: bool = Body(False, description="是否删除文件"),
 ) -> FileResponse:
+    """
+    下载文件
     
+    参数:
+    - background_tasks (BackgroundTasks): 后台任务对象
+    - file_path (str): 文件路径
+    - delete (bool): 是否删除文件
+    
+    返回:
+    - FileResponse: 包含下载文件的响应
+    """
     result = await FileService.download_service(file_path=file_path)
     if delete:
         background_tasks.add_task(UploadUtil.delete_file, Path(file_path))