package com.doumee.service.business;
|
|
import com.doumee.core.douyin.dto.DouyinBaseResp;
|
import com.doumee.core.douyin.dto.DouyinBoundProduct;
|
import com.doumee.core.douyin.dto.DouyinCancelParam;
|
import com.doumee.core.douyin.dto.DouyinPrepareParam;
|
import com.doumee.core.douyin.dto.DouyinPrepareResp;
|
import com.doumee.core.douyin.dto.DouyinVerifyParam;
|
import com.doumee.core.model.PageData;
|
import com.doumee.core.model.PageWrap;
|
import com.doumee.dao.business.model.DouyinVerifyRecord;
|
import com.doumee.dao.business.vo.DouyinVerifyRecordPageVO;
|
|
/**
|
* 抖音券核销 Service 定义
|
*
|
* @author rk
|
* @date 2026/06/22
|
*/
|
public interface DouyinVerifyService {
|
|
/**
|
* 验券准备:扫码/输码 → 返回券列表 + verifyToken
|
*/
|
DouyinBaseResp<DouyinPrepareResp> prepare(DouyinPrepareParam param);
|
|
/**
|
* 验券(核销),并落核销记录
|
* @param operator 操作人ID(由调用端传入,web 端取登录会员ID)
|
*/
|
DouyinVerifyRecord verify(DouyinVerifyParam param, String operator);
|
|
/**
|
* 验券(核销),使用调用方已校验好的套餐绑定结果(scanVerify 核销前校验后调用)。
|
* <p>核销成功后直接用 boundProduct 开通套餐,不再重复查询商品/套餐。
|
* @param param 核销入参
|
* @param operator 操作人ID
|
* @param boundProduct 核销前已校验的抖音商品 + 本地套餐(scanVerify 传入)
|
*/
|
DouyinVerifyRecord verify(DouyinVerifyParam param, String operator, DouyinBoundProduct boundProduct);
|
|
/**
|
* 核销前校验:按 skuId 校验抖音商品在库且已绑定有效本地套餐。
|
* <p>scanVerify 在核销前调用,失败抛业务异常(券尚未核销,避免抖音已核销但本地未开卡的不一致)。
|
* @param skuId 核销券对应的抖音 SKU ID
|
* @return 抖音商品 + 绑定的本地套餐(供 verify 开卡复用)
|
*/
|
DouyinBoundProduct resolveBoundProduct(String skuId);
|
|
/**
|
* 撤销核销(核销后 1 小时内),更新记录撤销状态
|
* @param operator 操作人ID(由调用端传入,web 端取登录会员ID)
|
*/
|
DouyinVerifyRecord cancel(DouyinCancelParam param, String operator);
|
|
/**
|
* 按 discountMemberId 把套餐卡详情填到 record.packageInfo(scanVerify 展示用)。
|
* <p>无套餐卡ID或查不到时,packageInfo 置 null,不影响主流程。
|
*
|
* @param record 核销记录(含 discountMemberId)
|
*/
|
void fillPackageInfo(DouyinVerifyRecord record);
|
|
/**
|
* 核销记录分页(web 端小程序自用,简单分页)
|
*/
|
PageData<DouyinVerifyRecord> findPage(PageWrap<DouyinVerifyRecord> pageWrap);
|
|
/**
|
* 核销记录分页(管理端对外):LEFT JOIN discount_member/member/douyin_product,
|
* 带出订单编号、会员openid/手机号(脱敏)、团购商品名、抖音券名、类目、兑换人、状态文案。
|
* 查询条件:抖音券码、验券状态、撤销状态。
|
*/
|
PageData<DouyinVerifyRecordPageVO> findManagePage(PageWrap<DouyinVerifyRecordPageVO> pageWrap);
|
|
/**
|
* 核销记录详情
|
*/
|
DouyinVerifyRecord findById(String id);
|
}
|
