package com.ruoyi.account.api.feignClient;

import com.ruoyi.account.api.dto.ChargingCardAuthDTO;
import com.ruoyi.account.api.dto.ChargingCardDeductDTO;
import com.ruoyi.account.api.factory.ChargingCardFallbackFactory;
import com.ruoyi.account.api.model.TChargingCard;
import com.ruoyi.account.api.vo.ChargingCardDeductVO;
import com.ruoyi.common.core.constant.ServiceNameConstants;
import com.ruoyi.common.core.domain.R;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 充电卡内部服务（刷卡启动鉴权、充电锁定、订单结算扣款）
 * <p>仅限订单服务等内部链路调用，禁止走管理后台权限体系。</p>
 */
@FeignClient(contextId = "ChargingCardClient", value = ServiceNameConstants.ACCOUNT_SERVICE,
        fallbackFactory = ChargingCardFallbackFactory.class)
public interface ChargingCardClient {

    /**
     * 刷卡启动鉴权（V0.2 定稿：卡片配置了密码才校验密码，未配置不校验）
     *
     * @param dto 卡号 + 设备上报密码
     * @return 鉴权失败时 R 的 code != 200 且 msg 为失败原因；成功时 data 为卡片信息（不含密码密文）
     */
    @PostMapping("/t-charging-card/inner/verify-charging")
    R<TChargingCard> verifyCharging(@RequestBody ChargingCardAuthDTO dto);

    /**
     * 锁定卡片为充电中（订单创建成功后调用）。
     *
     * @return data=false 表示卡片已被其他进行中订单占用（锁定前置条件未命中），调用方应放弃建单
     */
    @PostMapping("/t-charging-card/inner/lock-charging")
    R<Boolean> lockForCharging(@RequestParam("cardId") Long cardId,
                               @RequestParam("orderCode") String orderCode);

    /**
     * 解锁卡片（订单到达终态后调用）。带订单号比对，防止误释放其他订单。
     */
    @PostMapping("/t-charging-card/inner/unlock-charging")
    R<Boolean> unlockForCharging(@RequestParam("cardId") Long cardId,
                                 @RequestParam("orderCode") String orderCode);

    /**
     * 刷卡订单最终结算扣款（幂等，允许扣成负余额）。
     *
     * @return data.duplicated=true 表示该订单此前已扣款成功，本次未重复扣款
     */
    @PostMapping("/t-charging-card/inner/deduct-charging")
    R<ChargingCardDeductVO> deductForCharging(@RequestBody ChargingCardDeductDTO dto);
}