docs: add xml comments for tenant modules

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

@@ -11,6 +11,16 @@ namespace TakeoutSaaS.Domain.Tenants.Repositories;
 /// </summary>
 public interface ITenantNotificationRepository
 {
+    /// <summary>
+    /// 查询通知列表，按等级、未读状态与时间范围筛选。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="severity">通知等级。</param>
+    /// <param name="unreadOnly">仅返回未读。</param>
+    /// <param name="from">开始时间（UTC）。</param>
+    /// <param name="to">结束时间（UTC）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>通知集合。</returns>
     Task<IReadOnlyList<TenantNotification>> SearchAsync(
         long tenantId,
         TenantNotificationSeverity? severity,
@@ -19,11 +29,32 @@ public interface ITenantNotificationRepository
         DateTime? to,
         CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// 按 ID 获取通知。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="notificationId">通知 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>通知实体或 null。</returns>
     Task<TenantNotification?> FindByIdAsync(long tenantId, long notificationId, CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// 新增通知。
+    /// </summary>
+    /// <param name="notification">通知实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
     Task AddAsync(TenantNotification notification, CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// 更新通知。
+    /// </summary>
+    /// <param name="notification">通知实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
     Task UpdateAsync(TenantNotification notification, CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// 保存变更。
+    /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
     Task SaveChangesAsync(CancellationToken cancellationToken = default);
 }