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.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

import java.math.BigDecimal;
import java.util.List;

/**
 * 充电卡内部服务（刷卡启动鉴权、充电锁定、订单结算扣款）
 * <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);

    /**
     * 锁定卡片账户余额（刷卡充电申请，实扣冻结：余额立即扣减并计入锁定金额）。
     *
     * @return data 为锁定后可用余额；余额不足时 R 的 code != 200
     */
    @PostMapping("/t-charging-card/inner/lock-balance")
    R<BigDecimal> lockBalance(@RequestParam("cardId") Long cardId,
                              @RequestParam("amount") BigDecimal amount);

    /**
     * 结算卡片账户余额（解锁锁定额并按实际消费扣减，允许扣成负数；订单号幂等，与旧扣款接口共用唯一键）。
     *
     * @return data.duplicated=true 表示该订单此前已结算成功，本次未重复结算
     */
    @PostMapping("/t-charging-card/inner/settle-charging")
    R<ChargingCardDeductVO> settleForCharging(@RequestBody ChargingCardDeductDTO dto);

    /**
     * 释放卡片锁定金额（未产生消费/订单回滚时使用）。
     *
     * @return data 为释放后可用余额
     */
    @PostMapping("/t-charging-card/inner/unlock-balance")
    R<BigDecimal> unlockBalance(@RequestParam("cardId") Long cardId,
                                @RequestParam("amount") BigDecimal amount);

    /**
     * 批量查询已成功写入充电扣款流水的订单号。
     */
    @PostMapping("/t-charging-card/inner/deducted-order-codes")
    R<List<String>> listDeductedOrderCodes(@RequestBody List<String> orderCodes);

    /**
     * 按公司查询未删除的卡片列表（公司详情-充电用户信息聚合使用）。
     */
    @GetMapping("/t-charging-card/inner/list-by-company")
    R<List<TChargingCard>> listByCompany(@RequestParam("companyId") Integer companyId);
}