package com.doumee.service.business;

import com.doumee.core.douyin.dto.DouyinBaseResp;
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);

    /**
     * 撤销核销(核销后 1 小时内),更新记录撤销状态
     * @param operator 操作人ID(由调用端传入,web 端取登录会员ID)
     */
    DouyinVerifyRecord cancel(DouyinCancelParam param, String operator);

    /**
     * 核销记录分页(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);
}