feat: 套餐到期分布与到期租户筛选

src/Api/TakeoutSaaS.AdminApi/Controllers/TenantPackagesController.cs

@@ -62,6 +62,7 @@ public sealed class TenantPackagesController(IMediator mediator) : BaseApiContro
     /// </summary>
     /// <param name="tenantPackageId">套餐 ID。</param>
     /// <param name="keyword">关键词（可选）。</param>
+    /// <param name="expiringWithinDays">可选：未来 N 天内到期筛选。</param>
     /// <param name="page">页码（从 1 开始）。</param>
     /// <param name="pageSize">每页大小。</param>
     /// <param name="cancellationToken">取消标记。</param>
@@ -72,6 +73,7 @@ public sealed class TenantPackagesController(IMediator mediator) : BaseApiContro
     public async Task<ApiResponse<PagedResult<TenantPackageTenantDto>>> Tenants(
         long tenantPackageId,
         [FromQuery] string? keyword,
+        [FromQuery] int? expiringWithinDays,
         [FromQuery] int page = 1,
         [FromQuery] int pageSize = 20,
         CancellationToken cancellationToken = default)
@@ -81,6 +83,7 @@ public sealed class TenantPackagesController(IMediator mediator) : BaseApiContro
         {
             TenantPackageId = tenantPackageId,
             Keyword = keyword,
+            ExpiringWithinDays = expiringWithinDays,
             Page = page,
             PageSize = pageSize
         }, cancellationToken);