package com.jojubanking.boot.module.system.service.userinfo;

import java.util.*;
import javax.validation.*;

import com.jojubanking.boot.framework.common.validation.Mobile;
import com.jojubanking.boot.module.system.controller.app.userinfo.vo.*;
import com.jojubanking.boot.module.system.dal.dataobject.userinfo.UserInfoDO;
import com.jojubanking.boot.framework.common.pojo.PageResult;

/**
 * 用户信息 Service 接口
 *
 * @author admin
 */
public interface UserInfoService {

    /**
     * 通过手机查询用户
     *
     * @param mobile 手机
     * @return 用户对象
     */
    UserInfoDO getUserByMobile(String mobile);

    /**
     * 基于手机号创建用户。
     * 如果用户已经存在，则直接进行返回
     *
     * @param mobile 手机号
     * @param registerIp 注册 IP
     * @return 用户对象
     */
    UserInfoDO createUserIfAbsent(@Mobile String mobile, String registerIp);

    /**
     * 创建用户信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createUserInfo(@Valid AppUserInfoCreateReqVO createReqVO);

    /**
     * 更新用户信息
     *
     * @param updateReqVO 更新信息
     */
    void updateUserInfo(@Valid AppUserInfoUpdateReqVO updateReqVO);

    /**
     * 删除用户信息
     *
     * @param id 编号
     */
    void deleteUserInfo(Long id);

    /**
     * 获得用户信息
     *
     * @param id 编号
     * @return 用户信息
     */
    UserInfoDO getUserInfo(Long id);

    /**
     * 获得用户信息列表
     *
     * @param ids 编号
     * @return 用户信息列表
     */
    List<UserInfoDO> getUserInfoList(Collection<Long> ids);

    /**
     * 获得用户信息分页
     *
     * @param pageReqVO 分页查询
     * @return 用户信息分页
     */
    PageResult<UserInfoDO> getUserInfoPage(AppUserInfoPageReqVO pageReqVO);

    /**
     * 获得用户信息列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 用户信息列表
     */
    List<UserInfoDO> getUserInfoList(AppUserInfoExportReqVO exportReqVO);

}
