feat: 新增RBAC角色模板复制与初始化

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

@@ -1,3 +1,4 @@
+using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations;
 using MediatR;
 using Microsoft.AspNetCore.Authorization;
@@ -20,6 +21,78 @@ namespace TakeoutSaaS.AdminApi.Controllers;
 [Route("api/admin/v{version:apiVersion}/roles")]
 public sealed class RolesController(IMediator mediator) : BaseApiController
 {
+    /// <summary>
+    /// 获取预置角色模板列表。
+    /// </summary>
+    /// <remarks>
+    /// 示例：GET /api/admin/v1/roles/templates
+    /// </remarks>
+    [HttpGet("templates")]
+    [PermissionAuthorize("identity:role:read")]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyList<RoleTemplateDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<IReadOnlyList<RoleTemplateDto>>> ListTemplates(CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new ListRoleTemplatesQuery(), cancellationToken);
+        return ApiResponse<IReadOnlyList<RoleTemplateDto>>.Ok(result);
+    }
+
+    /// <summary>
+    /// 获取单个角色模板详情。
+    /// </summary>
+    /// <remarks>
+    /// 示例：GET /api/admin/v1/roles/templates/tenant-admin
+    /// </remarks>
+    [HttpGet("templates/{templateCode}")]
+    [PermissionAuthorize("identity:role:read")]
+    [ProducesResponseType(typeof(ApiResponse<RoleTemplateDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiResponse<RoleTemplateDto>), StatusCodes.Status404NotFound)]
+    public async Task<ApiResponse<RoleTemplateDto>> GetTemplate(string templateCode, CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new GetRoleTemplateQuery { TemplateCode = templateCode }, cancellationToken);
+        return result is null
+            ? ApiResponse<RoleTemplateDto>.Error(StatusCodes.Status404NotFound, "角色模板不存在")
+            : ApiResponse<RoleTemplateDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 按模板复制角色并绑定权限。
+    /// </summary>
+    /// <remarks>
+    /// 示例：POST /api/admin/v1/roles/templates/store-manager/copy
+    /// Body: { "roleName": "新区店长" }
+    /// </remarks>
+    [HttpPost("templates/{templateCode}/copy")]
+    [PermissionAuthorize("identity:role:create")]
+    [ProducesResponseType(typeof(ApiResponse<RoleDto>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<RoleDto>> CopyFromTemplate(
+        string templateCode,
+        [FromBody, Required] CopyRoleTemplateCommand command,
+        CancellationToken cancellationToken)
+    {
+        command = command with { TemplateCode = templateCode };
+        var result = await mediator.Send(command, cancellationToken);
+        return ApiResponse<RoleDto>.Ok(result);
+    }
+
+    /// <summary>
+    /// 为当前租户批量初始化预置角色模板。
+    /// </summary>
+    /// <remarks>
+    /// 示例：POST /api/admin/v1/roles/templates/init
+    /// Body: { "templateCodes": ["tenant-admin","store-manager","store-staff"] }
+    /// </remarks>
+    [HttpPost("templates/init")]
+    [PermissionAuthorize("identity:role:create")]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyList<RoleDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<IReadOnlyList<RoleDto>>> InitializeTemplates(
+        [FromBody] InitializeRoleTemplatesCommand? command,
+        CancellationToken cancellationToken)
+    {
+        command ??= new InitializeRoleTemplatesCommand();
+        var result = await mediator.Send(command, cancellationToken);
+        return ApiResponse<IReadOnlyList<RoleDto>>.Ok(result);
+    }
+
     /// <summary>
     /// 分页查询角色。
     /// </summary>