feat: 套餐使用统计与使用租户接口

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

@@ -37,6 +37,58 @@ public sealed class TenantPackagesController(IMediator mediator) : BaseApiContro
         return ApiResponse<PagedResult<TenantPackageDto>>.Ok(result);
     }
 
+    /// <summary>
+    /// 查询套餐使用统计（订阅关联数量、使用租户数量）。
+    /// </summary>
+    /// <param name="tenantPackageIds">套餐 ID 列表（为空表示查询全部）。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>套餐使用统计列表。</returns>
+    [HttpGet("usages")]
+    [PermissionAuthorize("tenant-package:read")]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyList<TenantPackageUsageDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<IReadOnlyList<TenantPackageUsageDto>>> Usages(
+        [FromQuery] long[]? tenantPackageIds,
+        CancellationToken cancellationToken)
+    {
+        // 1. 查询使用统计
+        var result = await mediator.Send(new GetTenantPackageUsagesQuery { TenantPackageIds = tenantPackageIds }, cancellationToken);
+
+        // 2. 返回结果
+        return ApiResponse<IReadOnlyList<TenantPackageUsageDto>>.Ok(result);
+    }
+
+    /// <summary>
+    /// 查询套餐当前使用租户列表（按有效订阅口径）。
+    /// </summary>
+    /// <param name="tenantPackageId">套餐 ID。</param>
+    /// <param name="keyword">关键词（可选）。</param>
+    /// <param name="page">页码（从 1 开始）。</param>
+    /// <param name="pageSize">每页大小。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>使用租户分页结果。</returns>
+    [HttpGet("{tenantPackageId:long}/tenants")]
+    [PermissionAuthorize("tenant-package:read")]
+    [ProducesResponseType(typeof(ApiResponse<PagedResult<TenantPackageTenantDto>>), StatusCodes.Status200OK)]
+    public async Task<ApiResponse<PagedResult<TenantPackageTenantDto>>> Tenants(
+        long tenantPackageId,
+        [FromQuery] string? keyword,
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        CancellationToken cancellationToken = default)
+    {
+        // 1. 查询套餐使用租户分页
+        var result = await mediator.Send(new GetTenantPackageTenantsQuery
+        {
+            TenantPackageId = tenantPackageId,
+            Keyword = keyword,
+            Page = page,
+            PageSize = pageSize
+        }, cancellationToken);
+
+        // 2. 返回结果
+        return ApiResponse<PagedResult<TenantPackageTenantDto>>.Ok(result);
+    }
+
     /// <summary>
     /// 查看套餐详情。
     /// </summary>