package com.red.circle.other.inner.endpoint.activity.api;

import com.red.circle.framework.dto.PageResult;
import com.red.circle.framework.dto.ResultResponse;
import com.red.circle.other.inner.model.cmd.activity.LotteryRecordQryCmd;
import com.red.circle.other.inner.model.dto.activity.LotteryRecordDTO;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 中奖记录管理Client API.
 *
 * @author system
 * @since 2025-10-18
 */
public interface LotteryRecordManageClientApi {

  String API_PREFIX = "/lottery-record-manage/client";

  /**
   * 分页查询中奖记录.
   */
  @PostMapping("/listRecords")
  ResultResponse<PageResult<LotteryRecordDTO>> listRecords(@RequestBody LotteryRecordQryCmd cmd);

  /**
   * 发放奖品.
   */
  @PostMapping("/deliverPrize")
  ResultResponse<Void> deliverPrize(@RequestParam("recordId") Long recordId);

}
