Add system notice interface (#487)

backend/app/admin/api/v1/sys/__init__.py

@@ -10,6 +10,7 @@ from backend.app.admin.api.v1.sys.dept import router as dept_router
 from backend.app.admin.api.v1.sys.dict_data import router as dict_data_router
 from backend.app.admin.api.v1.sys.dict_type import router as dict_type_router
 from backend.app.admin.api.v1.sys.menu import router as menu_router
+from backend.app.admin.api.v1.sys.notice import router as notice_router
 from backend.app.admin.api.v1.sys.role import router as role_router
 from backend.app.admin.api.v1.sys.user import router as user_router
 
@@ -25,3 +26,4 @@ router.include_router(menu_router, prefix='/menus', tags=['系统目录'])
 router.include_router(role_router, prefix='/roles', tags=['系统角色'])
 router.include_router(user_router, prefix='/users', tags=['系统用户'])
 router.include_router(data_rule_router, prefix='/data-rules', tags=['系统数据权限规则'])
+router.include_router(notice_router, prefix='/notices', tags=['系统通知公告'])

backend/app/admin/api/v1/sys/notice.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+from typing import Annotated
+
+from fastapi import APIRouter, Depends, Path, Query
+
+from backend.app.admin.schema.notice import CreateNoticeParam, GetNoticeListDetails, UpdateNoticeParam
+from backend.app.admin.service.notice_service import notice_service
+from backend.common.pagination import DependsPagination, paging_data
+from backend.common.response.response_schema import ResponseModel, response_base
+from backend.common.security.jwt import DependsJwtAuth
+from backend.common.security.permission import RequestPermission
+from backend.common.security.rbac import DependsRBAC
+from backend.database.db import CurrentSession
+
+router = APIRouter()
+
+
+@router.get('/{pk}', summary='获取通知公告详情', dependencies=[DependsJwtAuth])
+async def get_notice(pk: Annotated[int, Path(...)]) -> ResponseModel:
+    notice = await notice_service.get(pk=pk)
+    return response_base.success(data=notice)
+
+
+@router.get(
+    '',
+    summary='（模糊条件）分页获取所有通知公告',
+    dependencies=[
+        DependsJwtAuth,
+        DependsPagination,
+    ],
+)
+async def get_pagination_notice(db: CurrentSession) -> ResponseModel:
+    notice_select = await notice_service.get_select()
+    page_data = await paging_data(db, notice_select, GetNoticeListDetails)
+    return response_base.success(data=page_data)
+
+
+@router.post(
+    '',
+    summary='创建通知公告',
+    dependencies=[
+        Depends(RequestPermission('sys:notice:add')),
+        DependsRBAC,
+    ],
+)
+async def create_notice(obj: CreateNoticeParam) -> ResponseModel:
+    await notice_service.create(obj=obj)
+    return response_base.success()
+
+
+@router.put(
+    '/{pk}',
+    summary='更新通知公告',
+    dependencies=[
+        Depends(RequestPermission('sys:notice:edit')),
+        DependsRBAC,
+    ],
+)
+async def update_notice(pk: Annotated[int, Path(...)], obj: UpdateNoticeParam) -> ResponseModel:
+    count = await notice_service.update(pk=pk, obj=obj)
+    if count > 0:
+        return response_base.success()
+    return response_base.fail()
+
+
+@router.delete(
+    '',
+    summary='（批量）删除通知公告',
+    dependencies=[
+        Depends(RequestPermission('sys:notice:del')),
+        DependsRBAC,
+    ],
+)
+async def delete_notice(pk: Annotated[list[int], Query(...)]) -> ResponseModel:
+    count = await notice_service.delete(pk=pk)
+    if count > 0:
+        return response_base.success()
+    return response_base.fail()