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

src/Domain/TakeoutSaaS.Domain/Deliveries/Repositories/IDeliveryRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Deliveries.Entities;
 using TakeoutSaaS.Domain.Deliveries.Enums;
 
@@ -14,45 +11,77 @@ public interface IDeliveryRepository
     /// <summary>
     /// 依据标识获取配送单。
     /// </summary>
+    /// <param name="deliveryOrderId">配送单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>配送单实体或 null。</returns>
     Task<DeliveryOrder?> FindByIdAsync(long deliveryOrderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 依据订单标识获取配送单。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>配送单实体或 null。</returns>
     Task<DeliveryOrder?> FindByOrderIdAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取配送事件轨迹。
     /// </summary>
+    /// <param name="deliveryOrderId">配送单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>配送事件列表。</returns>
     Task<IReadOnlyList<DeliveryEvent>> GetEventsAsync(long deliveryOrderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增配送单。
     /// </summary>
+    /// <param name="deliveryOrder">配送单实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddDeliveryOrderAsync(DeliveryOrder deliveryOrder, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增配送事件。
     /// </summary>
+    /// <param name="deliveryEvent">配送事件。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddEventAsync(DeliveryEvent deliveryEvent, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按状态查询配送单。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="status">配送状态。</param>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>配送单列表。</returns>
     Task<IReadOnlyList<DeliveryOrder>> SearchAsync(long tenantId, DeliveryStatus? status, long? orderId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新配送单。
     /// </summary>
+    /// <param name="deliveryOrder">配送单实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateDeliveryOrderAsync(DeliveryOrder deliveryOrder, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除配送单及事件。
     /// </summary>
+    /// <param name="deliveryOrderId">配送单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteDeliveryOrderAsync(long deliveryOrderId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Dictionary/Entities/DictionaryGroup.cs

@@ -1,4 +1,3 @@
-using System.Collections.Generic;
 using TakeoutSaaS.Domain.Dictionary.Enums;
 using TakeoutSaaS.Shared.Abstractions.Entities;
 

src/Domain/TakeoutSaaS.Domain/Dictionary/Repositories/IDictionaryRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Dictionary.Entities;
 using TakeoutSaaS.Domain.Dictionary.Enums;
 
@@ -14,55 +11,89 @@ public interface IDictionaryRepository
     /// <summary>
     /// 依据 ID 获取分组。
     /// </summary>
+    /// <param name="id">分组 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>分组实体或 null。</returns>
     Task<DictionaryGroup?> FindGroupByIdAsync(long id, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 依据编码获取分组。
     /// </summary>
+    /// <param name="code">分组编码。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>分组实体或 null。</returns>
     Task<DictionaryGroup?> FindGroupByCodeAsync(string code, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 搜索分组，可按作用域过滤。
     /// </summary>
+    /// <param name="scope">作用域。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>分组集合。</returns>
     Task<IReadOnlyList<DictionaryGroup>> SearchGroupsAsync(DictionaryScope? scope, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增分组。
     /// </summary>
+    /// <param name="group">分组实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddGroupAsync(DictionaryGroup group, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除分组。
     /// </summary>
+    /// <param name="group">分组实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveGroupAsync(DictionaryGroup group, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 依据 ID 获取字典项。
     /// </summary>
+    /// <param name="id">字典项 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项或 null。</returns>
     Task<DictionaryItem?> FindItemByIdAsync(long id, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取某分组下的所有字典项。
     /// </summary>
+    /// <param name="groupId">分组 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项集合。</returns>
     Task<IReadOnlyList<DictionaryItem>> GetItemsByGroupIdAsync(long groupId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按分组编码集合获取字典项（可包含系统参数）。
     /// </summary>
+    /// <param name="codes">分组编码集合。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="includeSystem">是否包含系统分组。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项集合。</returns>
     Task<IReadOnlyList<DictionaryItem>> GetItemsByCodesAsync(IEnumerable<string> codes, long tenantId, bool includeSystem, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增字典项。
     /// </summary>
+    /// <param name="item">字典项实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddItemAsync(DictionaryItem item, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除字典项。
     /// </summary>
+    /// <param name="item">字典项实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveItemAsync(DictionaryItem item, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化更改。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IIdentityUserRepository.cs

@@ -1,7 +1,3 @@
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;
@@ -14,11 +10,17 @@ public interface IIdentityUserRepository
     /// <summary>
     /// 根据账号获取后台用户。
     /// </summary>
+    /// <param name="account">账号。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>后台用户或 null。</returns>
     Task<IdentityUser?> FindByAccountAsync(string account, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 根据 ID 获取后台用户。
     /// </summary>
+    /// <param name="userId">用户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>后台用户或 null。</returns>
     Task<IdentityUser?> FindByIdAsync(long userId, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -27,10 +29,15 @@ public interface IIdentityUserRepository
     /// <param name="tenantId">租户 ID。</param>
     /// <param name="keyword">可选关键字（账号/名称）。</param>
     /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>后台用户列表。</returns>
     Task<IReadOnlyList<IdentityUser>> SearchAsync(long tenantId, string? keyword, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取指定租户、用户集合对应的用户（只读）。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="userIds">用户 ID 集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>后台用户列表。</returns>
     Task<IReadOnlyList<IdentityUser>> GetByIdsAsync(long tenantId, IEnumerable<long> userIds, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IPermissionRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IRolePermissionRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IRoleRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IRoleTemplateRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;

src/Domain/TakeoutSaaS.Domain/Identity/Repositories/IUserRoleRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Identity.Entities;
 
 namespace TakeoutSaaS.Domain.Identity.Repositories;

src/Domain/TakeoutSaaS.Domain/Merchants/Repositories/IMerchantCategoryRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Merchants.Entities;
 
 namespace TakeoutSaaS.Domain.Merchants.Repositories;
@@ -13,35 +10,57 @@ public interface IMerchantCategoryRepository
     /// <summary>
     /// 列出当前租户的类目。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>类目列表。</returns>
     Task<IReadOnlyList<MerchantCategory>> ListAsync(long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 是否存在同名类目。
     /// </summary>
+    /// <param name="name">类目名称。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>存在返回 true。</returns>
     Task<bool> ExistsAsync(string name, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 查找类目。
     /// </summary>
+    /// <param name="id">类目 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>类目实体或 null。</returns>
     Task<MerchantCategory?> FindByIdAsync(long id, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增类目。
     /// </summary>
+    /// <param name="category">类目实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(MerchantCategory category, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除类目。
     /// </summary>
+    /// <param name="category">类目实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveAsync(MerchantCategory category, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 批量更新类目信息。
     /// </summary>
+    /// <param name="categories">类目集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateRangeAsync(IEnumerable<MerchantCategory> categories, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化更改。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Merchants/Repositories/IMerchantRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Merchants.Entities;
 using TakeoutSaaS.Domain.Merchants.Enums;
 
@@ -14,21 +11,37 @@ public interface IMerchantRepository
     /// <summary>
     /// 依据标识获取商户。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>商户实体或 null。</returns>
     Task<Merchant?> FindByIdAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按状态筛选商户列表。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="status">状态过滤。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>商户集合。</returns>
     Task<IReadOnlyList<Merchant>> SearchAsync(long tenantId, MerchantStatus? status, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取指定商户的员工列表。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>员工集合。</returns>
     Task<IReadOnlyList<MerchantStaff>> GetStaffAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取指定商户的合同列表。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>合同集合。</returns>
     Task<IReadOnlyList<MerchantContract>> GetContractsAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -44,6 +57,10 @@ public interface IMerchantRepository
     /// <summary>
     /// 获取指定商户的资质文件列表。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>资质文件列表。</returns>
     Task<IReadOnlyList<MerchantDocument>> GetDocumentsAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -59,16 +76,25 @@ public interface IMerchantRepository
     /// <summary>
     /// 新增商户主体。
     /// </summary>
+    /// <param name="merchant">商户实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddMerchantAsync(Merchant merchant, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增商户员工。
     /// </summary>
+    /// <param name="staff">员工实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddStaffAsync(MerchantStaff staff, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增商户合同。
     /// </summary>
+    /// <param name="contract">合同实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddContractAsync(MerchantContract contract, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -82,6 +108,9 @@ public interface IMerchantRepository
     /// <summary>
     /// 新增商户资质文件。
     /// </summary>
+    /// <param name="document">资质文件实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddDocumentAsync(MerchantDocument document, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -95,25 +124,41 @@ public interface IMerchantRepository
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新商户信息。
     /// </summary>
+    /// <param name="merchant">商户实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateMerchantAsync(Merchant merchant, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商户。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteMerchantAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 记录审核日志。
     /// </summary>
+    /// <param name="log">审核日志实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAuditLogAsync(MerchantAuditLog log, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取审核日志。
     /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>审核日志列表。</returns>
     Task<IReadOnlyList<MerchantAuditLog>> GetAuditLogsAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Orders/Repositories/IOrderRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Orders.Entities;
 using TakeoutSaaS.Domain.Orders.Enums;
 using TakeoutSaaS.Domain.Payments.Enums;
@@ -15,65 +12,111 @@ public interface IOrderRepository
     /// <summary>
     /// 依据标识获取订单。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>订单实体或 null。</returns>
     Task<Order?> FindByIdAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 依据订单号获取订单。
     /// </summary>
+    /// <param name="orderNo">订单号。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>订单实体或 null。</returns>
     Task<Order?> FindByOrderNoAsync(string orderNo, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按状态筛选订单列表。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="status">订单状态。</param>
+    /// <param name="paymentStatus">支付状态。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>订单集合。</returns>
     Task<IReadOnlyList<Order>> SearchAsync(long tenantId, OrderStatus? status, PaymentStatus? paymentStatus, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取订单明细行。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>订单明细集合。</returns>
     Task<IReadOnlyList<OrderItem>> GetItemsAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取订单状态流转记录。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>状态变更记录列表。</returns>
     Task<IReadOnlyList<OrderStatusHistory>> GetStatusHistoryAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取订单退款申请。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>退款申请列表。</returns>
     Task<IReadOnlyList<RefundRequest>> GetRefundsAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增订单。
     /// </summary>
+    /// <param name="order">订单实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddOrderAsync(Order order, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增订单明细。
     /// </summary>
+    /// <param name="items">明细集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddItemsAsync(IEnumerable<OrderItem> items, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增订单状态记录。
     /// </summary>
+    /// <param name="history">状态记录。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddStatusHistoryAsync(OrderStatusHistory history, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增退款申请。
     /// </summary>
+    /// <param name="refund">退款申请实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddRefundAsync(RefundRequest refund, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新订单。
     /// </summary>
+    /// <param name="order">订单实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateOrderAsync(Order order, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除订单。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteOrderAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Payments/Repositories/IPaymentRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Payments.Entities;
 using TakeoutSaaS.Domain.Payments.Enums;
 
@@ -14,45 +11,76 @@ public interface IPaymentRepository
     /// <summary>
     /// 依据标识获取支付记录。
     /// </summary>
+    /// <param name="paymentId">支付记录 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>支付记录或 null。</returns>
     Task<PaymentRecord?> FindByIdAsync(long paymentId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 依据订单标识获取支付记录。
     /// </summary>
+    /// <param name="orderId">订单 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>支付记录或 null。</returns>
     Task<PaymentRecord?> FindByOrderIdAsync(long orderId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取支付对应的退款记录。
     /// </summary>
+    /// <param name="paymentId">支付记录 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>退款记录列表。</returns>
     Task<IReadOnlyList<PaymentRefundRecord>> GetRefundsAsync(long paymentId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增支付记录。
     /// </summary>
+    /// <param name="payment">支付实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddPaymentAsync(PaymentRecord payment, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增退款记录。
     /// </summary>
+    /// <param name="refund">退款实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddRefundAsync(PaymentRefundRecord refund, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按状态筛选支付记录。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="status">支付状态。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>支付记录列表。</returns>
     Task<IReadOnlyList<PaymentRecord>> SearchAsync(long tenantId, PaymentStatus? status, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新支付记录。
     /// </summary>
+    /// <param name="payment">支付实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdatePaymentAsync(PaymentRecord payment, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除支付记录及关联退款。
     /// </summary>
+    /// <param name="paymentId">支付记录 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeletePaymentAsync(long paymentId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Products/Repositories/IProductRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Products.Entities;
 using TakeoutSaaS.Domain.Products.Enums;
 
@@ -14,135 +11,234 @@ public interface IProductRepository
     /// <summary>
     /// 依据标识获取商品。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>商品实体或 null。</returns>
     Task<Product?> FindByIdAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按分类与状态筛选商品列表。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="categoryId">分类 ID。</param>
+    /// <param name="status">商品状态。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>商品集合。</returns>
     Task<IReadOnlyList<Product>> SearchAsync(long tenantId, long? categoryId, ProductStatus? status, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取租户下的商品分类。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>分类集合。</returns>
     Task<IReadOnlyList<ProductCategory>> GetCategoriesAsync(long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品 SKU。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>SKU 集合。</returns>
     Task<IReadOnlyList<ProductSku>> GetSkusAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品加料组与选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>加料组集合。</returns>
     Task<IReadOnlyList<ProductAddonGroup>> GetAddonGroupsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品加料选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>加料选项集合。</returns>
     Task<IReadOnlyList<ProductAddonOption>> GetAddonOptionsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品规格组与选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>规格组集合。</returns>
     Task<IReadOnlyList<ProductAttributeGroup>> GetAttributeGroupsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品规格选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>规格选项集合。</returns>
     Task<IReadOnlyList<ProductAttributeOption>> GetAttributeOptionsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品媒资。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>媒资列表。</returns>
     Task<IReadOnlyList<ProductMediaAsset>> GetMediaAssetsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取商品定价规则。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>定价规则集合。</returns>
     Task<IReadOnlyList<ProductPricingRule>> GetPricingRulesAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增分类。
     /// </summary>
+    /// <param name="category">分类实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddCategoryAsync(ProductCategory category, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增商品。
     /// </summary>
+    /// <param name="product">商品实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddProductAsync(Product product, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增 SKU。
     /// </summary>
+    /// <param name="skus">SKU 集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddSkusAsync(IEnumerable<ProductSku> skus, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增加料组与选项。
     /// </summary>
+    /// <param name="groups">加料组集合。</param>
+    /// <param name="options">加料选项集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAddonGroupsAsync(IEnumerable<ProductAddonGroup> groups, IEnumerable<ProductAddonOption> options, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增规格组与选项。
     /// </summary>
+    /// <param name="groups">规格组集合。</param>
+    /// <param name="options">规格选项集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAttributeGroupsAsync(IEnumerable<ProductAttributeGroup> groups, IEnumerable<ProductAttributeOption> options, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增媒资。
     /// </summary>
+    /// <param name="assets">媒资集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddMediaAssetsAsync(IEnumerable<ProductMediaAsset> assets, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增定价规则。
     /// </summary>
+    /// <param name="rules">定价规则集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddPricingRulesAsync(IEnumerable<ProductPricingRule> rules, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新商品。
     /// </summary>
+    /// <param name="product">商品实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateProductAsync(Product product, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteProductAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新分类。
     /// </summary>
+    /// <param name="category">分类实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateCategoryAsync(ProductCategory category, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除分类。
     /// </summary>
+    /// <param name="categoryId">分类 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteCategoryAsync(long categoryId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品下的 SKU。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveSkusAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品下的加料组及选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveAddonGroupsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品下的规格组及选项。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveAttributeGroupsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品媒资。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveMediaAssetsAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除商品定价规则。
     /// </summary>
+    /// <param name="productId">商品 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemovePricingRulesAsync(long productId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/Stores/Repositories/IStoreRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.Stores.Entities;
 using TakeoutSaaS.Domain.Stores.Enums;
 
@@ -14,90 +11,152 @@ public interface IStoreRepository
     /// <summary>
     /// 依据标识获取门店。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>门店实体或 null。</returns>
     Task<Store?> FindByIdAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 按租户筛选门店列表。
     /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="status">状态过滤。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>门店集合。</returns>
     Task<IReadOnlyList<Store>> SearchAsync(long tenantId, StoreStatus? status, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店营业时段。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>营业时段列表。</returns>
     Task<IReadOnlyList<StoreBusinessHour>> GetBusinessHoursAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店配送区域配置。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>配送区域列表。</returns>
     Task<IReadOnlyList<StoreDeliveryZone>> GetDeliveryZonesAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店节假日配置。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>节假日配置列表。</returns>
     Task<IReadOnlyList<StoreHoliday>> GetHolidaysAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店桌台区域。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>桌台区域列表。</returns>
     Task<IReadOnlyList<StoreTableArea>> GetTableAreasAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店桌台列表。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>桌台列表。</returns>
     Task<IReadOnlyList<StoreTable>> GetTablesAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店员工排班。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>排班列表。</returns>
     Task<IReadOnlyList<StoreEmployeeShift>> GetShiftsAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增门店。
     /// </summary>
+    /// <param name="store">门店实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddStoreAsync(Store store, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增营业时段。
     /// </summary>
+    /// <param name="hours">营业时段集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddBusinessHoursAsync(IEnumerable<StoreBusinessHour> hours, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增配送区域。
     /// </summary>
+    /// <param name="zones">配送区域集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddDeliveryZonesAsync(IEnumerable<StoreDeliveryZone> zones, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增节假日配置。
     /// </summary>
+    /// <param name="holidays">节假日集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddHolidaysAsync(IEnumerable<StoreHoliday> holidays, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增桌台区域。
     /// </summary>
+    /// <param name="areas">桌台区域集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddTableAreasAsync(IEnumerable<StoreTableArea> areas, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增桌台。
     /// </summary>
+    /// <param name="tables">桌台集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddTablesAsync(IEnumerable<StoreTable> tables, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增排班。
     /// </summary>
+    /// <param name="shifts">排班集合。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddShiftsAsync(IEnumerable<StoreEmployeeShift> shifts, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化变更。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新门店。
     /// </summary>
+    /// <param name="store">门店实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateStoreAsync(Store store, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除门店。
     /// </summary>
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task DeleteStoreAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
 }

src/Domain/TakeoutSaaS.Domain/SystemParameters/Repositories/ISystemParameterRepository.cs

@@ -1,6 +1,3 @@
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using TakeoutSaaS.Domain.SystemParameters.Entities;
 
 namespace TakeoutSaaS.Domain.SystemParameters.Repositories;
@@ -13,35 +10,56 @@ public interface ISystemParameterRepository
     /// <summary>
     /// 根据标识获取系统参数。
     /// </summary>
+    /// <param name="id">参数 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>系统参数或 null。</returns>
     Task<SystemParameter?> FindByIdAsync(long id, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 根据键获取系统参数（当前租户）。
     /// </summary>
+    /// <param name="key">参数键。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>系统参数或 null。</returns>
     Task<SystemParameter?> FindByKeyAsync(string key, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 查询系统参数列表。
     /// </summary>
+    /// <param name="keyword">关键字。</param>
+    /// <param name="isEnabled">启用状态。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>参数列表。</returns>
     Task<IReadOnlyList<SystemParameter>> SearchAsync(string? keyword, bool? isEnabled, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增系统参数。
     /// </summary>
+    /// <param name="parameter">参数实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task AddAsync(SystemParameter parameter, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除系统参数。
     /// </summary>
+    /// <param name="parameter">参数实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task RemoveAsync(SystemParameter parameter, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 更新系统参数。
     /// </summary>
+    /// <param name="parameter">参数实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task UpdateAsync(SystemParameter parameter, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 持久化更改。
     /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }

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);
 }