package xiaozhi.modules.sys.service;

import java.util.List;
import java.util.Map;

import xiaozhi.common.page.PageData;
import xiaozhi.common.service.BaseService;
import xiaozhi.modules.sys.dto.SysParamsDTO;
import xiaozhi.modules.sys.entity.SysParamsEntity;

/**
 * 参数管理
 */
public interface SysParamsService extends BaseService<SysParamsEntity> {

    PageData<SysParamsDTO> page(Map<String, Object> params);

    List<SysParamsDTO> list(Map<String, Object> params);

    SysParamsDTO get(Long id);

    void save(SysParamsDTO dto);

    void update(SysParamsDTO dto);

    void delete(String[] ids);

    /**
     * 根据参数编码，获取参数的value值
     *
     * @param paramCode 参数编码
     * @param fromCache 是否从缓存中获取
     */
    String getValue(String paramCode, Boolean fromCache);

    /**
     * 根据参数编码，获取value的Object对象
     *
     * @param paramCode 参数编码
     * @param clazz     Object对象
     */
    <T> T getValueObject(String paramCode, Class<T> clazz);

    /**
     * 根据参数编码，更新value
     *
     * @param paramCode  参数编码
     * @param paramValue 参数值
     */
    int updateValueByCode(String paramCode, String paramValue);

    /**
     * 初始化服务器密钥
     */
    void initServerSecret();

    /**
     * 获取系统功能菜单配置
     *
     * @param fromCache 是否从缓存获取
     * @return 系统功能菜单配置JSON字符串
     */
    String getSystemWebMenu(boolean fromCache);

    /**
     * 更新系统功能菜单配置（自动处理功能相关的插件清理）
     *
     * @param configJson 新的系统功能菜单配置JSON
     */
    void updateSystemWebMenu(String configJson);
}