ebike-share/ebike-feign/src/main/java/com/ebike/feign/clients/OrdersFeignClient.java

package com.ebike.feign.clients;

import com.cdzy.common.model.EbikeUserFaultreportDto;
import com.cdzy.common.model.EbikeUserFaultreportQueryDto;
import com.cdzy.common.model.JsonResult;
import com.ebike.feign.model.res.ResFeignOrderPaymentDto;
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 java.util.List;

/**
 * 用车(订单） 外部调用。
 *
 * @author dingchao
 * @date 2025/4/17
 * @modified by:
 */
@FeignClient(name = "ebike-orders")
public interface OrdersFeignClient {

    /**
     * 批量更新用户上报故障信息。
     *
     * @param ebikeUserFaultreports 用户上报故障信息列表
     * @return {@code true} 批量更新成功，{@code false} 批量更新失败
     */
    @PostMapping("ebikeUserFaultreport/updateBatch")
    JsonResult<?> updateUserFaultreports(@RequestBody List<EbikeUserFaultreportDto> ebikeUserFaultreports);
    /**
     * 查询某台车所有用户上报故障信息。
     *
     * @param queryParam 查询参数
     * @return 列表, 含附件列表
     */
    @PostMapping("ebikeUserFaultreport/list")
    JsonResult<?> getUserReportList(@RequestBody EbikeUserFaultreportQueryDto queryParam);

    /**
     * 订单支付完成
     * @param paymentParam 支付信息
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @PostMapping("userOrders/payment")
    JsonResult<?> payment(@RequestBody ResFeignOrderPaymentDto paymentParam);

    /**
     * 根据ID获取订单支付详情
     * @param orderId 支付id
     * @return 订单支付详情
     */
    @GetMapping("userOrders/paymentDetailsInfo")
    JsonResult<?> getPaymentDetails(@RequestParam("orderId")Long orderId);

    /**
     * 订单发起退款
     * @param orderId 订单ID
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @GetMapping("userOrders/refund")
    JsonResult<?> refund(@RequestParam("orderId")Long orderId);

    /**
     * 订单发起退款申请
     * @param orderId 订单ID
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @GetMapping("userOrders/refundApply")
    JsonResult<?> refundApply(@RequestParam("orderId")Long orderId);

    /**
     * 订单退款完成
     * @param orderId 订单ID
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @GetMapping("userOrders/doneRefund")
    JsonResult<?> doneRefund(@RequestParam("orderId")Long orderId);

    /**
     * 订单退款驳回
     * @param orderId 订单ID
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @GetMapping("userOrders/rejectRefund")
    JsonResult<?> rejectRefund(@RequestParam("orderId")Long orderId);

    /**
     * 订单退款失败
     * @param orderId 订单ID
     * @return @ {@code 200} 成功，{@code 500} 失败
     */
    @GetMapping("userOrders/failRefund")
    JsonResult<?> failRefund(@RequestParam("orderId")Long orderId);
}