refactor: 清理平台表述并统一为系统

This commit is contained in:
root
2026-01-29 13:49:03 +00:00
parent b3d611304b
commit 52fb4fde72
30 changed files with 44 additions and 84 deletions

View File

@@ -4,7 +4,7 @@ using TakeoutSaaS.Shared.Abstractions.Entities;
namespace TakeoutSaaS.Domain.Tenants.Entities;
/// <summary>
/// 配额包定义(平台提供的可购买配额包)。
/// 配额包定义(系统提供的可购买配额包)。
/// </summary>
public sealed class QuotaPackage : AuditableEntityBase
{

View File

@@ -44,7 +44,7 @@ public sealed class TenantAnnouncement : MultiTenantEntityBase
public PublisherScope PublisherScope { get; set; }
/// <summary>
/// 发布者用户 ID平台或租户后台账号)。
/// 发布者用户 ID系统或租户后台账号)。
/// </summary>
public long? PublisherUserId { get; set; }

View File

@@ -4,7 +4,7 @@ using TakeoutSaaS.Shared.Abstractions.Entities;
namespace TakeoutSaaS.Domain.Tenants.Entities;
/// <summary>
/// 平台提供的租户套餐定义。
/// 系统提供的租户套餐定义。
/// </summary>
public sealed class TenantPackage : AuditableEntityBase
{
@@ -64,7 +64,7 @@ public sealed class TenantPackage : AuditableEntityBase
public string? FeaturePoliciesJson { get; set; }
/// <summary>
/// 是否仍启用(平台控制)。
/// 是否仍启用(系统控制)。
/// </summary>
public bool IsActive { get; set; } = true;

View File

@@ -6,9 +6,9 @@ namespace TakeoutSaaS.Domain.Tenants.Enums;
public enum PublisherScope
{
/// <summary>
/// 平台发布。
/// 系统发布。
/// </summary>
Platform = 0,
System = 0,
/// <summary>
/// 租户发布。

View File

@@ -21,9 +21,9 @@ public enum TenantAnnouncementType
Operation = 2,
/// <summary>
/// 平台系统更新公告。
/// 系统更新公告。
/// </summary>
SYSTEM_PLATFORM_UPDATE = 3,
SYSTEM_PRODUCT_UPDATE = 3,
/// <summary>
/// 系统安全公告。

View File

@@ -39,29 +39,4 @@ public enum TenantAuditAction
/// 租户状态变更(启用/停用/到期等)。
/// </summary>
StatusChanged = 7,
/// <summary>
/// 领取入驻审核。
/// </summary>
ReviewClaimed = 8,
/// <summary>
/// 强制接管入驻审核。
/// </summary>
ReviewForceClaimed = 9,
/// <summary>
/// 释放入驻审核(审核完成或手动释放)。
/// </summary>
ReviewClaimReleased = 10,
/// <summary>
/// 平台伪装登录租户。
/// </summary>
ImpersonatedLogin = 11,
/// <summary>
/// 生成主管理员重置链接。
/// </summary>
AdminResetLinkIssued = 12
}

View File

@@ -15,7 +15,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="subscriptionId">订阅 ID。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>订阅实体,未找到返回 null。</returns>
Task<TenantSubscription?> FindByIdAsync(
long subscriptionId,
@@ -27,7 +27,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="subscriptionIds">订阅 ID 列表。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>订阅实体列表。</returns>
Task<IReadOnlyList<TenantSubscription>> FindByIdsAsync(
IEnumerable<long> subscriptionIds,
@@ -39,7 +39,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="filter">查询过滤条件。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>分页结果。</returns>
Task<(IReadOnlyList<SubscriptionWithRelations> Items, int Total)> SearchPagedAsync(
SubscriptionSearchFilter filter,
@@ -51,7 +51,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="subscriptionId">订阅 ID。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>订阅详情信息。</returns>
Task<SubscriptionDetailInfo?> GetDetailAsync(
long subscriptionId,
@@ -63,7 +63,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="subscriptionIds">订阅 ID 列表。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>订阅与租户信息列表。</returns>
Task<IReadOnlyList<SubscriptionWithTenant>> FindByIdsWithTenantAsync(
IEnumerable<long> subscriptionIds,
@@ -76,7 +76,7 @@ public interface ISubscriptionRepository
/// <param name="now">当前时间UTC。</param>
/// <param name="renewalThreshold">续费阈值时间UTC到期时间小于等于该时间视为候选。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>候选订阅集合(含套餐信息)。</returns>
Task<IReadOnlyList<AutoRenewalCandidate>> FindAutoRenewalCandidatesAsync(
DateTime now,
@@ -90,7 +90,7 @@ public interface ISubscriptionRepository
/// <param name="startOfDay">筛选开始时间UTC。</param>
/// <param name="endOfDay">筛选结束时间UTC不含。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>候选订阅集合(含租户与套餐信息)。</returns>
Task<IReadOnlyList<RenewalReminderCandidate>> FindRenewalReminderCandidatesAsync(
DateTime startOfDay,
@@ -103,7 +103,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="now">当前时间UTC。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>到期订阅集合。</returns>
Task<IReadOnlyList<TenantSubscription>> FindExpiredActiveSubscriptionsAsync(
DateTime now,
@@ -116,7 +116,7 @@ public interface ISubscriptionRepository
/// <param name="now">当前时间UTC。</param>
/// <param name="gracePeriodDays">宽限期天数。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>宽限期到期订阅集合。</returns>
Task<IReadOnlyList<TenantSubscription>> FindGracePeriodExpiredSubscriptionsAsync(
DateTime now,
@@ -177,7 +177,7 @@ public interface ISubscriptionRepository
/// </summary>
/// <param name="tenantId">租户 ID。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于平台级查询/任务)。</param>
/// <param name="ignoreTenantFilter">是否忽略租户过滤(用于系统级任务)。</param>
/// <returns>配额使用列表。</returns>
Task<IReadOnlyList<TenantQuotaUsage>> GetQuotaUsagesAsync(
long tenantId,