chore: add documentation comments and stylecop rules

src/Application/TakeoutSaaS.Application/Identity/Handlers/CopyRoleTemplateCommandHandler.cs

@@ -26,6 +26,7 @@ public sealed class CopyRoleTemplateCommandHandler(
     /// <inheritdoc />
     public async Task<RoleDto> Handle(CopyRoleTemplateCommand request, CancellationToken cancellationToken)
     {
+        // 1. 查询模板与模板权限
         var template = await roleTemplateRepository.FindByCodeAsync(request.TemplateCode, cancellationToken)
             ?? throw new BusinessException(ErrorCodes.NotFound, $"角色模板 {request.TemplateCode} 不存在");
 
@@ -36,6 +37,7 @@ public sealed class CopyRoleTemplateCommandHandler(
             .Distinct(StringComparer.OrdinalIgnoreCase)
             .ToArray();
 
+        // 2. 计算角色名称/编码与描述
         var tenantId = tenantProvider.GetCurrentTenantId();
         var roleCode = string.IsNullOrWhiteSpace(request.RoleCode) ? template.TemplateCode : request.RoleCode.Trim();
         var roleName = string.IsNullOrWhiteSpace(request.RoleName) ? template.Name : request.RoleName.Trim();
@@ -69,7 +71,7 @@ public sealed class CopyRoleTemplateCommandHandler(
             await roleRepository.UpdateAsync(role, cancellationToken);
         }
 
-        // 2. 确保模板权限全部存在，不存在则按模板定义创建。
+        // 3. 确保模板权限全部存在，不存在则按模板定义创建。
         var existingPermissions = await permissionRepository.GetByCodesAsync(tenantId, permissionCodes, cancellationToken);
         var permissionMap = existingPermissions.ToDictionary(x => x.Code, StringComparer.OrdinalIgnoreCase);
 
@@ -94,7 +96,7 @@ public sealed class CopyRoleTemplateCommandHandler(
 
         await roleRepository.SaveChangesAsync(cancellationToken);
 
-        // 3. 绑定缺失的权限，保留租户自定义的已有授权。
+        // 4. 绑定缺失的权限，保留租户自定义的已有授权。
         var rolePermissions = await rolePermissionRepository.GetByRoleIdsAsync(tenantId, new[] { role.Id }, cancellationToken);
         var existingPermissionIds = rolePermissions
             .Select(x => x.PermissionId)