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

namespace Service.Interface
{
    /// <summary>
    /// 用户管理 服务接口
    /// </summary>
    public interface IUserService
    {
        /// <summary>分页查询用户列表（关键字匹配用户名/姓名，可按角色、组织节点筛选；受数据范围约束）</summary>
        Task<Result<List<UserDto>>> GetPagedAsync(int pageIndex, int pageSize, RefAsync<int> total, string? keyword = null, long? roleId = null, long? orgId = null);

        Task<Result<UserDto>> GetByIdAsync(long id);

        /// <summary>新增用户（校验用户名唯一，密码必填，可同时分配角色）</summary>
        Task<Result<UserDto>> AddAsync(UserDto dto);

        /// <summary>修改用户（不改密码，角色走 AssignRoles）</summary>
        Task<Result<UserDto>> UpdateAsync(UserDto dto);

        /// <summary>删除用户（软删，同时清理角色关联）</summary>
        Task<Result> DeleteAsync(long id);

        /// <summary>分配角色（全量覆盖该用户的角色关联）</summary>
        Task<Result> AssignRolesAsync(long userId, List<long> roleIds);

        /// <summary>管理员重置用户密码</summary>
        Task<Result> ResetPasswordAsync(long userId, string newPassword);

        /// <summary>启用/禁用用户</summary>
        Task<Result> SetEnabledAsync(long userId, bool enabled);

        /// <summary>用户下拉选项</summary>
        Task<Result<List<UserOptionDto>>> GetOptionsAsync();
    }
}