package com.cf.imes.module.system.service.auth;

import com.cf.imes.module.system.controller.admin.auth.vo.AuthLoginReqVO;
import com.cf.imes.module.system.controller.admin.auth.vo.AuthLoginRespVO;
import com.cf.imes.module.system.controller.admin.auth.vo.AuthLoginSmsCheckReqVO;
import com.cf.imes.module.system.controller.admin.auth.vo.AuthSmsSendReqVO;
import com.cf.imes.module.system.dal.dataobject.user.AdminUserDO;

import jakarta.validation.Valid;

/**
 * 管理后台的认证 Service 接口
 *
 * 提供用户的登录、登出的能力
 *
 * @author 晨丰科技
 */
public interface AdminAuthService {

    /**
     * 验证账号 + 密码。如果通过，则返回用户
     *
     * @param reqVO
     * @return 用户
     */
    AdminUserDO authenticate(AuthLoginReqVO reqVO);

    /**
     * 账号登录
     *
     * @param reqVO 登录信息
     * @param isManageEndPoint 是否为管理端登录
     * @return 登录结果
     */
    AuthLoginRespVO login(@Valid AuthLoginReqVO reqVO, boolean isManageEndPoint);

    /**
     * 登录校验
     * @param mobile
     * @return true需要验证码，false不需要验证码
     */
    boolean loginCheck(String mobile);

    /**
     * 登录短信验证码校验
     *
     * @return true正确，false错误
     */
    boolean loginSmsCheck(AuthLoginSmsCheckReqVO reqVO);

    /**
     * 基于 token 退出登录
     *
     * @param token token
     * @param logType 登出类型
     */
    void logout(String token, Integer logType);

    /**
     * 短信验证码发送
     *
     * @param reqVO 发送请求
     */
    void sendSmsCode(AuthSmsSendReqVO reqVO);

    /**
     * 获取 mes系统 JWT 令牌
     *
     * @return 令牌
     */
    String getMesJwtToken();
}
