|
|
|
|
@ -3,51 +3,52 @@ package cn.iocoder.yudao.module.promotion.api.combination;
|
|
|
|
|
import cn.iocoder.yudao.module.promotion.api.combination.dto.CombinationRecordCreateReqDTO;
|
|
|
|
|
import cn.iocoder.yudao.module.promotion.api.combination.dto.CombinationRecordCreateRespDTO;
|
|
|
|
|
import cn.iocoder.yudao.module.promotion.api.combination.dto.CombinationValidateJoinRespDTO;
|
|
|
|
|
import cn.iocoder.yudao.module.promotion.enums.ApiConstants;
|
|
|
|
|
import io.swagger.v3.oas.annotations.Operation;
|
|
|
|
|
import io.swagger.v3.oas.annotations.Parameter;
|
|
|
|
|
import io.swagger.v3.oas.annotations.Parameters;
|
|
|
|
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
|
|
|
|
import org.springframework.cloud.openfeign.FeignClient;
|
|
|
|
|
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;
|
|
|
|
|
|
|
|
|
|
import javax.validation.Valid;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 拼团记录 API 接口
|
|
|
|
|
*
|
|
|
|
|
* @author HUIHUI
|
|
|
|
|
*/
|
|
|
|
|
@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
|
|
|
|
|
@Tag(name = "RPC 服务 - 拼团记录")
|
|
|
|
|
public interface CombinationRecordApi {
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 校验是否满足拼团条件
|
|
|
|
|
*
|
|
|
|
|
* @param userId 用户编号
|
|
|
|
|
* @param activityId 活动编号
|
|
|
|
|
* @param headId 团长编号
|
|
|
|
|
* @param skuId sku 编号
|
|
|
|
|
* @param count 数量
|
|
|
|
|
*/
|
|
|
|
|
void validateCombinationRecord(Long userId, Long activityId, Long headId, Long skuId, Integer count);
|
|
|
|
|
String PREFIX = ApiConstants.PREFIX + "/combination-record";
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 创建开团记录
|
|
|
|
|
*
|
|
|
|
|
* @param reqDTO 请求 DTO
|
|
|
|
|
* @return 拼团信息
|
|
|
|
|
*/
|
|
|
|
|
CombinationRecordCreateRespDTO createCombinationRecord(@Valid CombinationRecordCreateReqDTO reqDTO);
|
|
|
|
|
@GetMapping(PREFIX + "/validate")
|
|
|
|
|
@Operation(summary = "校验是否满足拼团条件")
|
|
|
|
|
@Parameters({
|
|
|
|
|
@Parameter(name = "userId", description = "用户编号", required = true, example = "1024"),
|
|
|
|
|
@Parameter(name = "activityId", description = "活动编号", required = true, example = "2048"),
|
|
|
|
|
@Parameter(name = "headId", description = "团长编号", required = true, example = "4096"),
|
|
|
|
|
@Parameter(name = "skuId", description = "SKU 编号", required = true, example = "8192"),
|
|
|
|
|
@Parameter(name = "count", description = "数量", required = true, example = "1"),
|
|
|
|
|
})
|
|
|
|
|
void validateCombinationRecord(@RequestParam("userId") Long userId,
|
|
|
|
|
@RequestParam("activityId") Long activityId,
|
|
|
|
|
@RequestParam("headId") Long headId,
|
|
|
|
|
@RequestParam("skuId") Long skuId,
|
|
|
|
|
@RequestParam("count") Integer count);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 查询拼团记录是否成功
|
|
|
|
|
*
|
|
|
|
|
* @param userId 用户编号
|
|
|
|
|
* @param orderId 订单编号
|
|
|
|
|
* @return 拼团是否成功
|
|
|
|
|
*/
|
|
|
|
|
boolean isCombinationRecordSuccess(Long userId, Long orderId);
|
|
|
|
|
@PostMapping("/create")
|
|
|
|
|
@Operation(summary = "创建开团记录")
|
|
|
|
|
CombinationRecordCreateRespDTO createCombinationRecord(@RequestBody @Valid CombinationRecordCreateReqDTO reqDTO);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 更新拼团状态为【失败】
|
|
|
|
|
*
|
|
|
|
|
* @param userId 用户编号
|
|
|
|
|
* @param orderId 订单编号
|
|
|
|
|
*/
|
|
|
|
|
void updateRecordStatusToFailed(Long userId, Long orderId);
|
|
|
|
|
@GetMapping("/is-success")
|
|
|
|
|
@Operation(summary = "查询拼团记录是否成功")
|
|
|
|
|
@Parameters({
|
|
|
|
|
@Parameter(name = "userId", description = "用户编号", required = true, example = "1024"),
|
|
|
|
|
@Parameter(name = "orderId", description = "订单编号", required = true, example = "2048"),
|
|
|
|
|
})
|
|
|
|
|
boolean isCombinationRecordSuccess(@RequestParam("userId") Long userId,
|
|
|
|
|
@RequestParam("orderId") Long orderId);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 【下单前】校验是否满足拼团活动条件
|
|
|
|
|
@ -61,7 +62,19 @@ public interface CombinationRecordApi {
|
|
|
|
|
* @param count 数量
|
|
|
|
|
* @return 拼团信息
|
|
|
|
|
*/
|
|
|
|
|
CombinationValidateJoinRespDTO validateJoinCombination(Long userId, Long activityId, Long headId,
|
|
|
|
|
Long skuId, Integer count);
|
|
|
|
|
@GetMapping("/validate-join")
|
|
|
|
|
@Operation(summary = "【下单前】校验是否满足拼团活动条件") // 如果校验失败，则抛出业务异常
|
|
|
|
|
@Parameters({
|
|
|
|
|
@Parameter(name = "userId", description = "用户编号", required = true, example = "1024"),
|
|
|
|
|
@Parameter(name = "activityId", description = "活动编号", required = true, example = "2048"),
|
|
|
|
|
@Parameter(name = "headId", description = "团长编号", required = true, example = "4096"),
|
|
|
|
|
@Parameter(name = "skuId", description = "SKU 编号", required = true, example = "8192"),
|
|
|
|
|
@Parameter(name = "count", description = "数量", required = true, example = "1"),
|
|
|
|
|
})
|
|
|
|
|
CombinationValidateJoinRespDTO validateJoinCombination(@RequestParam("userId") Long userId,
|
|
|
|
|
@RequestParam("activityId") Long activityId,
|
|
|
|
|
@RequestParam("headId") Long headId,
|
|
|
|
|
@RequestParam("skuId") Long skuId,
|
|
|
|
|
@RequestParam("count") Integer count);
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
YunaiV
2 years ago