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

import com.jeesharp.business.modules.setting.entity.OperationPopup;
import com.jeesharp.business.modules.setting.vo.OperationPopupQueryVO;
import com.jeesharp.framework.mybatis.core.service.BaseInterface;

import java.util.List;

/**
 * 运营弹窗领域服务，定义持久化与 C 端投放查询。
 *
 * @author jeesharp
 * @since 2026-05-13
 */
public interface OperationPopupService extends BaseInterface<OperationPopup, OperationPopupQueryVO> {

    /**
     * 微信小程序首页当前有效弹窗列表（启用且在展示时段内），按排序升序。
     *
     * @return 实体列表，可能为空
     */
    List<OperationPopup> listActiveForWechatMiniHome();

    /**
     * 新增弹窗（带默认值填充）。
     *
     * @param entity 实体
     */
    void createPopup(OperationPopup entity);

    /**
     * 更新弹窗。
     *
     * @param entity 实体
     */
    void updatePopup(OperationPopup entity);
}
