chore: add documentation comments and stylecop rules

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

@@ -30,12 +30,30 @@ public interface IMerchantRepository
     /// 获取指定商户的合同列表。
     /// </summary>
     Task<IReadOnlyList<MerchantContract>> GetContractsAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 根据合同 ID 获取合同详情。
+    /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="contractId">合同 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>合同实体或 null。</returns>
     Task<MerchantContract?> FindContractByIdAsync(long merchantId, long tenantId, long contractId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取指定商户的资质文件列表。
     /// </summary>
     Task<IReadOnlyList<MerchantDocument>> GetDocumentsAsync(long merchantId, long tenantId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 根据文件 ID 获取资质文件详情。
+    /// </summary>
+    /// <param name="merchantId">商户 ID。</param>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="documentId">文件 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>资质文件实体或 null。</returns>
     Task<MerchantDocument?> FindDocumentByIdAsync(long merchantId, long tenantId, long documentId, CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -52,12 +70,26 @@ public interface IMerchantRepository
     /// 新增商户合同。
     /// </summary>
     Task AddContractAsync(MerchantContract contract, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 更新商户合同。
+    /// </summary>
+    /// <param name="contract">合同实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步操作任务。</returns>
     Task UpdateContractAsync(MerchantContract contract, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 新增商户资质文件。
     /// </summary>
     Task AddDocumentAsync(MerchantDocument document, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 更新商户资质文件。
+    /// </summary>
+    /// <param name="document">资质文件实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步操作任务。</returns>
     Task UpdateDocumentAsync(MerchantDocument document, CancellationToken cancellationToken = default);
 
     /// <summary>