package com.kexue.skills.service;
import com.github.pagehelper.PageInfo;

import com.kexue.skills.entity.SysUser;
import com.kexue.skills.entity.dto.SysUserDto;
import com.kexue.skills.entity.request.*;

import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * (SysUser)表服务接口
 *
 * @author 王志维
 * @since 2025-02-21 23:01:48
 */
public interface SysUserService extends BaseService {

    /**
     * 分页查询
     *
     * @param sysUserDto 筛选条件
     * @return 查询结果
     */
    PageInfo<SysUser> getPageList(SysUserDto sysUserDto);

    /**
     * 通过ID查询单条数据
     *
     * @param userId 主键
     * @return 实例对象
     */
    SysUser queryById(Long userId);

    /**
     * 查询多条数据
     *
     * @param offset 查询起始位置
     * @param limit 查询条数
     * @return 对象列表
     */
    List<SysUser> queryAllByLimit(int offset, int limit);

    /**
     * 新增数据
     *
     * @param sysUser 实例对象
     * @return 实例对象
     */
    SysUser insert(SysUser sysUser);

    /**
     * 修改数据
     *
     * @param sysUser 实例对象
     * @return 实例对象
     */
    SysUser update(SysUser sysUser);

    /**
     * 修改用户数据
     *
     * @param sysUserUpdateDto 用户更新请求参数
     * @return 实例对象
     */
    SysUser update(SysUserUpdateDto sysUserUpdateDto);

    /**
     * 通过主键删除数据
     *
     * @param userId 主键
     * @return 是否成功
     */
    boolean deleteById(Long userId);

    LoginUserDto login(LoginDto loginDto);

    boolean resetPassword(ResetPwdDto resetPasswordDto);

    SysUser getByUsername(String username);
    
    /**
     * 重置密码（管理员专用）
     *
     * @param userId 用户ID
     * @param newPassword 新密码
     * @param operator 操作人
     * @return 是否成功
     */
    boolean resetPwd(Long userId, String newPassword, String operator);
    
    /**
     * 管理员重置密码（通过用户名或手机号，无需旧密码）
     *
     * @param usernameOrPhone 用户名或手机号
     * @param newPassword 新密码
     * @param operator 操作人
     * @return 是否成功
     */
    boolean resetPasswordByUsernameOrPhone(String usernameOrPhone, String newPassword, String operator);
    
    /**
     * 发送手机验证码
     *
     * @param phone 手机号
     * @return 是否发送成功
     */
    boolean sendSmsCode(String phone);
    
    /**
     * 手机号登录
     *
     * @param phoneLoginDto 手机号登录信息
     * @return 登录结果
     */
    LoginUserDto phoneLogin(PhoneLoginDto phoneLoginDto);
    
    /**
     * 根据用户名或手机号查询用户
     *
     * @param usernameOrPhone 用户名或手机号
     * @return 用户对象
     */
    SysUser getUserByUsernameOrPhone(String usernameOrPhone);
    
    /**
     * 创建或获取用户会话
     *
     * @param userId 用户ID
     * @return 会话信息
     */
    com.kexue.skills.entity.dto.SessionDto createSession(Long userId);
    
    /**
     * 查询用户角色列表
     *
     * @param userId 用户ID
     * @return 角色编码列表
     */
    List<String> queryUserRoles(Long userId);
    
    /**
     * 更新用户缓存
     *
     * @param userId 用户ID
     * @param user 更新后的用户信息
     * @param token 用户的认证token
     */
    void updateUserCache(Long userId, SysUser user, String token);
    
    /**
     * 上传用户头像
     *
     * @param file 头像文件
     * @param userId 用户ID
     * @param token 用户的认证token
     * @return 上传成功的文件名
     */
    String uploadAvatar(MultipartFile file, Long userId, String token);
}
