jsowell-charger-web/jsowell-pile/src/main/java/com/jsowell/pile/service/MemberPointsInfoService.java

package com.jsowell.pile.service;

import com.jsowell.pile.domain.MemberPointsInfo;
import com.jsowell.pile.domain.MemberPointsRecord;

import java.math.BigDecimal;
import java.util.List;

/**
 * 用户积分Service接口
 */
public interface MemberPointsInfoService {

    /**
     * 根据会员ID查询积分信息
     *
     * @param memberId 会员ID
     * @return 积分信息
     */
    MemberPointsInfo selectByMemberId(String memberId);

    /**
     * 获取会员积分余额
     *
     * @param memberId 会员ID
     * @return 积分余额
     */
    BigDecimal getPointsBalance(String memberId);

    /**
     * 增加积分（充电奖励）
     *
     * @param memberId  会员ID
     * @param points    积分数量
     * @param orderCode 关联订单号
     * @return 操作结果
     */
    boolean addPoints(String memberId, BigDecimal points, String orderCode);

    /**
     * 扣减积分（消费抵扣）
     *
     * @param memberId  会员ID
     * @param points    积分数量
     * @param orderCode 关联订单号
     * @return 操作结果
     */
    boolean deductPoints(String memberId, BigDecimal points, String orderCode);

    /**
     * 查询会员积分流水列表
     *
     * @param memberId 会员ID
     * @return 积分流水列表
     */
    List<MemberPointsRecord> getPointsRecordList(String memberId);

    /**
     * 初始化会员积分账户
     *
     * @param memberId 会员ID
     * @return 操作结果
     */
    int initMemberPoints(String memberId);
}