refactor: 重构代码结构并优化命名一致性

feat(backend): 新增模块示例和路径配置
fix(backend): 修复菜单模型名称唯一性约束
refactor(backend): 重构日志模块和路径配置
style(backend): 统一API方法命名规范
refactor(frontend): 重构API方法命名规范
fix(frontend): 修复权限校验问题
refactor: 移动定时任务测试文件到正确模块
docs: 更新模板文件路径
refactor: 优化日志记录和错误处理
fix: 修复排序默认值问题

backend/app/api/v1/module_system/user/controller.py

@@ -12,7 +12,7 @@ from app.core.router_class import OperationLogRoute
 from app.core.dependencies import db_getter, get_current_user, AuthPermission
 from app.core.base_params import PaginationQueryParam
 from app.core.base_schema import BatchSetAvailable
-from app.core.logger import logger
+from app.core.logger import log
 
 from ..auth.schema import AuthSchema
 from .service import UserService
@@ -45,7 +45,7 @@ async def get_current_user_info_controller(
     - JSONResponse: 当前用户信息JSON响应
     """
     result_dict = await UserService.get_current_user_info_service(auth=auth)
-    logger.info(f"获取当前用户信息成功")
+    log.info(f"获取当前用户信息成功")
     return SuccessResponse(data=result_dict, msg='获取当前用户信息成功')
 
 
@@ -65,7 +65,7 @@ async def user_avatar_upload_controller(
     - JSONResponse: 上传头像JSON响应
     """
     result_str = await UserService.upload_avatar_service(base_url=str(request.base_url), file=file)
-    logger.info(f"上传头像成功: {result_str}")
+    log.info(f"上传头像成功: {result_str}")
     return SuccessResponse(data=result_str, msg='上传头像成功')
 
 
@@ -85,7 +85,7 @@ async def update_current_user_info_controller(
     - JSONResponse: 更新当前用户基本信息JSON响应
     """
     result_dict = await UserService.update_current_user_info_service(data=data, auth=auth)
-    logger.info(f"更新当前用户基本信息成功: {result_dict}")
+    log.info(f"更新当前用户基本信息成功: {result_dict}")
     return SuccessResponse(data=result_dict, msg='更新当前用户基本信息成功')
 
 
@@ -105,7 +105,7 @@ async def change_current_user_password_controller(
     - JSONResponse: 修改密码JSON响应
     """
     result_dict = await UserService.change_user_password_service(data=data, auth=auth)
-    logger.info(f"修改密码成功: {result_dict}")
+    log.info(f"修改密码成功: {result_dict}")
     return SuccessResponse(data=result_dict, msg='修改密码成功, 请重新登录')
 
 @UserRouter.put("/reset/password", summary="重置密码", description="重置密码")
@@ -124,7 +124,7 @@ async def reset_password_controller(
     - JSONResponse: 重置密码JSON响应
     """
     result_dict = await UserService.reset_user_password_service(data=data, auth=auth)
-    logger.info(f"重置密码成功: {result_dict}")
+    log.info(f"重置密码成功: {result_dict}")
     return SuccessResponse(data=result_dict, msg='重置密码成功')
 
 @UserRouter.post('/register', summary="注册用户", description="注册用户")
@@ -144,7 +144,7 @@ async def register_user_controller(
     """
     auth = AuthSchema(db=db)
     user_register_result = await UserService.register_user_service(data=data, auth=auth)
-    logger.info(f"{data.username} 注册用户成功: {user_register_result}")
+    log.info(f"{data.username} 注册用户成功: {user_register_result}")
     return SuccessResponse(data=user_register_result, msg='注册用户成功')
 
 
@@ -165,7 +165,7 @@ async def forget_password_controller(
     """
     auth = AuthSchema(db=db)
     user_forget_password_result = await UserService.forget_password_service(data=data, auth=auth)
-    logger.info(f"{data.username} 重置密码成功: {user_forget_password_result}")
+    log.info(f"{data.username} 重置密码成功: {user_forget_password_result}")
     return SuccessResponse(data=user_forget_password_result, msg='重置密码成功')
 
 
@@ -188,7 +188,7 @@ async def get_obj_list_controller(
     """
     result_dict_list = await UserService.get_user_list_service(search=search, auth=auth, order_by=page.order_by)
     result_dict = await PaginationService.paginate(data_list= result_dict_list, page_no= page.page_no, page_size = page.page_size)
-    logger.info(f"查询用户成功")
+    log.info(f"查询用户成功")
     return SuccessResponse(data=result_dict, msg="查询用户成功")
 
 
@@ -208,7 +208,7 @@ async def get_obj_detail_controller(
     - JSONResponse: 用户详情JSON响应
     """
     result_dict = await UserService.get_detail_by_id_service(id=id, auth=auth)
-    logger.info(f"获取用户详情成功 {id}")
+    log.info(f"获取用户详情成功 {id}")
     return SuccessResponse(data=result_dict, msg='获取用户详情成功')
 
 
@@ -232,7 +232,7 @@ async def create_obj_controller(
     - JSONResponse: 创建用户JSON响应
     """
     result_dict = await UserService.create_user_service(data=data, auth=auth)
-    logger.info(f"创建用户成功: {result_dict}")
+    log.info(f"创建用户成功: {result_dict}")
     return SuccessResponse(data=result_dict, msg="创建用户成功")
 
 
@@ -254,7 +254,7 @@ async def update_obj_controller(
     - JSONResponse: 修改用户JSON响应
     """
     result_dict = await UserService.update_user_service(id=id, data=data, auth=auth)
-    logger.info(f"修改用户成功: {result_dict}")
+    log.info(f"修改用户成功: {result_dict}")
     return SuccessResponse(data=result_dict, msg="修改用户成功")
 
 
@@ -274,7 +274,7 @@ async def delete_obj_controller(
     - JSONResponse: 删除用户JSON响应
     """
     await UserService.delete_user_service(ids=ids, auth=auth)
-    logger.info(f"删除用户成功: {ids}")
+    log.info(f"删除用户成功: {ids}")
     return SuccessResponse(msg="删除用户成功")
 
 
@@ -294,7 +294,7 @@ async def batch_set_available_obj_controller(
     - JSONResponse: 批量修改用户状态JSON响应
     """
     await UserService.set_user_available_service(data=data, auth=auth)
-    logger.info(f"批量修改用户状态成功: {data.ids}")
+    log.info(f"批量修改用户状态成功: {data.ids}")
     return SuccessResponse(msg="批量修改用户状态成功")
 
 
@@ -307,7 +307,7 @@ async def export_obj_template_controller()-> StreamingResponse:
     - StreamingResponse: 用户导入模板流响应
     """
     user_import_template_result = await UserService.get_import_template_user_service()
-    logger.info('获取用户导入模板成功')
+    log.info('获取用户导入模板成功')
 
     return StreamResponse(
         data=bytes2file_response(user_import_template_result),
@@ -338,7 +338,7 @@ async def export_obj_list_controller(
     """
     user_list = await UserService.get_user_list_service(auth=auth, search=search, order_by=page.order_by)
     user_export_result = await UserService.export_user_list_service(user_list)
-    logger.info('导出用户成功')
+    log.info('导出用户成功')
 
     return StreamResponse(
         data=bytes2file_response(user_export_result),
@@ -365,5 +365,5 @@ async def import_obj_list_controller(
     - JSONResponse: 导入用户JSON响应
     """
     batch_import_result = await UserService.batch_import_user_service(file=file, auth=auth, update_support=True)
-    logger.info(f"导入用户成功: {batch_import_result}")
+    log.info(f"导入用户成功: {batch_import_result}")
     return SuccessResponse(data=batch_import_result, msg="导入用户成功")

backend/app/api/v1/module_system/user/service.py

@@ -8,7 +8,7 @@ import pandas as pd
 from app.core.exceptions import CustomException
 from app.utils.hash_bcrpy_util import PwdUtil
 from app.core.base_schema import BatchSetAvailable, UploadResponseSchema
-from app.core.logger import logger
+from app.core.logger import log
 from app.utils.common_util import traversal_to_tree
 from app.utils.excel_util import ExcelUtil
 from app.utils.upload_util import UploadUtil
@@ -570,7 +570,7 @@ class UserService:
             return result
             
         except Exception as e:
-            logger.error(f"批量导入用户失败: {str(e)}")
+            log.error(f"批量导入用户失败: {str(e)}")
             raise CustomException(msg=f"导入失败: {str(e)}")
 
     @classmethod