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

import com.jeesharp.business.modules.setting.entity.CfgClientAppVersion;
import com.jeesharp.business.modules.setting.vo.ClientAppVersionQueryVO;
import com.jeesharp.framework.mybatis.core.service.BaseInterface;

import java.util.List;

/**
 * C 端客户端版本发布领域服务，定义已发布记录查询与后台维护入口。
 *
 * @author jeesharp
 * @since 2026-05-13
 */
public interface ClientAppVersionService extends BaseInterface<CfgClientAppVersion, ClientAppVersionQueryVO> {

    /**
     * 查询全部已发布且未删除的记录，按 {@code versionCode} 降序。
     *
     * @return 列表，可能为空
     */
    List<CfgClientAppVersion> findPublishedOrderByVersionCodeDesc();

    /**
     * 新增一条版本发布记录。
     */
    void createClientAppVersion(CfgClientAppVersion entity);

    /**
     * 更新版本发布记录。
     */
    void updateClientAppVersion(CfgClientAppVersion entity);
}
