YD_Event.Admin/YD_Event.Application/Event/Dtos/UserCompetitionDtos.cs

using System.ComponentModel.DataAnnotations;
using YD_Event.Application.Event.Dtos;
using YD_Event.Core.Entities;
using YD_Event.Core.Enum;
using Microsoft.AspNetCore.Http;

namespace YD_Event.Application.Event.Dtos;

/// <summary>
/// 用户端赛事查询输入
/// </summary>
public class UserEventQueryInput : Pagination
{
    /// <summary>
    /// 赛事状态 (0-全部, 1-报名中, 2-比赛中, 3-已结束)
    /// </summary>
    public EventStatus? Status { get; set; }

    /// <summary>
    /// 赛事类型
    /// </summary>
    public EventFormat? Type { get; set; }

    /// <summary>
    /// 时间范围开始
    /// </summary>
    public DateTime? StartTime { get; set; }

    /// <summary>
    /// 时间范围结束
    /// </summary>
    public DateTime? EndTime { get; set; }
    
    /// <summary>
    /// 关键字搜索（赛事名称）
    /// </summary>
    public string? Keyword { get; set; }
}

/// <summary>
/// 用户端赛事列表输出
/// </summary>
public class UserEventListOutput
{
    /// <summary>
    /// 赛事ID
    /// </summary>
    public long Id { get; set; }

    /// <summary>
    /// 赛事名称
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 封面图片
    /// </summary>
    public string CoverImage { get; set; }

    /// <summary>
    /// 赛事状态 (报名中/比赛中/已结束)
    /// </summary>
    public string Status { get; set; }

    /// <summary>
    /// 赛事类型 (线上/线下)
    /// </summary>
    public string Type { get; set; }

    /// <summary>
    /// 报名结束时间
    /// </summary>
    public DateTime RegistrationEndTime { get; set; }

    /// <summary>
    /// 比赛开始时间
    /// </summary>
    public DateTime MatchStartTime { get; set; }

    /// <summary>
    /// 比赛结束时间
    /// </summary>
    public DateTime MatchEndTime { get; set; }
}

/// <summary>
/// 用户端赛事详情输出
/// </summary>
public class UserEventDetailOutput
{
    /// <summary>
    /// 赛事ID
    /// </summary>
    public long Id { get; set; }

    /// <summary>
    /// 赛事名称
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 封面图片
    /// </summary>
    public string CoverImage { get; set; }

    /// <summary>
    /// 赛事视频
    /// </summary>
    public string? EventVideo { get; set; }

    /// <summary>
    /// 赛事状态
    /// </summary>
    public string Status { get; set; }

    /// <summary>
    /// 赛事类型
    /// </summary>
    public string Type { get; set; }

    /// <summary>
    /// 报名方式
    /// </summary>
    public string RegistrationType { get; set; }

    /// <summary>
    /// 积分规则名称
    /// </summary>
    public string PointsRuleName { get; set; }

    /// <summary>
    /// 报名开始时间
    /// </summary>
    public DateTime RegistrationStartTime { get; set; }

    /// <summary>
    /// 报名结束时间
    /// </summary>
    public DateTime RegistrationEndTime { get; set; }

    /// <summary>
    /// 是否需要上传素材
    /// </summary>
    public bool IsNeedMaterial { get; set; }

    /// <summary>
    /// 素材备注
    /// </summary>
    public string? MaterialRemark { get; set; }

    /// <summary>
    /// 素材上传截止时间
    /// </summary>
    public DateTime? MaterialUploadEndTime { get; set; }

    /// <summary>
    /// 比赛开始时间
    /// </summary>
    public DateTime MatchStartTime { get; set; }

    /// <summary>
    /// 比赛结束时间
    /// </summary>
    public DateTime MatchEndTime { get; set; }

    /// <summary>
    /// 赛事简介/规则
    /// </summary>
    public string Description { get; set; }

    /// <summary>
    /// 地址
    /// </summary>
    public string Address { get; set; }

    /// <summary>
    /// 备注
    /// </summary>
    public string? Remark { get; set; }

    /// <summary>
    /// 主办/承办单位
    /// </summary>
    public List<EventUnitDto> Units { get; set; }
    
