package com.yupi.project.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.project.model.entity.User;
import javax.servlet.http.HttpServletRequest;
import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

/**
* @description 针对表【user(用户表)】的数据库操作Service
* @createDate 2023-11-24 10:05:00
*/
public interface UserService extends IService<User> {

    /**
     * 用户注册
     *
     * @param username   用户名
     * @param password   密码
     * @param checkPassword 校验密码
     * @return 新用户 id
     */
    long userRegister(String username, String password, String checkPassword);

    /**
     * 用户登录
     *
     * @param username 用户名
     * @param password 密码
     * @param request  HttpServletRequest 用于操作 session
     * @return 脱敏后的用户信息
     */
    User userLogin(String username, String password, HttpServletRequest request);

    /**
     * 获取当前登录用户
     *
     * @param request HttpServletRequest
     * @return 当前登录用户，未登录则返回 null
     */
    User getCurrentUser(HttpServletRequest request);

    /**
     * 用户注销
     *
     * @param request HttpServletRequest
     * @return 是否成功
     */
    boolean userLogout(HttpServletRequest request);

    /**
     * 获取脱敏的用户信息
     *
     * @param originUser 原始用户信息
     * @return 脱敏后的用户信息
     */
    User getSafetyUser(User originUser);

    /**
     * 扣减用户余额
     *
     * @param userId 用户ID
     * @param amount 要扣减的金额 (注意：这里假设amount是正数)
     * @return 操作是否成功 (例如，余额不足则失败)
     */
    boolean decreaseBalance(Long userId, BigDecimal amount);

    /**
     * 增加用户余额
     *
     * @param userId 用户ID
     * @param amount 要增加的金额
     * @return 操作是否成功
     */
    boolean increaseBalance(Long userId, BigDecimal amount);

    /**
     * 获取用户列表 (仅管理员)
     *
     * @return 脱敏后的用户列表
     */
    List<User> listUsers();

    /**
     * 管理员删除用户 (逻辑删除)
     *
     * @param userId 用户ID
     * @return 操作是否成功
     */
    boolean adminDeleteUser(Long userId);

    /**
     * 管理员添加新用户
     *
     * @param addRequest 包含新用户信息的请求体
     * @return 新用户的ID
     */
    long adminAddUser(com.yupi.project.model.dto.user.UserAdminAddRequest addRequest);

    /**
     * 管理员更新用户信息
     *
     * @param updateRequest 包含待更新用户信息的请求体
     * @return 操作是否成功
     */
    boolean adminUpdateUser(com.yupi.project.model.dto.user.UserAdminUpdateRequest updateRequest);

    /**
     * 获取用户的仪表盘统计数据 (例如本月充电次数和消费)
     *
     * @param userId 用户ID
     * @return 包含统计数据的 Map
     */
    Map<String, Object> getUserDashboardStats(Long userId);
} 