upload project source code

This commit is contained in:
2026-04-30 18:49:43 +08:00
commit 9b394ba682
2277 changed files with 660945 additions and 0 deletions

View File

@@ -0,0 +1,2 @@
# -*- coding: utf-8 -*-

View File

@@ -0,0 +1,142 @@
# -*- coding: utf-8 -*-
from fastapi import APIRouter, Body, Depends, Path
from fastapi.responses import JSONResponse
from app.common.response import SuccessResponse
from app.common.request import PaginationService
from app.core.base_params import PaginationQueryParam
from app.core.dependencies import AuthPermission
from app.core.base_schema import BatchSetAvailable
from app.core.logger import log
from app.api.v1.module_system.auth.schema import AuthSchema
from app.core.router_class import OperationLogRoute
from .service import ApplicationService
from .schema import (
ApplicationCreateSchema,
ApplicationUpdateSchema,
ApplicationQueryParam
)
MyAppRouter = APIRouter(route_class=OperationLogRoute, prefix="/myapp", tags=["应用管理"])
@MyAppRouter.get("/detail/{id}", summary="获取应用详情", description="获取应用详情")
async def get_obj_detail_controller(
id: int = Path(..., description="应用ID"),
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:query"]))
) -> JSONResponse:
"""
获取应用详情
参数:
- id (int): 应用ID
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 包含应用详情的JSON响应
"""
result_dict = await ApplicationService.detail_service(id=id, auth=auth)
log.info(f"获取应用详情成功 {id}")
return SuccessResponse(data=result_dict, msg="获取应用详情成功")
@MyAppRouter.get("/list", summary="查询应用列表", description="查询应用列表")
async def get_obj_list_controller(
page: PaginationQueryParam = Depends(),
search: ApplicationQueryParam = Depends(),
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:query"]))
) -> JSONResponse:
"""
查询应用列表
参数:
- page (PaginationQueryParam): 分页参数模型
- search (ApplicationQueryParam): 查询参数模型
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 包含应用列表的JSON响应
"""
result_dict_list = await ApplicationService.list_service(auth=auth, search=search, 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)
log.info(f"查询应用列表成功")
return SuccessResponse(data=result_dict, msg="查询应用列表成功")
@MyAppRouter.post("/create", summary="创建应用", description="创建应用")
async def create_obj_controller(
data: ApplicationCreateSchema,
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:create"]))
) -> JSONResponse:
"""
创建应用
参数:
- data (ApplicationCreateSchema): 应用创建模型
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 包含创建应用详情的JSON响应
"""
result_dict = await ApplicationService.create_service(auth=auth, data=data)
log.info(f"创建应用成功: {result_dict}")
return SuccessResponse(data=result_dict, msg="创建应用成功")
@MyAppRouter.put("/update/{id}", summary="修改应用", description="修改应用")
async def update_obj_controller(
data: ApplicationUpdateSchema,
id: int = Path(..., description="应用ID"),
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:update"]))
) -> JSONResponse:
"""
修改应用
参数:
- data (ApplicationUpdateSchema): 应用更新模型
- id (int): 应用ID
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 包含修改应用详情的JSON响应
"""
result_dict = await ApplicationService.update_service(auth=auth, id=id, data=data)
log.info(f"修改应用成功: {result_dict}")
return SuccessResponse(data=result_dict, msg="修改应用成功")
@MyAppRouter.delete("/delete", summary="删除应用", description="删除应用")
async def delete_obj_controller(
ids: list[int] = Body(..., description="ID列表"),
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:delete"]))
) -> JSONResponse:
"""
删除应用
参数:
- ids (list[int]): 应用ID列表
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 包含删除应用详情的JSON响应
"""
await ApplicationService.delete_service(auth=auth, ids=ids)
log.info(f"删除应用成功: {ids}")
return SuccessResponse(msg="删除应用成功")
@MyAppRouter.patch("/available/setting", summary="批量修改应用状态", description="批量修改应用状态")
async def batch_set_available_obj_controller(
data: BatchSetAvailable,
auth: AuthSchema = Depends(AuthPermission(["module_application:myapp:patch"]))
) -> JSONResponse:
"""
批量修改应用状态
参数:
- data (BatchSetAvailable): 批量修改应用状态模型
- auth (AuthSchema): 认证信息模型
返回:
- JSONResponse: 批量修改应用状态成功
"""
await ApplicationService.set_available_service(auth=auth, data=data)
log.info(f"批量修改应用状态成功: {data.ids}")
return SuccessResponse(msg="批量修改应用状态成功")

View File

