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

import com.fasterxml.jackson.annotation.JsonAlias;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

/**
 * 小程序首页快捷宫格（两行四列，启用前 8 条）；数据来自 {@code cms_home_quick_grid}。
 *
 * @author jeesharp
 * @since 2026-05-13
 */
@Data
@Schema(description = "小程序首页-快捷宫格")
public class MiniHomeQuickNavItemVO {

    @Schema(description = "宫格主键（cms_home_quick_grid.id），列表/详情接口入参")
    private String id;

    /**
     * 业务编号；兼容历史 JSON 字段 {@code action}。
     */
    @JsonAlias("action")
    @Schema(description = "业务编号（唯一键，兼容旧字段 action）")
    private String navCode;

    @Schema(description = "展示文案（建议四字，端上可拆两行）")
    private String label;

    @Schema(description = "图标 URL，空则端上可按 navCode 使用内置图标")
    private String iconUrl;

    @Schema(description = "小程序页面路径，须以 / 开头；tabBar 页由端上 switchTab")
    private String linkUrl;

    @Schema(description = "宫格介绍跳转：1-介绍列表 2-介绍详情")
    private Integer introJumpType;

    @Schema(description = "介绍列表布局：0-大图卡片 … 10-动感频道页")
    private Integer introListLayout;

    @Schema(description = "详情模式：小程序详情页完整路径")
    private String introDetailLinkPath;

    @Schema(description = "详情模式：绑定介绍文章主键")
    private String introDetailArticleId;
}
