package com.custom.webui.service; import com.custom.webui.dto.req.ChangePasswordRequest; import com.custom.webui.dto.req.LoginRequest; import com.custom.webui.dto.req.RegisterRequest; import com.custom.webui.dto.resp.LoginResponse; import com.custom.webui.dto.resp.UserDTO; import com.custom.webui.entity.User; /** 用户与认证服务。 */ public interface UserService { /** * 登录:校验用户名密码,成功返回 JWT 与用户信息。 * * @throws com.custom.webui.exception.BusinessException 用户名或密码错误(401) */ LoginResponse login(LoginRequest request); /** * 注册新用户,角色固定为 user。 * * @throws com.custom.webui.exception.BusinessException 用户名已存在(400) */ UserDTO register(RegisterRequest request); /** 按 id 查用户,不存在抛 404 */ User requireById(Long userId); /** 转 DTO(自动剥离 passwordHash) */ UserDTO toDto(User user); /** 修改当前用户密码 */ void changePassword(Long userId, ChangePasswordRequest request); }