gami-web/app/types/api/skill.ts

// Skill / Playmate related types

// 技能 / 商品详情
export interface SkillDetailVo {
  // 技能 / 商品ID
  id: string
  // 头像
  avatar: string
  // 昵称
  nickname: string
  // 年龄
  age: number
  // 性别：0:未知，1:男，2:女
  gender: 0 | 1 | 2
  // 评分
  star: number
  // 所在区域
  area: string
  // 语言列表
  languageNames: string[]
  // 用户封面图片
  cover: string
  // 用户编号
  userNo: string
  // 品类名称
  categoryName: string
  // 摘要
  summary: string
  // 图片列表
  images: string[]
  // 语音条
  voiceBar: string
  // 价格
  price: number
  // 单位
  unit: string
  // 标签
  labels: string[]
}

// 创建技能商品订单-二维码模式 - 响应体
// 对应接口：POST /skill/create/order/qrcode
export interface SkillCreateQrVo {
  // 1:通用码下单，2:特定码下单
  type: number
  // 综合评分
  star: number
  // 订单当前单价及数量折合法币（idr）金额
  currencyAmount: number
  // 二维码（后端返回的二维码标识/字符串）
  qrCode: string
}

// 技能 / 商品详情请求体
export interface SkillDetailRequest {
  id: string
}

// 游标分页请求（公共）
export interface NextDTO {
  // 条目数
  size?: number
  // 游标，返回获取下一页的游标，空字符串/NULL = 第一页
  next?: unknown
}

// 技能商品筛选 - 请求参数
export interface SkillSearchDTO {
  // 品类编码
  code: string
  // 年龄，-1:不限制，0:15-25，1:25-35，2:35以上
  ageRange?: number
  // 性别：-1:无限制,0:未知，1:男，2:女
  gender?: number
  // 区域编码
  areCode?: string
  // 评分排序，-1:默认排序，0:升序，1:降序
  sortByStar?: number
  // 价格排序，-1:默认排序，0:升序，1:降序
  sortByPrice?: number
  // 价格区间，-1:无限制，0:0-1000，1:1000-1500，2:1500-2500，3:2500-5000，4:5000以上
  priceRange?: number
  // 游标分页参数
  page: NextDTO
}

// 首单折扣机会 - 对应接口 POST /skill/firstOrder/discount/chance
export interface FirstOrderDiscountChanceVo {
  /** 当前是否有首单1折机会 */
  hasChance: boolean
  /** 当前首单折扣率（例如 0.1 表示 1 折） */
  discountRate: number
  /** 可参与优惠的 SKU 单价（金币） */
  eligiblePrice: number
}

// 技能商品 - 列表项
export interface SkillSearchVo {
  id: string
  avatar: string
  nickname: string
  age: number
  // 性别：0:未知，1:男，2:女
  gender: 0 | 1 | 2
  // 评分
  star: number
  // 所在区域
  area: string
  // 摘要
  summary: string
  // 图片列表
  images: string[]
  // 语音条
  voiceBar: string
  // 价格
  price: number
  // 单位
  unit: string
  // 标签
  labels: string[]
  // 品类图标
  categoryIcon: string
  // 品类名称
  categoryName: string
  /** 用户编号（可选，用于排除当前用户自己的商品不展示折后价） */
  userNo?: string
}

// 技能商品列表 - 游标分页响应
export interface NextVOSkillSearchVo {
  list: SkillSearchVo[]
  // 返回下一页的基准点 - 游标，NULL/空字符串 = 没有下一页
  next: unknown
}

// 创建技能商品订单-二维码模式 - 请求参数
export interface SkillQrCodeCreateDto {
  // 技能id
  skillId: string
  // 购买数量
  purchaseQty?: number
  // 1:通用码下单，2:特定码下单
  type?: number
}

// 二维码订单-支付 - 请求参数
export interface SkillQrCodePayDto {
  // 二维码 code（创建技能商品二维码接口返回的 qrcode 字符串）
  qrCode: string
  // 购买数量，可选；不传则使用默认数量
  purchaseQty?: number
}

