docs: 完善参数注释与StyleCop配置

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantAnnouncementReadRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 
 namespace TakeoutSaaS.Domain.Tenants.Repositories;
@@ -44,11 +41,13 @@ public interface ITenantAnnouncementReadRepository
     /// </summary>
     /// <param name="record">已读实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantAnnouncementRead record, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 保存变更。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantAnnouncementRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 using TakeoutSaaS.Domain.Tenants.Enums;
 
@@ -41,6 +38,7 @@ public interface ITenantAnnouncementRepository
     /// </summary>
     /// <param name="announcement">公告实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantAnnouncement announcement, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -48,6 +46,7 @@ public interface ITenantAnnouncementRepository
     /// </summary>
     /// <param name="announcement">公告实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(TenantAnnouncement announcement, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -56,11 +55,13 @@ public interface ITenantAnnouncementRepository
     /// <param name="tenantId">租户 ID。</param>
     /// <param name="announcementId">公告 ID。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteAsync(long tenantId, long announcementId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 保存变更。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantBillingRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 using TakeoutSaaS.Domain.Tenants.Enums;
 
@@ -50,6 +47,7 @@ public interface ITenantBillingRepository
     /// </summary>
     /// <param name="bill">账单实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantBillingStatement bill, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -57,11 +55,13 @@ public interface ITenantBillingRepository
     /// </summary>
     /// <param name="bill">账单实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(TenantBillingStatement bill, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 保存变更。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantNotificationRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 using TakeoutSaaS.Domain.Tenants.Enums;
 
@@ -43,6 +40,7 @@ public interface ITenantNotificationRepository
     /// </summary>
     /// <param name="notification">通知实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantNotification notification, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -50,11 +48,13 @@ public interface ITenantNotificationRepository
     /// </summary>
     /// <param name="notification">通知实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(TenantNotification notification, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 保存变更。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantPackageRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 
 namespace TakeoutSaaS.Domain.Tenants.Repositories;
@@ -32,6 +29,7 @@ public interface ITenantPackageRepository
     /// </summary>
     /// <param name="package">套餐实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantPackage package, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -39,6 +37,7 @@ public interface ITenantPackageRepository
     /// </summary>
     /// <param name="package">套餐实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(TenantPackage package, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -46,11 +45,13 @@ public interface ITenantPackageRepository
     /// </summary>
     /// <param name="id">套餐 ID（雪花算法）。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteAsync(long id, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantQuotaUsageRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 using TakeoutSaaS.Domain.Tenants.Enums;
 
@@ -33,6 +30,7 @@ public interface ITenantQuotaUsageRepository
     /// </summary>
     /// <param name="usage">配额使用实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(TenantQuotaUsage usage, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -40,11 +38,13 @@ public interface ITenantQuotaUsageRepository
     /// </summary>
     /// <param name="usage">配额使用实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(TenantQuotaUsage usage, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Tenants/Repositories/ITenantRepository.cs

@@ -1,5 +1,3 @@
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Tenants.Entities;
 using TakeoutSaaS.Domain.Tenants.Enums;
 
@@ -35,6 +33,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="tenant">租户实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddTenantAsync(Tenant tenant, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -42,6 +41,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="tenant">租户实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateTenantAsync(Tenant tenant, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -65,6 +65,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="profile">实名资料实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpsertVerificationProfileAsync(TenantVerificationProfile profile, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -89,6 +90,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="subscription">订阅实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddSubscriptionAsync(TenantSubscription subscription, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -96,6 +98,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="subscription">订阅实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateSubscriptionAsync(TenantSubscription subscription, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -103,6 +106,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="history">订阅历史实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddSubscriptionHistoryAsync(TenantSubscriptionHistory history, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -118,6 +122,7 @@ public interface ITenantRepository
     /// </summary>
     /// <param name="log">审核日志实体。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAuditLogAsync(TenantAuditLog log, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -132,5 +137,6 @@ public interface ITenantRepository
     /// 持久化。
     /// </summary>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }