package com.talentcard.server.request;

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;

@Schema(name = "小程序票包领取请求", description = "小程序领取票包兑换码")
public record TicketPackageClaimRequest(
        @Schema(description = "持卡人ID", example = "2", requiredMode = Schema.RequiredMode.REQUIRED)
        @NotNull(message = "持卡人ID不能为空")
        Long talentId,

        @Schema(description = "人才卡ID；不传时取该持卡人的有效卡", example = "8")
        Long cardId,

        @Schema(description = "当前领取影城/商家ID；多商家票包用于记录实际领取商家", example = "12")
        Long merchantId,

        @Schema(description = "幂等领取凭证；也可通过请求头X-Idempotency-Key传入", example = "ticket-package-claim-20260804-001")
        @Size(max = 128, message = "领取凭证长度不能超过128")
        String idempotencyKey
) {
}