Revert "refactor: 清理租户API旧模块代码"

This reverts commit 992930a821.

src/Application/TakeoutSaaS.Application/App/Billings/Commands/BatchUpdateStatusCommand.cs

@@ -0,0 +1,25 @@
+using MediatR;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 批量更新账单状态命令。
+/// </summary>
+public sealed record BatchUpdateStatusCommand : IRequest<int>
+{
+    /// <summary>
+    /// 账单 ID 列表（雪花算法）。
+    /// </summary>
+    public long[] BillingIds { get; init; } = [];
+
+    /// <summary>
+    /// 新状态。
+    /// </summary>
+    public TenantBillingStatus NewStatus { get; init; }
+
+    /// <summary>
+    /// 批量操作备注。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/CancelBillingCommand.cs

@@ -0,0 +1,19 @@
+using MediatR;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 取消账单命令。
+/// </summary>
+public sealed record CancelBillingCommand : IRequest<Unit>
+{
+    /// <summary>
+    /// 账单 ID（雪花算法）。
+    /// </summary>
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 取消原因。
+    /// </summary>
+    public string Reason { get; init; } = string.Empty;
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/ConfirmPaymentCommand.cs

@@ -0,0 +1,42 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 一键确认收款命令（记录支付 + 立即审核通过）。
+/// </summary>
+public sealed record ConfirmPaymentCommand : IRequest<PaymentRecordDto>
+{
+    /// <summary>
+    /// 账单 ID（雪花算法）。
+    /// </summary>
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 支付金额。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 支付方式。
+    /// </summary>
+    public TenantPaymentMethod Method { get; init; }
+
+    /// <summary>
+    /// 交易号。
+    /// </summary>
+    public string? TransactionNo { get; init; }
+
+    /// <summary>
+    /// 支付凭证 URL。
+    /// </summary>
+    public string? ProofUrl { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+}
+

src/Application/TakeoutSaaS.Application/App/Billings/Commands/CreateBillCommand.cs

@@ -0,0 +1,30 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 创建账单命令。
+/// </summary>
+public sealed record CreateBillCommand : IRequest<BillDto>
+{
+    /// <summary>
+    /// 租户 ID（雪花算法）。
+    /// </summary>
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/CreateBillingCommand.cs

@@ -0,0 +1,41 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 创建账单命令。
+/// </summary>
+public sealed record CreateBillingCommand : IRequest<BillingDetailDto>
+{
+    /// <summary>
+    /// 租户 ID（雪花算法）。
+    /// </summary>
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 账单明细列表。
+    /// </summary>
+    public List<BillingLineItemDto> LineItems { get; init; } = [];
+
+    /// <summary>
+    /// 备注。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/GenerateSubscriptionBillingCommand.cs

@@ -0,0 +1,15 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 生成订阅账单命令（自动化场景）。
+/// </summary>
+public sealed record GenerateSubscriptionBillingCommand : IRequest<BillingDetailDto>
+{
+    /// <summary>
+    /// 订阅 ID（雪花算法）。
+    /// </summary>
+    public long SubscriptionId { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/ProcessOverdueBillingsCommand.cs

@@ -0,0 +1,10 @@
+using MediatR;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 处理逾期账单命令（后台任务场景）。
+/// </summary>
+public sealed record ProcessOverdueBillingsCommand : IRequest<int>
+{
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/RecordPaymentCommand.cs

@@ -0,0 +1,41 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 记录支付命令。
+/// </summary>
+public sealed record RecordPaymentCommand : IRequest<PaymentRecordDto>
+{
+    /// <summary>
+    /// 账单 ID（雪花算法）。
+    /// </summary>
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 支付金额。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 支付方式。
+    /// </summary>
+    public TenantPaymentMethod Method { get; init; }
+
+    /// <summary>
+    /// 交易号。
+    /// </summary>
+    public string? TransactionNo { get; init; }
+
+    /// <summary>
+    /// 支付凭证 URL。
+    /// </summary>
+    public string? ProofUrl { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/UpdateBillStatusCommand.cs

@@ -0,0 +1,26 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Billings.Dto;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 更新账单状态命令。
+/// </summary>
+public sealed record UpdateBillStatusCommand : IRequest<BillDto?>
+{
+    /// <summary>
+    /// 账单 ID（雪花算法）。
+    /// </summary>
+    public long BillId { get; init; }
+
+    /// <summary>
+    /// 新状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/UpdateBillingStatusCommand.cs

@@ -0,0 +1,25 @@
+using MediatR;
+using TakeoutSaaS.Domain.Tenants.Enums;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 更新账单状态命令。
+/// </summary>
+public sealed record UpdateBillingStatusCommand : IRequest<Unit>
+{
+    /// <summary>
+    /// 账单 ID（雪花算法）。
+    /// </summary>
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 新状态。
+    /// </summary>
+    public TenantBillingStatus NewStatus { get; init; }
+
+    /// <summary>
+    /// 备注。
+    /// </summary>
+    public string? Notes { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Commands/VerifyPaymentCommand.cs

@@ -0,0 +1,28 @@
+using MediatR;
+using System.ComponentModel.DataAnnotations;
+using TakeoutSaaS.Application.App.Billings.Dto;
+
+namespace TakeoutSaaS.Application.App.Billings.Commands;
+
+/// <summary>
+/// 审核支付命令。
+/// </summary>
+public sealed record VerifyPaymentCommand : IRequest<PaymentRecordDto>
+{
+    /// <summary>
+    /// 支付记录 ID（雪花算法）。
+    /// </summary>
+    [Required]
+    public long PaymentId { get; init; }
+
+    /// <summary>
+    /// 是否通过审核。
+    /// </summary>
+    public bool Approved { get; init; }
+
+    /// <summary>
+    /// 审核备注（可选）。
+    /// </summary>
+    [MaxLength(512)]
+    public string? Notes { get; init; }
+}