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

import com.red.circle.framework.dto.ResultResponse;
import com.red.circle.other.inner.model.dto.activity.LotteryActivityDTO;
import com.red.circle.other.inner.model.dto.activity.LotteryPrizeDTO;
import com.red.circle.other.inner.model.dto.activity.LotteryRecordDTO;
import java.util.List;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 抽奖活动Client API.
 *
 * @author system
 * @since 2025-10-18
 */
public interface LotteryActivityClientApi {

  String API_PREFIX = "/lottery-activity/client";

  /**
   * 根据活动编码获取活动信息.
   */
  @GetMapping("/getByCode")
  ResultResponse<LotteryActivityDTO> getByActivityCode(@RequestParam("activityCode") String activityCode);

  /**
   * 根据活动ID获取活动信息.
   */
  @GetMapping("/getById")
  ResultResponse<LotteryActivityDTO> getById(@RequestParam("id") Long id);

  /**
   * 获取活动列表.
   */
  @GetMapping("/list")
  ResultResponse<List<LotteryActivityDTO>> listActivities();

}