@@ -0,0 +1,101 @@
'''
Author: caoziyuan ziyuan.cao@zhuying.com
Date: 2025-12-15 17:37:50
LastEditors: caoziyuan ziyuan.cao@zhuying.com
LastEditTime: 2025-12-22 17:26:54
FilePath: \backend\app\api\v1\module_application\myapp\crud.py
Description: 这是默认设置,请设置`customMade`, 打开koroFileHeader查看配置 进行设置: https://github.com/OBKoro1/koro1FileHeader/wiki/%E9%85%8D%E7%BD%AE
'''
# -*- coding: utf-8 -*-
from typing import Sequence, Any
from app.core.base_crud import CRUDBase
from app.api.v1.module_system.auth.schema import AuthSchema
from .model import ApplicationModel
from .schema import ApplicationCreateSchema, ApplicationUpdateSchema
class ApplicationCRUD(CRUDBase[ApplicationModel, ApplicationCreateSchema, ApplicationUpdateSchema]):
"""应用系统数据层"""
def __init__(self, auth: AuthSchema) -> None:
"""
初始化应用CRUD
参数:
- auth (AuthSchema): 认证信息模型
"""
self.auth = auth
super().__init__(model=ApplicationModel, auth=auth)
async def get_by_id_crud(self, id: int, preload: list[str | Any] | None = None) -> ApplicationModel | None:
"""
根据id获取应用详情
参数:
- id (int): 应用ID
- preload (list[str | Any] | None): 预加载关系,未提供时使用模型默认项
返回:
- ApplicationModel | None: 应用详情,如果不存在则为None
"""
return await self.get(id=id, preload=preload)
async def list_crud(self, search: dict[str, Any] | None = None, order_by: list[dict[str, str]] | None = None, preload: list[str | Any] | None = None) -> Sequence[ApplicationModel]:
"""
列表查询应用
参数:
- search (dict[str, Any] | None): 查询参数,默认None
- order_by (list[dict[str, str]] | None): 排序参数,默认None
- preload (list[str | Any] | None): 预加载关系,未提供时使用模型默认项
返回:
- Sequence[ApplicationModel]: 应用列表
"""
return await self.list(search=search, order_by=order_by, preload=preload)
async def create_crud(self, data: ApplicationCreateSchema) -> ApplicationModel | None:
"""
创建应用
参数:
- data (ApplicationCreateSchema): 应用创建模型
返回:
- ApplicationModel | None: 创建的应用详情,如果创建失败则为None
"""
return await self.create(data=data)
async def update_crud(self, id: int, data: ApplicationUpdateSchema) -> ApplicationModel | None:
"""
更新应用
参数:
- id (int): 应用ID
- data (ApplicationUpdateSchema): 应用更新模型
返回:
- ApplicationModel | None: 更新后的应用详情,如果更新失败则为None
"""
return await self.update(id=id, data=data)
async def delete_crud(self, ids: list[int]) -> None:
"""
批量删除应用
参数:
- ids (list[int]): 应用ID列表
"""
return await self.delete(ids=ids)
async def set_available_crud(self, ids: list[int], status: str) -> None:
"""
批量设置可用状态
参数:
- ids (list[int]): 应用ID列表
- status (str): 可用状态,True为可用,False为不可用
"""
return await self.set(ids=ids, status=status)

View File

@@ -0,0 +1,19 @@
# -*- coding: utf-8 -*-
from sqlalchemy import String
from sqlalchemy.orm import Mapped, mapped_column
from app.core.base_model import ModelMixin, UserMixin
class ApplicationModel(ModelMixin, UserMixin):
"""
应用系统表
"""
__tablename__: str = 'app_myapp'
__table_args__: dict[str, str] = ({'comment': '应用系统表'})
__loader_options__: list[str] = ["created_by", "updated_by"]
name: Mapped[str] = mapped_column(String(64), nullable=False, comment='应用名称')
access_url: Mapped[str] = mapped_column(String(500), nullable=False, comment='访问地址')
icon_url: Mapped[str | None] = mapped_column(String(300), nullable=True, comment='应用图标URL')

View File

@@ -0,0 +1,79 @@
# -*- coding: utf-8 -*-
from pydantic import BaseModel, ConfigDict, Field, field_validator
from urllib.parse import urlparse
from fastapi import Query
from app.core.validator import DateTimeStr
from app.core.base_schema import BaseSchema, UserBySchema
class ApplicationCreateSchema(BaseModel):
"""应用创建模型"""
name: str = Field(..., max_length=64, description='应用名称')
access_url: str = Field(..., max_length=255, description="访问地址")
icon_url: str | None = Field(None, max_length=300, description="应用图标URL")
status: str = Field("0", description="是否启用(0:启用 1:禁用)")
description: str | None = Field(default=None, max_length=255, description="描述")
@field_validator('access_url')
@classmethod
def _validate_access_url(cls, v: str) -> str:
v = v.strip()
if not v:
raise ValueError('访问地址不能为空')
parsed = urlparse(v)
if parsed.scheme not in ('http', 'https'):
raise ValueError('访问地址必须为 http/https URL')
return v
@field_validator('icon_url')
@classmethod
def _validate_icon_url(cls, v: str | None) -> str | None:
if v is None:
return v
v = v.strip()
if v == "":
return None
parsed = urlparse(v)
if parsed.scheme not in ('http', 'https'):
raise ValueError('应用图标URL必须为 http/https URL')
return v
class ApplicationUpdateSchema(ApplicationCreateSchema):
"""应用更新模型"""
...
class ApplicationOutSchema(ApplicationCreateSchema, BaseSchema, UserBySchema):
"""应用响应模型"""
model_config = ConfigDict(from_attributes=True)
class ApplicationQueryParam:
"""应用系统查询参数"""
def __init__(
self,
name: str | None = Query(None, description="应用名称"),
status: str | None = Query(None, description="是否启用"),
created_time: list[DateTimeStr] | None = Query(None, description="创建时间范围", examples=["2025-01-01 00:00:00", "2025-12-31 23:59:59"]),
updated_time: list[DateTimeStr] | None = Query(None, description="更新时间范围", examples=["2025-01-01 00:00:00", "2025-12-31 23:59:59"]),
created_id: int | None = Query(None, description="创建人"),
updated_id: int | None = Query(None, description="更新人"),
) -> None:
# 模糊查询字段
self.name = ("like", name) if name else None
# 精确查询字段
self.status = status
self.created_id = created_id
self.updated_id = updated_id
# 时间范围查询
if created_time and len(created_time) == 2:
self.created_time = ("between", (created_time[0], created_time[1]))
if updated_time and len(updated_time) == 2:
self.updated_time = ("between", (updated_time[0], updated_time[1]))

