zjk
7 小时以前 8ea6a7dd1fcdbd4e22c564ed63a5a8023510161a
hugray-server/ruoyi-modules/ruoyi-user/src/main/java/com/ruoyi/user/service/IAccountUserService.java
@@ -5,6 +5,10 @@
import com.ruoyi.user.domain.AccountUser;
import com.ruoyi.user.domain.vo.AccountUserDetailVo;
import com.ruoyi.user.domain.vo.MemberOptionVo;
import com.ruoyi.user.domain.vo.AccountInviteeVo;
import com.ruoyi.user.domain.vo.AccountReferrerVo;
import com.ruoyi.user.domain.vo.AccountUserInfoVo;
import com.ruoyi.user.domain.vo.InviteCodeVo;
/**
 * 会员用户 业务层
@@ -17,6 +21,11 @@
     * 根据会员ID查询
     */
    public AccountUser selectAccountUserById(Long userId);
    /**
     * 根据手机号查询会员
     */
    public AccountUser selectAccountUserByPhone(String phone);
    /**
     * 查询会员列表
@@ -89,4 +98,60 @@
     * 批量逻辑删除收货地址
     */
    public int deleteAccountAddressByIds(Long[] ids);
    /**
     * C端会员注册
     *
     * 校验手机号未注册、推荐码有效后,生成唯一推荐码并落库(无密码)。
     *
     * @param phone 手机号
     * @param referralCode 推荐人本人的推荐码
     * @return 注册成功后的会员信息(含生成的 userId 与 myReferralCode)
     */
    public AccountUser registerMember(String phone, String referralCode);
    /**
     * 查询C端会员个人中心信息(昵称 / 头像 / 会员等级 / 收益汇总)
     *
     * @param userId 会员ID(取自登录态,非前端传入)
     * @return 会员信息展示对象;会员不存在时抛业务异常
     */
    public AccountUserInfoVo getAccountUserInfo(Long userId);
    /**
     * 更新C端会员头像
     *
     * 头像文件由小程序直传文件服务后,将返回的 url 写回 account_user.avatar;
     * 只更新 avatar 一列,不触碰其它资料。
     *
     * @param userId 会员ID(取自登录态,非前端传入)
     * @param avatarUrl 头像地址(来自文件服务上传结果)
     */
    public void updateAvatar(Long userId, String avatarUrl);
    /**
     * 查询本人邀请码(我的邀请页「邀请码」Tab)
     *
     * @param userId 会员ID(取自登录态,非前端传入)
     * @return 邀请码展示对象;会员不存在时抛业务异常
     */
    public InviteCodeVo getInviteCode(Long userId);
    /**
     * 查询本人直接下级(被邀请人)列表(我的邀请页「我邀请的」Tab)
     *
     * 按绑定时间倒序(最新在前);手机号脱敏下发;配合 Controller 的分页生效。
     *
     * @param userId 会员ID(取自登录态,非前端传入)
     * @return 被邀请人列表(无下级时返回空集合)
     */
    public List<AccountInviteeVo> getInvitees(Long userId);
    /**
     * 查询本人上级(推荐人)信息(我的邀请页「邀请我的」Tab)
     *
     * @param userId 会员ID(取自登录态,非前端传入)
     * @return 上级展示对象;无上级时返回各字段为 null 的对象(前端渲染空态)
     */
    public AccountReferrerVo getReferrer(Long userId);
}