refactor(api): 重构API路由及模块结构，清理废弃模型代码

- 修改alembic配置以使用异步数据库URI和更新Base类引用 - 新增数据库Schema优化脚本，统一字段长度，添加索引，规范外键策略 - 重构API路由管理，按模块类型分组并统一前缀 - 删除示例、监控及系统各子模块的模型定义，减少冗余代码 - 将mcp_server相关代码迁移到module_ai模块下，规范模块目录结构 - 迁移example控制器至module_application.application模块，并重命名相关服务和参数名 - 优化示例控制器中的依赖和响应结构，统一命名规范
2026-09-22 05:02:57 +00:00 · 2025-09-04 02:50:29 +08:00
parent 35fa896a74
commit 3b04534b32
233 changed files with 6809 additions and 1788 deletions
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+
+from typing import Any, Dict, List
+
+from app.core.base_schema import BatchSetAvailable
+from app.core.exceptions import CustomException
+from app.utils.excel_util import ExcelUtil
+from ..auth.schema import AuthSchema
+from .crud import RoleCRUD
+from .param import RoleQueryParams
+from .schema import (
+    RoleCreateSchema,
+    RoleUpdateSchema,
+    RolePermissionSettingSchema,
+    RoleOutSchema
+)
+
+
+class RoleService:
+    """角色模块服务层"""
+
+    @classmethod
+    async def get_role_detail_service(cls, auth: AuthSchema, id: int) -> Dict:
+        """获取角色详情"""
+        role = await RoleCRUD(auth).get_by_id_crud(id=id)
+        return RoleOutSchema.model_validate(role).model_dump()
+
+    @classmethod
+    async def get_role_list_service(cls, auth: AuthSchema, search: RoleQueryParams, order_by: List[Dict[str, str]] = None) -> List[Dict]:
+        """获取角色列表"""
+        if order_by:
+            order_by = eval(order_by)
+        else:
+            order_by = [{"order": "asc"}]
+        role_list = await RoleCRUD(auth).get_list_crud(search=search.__dict__, order_by=order_by)
+        return [RoleOutSchema.model_validate(role).model_dump() for role in role_list]
+
+    @classmethod
+    async def create_role_service(cls, auth: AuthSchema, data: RoleCreateSchema) -> Dict:
+        """创建角色"""
+        role = await RoleCRUD(auth).get(name=data.name)
+        if role:
+            raise CustomException(msg='创建失败，该角色已存在')
+        new_role = await RoleCRUD(auth).create(data=data)
+        return RoleOutSchema.model_validate(new_role).model_dump()
+
+    @classmethod
+    async def update_role_service(cls, auth: AuthSchema, data: RoleUpdateSchema) -> Dict:
+        """更新角色"""
+        role = await RoleCRUD(auth).get_by_id_crud(id=data.id)
+        if not role:
+            raise CustomException(msg='更新失败，该角色不存在')
+        exist_role = await RoleCRUD(auth).get(name=data.name)
+        if exist_role and exist_role.id != data.id:
+            raise CustomException(msg='更新失败，角色名称重复')
+        updated_role = await RoleCRUD(auth).update(id=data.id, data=data)
+        return RoleOutSchema.model_validate(updated_role).model_dump()
+
+    @classmethod
+    async def delete_role_service(cls, auth: AuthSchema, ids: list[id]) -> None:
+        """删除角色"""
+        if len(ids) < 1:
+            raise CustomException(msg='删除失败，删除对象不能为空')
+        for id in ids:
+            role = await RoleCRUD(auth).get_by_id_crud(id=id)
+            if not role:
+                raise CustomException(msg='删除失败，该角色不存在')
+        await RoleCRUD(auth).delete(ids=ids)
+
+    @classmethod
+    async def set_role_permission_service(cls, auth: AuthSchema, data: RolePermissionSettingSchema) -> None:
+        """设置角色权限"""
+        # 设置角色菜单权限
+        await RoleCRUD(auth).set_role_menus_crud(role_ids=data.role_ids, menu_ids=data.menu_ids)
+        
+        # 设置数据权限范围
+        await RoleCRUD(auth).set_role_data_scope_crud(role_ids=data.role_ids, data_scope=data.data_scope)
+        
+        # 设置自定义数据权限部门
+        if data.data_scope == 5 and data.dept_ids:
+            await RoleCRUD(auth).set_role_depts_crud(role_ids=data.role_ids, dept_ids=data.dept_ids)
+        else:
+            await RoleCRUD(auth).set_role_depts_crud(role_ids=data.role_ids, dept_ids=[])
+
+    @classmethod
+    async def set_role_available_service(cls, auth: AuthSchema, data: BatchSetAvailable) -> None:
+        """设置角色可用状态"""
+        await RoleCRUD(auth).set_available_crud(ids=data.ids, status=data.status)
+
+    @classmethod
+    async def export_role_list_service(cls, role_list: List[Dict[str, Any]]) -> bytes:
+        """导出角色列表"""
+        # 字段映射配置
+        mapping_dict = {
+            'id': '角色编号',
+            'name': '角色名称',
+            'order': '显示顺序', 
+            'data_scope': '数据权限',
+            'status': '状态',
+            'description': '备注',
+            'created_at': '创建时间',
+            'updated_at': '更新时间',
+            'creator_id': '创建者ID',
+            'creator': '创建者',
+        }
+
+        # 数据权限映射
+        data_scope_map = {
+            1: '仅本人数据权限',
+            2: '本部门数据权限',
+            3: '本部门及以下数据权限',
+            4: '全部数据权限',
+            5: '自定义数据权限'
+        }
+
+        # 处理数据
+        data = role_list.copy()
+        for item in data:
+            item['status'] = '正常' if item.get('status') else '停用'
+            item['data_scope'] = data_scope_map.get(item.get('data_scope'))
+            item['creator'] = item.get('creator', {}).get('name', '未知') if isinstance(item.get('creator'), dict) else '未知'
+
+        return ExcelUtil.export_list2excel(list_data=role_list, mapping_dict=mapping_dict)
+