package com.ruoyi.account.service;
|
|
import com.baomidou.mybatisplus.core.metadata.IPage;
|
import com.baomidou.mybatisplus.extension.service.IService;
|
import com.ruoyi.account.api.dto.ChargingCardAuthDTO;
|
import com.ruoyi.account.api.dto.ChargingCardBalanceDTO;
|
import com.ruoyi.account.api.dto.ChargingCardDeductDTO;
|
import com.ruoyi.account.api.dto.ChargingCardExcelDTO;
|
import com.ruoyi.account.api.dto.ChargingCardQueryDTO;
|
import com.ruoyi.account.api.dto.ChargingCardSaveDTO;
|
import com.ruoyi.account.api.dto.ChargingCardStatusDTO;
|
import com.ruoyi.account.api.model.TChargingCard;
|
import com.ruoyi.account.api.vo.ChargingCardDeductVO;
|
|
import java.util.List;
|
|
public interface TChargingCardService extends IService<TChargingCard> {
|
|
IPage<TChargingCard> selectCardPage(ChargingCardQueryDTO query);
|
|
boolean saveCard(ChargingCardSaveDTO dto);
|
|
boolean updateCard(ChargingCardSaveDTO dto);
|
|
boolean deleteCards(List<Long> ids);
|
|
boolean updateStatus(ChargingCardStatusDTO dto);
|
|
boolean updateBalance(ChargingCardBalanceDTO dto);
|
|
List<ChargingCardExcelDTO> selectExportList(ChargingCardQueryDTO query);
|
|
String importCards(List<ChargingCardExcelDTO> cards);
|
|
/**
|
* 刷卡启动鉴权（内部接口）。
|
* 条件密码校验（V0.2 定稿）：卡片配置了密码时校验设备上报密码；未配置密码时不校验。
|
*
|
* @param dto 卡号与设备上报密码
|
* @return 鉴权通过返回卡片实体（不包含密码密文）；失败抛出 ServiceException 携带原因
|
*/
|
TChargingCard verifyCardForCharging(ChargingCardAuthDTO dto);
|
|
/**
|
* 锁定卡片为充电中（刷卡订单创建成功后调用）。同卡已有进行中订单时返回 false。
|
*/
|
boolean lockCardForCharging(Long cardId, String orderCode);
|
|
/**
|
* 解锁卡片（订单终态后调用）。带订单号比对，幂等：已解锁或订单号不匹配时返回 false。
|
*/
|
boolean unlockCardForCharging(Long cardId, String orderCode);
|
|
/**
|
* 刷卡订单最终结算扣款（内部接口）。
|
* 幂等（订单号为幂等键）+ 允许扣成负余额（V0.2 定稿）。
|
*
|
* @return 扣款结果；duplicated=true 表示该订单此前已扣款，本次未重复扣款
|
*/
|
ChargingCardDeductVO deductBalanceForCharging(ChargingCardDeductDTO dto);
|
|
/**
|
* 批量查询已经成功写入充电扣款流水的订单号。
|
*/
|
List<String> listDeductedOrderCodes(List<String> orderCodes);
|
}
|
