feat: 新增配额包/支付相关实体与迁移
App：新增 operation_logs/quota_packages/tenant_payments/tenant_quota_package_purchases 表 Identity：修正 Avatar 字段类型（varchar(256)->text），保持现有数据不变
This commit is contained in:
121
src/Api/TakeoutSaaS.AdminApi/Controllers/BillingsController.cs
Normal file
121
src/Api/TakeoutSaaS.AdminApi/Controllers/BillingsController.cs
Normal file
@@ -0,0 +1,121 @@
|
||||
using MediatR;
|
||||
using Microsoft.AspNetCore.Authorization;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using System.ComponentModel.DataAnnotations;
|
||||
using TakeoutSaaS.Application.App.Billings.Commands;
|
||||
using TakeoutSaaS.Application.App.Billings.Dto;
|
||||
using TakeoutSaaS.Application.App.Billings.Queries;
|
||||
using TakeoutSaaS.Module.Authorization.Attributes;
|
||||
using TakeoutSaaS.Shared.Abstractions.Results;
|
||||
using TakeoutSaaS.Shared.Web.Api;
|
||||
|
||||
namespace TakeoutSaaS.AdminApi.Controllers;
|
||||
|
||||
/// <summary>
|
||||
/// 账单管理。
|
||||
/// </summary>
|
||||
[ApiVersion("1.0")]
|
||||
[Authorize]
|
||||
[Route("api/admin/v{version:apiVersion}/bills")]
|
||||
public sealed class BillingsController(IMediator mediator) : BaseApiController
|
||||
{
|
||||
/// <summary>
|
||||
/// 分页查询账单列表。
|
||||
/// </summary>
|
||||
/// <returns>账单分页结果。</returns>
|
||||
[HttpGet]
|
||||
[PermissionAuthorize("bill:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<PagedResult<BillDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<PagedResult<BillDto>>> GetList([FromQuery] GetBillListQuery query, CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
return ApiResponse<PagedResult<BillDto>>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取账单详情。
|
||||
/// </summary>
|
||||
/// <param name="id">账单 ID。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>账单详情。</returns>
|
||||
[HttpGet("{id:long}")]
|
||||
[PermissionAuthorize("bill:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<BillDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<BillDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<BillDetailDto>> GetDetail(long id, CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(new GetBillDetailQuery { BillId = id }, cancellationToken);
|
||||
|
||||
return result is null
|
||||
? ApiResponse<BillDetailDto>.Error(StatusCodes.Status404NotFound, "账单不存在")
|
||||
: ApiResponse<BillDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 手动创建账单。
|
||||
/// </summary>
|
||||
/// <param name="command">创建账单命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>创建的账单信息。</returns>
|
||||
[HttpPost]
|
||||
[PermissionAuthorize("bill:create")]
|
||||
[ProducesResponseType(typeof(ApiResponse<BillDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<BillDto>> Create([FromBody, Required] CreateBillCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
return ApiResponse<BillDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 更新账单状态。
|
||||
/// </summary>
|
||||
/// <param name="id">账单 ID。</param>
|
||||
/// <param name="command">更新状态命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>更新后的账单信息。</returns>
|
||||
[HttpPut("{id:long}/status")]
|
||||
[PermissionAuthorize("bill:update")]
|
||||
[ProducesResponseType(typeof(ApiResponse<BillDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<BillDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<BillDto>> UpdateStatus(long id, [FromBody, Required] UpdateBillStatusCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
command = command with { BillId = id };
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
return result is null
|
||||
? ApiResponse<BillDto>.Error(StatusCodes.Status404NotFound, "账单不存在")
|
||||
: ApiResponse<BillDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取账单支付记录。
|
||||
/// </summary>
|
||||
/// <param name="billId">账单 ID。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>支付记录列表。</returns>
|
||||
[HttpGet("{billId:long}/payments")]
|
||||
[PermissionAuthorize("bill:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<List<PaymentDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<List<PaymentDto>>> GetPayments(long billId, CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(new GetTenantPaymentsQuery { BillId = billId }, cancellationToken);
|
||||
return ApiResponse<List<PaymentDto>>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 记录支付（线下支付确认）。
|
||||
/// </summary>
|
||||
/// <param name="billId">账单 ID。</param>
|
||||
/// <param name="command">记录支付命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>支付记录信息。</returns>
|
||||
[HttpPost("{billId:long}/payments")]
|
||||
[PermissionAuthorize("bill:pay")]
|
||||
[ProducesResponseType(typeof(ApiResponse<PaymentDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<PaymentDto>> RecordPayment(long billId, [FromBody, Required] RecordPaymentCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
command = command with { BillId = billId };
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
return ApiResponse<PaymentDto>.Ok(result);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,198 @@
|
||||
using MediatR;
|
||||
using Microsoft.AspNetCore.Authorization;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using System.ComponentModel.DataAnnotations;
|
||||
using TakeoutSaaS.Application.App.QuotaPackages.Commands;
|
||||
using TakeoutSaaS.Application.App.QuotaPackages.Dto;
|
||||
using TakeoutSaaS.Application.App.QuotaPackages.Queries;
|
||||
using TakeoutSaaS.Module.Authorization.Attributes;
|
||||
using TakeoutSaaS.Shared.Abstractions.Results;
|
||||
using TakeoutSaaS.Shared.Web.Api;
|
||||
|
||||
namespace TakeoutSaaS.AdminApi.Controllers;
|
||||
|
||||
/// <summary>
|
||||
/// 配额包管理。
|
||||
/// </summary>
|
||||
[ApiVersion("1.0")]
|
||||
[Authorize]
|
||||
[Route("api/admin/v{version:apiVersion}/quota-packages")]
|
||||
public sealed class QuotaPackagesController(IMediator mediator) : BaseApiController
|
||||
{
|
||||
/// <summary>
|
||||
/// 配额包列表。
|
||||
/// </summary>
|
||||
/// <param name="query">查询条件。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>配额包分页结果。</returns>
|
||||
[HttpGet]
|
||||
[PermissionAuthorize("quota-package:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<PagedResult<QuotaPackageListDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<PagedResult<QuotaPackageListDto>>> List([FromQuery] GetQuotaPackageListQuery query, CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 查询配额包分页
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
|
||||
// 2. 返回结果
|
||||
return ApiResponse<PagedResult<QuotaPackageListDto>>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建配额包。
|
||||
/// </summary>
|
||||
/// <param name="command">创建命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>创建后的配额包。</returns>
|
||||
[HttpPost]
|
||||
[PermissionAuthorize("quota-package:create")]
|
||||
[ProducesResponseType(typeof(ApiResponse<QuotaPackageDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<QuotaPackageDto>> Create([FromBody, Required] CreateQuotaPackageCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 执行创建
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 2. 返回创建结果
|
||||
return ApiResponse<QuotaPackageDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 更新配额包。
|
||||
/// </summary>
|
||||
/// <param name="quotaPackageId">配额包 ID。</param>
|
||||
/// <param name="command">更新命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>更新后的配额包或未找到。</returns>
|
||||
[HttpPut("{quotaPackageId:long}")]
|
||||
[PermissionAuthorize("quota-package:update")]
|
||||
[ProducesResponseType(typeof(ApiResponse<QuotaPackageDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<QuotaPackageDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<QuotaPackageDto>> Update(long quotaPackageId, [FromBody, Required] UpdateQuotaPackageCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { QuotaPackageId = quotaPackageId };
|
||||
|
||||
// 2. 执行更新
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回更新结果或 404
|
||||
return result is null
|
||||
? ApiResponse<QuotaPackageDto>.Error(StatusCodes.Status404NotFound, "配额包不存在")
|
||||
: ApiResponse<QuotaPackageDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 删除配额包。
|
||||
/// </summary>
|
||||
/// <param name="quotaPackageId">配额包 ID。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>删除结果。</returns>
|
||||
[HttpDelete("{quotaPackageId:long}")]
|
||||
[PermissionAuthorize("quota-package:delete")]
|
||||
[ProducesResponseType(typeof(ApiResponse<bool>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<bool>> Delete(long quotaPackageId, CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 构建删除命令
|
||||
var command = new DeleteQuotaPackageCommand { QuotaPackageId = quotaPackageId };
|
||||
|
||||
// 2. 执行删除并返回
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
return ApiResponse<bool>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 上架/下架配额包。
|
||||
/// </summary>
|
||||
/// <param name="quotaPackageId">配额包 ID。</param>
|
||||
/// <param name="command">状态更新命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>更新结果。</returns>
|
||||
[HttpPut("{quotaPackageId:long}/status")]
|
||||
[PermissionAuthorize("quota-package:update")]
|
||||
[ProducesResponseType(typeof(ApiResponse<bool>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<bool>> UpdateStatus(long quotaPackageId, [FromBody, Required] UpdateQuotaPackageStatusCommand command, CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { QuotaPackageId = quotaPackageId };
|
||||
|
||||
// 2. 执行状态更新
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回结果
|
||||
return ApiResponse<bool>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 为租户购买配额包。
|
||||
/// </summary>
|
||||
/// <param name="tenantId">租户 ID。</param>
|
||||
/// <param name="command">购买命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>购买记录。</returns>
|
||||
[HttpPost("~/api/admin/v{version:apiVersion}/tenants/{tenantId:long}/quota-packages")]
|
||||
[PermissionAuthorize("tenant:quota:purchase")]
|
||||
[ProducesResponseType(typeof(ApiResponse<TenantQuotaPurchaseDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<TenantQuotaPurchaseDto>> PurchaseForTenant(
|
||||
long tenantId,
|
||||
[FromBody, Required] PurchaseQuotaPackageCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定租户 ID
|
||||
command = command with { TenantId = tenantId };
|
||||
|
||||
// 2. 执行购买
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回购买结果
|
||||
return ApiResponse<TenantQuotaPurchaseDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 租户配额使用情况。
|
||||
/// </summary>
|
||||
/// <param name="tenantId">租户 ID。</param>
|
||||
/// <param name="query">查询条件。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>配额使用情况列表。</returns>
|
||||
[HttpGet("~/api/admin/v{version:apiVersion}/tenants/{tenantId:long}/quota-usage")]
|
||||
[PermissionAuthorize("tenant:quota:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<IReadOnlyList<TenantQuotaUsageDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<IReadOnlyList<TenantQuotaUsageDto>>> GetTenantQuotaUsage(
|
||||
long tenantId,
|
||||
[FromQuery] GetTenantQuotaUsageQuery query,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定租户 ID
|
||||
query = query with { TenantId = tenantId };
|
||||
|
||||
// 2. 查询配额使用情况
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
|
||||
// 3. 返回结果
|
||||
return ApiResponse<IReadOnlyList<TenantQuotaUsageDto>>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 租户配额购买记录。
|
||||
/// </summary>
|
||||
/// <param name="tenantId">租户 ID。</param>
|
||||
/// <param name="query">查询条件。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>购买记录分页结果。</returns>
|
||||
[HttpGet("~/api/admin/v{version:apiVersion}/tenants/{tenantId:long}/quota-purchases")]
|
||||
[PermissionAuthorize("tenant:quota:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<PagedResult<TenantQuotaPurchaseDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<PagedResult<TenantQuotaPurchaseDto>>> GetTenantQuotaPurchases(
|
||||
long tenantId,
|
||||
[FromQuery] GetTenantQuotaPurchasesQuery query,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定租户 ID
|
||||
query = query with { TenantId = tenantId };
|
||||
|
||||
// 2. 查询购买记录
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
|
||||
// 3. 返回结果
|
||||
return ApiResponse<PagedResult<TenantQuotaPurchaseDto>>.Ok(result);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,96 @@
|
||||
using MediatR;
|
||||
using Microsoft.AspNetCore.Authorization;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using TakeoutSaaS.Application.App.Statistics.Dto;
|
||||
using TakeoutSaaS.Application.App.Statistics.Queries;
|
||||
using TakeoutSaaS.Domain.Tenants.Enums;
|
||||
using TakeoutSaaS.Module.Authorization.Attributes;
|
||||
using TakeoutSaaS.Shared.Abstractions.Results;
|
||||
using TakeoutSaaS.Shared.Web.Api;
|
||||
|
||||
namespace TakeoutSaaS.AdminApi.Controllers;
|
||||
|
||||
/// <summary>
|
||||
/// 统计数据接口。
|
||||
/// </summary>
|
||||
[ApiVersion("1.0")]
|
||||
[Authorize]
|
||||
[Route("api/admin/v{version:apiVersion}/statistics")]
|
||||
public sealed class StatisticsController(IMediator mediator) : BaseApiController
|
||||
{
|
||||
/// <summary>
|
||||
/// 获取订阅概览统计。
|
||||
/// </summary>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>订阅概览数据。</returns>
|
||||
[HttpGet("subscription-overview")]
|
||||
[PermissionAuthorize("statistics:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionOverviewDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<SubscriptionOverviewDto>> GetSubscriptionOverview(CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(new GetSubscriptionOverviewQuery(), cancellationToken);
|
||||
return ApiResponse<SubscriptionOverviewDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取配额使用排行。
|
||||
/// </summary>
|
||||
/// <param name="quotaType">配额类型。</param>
|
||||
/// <param name="topN">返回前N条记录，默认10。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>配额使用排行数据。</returns>
|
||||
[HttpGet("quota-ranking")]
|
||||
[PermissionAuthorize("statistics:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<QuotaUsageRankingDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<QuotaUsageRankingDto>> GetQuotaRanking(
|
||||
[FromQuery] TenantQuotaType quotaType,
|
||||
[FromQuery] int topN = 10,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
var query = new GetQuotaUsageRankingQuery { QuotaType = quotaType, TopN = topN };
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
return ApiResponse<QuotaUsageRankingDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取收入统计。
|
||||
/// </summary>
|
||||
/// <param name="monthsCount">统计月份数量，默认12个月。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>收入统计数据。</returns>
|
||||
[HttpGet("revenue")]
|
||||
[PermissionAuthorize("statistics:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<RevenueStatisticsDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<RevenueStatisticsDto>> GetRevenue(
|
||||
[FromQuery] int monthsCount = 12,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
var query = new GetRevenueStatisticsQuery { MonthsCount = monthsCount };
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
return ApiResponse<RevenueStatisticsDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取即将到期的订阅列表。
|
||||
/// </summary>
|
||||
/// <param name="daysAhead">筛选天数，默认7天内到期。</param>
|
||||
/// <param name="onlyWithoutAutoRenew">是否只返回未开启自动续费的订阅。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>即将到期的订阅列表。</returns>
|
||||
[HttpGet("expiring-subscriptions")]
|
||||
[PermissionAuthorize("statistics:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<IReadOnlyList<ExpiringSubscriptionDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<IReadOnlyList<ExpiringSubscriptionDto>>> GetExpiringSubscriptions(
|
||||
[FromQuery] int daysAhead = 7,
|
||||
[FromQuery] bool onlyWithoutAutoRenew = false,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
var query = new GetExpiringSubscriptionsQuery
|
||||
{
|
||||
DaysAhead = daysAhead,
|
||||
OnlyWithoutAutoRenew = onlyWithoutAutoRenew
|
||||
};
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
return ApiResponse<IReadOnlyList<ExpiringSubscriptionDto>>.Ok(result);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,210 @@
|
||||
using MediatR;
|
||||
using Microsoft.AspNetCore.Authorization;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using System.ComponentModel.DataAnnotations;
|
||||
using TakeoutSaaS.Application.App.Subscriptions.Commands;
|
||||
using TakeoutSaaS.Application.App.Subscriptions.Dto;
|
||||
using TakeoutSaaS.Application.App.Subscriptions.Queries;
|
||||
using TakeoutSaaS.Module.Authorization.Attributes;
|
||||
using TakeoutSaaS.Shared.Abstractions.Results;
|
||||
using TakeoutSaaS.Shared.Web.Api;
|
||||
|
||||
namespace TakeoutSaaS.AdminApi.Controllers;
|
||||
|
||||
/// <summary>
|
||||
/// 订阅管理。
|
||||
/// </summary>
|
||||
[ApiVersion("1.0")]
|
||||
[Authorize]
|
||||
[Route("api/admin/v{version:apiVersion}/subscriptions")]
|
||||
public sealed class SubscriptionsController(IMediator mediator) : BaseApiController
|
||||
{
|
||||
/// <summary>
|
||||
/// 分页查询订阅列表（支持按状态、套餐、到期时间筛选）。
|
||||
/// </summary>
|
||||
/// <param name="query">查询条件。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>订阅分页结果。</returns>
|
||||
[HttpGet]
|
||||
[PermissionAuthorize("subscription:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<PagedResult<SubscriptionListDto>>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<PagedResult<SubscriptionListDto>>> List(
|
||||
[FromQuery] GetSubscriptionListQuery query,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 查询订阅分页
|
||||
var result = await mediator.Send(query, cancellationToken);
|
||||
|
||||
// 2. 返回结果
|
||||
return ApiResponse<PagedResult<SubscriptionListDto>>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 查看订阅详情（含套餐信息、配额使用、变更历史）。
|
||||
/// </summary>
|
||||
/// <param name="subscriptionId">订阅 ID。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>订阅详情或未找到。</returns>
|
||||
[HttpGet("{subscriptionId:long}")]
|
||||
[PermissionAuthorize("subscription:read")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<SubscriptionDetailDto>> Detail(
|
||||
long subscriptionId,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 查询订阅详情
|
||||
var result = await mediator.Send(new GetSubscriptionDetailQuery { SubscriptionId = subscriptionId }, cancellationToken);
|
||||
|
||||
// 2. 返回查询结果或 404
|
||||
return result is null
|
||||
? ApiResponse<SubscriptionDetailDto>.Error(StatusCodes.Status404NotFound, "订阅不存在")
|
||||
: ApiResponse<SubscriptionDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 更新订阅基础信息（备注、自动续费等）。
|
||||
/// </summary>
|
||||
/// <param name="subscriptionId">订阅 ID。</param>
|
||||
/// <param name="command">更新命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>更新后的订阅详情或未找到。</returns>
|
||||
[HttpPut("{subscriptionId:long}")]
|
||||
[PermissionAuthorize("subscription:update")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<SubscriptionDetailDto>> Update(
|
||||
long subscriptionId,
|
||||
[FromBody, Required] UpdateSubscriptionCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { SubscriptionId = subscriptionId };
|
||||
|
||||
// 2. 执行更新
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回更新结果或 404
|
||||
return result is null
|
||||
? ApiResponse<SubscriptionDetailDto>.Error(StatusCodes.Status404NotFound, "订阅不存在")
|
||||
: ApiResponse<SubscriptionDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 延期订阅（增加订阅时长）。
|
||||
/// </summary>
|
||||
/// <param name="subscriptionId">订阅 ID。</param>
|
||||
/// <param name="command">延期命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>延期后的订阅详情或未找到。</returns>
|
||||
[HttpPost("{subscriptionId:long}/extend")]
|
||||
[PermissionAuthorize("subscription:extend")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<SubscriptionDetailDto>> Extend(
|
||||
long subscriptionId,
|
||||
[FromBody, Required] ExtendSubscriptionCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { SubscriptionId = subscriptionId };
|
||||
|
||||
// 2. 执行延期
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回延期结果或 404
|
||||
return result is null
|
||||
? ApiResponse<SubscriptionDetailDto>.Error(StatusCodes.Status404NotFound, "订阅不存在")
|
||||
: ApiResponse<SubscriptionDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 变更套餐（支持立即生效或下周期生效）。
|
||||
/// </summary>
|
||||
/// <param name="subscriptionId">订阅 ID。</param>
|
||||
/// <param name="command">变更套餐命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>变更后的订阅详情或未找到。</returns>
|
||||
[HttpPost("{subscriptionId:long}/change-plan")]
|
||||
[PermissionAuthorize("subscription:change-plan")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<SubscriptionDetailDto>> ChangePlan(
|
||||
long subscriptionId,
|
||||
[FromBody, Required] ChangeSubscriptionPlanCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { SubscriptionId = subscriptionId };
|
||||
|
||||
// 2. 执行套餐变更
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回变更结果或 404
|
||||
return result is null
|
||||
? ApiResponse<SubscriptionDetailDto>.Error(StatusCodes.Status404NotFound, "订阅不存在")
|
||||
: ApiResponse<SubscriptionDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 变更订阅状态。
|
||||
/// </summary>
|
||||
/// <param name="subscriptionId">订阅 ID。</param>
|
||||
/// <param name="command">状态变更命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>变更后的订阅详情或未找到。</returns>
|
||||
[HttpPost("{subscriptionId:long}/status")]
|
||||
[PermissionAuthorize("subscription:update-status")]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status200OK)]
|
||||
[ProducesResponseType(typeof(ApiResponse<SubscriptionDetailDto>), StatusCodes.Status404NotFound)]
|
||||
public async Task<ApiResponse<SubscriptionDetailDto>> UpdateStatus(
|
||||
long subscriptionId,
|
||||
[FromBody, Required] UpdateSubscriptionStatusCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
// 1. 绑定路由 ID
|
||||
command = command with { SubscriptionId = subscriptionId };
|
||||
|
||||
// 2. 执行状态变更
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
|
||||
// 3. 返回变更结果或 404
|
||||
return result is null
|
||||
? ApiResponse<SubscriptionDetailDto>.Error(StatusCodes.Status404NotFound, "订阅不存在")
|
||||
: ApiResponse<SubscriptionDetailDto>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 批量延期订阅。
|
||||
/// </summary>
|
||||
/// <param name="command">批量延期命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>批量延期结果。</returns>
|
||||
[HttpPost("batch-extend")]
|
||||
[PermissionAuthorize("subscription:batch-extend")]
|
||||
[ProducesResponseType(typeof(ApiResponse<BatchExtendResult>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<BatchExtendResult>> BatchExtend(
|
||||
[FromBody, Required] BatchExtendSubscriptionsCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
return ApiResponse<BatchExtendResult>.Ok(result);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 批量发送续费提醒。
|
||||
/// </summary>
|
||||
/// <param name="command">批量发送提醒命令。</param>
|
||||
/// <param name="cancellationToken">取消标记。</param>
|
||||
/// <returns>批量发送提醒结果。</returns>
|
||||
[HttpPost("batch-remind")]
|
||||
[PermissionAuthorize("subscription:batch-remind")]
|
||||
[ProducesResponseType(typeof(ApiResponse<BatchSendReminderResult>), StatusCodes.Status200OK)]
|
||||
public async Task<ApiResponse<BatchSendReminderResult>> BatchRemind(
|
||||
[FromBody, Required] BatchSendReminderCommand command,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
var result = await mediator.Send(command, cancellationToken);
|
||||
return ApiResponse<BatchSendReminderResult>.Ok(result);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user