kong
2026-04-12 37c866f665fc1d2255f0442f92516c686c6c9edf
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
65
66
67
68
69
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.dto.account.NavigationCouponPickerRequest;
import com.xiaopeng.api.model.account.XpAppUserCoupon;
import com.xiaopeng.api.vo.account.NavigationCouponPickerVo;
import com.xiaopeng.common.core.domain.R;
 
import java.util.List;
 
/**
 * <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);
 
    /**
     * 导航下单页:选券弹窗列表、气泡文案、最佳优惠标记
     */
    NavigationCouponPickerVo navigationCouponPicker(Long userId, NavigationCouponPickerRequest request);
 
    /**
     * 发送优惠券
     *
     * @param dto
     * @return
     */
   R<String> send(SendCouponDto dto);
 
}