    /// <summary>
    /// 报名限制配置
    /// </summary>
    public UserEventLimitOutput? LimitConfig { get; set; }

    /// <summary>
    /// 费用配置
    /// </summary>
    public UserEventFeeOutput? FeeConfig { get; set; }

    /// <summary>
    /// 项目列表
    /// </summary>
    public List<UserEventProjectListOutput>? Projects { get; set; }

    /// <summary>
    /// 当前用户报名状态 (未报名/已报名/审核中)
    /// </summary>
    public string UserRegistrationStatus { get; set; }

    /// <summary>
    /// 报名ID (如果已报名)
    /// </summary>
    public long? RegistrationId { get; set; }
}

/// <summary>
/// 用户端赛事限制输出
/// </summary>
public class UserEventLimitOutput
{
    /// <summary>
    /// 个人项目限报数量
    /// </summary>
    public int IndividualProjectLimit { get; set; }

    /// <summary>
    /// 团队项目限报数量
    /// </summary>
    public int TeamProjectLimit { get; set; }
}

/// <summary>
/// 用户端赛事费用输出
/// </summary>
public class UserEventFeeOutput
{
    /// <summary>
    /// 收费模式
    /// </summary>
    public string ChargeMode { get; set; }

    /// <summary>
    /// 价格
    /// </summary>
    public decimal Price { get; set; }
}

/// <summary>
/// 报名项目选择输出
/// </summary>
public class UserEventProjectListOutput
{
    /// <summary>
    /// 项目ID
    /// </summary>
    public long Id { get; set; }

    /// <summary>
    /// 项目名称
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 组别名称
    /// </summary>
    public string GroupName { get; set; }

    /// <summary>
    /// 费用
    /// </summary>
    public decimal Fee { get; set; }

    /// <summary>
    /// 人数限制
    /// </summary>
    public int? LimitCount { get; set; }

    /// <summary>
    /// 已报名人数
    /// </summary>
    public int RegisteredCount { get; set; }

    /// <summary>
    /// 报名要求描述
    /// </summary>
    public string Requirements { get; set; }

    /// <summary>
    /// 团队人数要求 (1为个人)
    /// </summary>
    public int TeamSize { get; set; }

    /// <summary>
    /// 完成人数
    /// </summary>
    public int CompletionCount { get; set; }
}

/// <summary>
/// 团队成员搜索输入
/// </summary>
public class UserMemberSearchInput
{
    /// <summary>
    /// 关键字 (手机号或ID)
    /// </summary>
    public string Keyword { get; set; }
}

/// <summary>
/// 团队成员信息输出
/// </summary>
public class UserTeamMemberOutput
{
    /// <summary>
    /// 用户ID
    /// </summary>
    public long UserId { get; set; }

    /// <summary>
    /// 姓名
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 手机号
    /// </summary>
    public string Mobile { get; set; }

    /// <summary>
    /// 身份证号 (脱敏显示)
    /// </summary>
    public string IdCardNumber { get; set; }

    /// <summary>
    /// 性别
    /// </summary>
    public string Gender { get; set; }

    /// <summary>
    /// 是否符合参赛资格
    /// </summary>
    public bool IsEligible { get; set; }

    /// <summary>
    /// 不符合原因
    /// </summary>
    public string IneligibilityReason { get; set; }
}

/// <summary>
/// 提交报名输入 (草稿或正式提交)
/// </summary>
public class UserSubmitRegistrationInput
{
    /// <summary>
    /// 赛事ID
    /// </summary>
    public long EventId { get; set; }
    
    /// <summary>
    /// 选中的项目ID列表
    /// </summary>
    public List<long> ProjectIds { get; set; }
    
    /// <summary>
    /// 队员列表
    /// </summary>
    public List<long> MemberIds { get; set; }
    
    /// <summary>
    /// 是否保存草稿
    /// </summary>
    public bool IsDraft { get; set; }
}

/// <summary>
/// 订单预览输出
/// </summary>
public class UserOrderPreviewOutput
{
    /// <summary>
    /// 赛事ID
    /// </summary>
    public long EventId { get; set; }

    /// <summary>
    /// 赛事名称
    /// </summary>
    public string EventName { get; set; }

    /// <summary>
    /// 项目列表
    /// </summary>
    public List<UserEventProjectListOutput> Projects { get; set; }

