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

import com.jeesharp.business.modules.setting.entity.CmsHomeQuickGrid;
import com.jeesharp.business.modules.setting.vo.HomeQuickGridQueryVO;
import com.jeesharp.framework.mybatis.core.service.BaseInterface;

import java.util.List;

/**
 * 小程序首页快捷宫格领域服务。
 *
 * @author jeesharp
 * @since 2026-05-15
 */
public interface HomeQuickGridService extends BaseInterface<CmsHomeQuickGrid, HomeQuickGridQueryVO> {

    /**
     * C 端壳层：启用中的宫格，按排序与创建时间，至多 {@code limit} 条。
     *
     * @param limit 最大条数（小程序首页固定 8）
     */
    List<CmsHomeQuickGrid> listEnabledForShell(int limit);

    /**
     * 统计未删除记录中业务编号出现次数（更新时排除自身主键）。
     *
     * @param navCode   业务编号
     * @param excludeId 排除的主键 id，新增时可为空
     */
    long countByNavCodeExcludeId(String navCode, String excludeId);
}
