package com.corewing.app.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.corewing.app.entity.User;

/**
 * 应用用户 Service 接口
 */
public interface UserService extends IService<User> {

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户信息
     */
    User getByUsername(String username);

    /**
     * 根据账号查询用户（支持用户名/邮箱/手机号）
     *
     * @param account 账号
     * @return 用户信息
     */
    User getByAccount(String account);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    User getByEmail(String email);

    /**
     * 根据手机号查询用户
     *
     * @param telephone 手机号
     * @return 用户信息
     */
    User getByTelephone(String telephone);

    /**
     * 用户登录
     *
     * @param account  账号（用户名/邮箱/手机号）
     * @param password 密码
     * @return token
     */
    String login(String account, String password);

    /**
     * 用户注册
     *
     * @param user 用户信息
     * @param code 验证码
     * @param registerIp 注册IP
     * @return 是否成功
     */
    boolean register(User user, String code, String registerIp);

    /**
     * 更新登录IP
     *
     * @param userId  用户ID
     * @param loginIp 登录IP
     */
    void updateLoginIp(Long userId, String loginIp);

    /**
     * 更新登录信息（IP和归属地）
     *
     * @param userId  用户ID
     * @param loginIp 登录IP
     */
    void updateLoginInfo(Long userId, String loginIp);
}
