feat: tenant门店管理首批接口落地

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

@@ -11,7 +11,11 @@ public interface IStoreRepository
     /// <summary>
     /// 依据标识获取门店。
     /// </summary>
-    Task<Store?> FindByIdAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<Store?> FindByIdAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 获取指定商户的门店列表。
@@ -22,13 +26,14 @@ public interface IStoreRepository
     /// 按租户筛选门店列表。
     /// </summary>
     Task<IReadOnlyList<Store>> SearchAsync(
-        long tenantId,
+        long? tenantId,
         long? merchantId,
         StoreStatus? status,
         StoreAuditStatus? auditStatus,
         StoreBusinessStatus? businessStatus,
         StoreOwnershipType? ownershipType,
         string? keyword,
+        bool includeDeleted = false,
         CancellationToken cancellationToken = default);
 
     /// <summary>
@@ -45,17 +50,25 @@ public interface IStoreRepository
     /// <summary>
     /// 获取指定商户集合的门店数量。
     /// </summary>
-    Task<Dictionary<long, int>> GetStoreCountsAsync(long tenantId, IReadOnlyCollection<long> merchantIds, CancellationToken cancellationToken = default);
+    Task<Dictionary<long, int>> GetStoreCountsAsync(long? tenantId, IReadOnlyCollection<long> merchantIds, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 获取门店营业时段。
     /// </summary>
-    Task<IReadOnlyList<StoreBusinessHour>> GetBusinessHoursAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<IReadOnlyList<StoreBusinessHour>> GetBusinessHoursAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 获取门店费用配置。
     /// </summary>
-    Task<StoreFee?> GetStoreFeeAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<StoreFee?> GetStoreFeeAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 新增门店费用配置。
@@ -70,7 +83,11 @@ public interface IStoreRepository
     /// <summary>
     /// 获取门店资质列表。
     /// </summary>
-    Task<IReadOnlyList<StoreQualification>> GetQualificationsAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<IReadOnlyList<StoreQualification>> GetQualificationsAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 依据标识获取门店资质。
@@ -110,22 +127,38 @@ public interface IStoreRepository
     /// <summary>
     /// 获取门店配送区域配置。
     /// </summary>
-    Task<IReadOnlyList<StoreDeliveryZone>> GetDeliveryZonesAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<IReadOnlyList<StoreDeliveryZone>> GetDeliveryZonesAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 依据标识获取配送区域。
     /// </summary>
-    Task<StoreDeliveryZone?> FindDeliveryZoneByIdAsync(long deliveryZoneId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="deliveryZoneId">配送区域 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<StoreDeliveryZone?> FindDeliveryZoneByIdAsync(long deliveryZoneId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 获取门店节假日配置。
     /// </summary>
-    Task<IReadOnlyList<StoreHoliday>> GetHolidaysAsync(long storeId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="storeId">门店 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<IReadOnlyList<StoreHoliday>> GetHolidaysAsync(long storeId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 依据标识获取节假日配置。
     /// </summary>
-    Task<StoreHoliday?> FindHolidayByIdAsync(long holidayId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="holidayId">节假日配置 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <param name="includeDeleted">是否包含已删除数据。</param>
+    Task<StoreHoliday?> FindHolidayByIdAsync(long holidayId, long? tenantId, CancellationToken cancellationToken = default, bool includeDeleted = false);
 
     /// <summary>
     /// 获取门店桌台区域。
@@ -275,12 +308,18 @@ public interface IStoreRepository
     /// <summary>
     /// 删除配送区域。
     /// </summary>
-    Task DeleteDeliveryZoneAsync(long deliveryZoneId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="deliveryZoneId">配送区域 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    Task DeleteDeliveryZoneAsync(long deliveryZoneId, long? tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除节假日。
     /// </summary>
-    Task DeleteHolidayAsync(long holidayId, long tenantId, CancellationToken cancellationToken = default);
+    /// <param name="holidayId">节假日配置 ID。</param>
+    /// <param name="tenantId">租户 ID（为空则不做租户过滤）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    Task DeleteHolidayAsync(long holidayId, long? tenantId, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// 删除桌台区域。