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

import com.jeesharp.business.modules.setting.entity.CmsHomeBanner;
import com.jeesharp.business.modules.setting.vo.HomeBannerQueryVO;
import com.jeesharp.framework.mybatis.core.service.BaseInterface;

import java.util.List;

/**
 * 首页轮播领域服务。
 *
 * @author jeesharp
 * @since 2026-05-08
 */
public interface HomeBannerService extends BaseInterface<CmsHomeBanner, HomeBannerQueryVO> {

    void createHomeBanner(CmsHomeBanner entity);

    void updateHomeBanner(CmsHomeBanner entity);
/**
     * C 端/商城：启用中的轮播，按端（含 ALL）与展示位置筛选。
     *
     * @param platform       展示端，如 {@link com.jeesharp.business.modules.setting.enums.HomeBannerPlatformEnum#WECHAT_MINI}
     * @param bannerPosition 展示位置，如 {@link com.jeesharp.business.modules.setting.enums.HomeBannerPositionEnum#HOME}
     */
    List<CmsHomeBanner> listEnabledForPortal(String platform, String bannerPosition);
}
