✨ feat: 完成账单管理模块后端功能开发及API优化

核心功能:
- 账单CRUD操作（创建、查询、详情、更新状态、删除）
- 支付记录管理（创建支付、审核支付）
- 批量操作支持（批量更新账单状态）
- 统计分析功能（账单统计、逾期账单查询）
- 导出功能（Excel/PDF/CSV）

API端点 (16个):
- GET /api/admin/v1/billings - 账单列表（分页、筛选、排序）
- POST /api/admin/v1/billings - 创建账单
- GET /api/admin/v1/billings/{id} - 账单详情
- DELETE /api/admin/v1/billings/{id} - 删除账单
- PUT /api/admin/v1/billings/{id}/status - 更新状态
- POST /api/admin/v1/billings/batch/status - 批量更新
- GET /api/admin/v1/billings/{id}/payments - 支付记录
- POST /api/admin/v1/billings/{id}/payments - 创建支付
- PUT /api/admin/v1/billings/payments/{paymentId}/verify - 审核支付
- GET /api/admin/v1/billings/statistics - 统计数据
- GET /api/admin/v1/billings/overdue - 逾期账单
- POST /api/admin/v1/billings/export - 导出账单

架构优化:
- 采用CQRS模式分离读写（MediatR + Dapper + EF Core）
- 完整的领域模型设计（TenantBillingStatement, TenantPayment等）
- FluentValidation请求验证
- 状态机管理账单和支付状态流转

API设计优化 (三项改进):
1. 导出API响应Content-Type改为application/octet-stream
2. 支付审核API添加Approved和Notes可选参数，支持通过/拒绝
3. 移除TenantBillings API中重复的TenantId参数

数据库变更:
- 新增账单相关表及关系
- 支持Snowflake ID主键
- 完整的审计字段支持

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingDetailDto.cs

