package com.jeesharp.business.modules.coupon.api;

import com.jeesharp.business.modules.coupon.dto.MemberCouponStoreStatsQueryDTO;
import com.jeesharp.business.modules.coupon.vo.MemberCouponChannelCountVO;
import com.jeesharp.business.modules.coupon.vo.MemberCouponDailyCountVO;

import java.util.List;

/**
 * 会员券统计 API，供会员营销等模块跨域查询领券数据。
 *
 * @author jeesharp
 * @since 2026-06-25
 */
public interface MemberCouponStatsApi {

    /**
     * 统计店铺线下券领券总数。
     */
    Long countStoreOfflineReceive(MemberCouponStoreStatsQueryDTO query);

    /**
     * 按日统计店铺线下券领券数。
     */
    List<MemberCouponDailyCountVO> dailyStoreOfflineReceive(MemberCouponStoreStatsQueryDTO query);

    /**
     * 按入会渠道统计店铺线下券领券数。
     */
    List<MemberCouponChannelCountVO> channelStoreOfflineReceive(MemberCouponStoreStatsQueryDTO query);
}