    /// <summary>
    /// 成员列表
    /// </summary>
    public List<UserTeamMemberOutput> Members { get; set; }

    /// <summary>
    /// 总金额
    /// </summary>
    public decimal TotalAmount { get; set; }

    /// <summary>
    /// 费用明细
    /// </summary>
    public Dictionary<string, decimal> FeeDetails { get; set; }
}

/// <summary>
/// 创建支付订单输入
/// </summary>
public class UserCreateOrderInput
{
    /// <summary>
    /// 报名ID
    /// </summary>
    public long RegistrationId { get; set; }

    /// <summary>
    /// 支付方式 (1-微信, 2-支付宝, 3-银行卡)
    /// </summary>
    public int PaymentMethod { get; set; }
}

/// <summary>
/// 用户支付结果输出
/// </summary>
public class UserPaymentResultOutput
{
    /// <summary>
    /// 订单号
    /// </summary>
    public string OrderNo { get; set; }

    /// <summary>
    /// 支付链接或二维码
    /// </summary>
    public string PayUrl { get; set; }

    /// <summary>
    /// 状态
    /// </summary>
    public int Status { get; set; }

    /// <summary>
    /// 支付方式 (例如：JSAPI, NATIVE)
    /// </summary>
    public string? TradeType { get; set; }

