package com.jeesharp.business.modules.setting.vo;

import com.jeesharp.business.modules.setting.dto.OperationPopupExtConfigDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

import java.util.List;

/**
 * 小程序首页运营弹窗（C 端展示用），与《小程序接口文档》§3.31.7 字段建议对齐。
 * <p>由 {@link com.jeesharp.business.modules.setting.application.OperationPopupApplicationService#listForWechatMiniHome()} 从表 {@code cfg_operation_popup} 组装。</p>
 *
 * @author jeesharp
 * @since 2026-05-12
 */
@Data
@Schema(description = "运营首页弹窗（客户端）")
public class OperationPopupClientVO {

    @Schema(description = "弹窗配置主键")
    private String id;

    @Schema(description = "标题")
    private String title;

    @Schema(description = "副标题")
    private String subtitle;

    @Schema(description = "展示方式：IMAGE_H/IMAGE_V/CARD/COUPON_PACK/ACTIVITY")
    private String displayMode;

    @Schema(description = "模式扩展配置")
    private OperationPopupExtConfigDTO extConfig;

    @Schema(description = "配图 URL")
    private String imageUrl;

    @Schema(description = "券包模式下的券列表")
    private List<OperationPopupClientCouponItemVO> coupons;

    @Schema(description = "点击后跳转路径（小程序内路径或约定外链）")
    private String linkPath;

    @Schema(description = "是否允许用户关闭")
    private Boolean closable;

    @Schema(description = "展示开始时间")
    private String startTime;

    @Schema(description = "展示结束时间")
    private String endTime;
}
