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);
|
}
|