View File

@@ -0,0 +1,133 @@
# -*- coding: utf-8 -*-
from app.core.base_schema import BatchSetAvailable
from app.core.exceptions import CustomException
from app.api.v1.module_system.auth.schema import AuthSchema
from .schema import (
ApplicationCreateSchema,
ApplicationUpdateSchema,
ApplicationOutSchema,
ApplicationQueryParam
)
from .crud import ApplicationCRUD
class ApplicationService:
"""
应用系统管理服务层
"""
@classmethod
async def detail_service(cls, auth: AuthSchema, id: int) -> dict:
"""
获取应用详情
参数:
- auth (AuthSchema): 认证信息模型
- id (int): 应用ID
返回:
- dict: 应用详情字典
"""
obj = await ApplicationCRUD(auth).get_by_id_crud(id=id)
if not obj:
raise CustomException(msg='应用不存在')
return ApplicationOutSchema.model_validate(obj).model_dump()
@classmethod
async def list_service(cls, auth: AuthSchema, search: ApplicationQueryParam | None = None, order_by: list[dict[str, str]] | None = None) -> list[dict]:
"""
获取应用列表
参数:
- auth (AuthSchema): 认证信息模型
- search (ApplicationQueryParam | None): 查询参数模型
- order_by (list[dict[str, str]] | None): 排序参数,支持字符串或字典列表
返回:
- list[dict]: 应用详情字典列表
"""
# 过滤空值
search_dict = search.__dict__ if search else None
obj_list = await ApplicationCRUD(auth).list_crud(search=search_dict, order_by=order_by)
return [ApplicationOutSchema.model_validate(obj).model_dump() for obj in obj_list]
@classmethod
async def create_service(cls, auth: AuthSchema, data: ApplicationCreateSchema) -> dict:
"""
创建应用
参数:
- auth (AuthSchema): 认证信息模型
- data (ApplicationCreateSchema): 应用创建模型
返回:
- Dict: 应用详情字典
"""
# 检查名称是否重复
obj = await ApplicationCRUD(auth).get(name=data.name)
if obj:
raise CustomException(msg='创建失败,应用名称已存在')
obj = await ApplicationCRUD(auth).create_crud(data=data)
return ApplicationOutSchema.model_validate(obj).model_dump()
@classmethod
async def update_service(cls, auth: AuthSchema, id: int, data: ApplicationUpdateSchema) -> dict:
"""
更新应用
参数:
- auth (AuthSchema): 认证信息模型
- id (int): 应用ID
- data (ApplicationUpdateSchema): 应用更新模型
返回:
- Dict: 应用详情字典
"""
obj = await ApplicationCRUD(auth).get_by_id_crud(id=id)
if not obj:
raise CustomException(msg='更新失败,该应用不存在')
# 检查名称重复
exist_obj = await ApplicationCRUD(auth).get(name=data.name)
if exist_obj and exist_obj.id != id:
raise CustomException(msg='更新失败,应用名称重复')
obj = await ApplicationCRUD(auth).update_crud(id=id, data=data)
return ApplicationOutSchema.model_validate(obj).model_dump()
@classmethod
async def delete_service(cls, auth: AuthSchema, ids: list[int]) -> None:
"""
删除应用
参数:
- auth (AuthSchema): 认证信息模型
- ids (list[int]): 应用ID列表
返回:
- None
"""
if len(ids) < 1:
raise CustomException(msg='删除失败,删除对象不能为空')
for id in ids:
obj = await ApplicationCRUD(auth).get_by_id_crud(id=id)
if not obj:
raise CustomException(msg=f'删除失败,应用 {id} 不存在')
await ApplicationCRUD(auth).delete_crud(ids=ids)
@classmethod
async def set_available_service(cls, auth: AuthSchema, data: BatchSetAvailable) -> None:
"""
批量设置应用状态
参数:
- auth (AuthSchema): 认证信息模型
- data (BatchSetAvailable): 批量设置应用状态模型
返回:
- None
"""
await ApplicationCRUD(auth).set_available_crud(ids=data.ids, status=data.status)