docs: add xml comments and update ignore rules

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfRolePermissionRepository.cs

@@ -9,25 +9,49 @@ namespace TakeoutSaaS.Infrastructure.Identity.Persistence;
 /// </summary>
 public sealed class EfRolePermissionRepository(IdentityDbContext dbContext) : IRolePermissionRepository
 {
+    /// <summary>
+    /// 根据角色 ID 集合获取角色权限映射。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="roleIds">角色 ID 集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>角色权限映射列表。</returns>
     public Task<IReadOnlyList<RolePermission>> GetByRoleIdsAsync(long tenantId, IEnumerable<long> roleIds, CancellationToken cancellationToken = default)
         => dbContext.RolePermissions.AsNoTracking()
             .Where(x => x.TenantId == tenantId && roleIds.Contains(x.RoleId))
             .ToListAsync(cancellationToken)
             .ContinueWith(t => (IReadOnlyList<RolePermission>)t.Result, cancellationToken);
 
+    /// <summary>
+    /// 批量新增角色权限。
+    /// </summary>
+    /// <param name="rolePermissions">角色权限集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     public async Task AddRangeAsync(IEnumerable<RolePermission> rolePermissions, CancellationToken cancellationToken = default)
     {
+        // 1. 转为数组便于计数
         var toAdd = rolePermissions as RolePermission[] ?? rolePermissions.ToArray();
         if (toAdd.Length == 0)
         {
             return;
         }
 
+        // 2. 批量插入
         await dbContext.RolePermissions.AddRangeAsync(toAdd, cancellationToken);
     }
 
+    /// <summary>
+    /// 替换指定角色的权限集合。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="roleId">角色 ID。</param>
+    /// <param name="permissionIds">权限 ID 集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     public async Task ReplaceRolePermissionsAsync(long tenantId, long roleId, IEnumerable<long> permissionIds, CancellationToken cancellationToken = default)
     {
+        // 1. 使用执行策略保证可靠性
         var strategy = dbContext.Database.CreateExecutionStrategy();
         await strategy.ExecuteAsync(async () =>
         {
@@ -52,6 +76,11 @@ public sealed class EfRolePermissionRepository(IdentityDbContext dbContext) : IR
         });
     }
 
+    /// <summary>
+    /// 保存仓储变更。
+    /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>保存任务。</returns>
     public Task SaveChangesAsync(CancellationToken cancellationToken = default)
         => dbContext.SaveChangesAsync(cancellationToken);
 }