@@ -0,0 +1,146 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Domain.Tenants.Enums;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单详情 DTO（管理员端）。
+/// </summary>
+public sealed record BillingDetailDto
+{
+    /// <summary>
+    /// 账单 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 已支付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额（应付金额 - 折扣 + 税费）。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 到期日。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 订阅 ID（可选）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单明细 JSON（原始字符串）。
+    /// </summary>
+    public string? LineItemsJson { get; init; }
+
+    /// <summary>
+    /// 账单明细行项目。
+    /// </summary>
+    public IReadOnlyList<BillingLineItemDto> LineItems { get; init; } = [];
+
+    /// <summary>
+    /// 支付记录。
+    /// </summary>
+    public IReadOnlyList<PaymentRecordDto> Payments { get; init; } = [];
+
+    /// <summary>
+    /// 提醒发送时间。
+    /// </summary>
+    public DateTime? ReminderSentAt { get; init; }
+
+    /// <summary>
+    /// 逾期通知时间。
+    /// </summary>
+    public DateTime? OverdueNotifiedAt { get; init; }
+
+    /// <summary>
+    /// 备注。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 创建时间。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+
+    /// <summary>
+    /// 创建人 ID。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? CreatedBy { get; init; }
+
+    /// <summary>
+    /// 更新时间。
+    /// </summary>
+    public DateTime? UpdatedAt { get; init; }
+
+    /// <summary>
+    /// 更新人 ID。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? UpdatedBy { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingDtos.cs

@@ -0,0 +1,545 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Domain.Tenants.Enums;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto.Legacy;
+
+/// <summary>
+/// 账单列表 DTO（用于列表展示）。
+/// </summary>
+public sealed record BillingListDto
+{
+    /// <summary>
+    /// 账单 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 关联订阅 ID（仅订阅/续费账单可能有值）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额（应付金额 - 折扣 + 税费）。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 已付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 是否已逾期（根据到期日与状态综合判断）。
+    /// </summary>
+    public bool IsOverdue { get; init; }
+
+    /// <summary>
+    /// 逾期天数（未逾期为 0）。
+    /// </summary>
+    public int OverdueDays { get; init; }
+
+    /// <summary>
+    /// 创建时间（UTC）。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+
+    /// <summary>
+    /// 更新时间（UTC）。
+    /// </summary>
+    public DateTime? UpdatedAt { get; init; }
+}
+
+/// <summary>
+/// 账单详情 DTO（含明细项）。
+/// </summary>
+public sealed record BillingDetailDto
+{
+    /// <summary>
+    /// 账单 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 关联订阅 ID（仅订阅/续费账单可能有值）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额（应付金额 - 折扣 + 税费）。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 已付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 账单明细 JSON。
+    /// </summary>
+    public string? LineItemsJson { get; init; }
+
+    /// <summary>
+    /// 账单明细列表（从 JSON 反序列化）。
+    /// </summary>
+    public IReadOnlyList<BillingLineItemDto> LineItems { get; init; } = [];
+
+    /// <summary>
+    /// 支付记录列表。
+    /// </summary>
+    public IReadOnlyList<PaymentRecordDto> Payments { get; init; } = [];
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 创建时间（UTC）。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+
+    /// <summary>
+    /// 更新时间（UTC）。
+    /// </summary>
+    public DateTime? UpdatedAt { get; init; }
+}
+
+/// <summary>
+/// 账单明细项 DTO。
+/// </summary>
+public sealed record BillingLineItemDto
+{
+    /// <summary>
+    /// 明细类型（如：套餐费、配额包费用、其他费用）。
+    /// </summary>
+    public string ItemType { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 描述。
+    /// </summary>
+    public string Description { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 数量。
+    /// </summary>
+    public decimal Quantity { get; init; }
+
+    /// <summary>
+    /// 单价。
+    /// </summary>
+    public decimal UnitPrice { get; init; }
+
+    /// <summary>
+    /// 金额（数量 × 单价）。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 折扣率（0-1）。
+    /// </summary>
+    public decimal? DiscountRate { get; init; }
+}
+
+/// <summary>
+/// 支付记录 DTO。
+/// </summary>
+public sealed record PaymentRecordDto
+{
+    /// <summary>
+    /// 支付记录 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 账单 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 支付金额。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 支付方式。
+    /// </summary>
+    public TenantPaymentMethod Method { get; init; }
+
+    /// <summary>
+    /// 支付状态。
+    /// </summary>
+    public TenantPaymentStatus Status { get; init; }
+
+    /// <summary>
+    /// 支付流水号。
+    /// </summary>
+    public string? TransactionNo { get; init; }
+
+    /// <summary>
+    /// 支付凭证 URL。
+    /// </summary>
+    public string? ProofUrl { get; init; }
+
+    /// <summary>
+    /// 备注。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 审核状态（待审核/已通过/已拒绝）。
+    /// </summary>
+    public bool IsVerified { get; init; }
+
+    /// <summary>
+    /// 审核人 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? VerifiedBy { get; init; }
+
+    /// <summary>
+    /// 审核时间（UTC）。
+    /// </summary>
+    public DateTime? VerifiedAt { get; init; }
+
+    /// <summary>
+    /// 退款原因。
+    /// </summary>
+    public string? RefundReason { get; init; }
+
+    /// <summary>
+    /// 退款时间（UTC）。
+    /// </summary>
+    public DateTime? RefundedAt { get; init; }
+
+    /// <summary>
+    /// 支付时间（UTC）。
+    /// </summary>
+    public DateTime? PaidAt { get; init; }
+
+    /// <summary>
+    /// 创建时间（UTC）。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+}
+
+/// <summary>
+/// 账单统计 DTO。
+/// </summary>
+public sealed record BillingStatisticsDto
+{
+    /// <summary>
+    /// 租户 ID（为空表示跨租户统计）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? TenantId { get; init; }
+
+    /// <summary>
+    /// 统计周期开始时间（UTC）。
+    /// </summary>
+    public DateTime StartDate { get; init; }
+
+    /// <summary>
+    /// 统计周期结束时间（UTC）。
+    /// </summary>
+    public DateTime EndDate { get; init; }
+
+    /// <summary>
+    /// 分组方式（Day/Week/Month）。
+    /// </summary>
+    public string GroupBy { get; init; } = "Day";
+
+    /// <summary>
+    /// 总账单数量。
+    /// </summary>
+    public int TotalCount { get; init; }
+
+    /// <summary>
+    /// 待付款账单数量。
+    /// </summary>
+    public int PendingCount { get; init; }
+
+    /// <summary>
+    /// 已付款账单数量。
+    /// </summary>
+    public int PaidCount { get; init; }
+
+    /// <summary>
+    /// 逾期账单数量。
+    /// </summary>
+    public int OverdueCount { get; init; }
+
+    /// <summary>
+    /// 已取消账单数量。
+    /// </summary>
+    public int CancelledCount { get; init; }
+
+    /// <summary>
+    /// 总应收金额（账单原始应付）。
+    /// </summary>
+    public decimal TotalAmountDue { get; init; }
+
+    /// <summary>
+    /// 总实收金额。
+    /// </summary>
+    public decimal TotalAmountPaid { get; init; }
+
+    /// <summary>
+    /// 总未收金额（总金额 - 实收）。
+    /// </summary>
+    public decimal TotalAmountUnpaid { get; init; }
+
+    /// <summary>
+    /// 逾期未收金额。
+    /// </summary>
+    public decimal TotalOverdueAmount { get; init; }
+
+    /// <summary>
+    /// 分组统计：应收金额趋势（Key 为分组起始日期 yyyy-MM-dd）。
+    /// </summary>
+    public Dictionary<string, decimal> AmountDueTrend { get; init; } = [];
+
+    /// <summary>
+    /// 分组统计：实收金额趋势（Key 为分组起始日期 yyyy-MM-dd）。
+    /// </summary>
+    public Dictionary<string, decimal> AmountPaidTrend { get; init; } = [];
+
+    /// <summary>
+    /// 分组统计：账单数量趋势（Key 为分组起始日期 yyyy-MM-dd）。
+    /// </summary>
+    public Dictionary<string, int> CountTrend { get; init; } = [];
+}
+
+/// <summary>
+/// 账单导出 DTO。
+/// </summary>
+public sealed record BillingExportDto
+{
+    /// <summary>
+    /// 账单 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID（雪花算法，序列化为字符串）。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 关联订阅 ID（仅订阅/续费账单可能有值）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 已付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 账单明细列表。
+    /// </summary>
+    public List<BillingLineItemDto> LineItems { get; init; } = [];
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingExportDto.cs

@@ -0,0 +1,104 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Domain.Tenants.Enums;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单导出 DTO。
+/// </summary>
+public sealed record BillingExportDto
+{
+    /// <summary>
+    /// 账单 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 订阅 ID（可选）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额（应付金额 - 折扣 + 税费）。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 已支付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 到期日（UTC）。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 备注。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 账单明细。
+    /// </summary>
+    public IReadOnlyList<BillingLineItemDto> LineItems { get; init; } = [];
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingLineItemDto.cs

@@ -0,0 +1,37 @@
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单明细行项目 DTO。
+/// </summary>
+public sealed record BillingLineItemDto
+{
+    /// <summary>
+    /// 明细类型（如：订阅费、配额包费用、其他费用）。
+    /// </summary>
+    public string ItemType { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 描述。
+    /// </summary>
+    public string Description { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 数量。
+    /// </summary>
+    public decimal Quantity { get; init; }
+
+    /// <summary>
+    /// 单价。
+    /// </summary>
+    public decimal UnitPrice { get; init; }
+
+    /// <summary>
+    /// 金额（数量 × 单价）。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 折扣率（0-1，可选）。
+    /// </summary>
+    public decimal? DiscountRate { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingListDto.cs

@@ -0,0 +1,114 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Domain.Tenants.Enums;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单列表 DTO（管理员端列表展示）。
+/// </summary>
+public sealed record BillingListDto
+{
+    /// <summary>
+    /// 账单 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 租户名称。
+    /// </summary>
+    public string TenantName { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 订阅 ID（可选）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? SubscriptionId { get; init; }
+
+    /// <summary>
+    /// 账单编号。
+    /// </summary>
+    public string StatementNo { get; init; } = string.Empty;
+
+    /// <summary>
+    /// 计费周期开始时间（UTC）。
+    /// </summary>
+    public DateTime PeriodStart { get; init; }
+
+    /// <summary>
+    /// 计费周期结束时间（UTC）。
+    /// </summary>
+    public DateTime PeriodEnd { get; init; }
+
+    /// <summary>
+    /// 账单类型。
+    /// </summary>
+    public BillingType BillingType { get; init; }
+
+    /// <summary>
+    /// 账单状态。
+    /// </summary>
+    public TenantBillingStatus Status { get; init; }
+
+    /// <summary>
+    /// 应付金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 已支付金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+
+    /// <summary>
+    /// 折扣金额。
+    /// </summary>
+    public decimal DiscountAmount { get; init; }
+
+    /// <summary>
+    /// 税费金额。
+    /// </summary>
+    public decimal TaxAmount { get; init; }
+
+    /// <summary>
+    /// 总金额（应付金额 - 折扣 + 税费）。
+    /// </summary>
+    public decimal TotalAmount { get; init; }
+
+    /// <summary>
+    /// 币种。
+    /// </summary>
+    public string Currency { get; init; } = "CNY";
+
+    /// <summary>
+    /// 到期日。
+    /// </summary>
+    public DateTime DueDate { get; init; }
+
+    /// <summary>
+    /// 创建时间。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+
+    /// <summary>
+    /// 更新时间。
+    /// </summary>
+    public DateTime? UpdatedAt { get; init; }
+
+    /// <summary>
+    /// 是否逾期。
+    /// </summary>
+    public bool IsOverdue { get; init; }
+
+    /// <summary>
+    /// 逾期天数（未逾期为 0）。
+    /// </summary>
+    public int OverdueDays { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingStatisticsDto.cs

@@ -0,0 +1,91 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单统计数据 DTO。
+/// </summary>
+public sealed record BillingStatisticsDto
+{
+    /// <summary>
+    /// 租户 ID（可选，管理员可跨租户统计）。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? TenantId { get; init; }
+
+    /// <summary>
+    /// 统计开始时间（UTC）。
+    /// </summary>
+    public DateTime StartDate { get; init; }
+
+    /// <summary>
+    /// 统计结束时间（UTC）。
+    /// </summary>
+    public DateTime EndDate { get; init; }
+
+    /// <summary>
+    /// 分组方式（Day/Week/Month）。
+    /// </summary>
+    public string GroupBy { get; init; } = "Day";
+
+    /// <summary>
+    /// 总账单数量。
+    /// </summary>
+    public int TotalCount { get; init; }
+
+    /// <summary>
+    /// 待支付账单数量。
+    /// </summary>
+    public int PendingCount { get; init; }
+
+    /// <summary>
+    /// 已支付账单数量。
+    /// </summary>
+    public int PaidCount { get; init; }
+
+    /// <summary>
+    /// 逾期账单数量。
+    /// </summary>
+    public int OverdueCount { get; init; }
+
+    /// <summary>
+    /// 已取消账单数量。
+    /// </summary>
+    public int CancelledCount { get; init; }
+
+    /// <summary>
+    /// 总应收金额。
+    /// </summary>
+    public decimal TotalAmountDue { get; init; }
+
+    /// <summary>
+    /// 已收金额。
+    /// </summary>
+    public decimal TotalAmountPaid { get; init; }
+
+    /// <summary>
+    /// 未收金额。
+    /// </summary>
+    public decimal TotalAmountUnpaid { get; init; }
+
+    /// <summary>
+    /// 逾期金额。
+    /// </summary>
+    public decimal TotalOverdueAmount { get; init; }
+
+    /// <summary>
+    /// 应收金额趋势（Key 为日期桶字符串）。
+    /// </summary>
+    public IReadOnlyDictionary<string, decimal> AmountDueTrend { get; init; } = new Dictionary<string, decimal>();
+
+    /// <summary>
+    /// 实收金额趋势（Key 为日期桶字符串）。
+    /// </summary>
+    public IReadOnlyDictionary<string, decimal> AmountPaidTrend { get; init; } = new Dictionary<string, decimal>();
+
+    /// <summary>
+    /// 数量趋势（Key 为日期桶字符串）。
+    /// </summary>
+    public IReadOnlyDictionary<string, int> CountTrend { get; init; } = new Dictionary<string, int>();
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingTrendPointDto.cs

@@ -0,0 +1,27 @@
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 账单趋势数据点 DTO。
+/// </summary>
+public sealed record BillingTrendPointDto
+{
+    /// <summary>
+    /// 分组时间点（Day/Week/Month 对齐后的时间）。
+    /// </summary>
+    public DateTime Period { get; init; }
+
+    /// <summary>
+    /// 账单数量。
+    /// </summary>
+    public int Count { get; init; }
+
+    /// <summary>
+    /// 应收金额。
+    /// </summary>
+    public decimal AmountDue { get; init; }
+
+    /// <summary>
+    /// 实收金额。
+    /// </summary>
+    public decimal AmountPaid { get; init; }
+}

src/Application/TakeoutSaaS.Application/App/Billings/Dto/PaymentDto.cs

@@ -29,12 +29,12 @@ public sealed record PaymentDto
     /// <summary>
     /// 支付方式。
     /// </summary>
-    public PaymentMethod Method { get; init; }
+    public TenantPaymentMethod Method { get; init; }
 
     /// <summary>
     /// 支付状态。
     /// </summary>
-    public PaymentStatus Status { get; init; }
+    public TenantPaymentStatus Status { get; init; }
 
     /// <summary>
     /// 交易号。

src/Application/TakeoutSaaS.Application/App/Billings/Dto/PaymentRecordDto.cs

@@ -0,0 +1,95 @@
+using System.Text.Json.Serialization;
+using TakeoutSaaS.Domain.Tenants.Enums;
+using TakeoutSaaS.Shared.Abstractions.Serialization;
+
+namespace TakeoutSaaS.Application.App.Billings.Dto;
+
+/// <summary>
+/// 支付记录 DTO（管理员端）。
+/// </summary>
+public sealed record PaymentRecordDto
+{
+    /// <summary>
+    /// 支付记录 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long Id { get; init; }
+
+    /// <summary>
+    /// 租户 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long TenantId { get; init; }
+
+    /// <summary>
+    /// 关联的账单 ID。
+    /// </summary>
+    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
+    public long BillingId { get; init; }
+
+    /// <summary>
+    /// 支付金额。
+    /// </summary>
+    public decimal Amount { get; init; }
+
+    /// <summary>
+    /// 支付方式。
+    /// </summary>
+    public TenantPaymentMethod Method { get; init; }
+
+    /// <summary>
+    /// 支付状态。
+    /// </summary>
+    public TenantPaymentStatus Status { get; init; }
+
+    /// <summary>
+    /// 交易号。
+    /// </summary>
+    public string? TransactionNo { get; init; }
+
+    /// <summary>
+    /// 支付凭证 URL。
+    /// </summary>
+    public string? ProofUrl { get; init; }
+
+    /// <summary>
+    /// 支付时间。
+    /// </summary>
+    public DateTime? PaidAt { get; init; }
+
+    /// <summary>
+    /// 是否已审核。
+    /// </summary>
+    public bool IsVerified { get; init; }
+
+    /// <summary>
+    /// 审核人 ID。
+    /// </summary>
+    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
+    public long? VerifiedBy { get; init; }
+
+    /// <summary>
+    /// 审核时间。
+    /// </summary>
+    public DateTime? VerifiedAt { get; init; }
+
+    /// <summary>
+    /// 退款原因。
+    /// </summary>
+    public string? RefundReason { get; init; }
+
+    /// <summary>
+    /// 退款时间。
+    /// </summary>
+    public DateTime? RefundedAt { get; init; }
+
+    /// <summary>
+    /// 备注信息。
+    /// </summary>
+    public string? Notes { get; init; }
+
+    /// <summary>
+    /// 创建时间（UTC）。
+    /// </summary>
+    public DateTime CreatedAt { get; init; }
+}