using Model;
using Model.Dto.System;
using SqlSugar;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace Service.Interface
{
    /// <summary>
    /// 系统参数配置 服务接口
    /// 管理侧：CRUD（按 Group 分组、关键字检索）；业务侧：按 Key 单/批量取值（带缓存）
    /// 内置参数（IsSystem=1）禁止删除，仅允许修改 Value
    /// </summary>
    public interface ISystemParamService
    {
        // ==================== 管理侧 ====================

        /// <summary>分页查询（关键字匹配 ParamKey/ParamName；可选 Group 过滤）</summary>
        Task<Result<List<SystemParamDto>>> GetListPagedAsync(int pageIndex, int pageSize, RefAsync<int> total, string? keyword = null, string? group = null);

        /// <summary>参数详情</summary>
        Task<Result<SystemParamDto>> GetByIdAsync(long id);

        /// <summary>新增参数（校验 ParamKey 唯一）</summary>
        Task<Result<SystemParamDto>> AddAsync(SystemParamDto dto);

        /// <summary>修改参数（内置参数仅允许改 Value/Remark；非内置可改全字段；Key 变更时同步失效缓存）</summary>
        Task<Result<SystemParamDto>> UpdateAsync(SystemParamDto dto);

        /// <summary>删除参数（内置参数禁止删除）</summary>
        Task<Result> DeleteAsync(long id);

        /// <summary>清空参数值缓存（运维用）</summary>
        Task<Result> ReloadCacheAsync();

        // ==================== 业务侧（无权限，供其它模块调用） ====================

        /// <summary>按 Key 取单个值（带缓存；不存在返回空字符串）</summary>
        Task<Result<string>> GetValueAsync(string key);

        /// <summary>按 Key 列表批量取值（带缓存）</summary>
        Task<Result<List<SystemParamValueDto>>> GetValuesAsync(string[] keys);
    }
}