using System.ComponentModel.DataAnnotations; using System.Globalization; using System.Text.Json; using Tiku.Application.Growth; namespace Tiku.Api.Contracts; /// /// 保存佣金配置请求。 /// public sealed class UpdateCommissionSettingsDto { /// /// 默认佣金比例。 /// [Range(0, 1)] public decimal? DefaultRate { get; set; } /// /// 最低结算金额,单位为分。 /// [Range(0, int.MaxValue)] public int? MinSettlementCents { get; set; } /// /// 结算周期。 /// [StringLength(50)] public string? SettlementCycle { get; set; } /// /// 配置内容。 /// public JsonElement? Config { get; set; } public UpdateCommissionSettingsCommand ToCommand() => new(DefaultRate, MinSettlementCents, SettlementCycle, Config); } /// /// 调整成员佣金比例请求。 /// public sealed class UpdateMemberCommissionRateDto { /// /// 用户 ID。 /// [Required] public Guid UserId { get; set; } /// /// 成员佣金比例。 /// [Range(0, 1)] public decimal? CommissionRate { get; set; } /// /// 佣金扩展配置。 /// public JsonElement? CommissionConfig { get; set; } public UpdateMemberCommissionRateCommand ToCommand() => new(UserId, CommissionRate, CommissionConfig); } /// /// 佣金统计周期查询参数。 /// public class CommissionPeriodQueryDto { /// /// 开始日期,格式为 yyyy-MM-dd。 /// [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")] public string? StartDate { get; set; } /// /// 结束日期,格式为 yyyy-MM-dd。 /// [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")] public string? EndDate { get; set; } /// /// 推荐人用户 ID。 /// public Guid? ReferrerUserId { get; set; } /// /// 返回数量上限。 /// [Range(1, 500)] public int? Limit { get; set; } public CommissionPeriodQuery ToQuery() => new(ParseDate(StartDate), ParseDate(EndDate), ReferrerUserId, Limit); protected static DateOnly? ParseDate(string? value) => string.IsNullOrWhiteSpace(value) ? null : DateOnly.ParseExact(value, "yyyy-MM-dd", CultureInfo.InvariantCulture); } /// /// 佣金结算单查询参数。 /// public sealed class CommissionSettlementsQueryDto { /// /// 状态。 /// [StringLength(50)] public string? Status { get; set; } /// /// 推荐人用户 ID。 /// public Guid? ReferrerUserId { get; set; } /// /// 返回数量上限。 /// [Range(1, 500)] public int? Limit { get; set; } public CommissionSettlementQuery ToQuery() => new(Status, ReferrerUserId, Limit); } /// /// 生成佣金结算单请求 DTO。 /// public sealed class GenerateCommissionSettlementDto { /// /// 开始日期,格式为 yyyy-MM-dd。 /// [Required] [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")] public string StartDate { get; set; } = string.Empty; /// /// 结束日期,格式为 yyyy-MM-dd。 /// [Required] [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")] public string EndDate { get; set; } = string.Empty; /// /// 推荐人用户 ID。 /// [Required] public Guid ReferrerUserId { get; set; } /// /// 状态。 /// [StringLength(50)] public string? Status { get; set; } /// /// 备注。 /// [StringLength(1000)] public string? Remark { get; set; } /// /// 扩展元数据。 /// public JsonElement? Metadata { get; set; } public GenerateCommissionSettlementCommand ToCommand() => new(Parse(StartDate), Parse(EndDate), ReferrerUserId, Status, Remark, Metadata); private static DateOnly Parse(string value) => DateOnly.ParseExact(value, "yyyy-MM-dd", CultureInfo.InvariantCulture); } /// /// 更新佣金结算单状态请求 DTO。 /// public sealed class UpdateCommissionSettlementStatusDto { /// /// 结算单 ID。 /// [Required] public Guid SettlementId { get; set; } /// /// 状态。 /// [StringLength(50)] public string? Status { get; set; } /// /// 审核备注。 /// [StringLength(1000)] public string? ReviewNote { get; set; } /// /// 支付方式。 /// [StringLength(100)] public string? PaymentMethod { get; set; } /// /// 收款账号。 /// [StringLength(200)] public string? PaymentAccount { get; set; } /// /// 扩展元数据。 /// public JsonElement? Metadata { get; set; } public UpdateCommissionSettlementStatusCommand ToCommand() => new(SettlementId, Status, ReviewNote, PaymentMethod, PaymentAccount, Metadata); } /// /// 佣金结算单导出查询参数。 /// public sealed class CommissionSettlementExportQueryDto { /// /// 结算单 ID。 /// [Required] public Guid SettlementId { get; set; } /// /// 导出格式。 /// [StringLength(10)] public string? Format { get; set; } } /// /// 佣金结算单凭证查询参数。 /// public sealed class CommissionSettlementProofQueryDto { /// /// 结算单 ID。 /// [Required] public Guid SettlementId { get; set; } } /// /// 创建佣金结算凭证请求。 /// public sealed class CreateCommissionProofDto { /// /// 结算单 ID。 /// [Required] public Guid SettlementId { get; set; } /// /// 凭证类型。 /// [StringLength(50)] public string? ProofType { get; set; } /// /// 标题。 /// [StringLength(200)] public string? Title { get; set; } /// /// 说明。 /// [StringLength(2000)] public string? Description { get; set; } /// /// 资产 ID。 /// public Guid? AssetId { get; set; } /// /// 外部链接。 /// [StringLength(2048)] public string? ExternalUrl { get; set; } /// /// 金额,单位为分。 /// [Range(0, int.MaxValue)] public int? AmountCents { get; set; } /// /// 支付方式。 /// [StringLength(100)] public string? PaymentMethod { get; set; } /// /// 收款账号。 /// [StringLength(200)] public string? PaymentAccount { get; set; } /// /// 支付时间。 /// public DateTimeOffset? PaidAt { get; set; } /// /// 扩展元数据。 /// public JsonElement? Metadata { get; set; } public CreateCommissionProofCommand ToCommand() => new(SettlementId, ProofType, Title, Description, AssetId, ExternalUrl, AmountCents, PaymentMethod, PaymentAccount, PaidAt, Metadata); } /// /// 更新佣金结算凭证状态请求。 /// public sealed class UpdateCommissionProofStatusDto { /// /// 凭证 ID。 /// [Required] public Guid ProofId { get; set; } /// /// 状态。 /// [StringLength(50)] public string? Status { get; set; } /// /// 审核备注。 /// [StringLength(1000)] public string? ReviewNote { get; set; } /// /// 扩展元数据。 /// public JsonElement? Metadata { get; set; } public UpdateCommissionProofStatusCommand ToCommand() => new(ProofId, Status, ReviewNote, Metadata); }