    /// <summary>
    /// 微信Native支付参数 - 二维码链接
    /// </summary>
    public string? QrcodeUrl { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - AppId
    /// </summary>
    public string? AppId { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - 时间戳
    /// </summary>
    public string? TimeStamp { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - 随机字符串
    /// </summary>
    public string? NonceStr { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - 订单详情扩展字符串
    /// </summary>
    public string? Package { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - 签名方式
    /// </summary>
    public string? SignType { get; set; }

    /// <summary>
    /// 微信JSAPI支付参数 - 签名
    /// </summary>
    public string? PaySign { get; set; }
}

#region 参赛记录相关 DTOs

/// <summary>
/// 参赛记录查询输入
/// </summary>
public class RegistrationListQueryInput : Pagination
{
    /// <summary>
    /// 赛事ID (可选)
    /// </summary>
    public long? EventId { get; set; }

    /// <summary>
    /// 状态 (可选)
    /// </summary>
    public string? Status { get; set; } // 对应 RegistrationStatus 或 PaymentStatus 组合状态

    /// <summary>
    /// 关键字搜索 (队伍名/赛事名)
    /// </summary>
    public string? Keyword { get; set; }
}

/// <summary>
/// 参赛记录列表项输出
/// </summary>
public class RegistrationItemDTO
{
    /// <summary>
    /// 报名ID
    /// </summary>
    public long RegistrationId { get; set; }

    /// <summary>
    /// 赛事名称
    /// </summary>
    public string EventName { get; set; }

    /// <summary>
    /// 团队名称
    /// </summary>
    public string TeamName { get; set; }

    /// <summary>
    /// 综合状态描述 (待付款, 待上传素材, 已取消, 已报名, 待审核)
    /// </summary>
    public string Status { get; set; }

    /// <summary>
    /// 创建时间
    /// </summary>
    public DateTime CreateTime { get; set; }

    /// <summary>
    /// 更新时间
    /// </summary>
    public DateTime? UpdateTime { get; set; }

    /// <summary>
    /// 支付状态
    /// </summary>
    public string PayStatus { get; set; }

    /// <summary>
    /// 证书状态
    /// </summary>
    public string CertStatus { get; set; }

    /// <summary>
    /// 是否有素材
    /// </summary>
    public bool HasMaterial { get; set; }

    /// <summary>
    /// 是否有凭证
    /// </summary>
    public bool HasVoucher { get; set; }

    /// <summary>
    /// 成员数量
    /// </summary>
    public int MemberCount { get; set; }

    /// <summary>
    /// 允许的最大人数
    /// </summary>
    public int MaxMember { get; set; }

    /// <summary>
    /// 支付或素材上传截止时间
    /// </summary>
    public DateTime? ExpireTime { get; set; }
}

/// <summary>
/// 上传素材输入
/// </summary>
public class UploadMaterialInput
{
    /// <summary>
    /// 文件列表 (最多5个)
    /// </summary>
    [Required]
    public List<IFormFile> Files { get; set; }

    /// <summary>
    /// 素材类型 (图片/视频/其他)
    /// </summary>
    [Required]
    public string MaterialType { get; set; } 

    /// <summary>
    /// 描述 (可选)
    /// </summary>
    public string? Description { get; set; }
}

/// <summary>
/// 素材信息输出
/// </summary>
public class MaterialDTO
{
    /// <summary>
    /// 素材ID
    /// </summary>
    public string MaterialId { get; set; }

    /// <summary>
    /// OSS URL
    /// </summary>
    public string OssUrl { get; set; }

    /// <summary>
    /// 文件名
    /// </summary>
    public string FileName { get; set; }

    /// <summary>
    /// 文件大小
    /// </summary>
    public long FileSize { get; set; }

    /// <summary>
    /// 上传时间
    /// </summary>
    public DateTime UploadTime { get; set; }
}

/// <summary>
/// 上传支付凭证输入
/// </summary>
public class UploadVoucherInput
{
    /// <summary>
    /// 凭证图片 (单张)
    /// </summary>
    [Required]
    public IFormFile File { get; set; }

    /// <summary>
    /// 支付金额
    /// </summary>
    [Required]
    public decimal PayAmount { get; set; }

    /// <summary>
    /// 支付时间
    /// </summary>
    [Required]
    public DateTime PayTime { get; set; }

    /// <summary>
    /// 支付渠道 (微信/支付宝/银行转账)
    /// </summary>
    [Required]
    public string PayChannel { get; set; }

    /// <summary>
    /// 交易流水号 (可选)
    /// </summary>
    public string? TransactionId { get; set; }
}

/// <summary>
/// 支付凭证输出
/// </summary>
public class VoucherDTO
{
    /// <summary>
    /// 凭证ID
    /// </summary>
    public string VoucherId { get; set; }

    /// <summary>
    /// OSS URL
    /// </summary>
    public string OssUrl { get; set; }

    /// <summary>
    /// 审核状态
    /// </summary>
    public string AuditStatus { get; set; }
}

/// <summary>
/// 队员信息 DTO
/// </summary>
public class TeamMemberDTO
{
    /// <summary>
    /// 用户ID
    /// </summary>
    public long UserId { get; set; }

    /// <summary>
    /// 真实姓名
    /// </summary>
    public string RealName { get; set; }

    /// <summary>
    /// 手机号
    /// </summary>
    public string Phone { get; set; }

    /// <summary>
    /// 邮箱
    /// </summary>
    public string Email { get; set; }

    /// <summary>
    /// 角色 (队长/队员)
    /// </summary>
    public string Role { get; set; }

    /// <summary>
    /// 邀请状态
    /// </summary>
    public string InviteStatus { get; set; }

    /// <summary>
    /// 加入时间
    /// </summary>
    public DateTime JoinTime { get; set; }
}

/// <summary>
/// 更换队员输入
/// </summary>
public class ReplaceMemberInput
{
    /// <summary>
    /// 新队员用户ID
    /// </summary>
    [Required]
    public long NewUserId { get; set; }

    /// <summary>
    /// 更换原因 (可选)
    /// </summary>
    public string? ReplaceReason { get; set; }
}

/// <summary>
/// 证书信息输出
/// </summary>
public class CertificateDTO
{
    /// <summary>
    /// 证书URL
    /// </summary>
    public string CertUrl { get; set; }

    /// <summary>
    /// 证书编号
    /// </summary>
    public string CertNumber { get; set; }

    /// <summary>
    /// 颁发时间
    /// </summary>
    public DateTime IssueTime { get; set; }

    /// <summary>
    /// 过期时间
    /// </summary>
    public DateTime? ExpireTime { get; set; }
}

/// <summary>
/// 统一响应 DTO (泛型)
/// </summary>
public class ResponseDTO<T>
{
    /// <summary>
    /// 状态码
    /// </summary>
    public int Code { get; set; }

    /// <summary>
    /// 消息
    /// </summary>
    public string Message { get; set; }

    /// <summary>
    /// 数据
    /// </summary>
    public T Data { get; set; }

    /// <summary>
    /// 是否成功
    /// </summary>
    public bool Success { get; set; }
}

#endregion