package com.zsElectric.boot.business.service;

import com.zsElectric.boot.business.model.entity.UserInfo;
import com.zsElectric.boot.business.model.form.UserInfoForm;
import com.zsElectric.boot.business.model.query.UserInfoQuery;
import com.zsElectric.boot.business.model.vo.UserInfoVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zsElectric.boot.business.model.vo.applet.AppletUserInfoVO;

/**
 * 个人用户信息服务类
 *
 * @author zsElectric
 * @since 2025-12-12 10:27
 */
public interface UserInfoService extends IService<UserInfo> {

    /**
     *个人用户信息分页列表
     *
     * @return {@link IPage<UserInfoVO>} 个人用户信息分页列表
     */
    IPage<UserInfoVO> getUserInfoPage(UserInfoQuery queryParams);

    /**
     * 获取个人用户信息表单数据
     *
     * @param id 个人用户信息ID
     * @return 个人用户信息表单数据
     */
     UserInfoForm getUserInfoFormData(Long id);

    /**
     * 新增个人用户信息
     *
     * @param formData 个人用户信息表单对象
     * @return 是否新增成功
     */
    boolean saveUserInfo(UserInfoForm formData);

    /**
     * 修改个人用户信息
     *
     * @param id   个人用户信息ID
     * @param formData 个人用户信息表单对象
     * @return 是否修改成功
     */
    boolean updateUserInfo(Long id, UserInfoForm formData);

    /**
     * 删除个人用户信息
     *
     * @param ids 个人用户信息ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteUserInfos(String ids);

    /**
     * 根据openid获取用户信息
     *
     * @param openid 手机号
     * @return 用户信息，不存在返回null
     */
    UserInfo getUserInfoByOpenid(String openid);

    /**
     * 根据手机号注册或更新用户（小程序用）
     * <p>
     * 如果用户不存在则创建，存在则更新openid
     *
     * @param phone 手机号
     * @param openId 微信openid（可为null）
     * @return 用户信息
     */
    UserInfo registerOrUpdateUserByPhone(String phone, String openId);

    AppletUserInfoVO getAppletUserInfo();
}
