feat: 租户账单公告通知接口

src/Api/TakeoutSaaS.AdminApi/Controllers/TenantAnnouncementsController.cs

@@ -0,0 +1,106 @@
+using System.ComponentModel.DataAnnotations;
+using MediatR;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using TakeoutSaaS.Application.App.Tenants.Commands;
+using TakeoutSaaS.Application.App.Tenants.Dto;
+using TakeoutSaaS.Application.App.Tenants.Queries;
+using TakeoutSaaS.Module.Authorization.Attributes;
+using TakeoutSaaS.Shared.Abstractions.Results;
+using TakeoutSaaS.Shared.Web.Api;
+
+namespace TakeoutSaaS.AdminApi.Controllers;
+
+/// <summary>
+/// 租户公告管理。
+/// </summary>
+[ApiVersion("1.0")]
+[Authorize]
+[Route("api/admin/v{version:apiVersion}/tenants/{tenantId:long}/announcements")]
+public sealed class TenantAnnouncementsController(IMediator mediator) : BaseApiController
+{
+    /// <summary>
+    /// 分页查询公告。
+    /// </summary>
+    [HttpGet]
+    [PermissionAuthorize("tenant-announcement:read")]
+    [ProducesResponseType(typeof(ApiResponse<PagedResult<TenantAnnouncementDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<PagedResult<TenantAnnouncementDto>>> Search(long tenantId, [FromQuery] SearchTenantAnnouncementsQuery query, CancellationToken cancellationToken)
+    {
+        query = query with { TenantId = tenantId };
+        var result = await mediator.Send(query, cancellationToken);
+        return ApiResponse<PagedResult<TenantAnnouncementDto>>.Ok(result);
+    }
+
+    /// <summary>
+    /// 公告详情。
+    /// </summary>
+    [HttpGet("{announcementId:long}")]
+    [PermissionAuthorize("tenant-announcement:read")]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<TenantAnnouncementDto>> Detail(long tenantId, long announcementId, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new GetTenantAnnouncementQuery { TenantId = tenantId, AnnouncementId = announcementId }, cancellationToken);
+        return result is null
+            ? ApiResponse<TenantAnnouncementDto>.Error(StatusCodes.Status404NotFound, "公告不存在")
+            : ApiResponse<TenantAnnouncementDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 创建公告。
+    /// </summary>
+    [HttpPost]
+    [PermissionAuthorize("tenant-announcement:create")]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<TenantAnnouncementDto>> Create(long tenantId, [FromBody, Required] CreateTenantAnnouncementCommand command, CancellationToken cancellationToken)
+    {
+        command = command with { TenantId = tenantId };
+        var result = await mediator.Send(command, cancellationToken);
+        return ApiResponse<TenantAnnouncementDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 更新公告。
+    /// </summary>
+    [HttpPut("{announcementId:long}")]
+    [PermissionAuthorize("tenant-announcement:update")]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<TenantAnnouncementDto>> Update(long tenantId, long announcementId, [FromBody, Required] UpdateTenantAnnouncementCommand command, CancellationToken cancellationToken)
+    {
+        command = command with { TenantId = tenantId, AnnouncementId = announcementId };
+        var result = await mediator.Send(command, cancellationToken);
+        return result is null
+            ? ApiResponse<TenantAnnouncementDto>.Error(StatusCodes.Status404NotFound, "公告不存在")
+            : ApiResponse<TenantAnnouncementDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 删除公告。
+    /// </summary>
+    [HttpDelete("{announcementId:long}")]
+    [PermissionAuthorize("tenant-announcement:delete")]
+    [ProducesResponseType(typeof(ApiResponse<bool>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<bool>> Delete(long tenantId, long announcementId, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new DeleteTenantAnnouncementCommand { TenantId = tenantId, AnnouncementId = announcementId }, cancellationToken);
+        return ApiResponse<bool>.Ok(result);
+    }
+
+    /// <summary>
+    /// 标记公告已读。
+    /// </summary>
+    [HttpPost("{announcementId:long}/read")]
+    [PermissionAuthorize("tenant-announcement:read")]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<TenantAnnouncementDto>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<TenantAnnouncementDto>> MarkRead(long tenantId, long announcementId, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new MarkTenantAnnouncementReadCommand { TenantId = tenantId, AnnouncementId = announcementId }, cancellationToken);
+        return result is null
+            ? ApiResponse<TenantAnnouncementDto>.Error(StatusCodes.Status404NotFound, "公告不存在")
+            : ApiResponse<TenantAnnouncementDto>.Ok(result);
+    }
+}