feat: 系统参数应用层与验证

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

@@ -0,0 +1,115 @@
+using MediatR;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using TakeoutSaaS.Application.App.SystemParameters.Commands;
+using TakeoutSaaS.Application.App.SystemParameters.Dto;
+using TakeoutSaaS.Application.App.SystemParameters.Queries;
+using TakeoutSaaS.Module.Authorization.Attributes;
+using TakeoutSaaS.Shared.Abstractions.Constants;
+using TakeoutSaaS.Shared.Abstractions.Results;
+using TakeoutSaaS.Shared.Web.Api;
+
+namespace TakeoutSaaS.AdminApi.Controllers;
+
+/// <summary>
+/// 系统参数管理。
+/// </summary>
+/// <remarks>
+/// 提供参数的新增、修改、查询与删除。
+/// </remarks>
+[ApiVersion("1.0")]
+[Authorize]
+[Route("api/admin/v{version:apiVersion}/system-parameters")]
+public sealed class SystemParametersController(IMediator mediator) : BaseApiController
+{
+    /// <summary>
+    /// 创建系统参数。
+    /// </summary>
+    [HttpPost]
+    [PermissionAuthorize("system-parameter:create")]
+    [ProducesResponseType(typeof(ApiResponse<SystemParameterDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<SystemParameterDto>> Create([FromBody] CreateSystemParameterCommand command, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(command, cancellationToken);
+        return ApiResponse<SystemParameterDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 查询系统参数列表。
+    /// </summary>
+    [HttpGet]
+    [PermissionAuthorize("system-parameter:read")]
+    [ProducesResponseType(typeof(ApiResponse<PagedResult<SystemParameterDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<PagedResult<SystemParameterDto>>> List(
+        [FromQuery] string? keyword,
+        [FromQuery] bool? isEnabled,
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        [FromQuery] string? sortBy = null,
+        [FromQuery] bool sortDesc = true,
+        CancellationToken cancellationToken = default)
+    {
+        var result = await mediator.Send(new SearchSystemParametersQuery
+        {
+            Keyword = keyword,
+            IsEnabled = isEnabled,
+            Page = page,
+            PageSize = pageSize,
+            SortBy = sortBy,
+            SortDescending = sortDesc
+        }, cancellationToken);
+
+        return ApiResponse<PagedResult<SystemParameterDto>>.Ok(result);
+    }
+
+    /// <summary>
+    /// 获取系统参数详情。
+    /// </summary>
+    [HttpGet("{parameterId:long}")]
+    [PermissionAuthorize("system-parameter:read")]
+    [ProducesResponseType(typeof(ApiResponse<SystemParameterDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<SystemParameterDto>> Detail(long parameterId, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new GetSystemParameterByIdQuery(parameterId), cancellationToken);
+        return result == null
+            ? ApiResponse<SystemParameterDto>.Error(ErrorCodes.NotFound, "系统参数不存在")
+            : ApiResponse<SystemParameterDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 更新系统参数。
+    /// </summary>
+    [HttpPut("{parameterId:long}")]
+    [PermissionAuthorize("system-parameter:update")]
+    [ProducesResponseType(typeof(ApiResponse<SystemParameterDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<SystemParameterDto>> Update(long parameterId, [FromBody] UpdateSystemParameterCommand command, CancellationToken cancellationToken)
+    {
+        if (command.ParameterId == 0)
+        {
+            command = command with { ParameterId = parameterId };
+        }
+
+        var result = await mediator.Send(command, cancellationToken);
+        return result == null
+            ? ApiResponse<SystemParameterDto>.Error(ErrorCodes.NotFound, "系统参数不存在")
+            : ApiResponse<SystemParameterDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 删除系统参数。
+    /// </summary>
+    [HttpDelete("{parameterId:long}")]
+    [PermissionAuthorize("system-parameter:delete")]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<object>> Delete(long parameterId, CancellationToken cancellationToken)
+    {
+        var success = await mediator.Send(new DeleteSystemParameterCommand { ParameterId = parameterId }, cancellationToken);
+        return success
+            ? ApiResponse.Success()
+            : ApiResponse<object>.Error(ErrorCodes.NotFound, "系统参数不存在");
+    }
+}