优惠券处理

liujie

2026-02-26 04e498d0264f4bd3c467c2f760761934a04c4e74

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
package com.xiaopeng.account.service;
 
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiaopeng.account.model.dto.ReceiveCouponDto;
import com.xiaopeng.account.model.dto.SendCouponDto;
import com.xiaopeng.account.model.query.XpUserCouponListQuery;
import com.xiaopeng.account.model.vo.XpAppUserCouponTotalVo;
import com.xiaopeng.account.model.vo.XpAppUserCouponVo;
import com.xiaopeng.api.model.account.XpAppUserCoupon;
import com.xiaopeng.common.core.domain.R;
 
import java.util.List;
import java.util.concurrent.CompletableFuture;
 
/**
 * <p>
 * 用户优惠券 服务类
 * </p>
 *
 * @author mitao
 * @since 2026-02-03
 */
public interface IXpAppUserCouponService extends IService<XpAppUserCoupon> {
 
    /**
     * 获取用户优惠券列表
     * @param query
     * @param uid
     * @return
     */
    XpAppUserCouponVo userCouponList(XpUserCouponListQuery query, String uid);
 
    /**+
     * 获取用户优惠券数量total
     * @param uid
     * @return
     */
    XpAppUserCouponTotalVo userCouponTotal(String uid);
 
    /**
     * 领取优惠券
     * @param dto
     * @param uid
     * @return
     */
    boolean receive(ReceiveCouponDto dto, String uid);
 
    /**
     *  根据时间规则筛选出优惠券
     * @param couponList
     * @return
     */
    List<XpAppUserCoupon> timeRule(List<XpAppUserCoupon> couponList);
 
 
    /**
     * 发送优惠券
     *
     * @param dto
     * @return
     */
    CompletableFuture<R<String>> send(SendCouponDto dto);
 
}