chore: 提交当前变更

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

@@ -0,0 +1,126 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using TakeoutSaaS.Application.Dictionary.Abstractions;
+using TakeoutSaaS.Application.Dictionary.Contracts;
+using TakeoutSaaS.Application.Dictionary.Models;
+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}/dictionaries")]
+public sealed class DictionaryController : BaseApiController
+{
+    private readonly IDictionaryAppService _dictionaryAppService;
+
+    /// <summary>
+    /// 初始化字典控制器。
+    /// </summary>
+    /// <param name="dictionaryAppService">字典服务</param>
+    public DictionaryController(IDictionaryAppService dictionaryAppService)
+    {
+        _dictionaryAppService = dictionaryAppService;
+    }
+
+    /// <summary>
+    /// 查询字典分组。
+    /// </summary>
+    [HttpGet]
+    [PermissionAuthorize("dictionary:group:read")]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyList<DictionaryGroupDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<IReadOnlyList<DictionaryGroupDto>>> GetGroups([FromQuery] DictionaryGroupQuery query, CancellationToken cancellationToken)
+    {
+        var groups = await _dictionaryAppService.SearchGroupsAsync(query, cancellationToken);
+        return ApiResponse<IReadOnlyList<DictionaryGroupDto>>.Ok(groups);
+    }
+
+    /// <summary>
+    /// 创建字典分组。
+    /// </summary>
+    [HttpPost]
+    [PermissionAuthorize("dictionary:group:create")]
+    [ProducesResponseType(typeof(ApiResponse<DictionaryGroupDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<DictionaryGroupDto>> CreateGroup([FromBody] CreateDictionaryGroupRequest request, CancellationToken cancellationToken)
+    {
+        var group = await _dictionaryAppService.CreateGroupAsync(request, cancellationToken);
+        return ApiResponse<DictionaryGroupDto>.Ok(group);
+    }
+
+    /// <summary>
+    /// 更新字典分组。
+    /// </summary>
+    [HttpPut("{groupId:guid}")]
+    [PermissionAuthorize("dictionary:group:update")]
+    [ProducesResponseType(typeof(ApiResponse<DictionaryGroupDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<DictionaryGroupDto>> UpdateGroup(Guid groupId, [FromBody] UpdateDictionaryGroupRequest request, CancellationToken cancellationToken)
+    {
+        var group = await _dictionaryAppService.UpdateGroupAsync(groupId, request, cancellationToken);
+        return ApiResponse<DictionaryGroupDto>.Ok(group);
+    }
+
+    /// <summary>
+    /// 删除字典分组。
+    /// </summary>
+    [HttpDelete("{groupId:guid}")]
+    [PermissionAuthorize("dictionary:group:delete")]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<object>> DeleteGroup(Guid groupId, CancellationToken cancellationToken)
+    {
+        await _dictionaryAppService.DeleteGroupAsync(groupId, cancellationToken);
+        return ApiResponse.Success();
+    }
+
+    /// <summary>
+    /// 创建字典项。
+    /// </summary>
+    [HttpPost("{groupId:guid}/items")]
+    [PermissionAuthorize("dictionary:item:create")]
+    [ProducesResponseType(typeof(ApiResponse<DictionaryItemDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<DictionaryItemDto>> CreateItem(Guid groupId, [FromBody] CreateDictionaryItemRequest request, CancellationToken cancellationToken)
+    {
+        request.GroupId = groupId;
+        var item = await _dictionaryAppService.CreateItemAsync(request, cancellationToken);
+        return ApiResponse<DictionaryItemDto>.Ok(item);
+    }
+
+    /// <summary>
+    /// 更新字典项。
+    /// </summary>
+    [HttpPut("items/{itemId:guid}")]
+    [PermissionAuthorize("dictionary:item:update")]
+    [ProducesResponseType(typeof(ApiResponse<DictionaryItemDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<DictionaryItemDto>> UpdateItem(Guid itemId, [FromBody] UpdateDictionaryItemRequest request, CancellationToken cancellationToken)
+    {
+        var item = await _dictionaryAppService.UpdateItemAsync(itemId, request, cancellationToken);
+        return ApiResponse<DictionaryItemDto>.Ok(item);
+    }
+
+    /// <summary>
+    /// 删除字典项。
+    /// </summary>
+    [HttpDelete("items/{itemId:guid}")]
+    [PermissionAuthorize("dictionary:item:delete")]
+    [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<object>> DeleteItem(Guid itemId, CancellationToken cancellationToken)
+    {
+        await _dictionaryAppService.DeleteItemAsync(itemId, cancellationToken);
+        return ApiResponse.Success();
+    }
+
+    /// <summary>
+    /// 批量获取字典项（命中缓存）。
+    /// </summary>
+    [HttpPost("batch")]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyDictionary<string, IReadOnlyList<DictionaryItemDto>>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<IReadOnlyDictionary<string, IReadOnlyList<DictionaryItemDto>>>> BatchGet([FromBody] DictionaryBatchQueryRequest request, CancellationToken cancellationToken)
+    {
+        var dictionaries = await _dictionaryAppService.GetCachedItemsAsync(request, cancellationToken);
+        return ApiResponse<IReadOnlyDictionary<string, IReadOnlyList<DictionaryItemDto>>>.Ok(dictionaries);
+    }
+}