// 直接技能下单-支付 - 请求参数
export interface SkillOrderCreateDto {
  // 技能 id
  skillId: string
  // 购买数量，可选
  purchaseQty?: number
}

// 技能订单支付结果 - 响应体
// 对应接口：
// - POST /skill/order/payment
// - POST /skill/order/qr/payment
export interface OrderPaymentVo {
  // 订单编号
  orderNo: string
  // 金币余额
  goldCoinBalance: number
}

// 查看二维码订单信息 - 响应体
export interface SkillViewQrOrderVo {
  // 技能/商品订单ID
  orderId: string
  // 头像
  avatar: string
  // 昵称
  nickname: string
  // 品类名称
  bizCategoryName: string
  // 单价
  price: number
  // 单位
  unit: string
  // 购买数量
  purchaseQty: number
  // 1:通用码下单，2:特定码下单
  type: number
}

// 查看二维码订单信息 - 请求体
export interface SkillViewQrOrderRequest {
  // 二维码ID（创建二维码接口返回的字符串 qrcode）
  id: string
}

/**
 * 订单列表 & 订单操作相关类型
 * 列表对应接口：POST /skill/order/list
 */

// 技能订单详情 - 请求体
// 对应接口：POST /skill/order/detail
export interface SkillOrderDetailRequest {
  id: string
}

// 通用 ID 请求体（与后端 IdDTOString 结构兼容）
export interface IdDTOString {
  id: string
}

// 订单退款附件
export interface OrderRefundAttachment {
  // 附件地址
  attachmentUrl?: string
  // 附件类型
  type?: number
  // 文件名
  fileName?: string
}

// 通用文件附件（与后端 FileAttachmet 结构兼容）
export interface FileAttachment {
  // 附件地址
  attachmentUrl?: string
  // 附件类型
  type?: number
  // 文件名
  fileName?: string
}

// 订单退款申请请求体
// 对应接口：POST /skill/order/refund/apply
export interface OrderRefundApplyDTO {
  // 订单编号
  orderId: string
  // 退款原因
  reason?: string
  // 附件列表
  attachments?: OrderRefundAttachment[]
  // Playmate supplemental reason
  playmateReason?: string
  // Playmate supplemental attachments
  playmateAttachments?: OrderRefundAttachment[]
}

// 订单评分请求体
// 对应接口：POST /skill/order/star
export interface OrderStarDTO {
  // 订单编号
  orderId: string
  // 评分（1-5）
  star: number
}

// 查看付费订单信息 - 列表项
export interface SkillOrderInfoVo {
  // 订单ID
  orderId: string
  // 头像
  avatar: string
  // 昵称
  nickname: string
  // 品类名称
  bizCategoryName: string
  // 品类图标
  categoryIcon: string
  // 单价
  price: number
  // 单位
  unit: string
  // 购买数量
  purchaseQty: number
  // 状态：0:待支付，1:已支付，2:完成，3:退款/取消
  status: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8
  // 下单时间
  createTime: number
  // 评分
  star?: number
  // 是否已申请退款
  refundApply: boolean
  // 总价
  totalAmount: number
  // 客户备注
  customerRemark?: string
  // 用户性别
  gender?: 0 | 1 | 2
}

// 订单详情 - 响应体
// 对应接口：POST /skill/order/detail
export interface SkillOrderInfoDetailVo {
  // 查看付费订单信息
  orderInfo: SkillOrderInfoVo
  // 客户理由
  reason?: string
  // 客户附件
  attachments?: FileAttachment[]
  // 陪玩师凭证理由
  playmateReason?: string
  // 陪玩师凭证附件
  playmateAttachments?: FileAttachment[]
}

// 订单列表 - 游标分页响应
export interface NextVOSkillOrderInfoVo {
  // 查看付费订单信息
  list: SkillOrderInfoVo[]
  // 返回下一页的基准点 - 游标，NULL/空字符串 = 没有下一页
  next: unknown
}

// 订单列表请求体
export interface SkillOrderListDTO {
  status: number
  page: NextDTO
}