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.ChargingCardAllocateDTO;
|
import com.ruoyi.account.api.dto.ChargingCardAuthDTO;
|
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.ChargingCardAllocateVO;
|
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);
|
|
/**
|
* 额度分配概览：公司可分配余额（available_balance）与总账户余额（累计充值到账）。
|
* 仅分配模式（account_mode=2）的公司可执行额度分配。
|
*
|
* @param companyId 公司ID
|
* @return 概览信息；公司不存在时抛出业务异常
|
*/
|
ChargingCardAllocateVO getAllocateOverview(Integer companyId);
|
|
/**
|
* 卡片额度分配（公司可用余额 → 卡片余额）。
|
* 校验公司为启用且分配模式、卡片归属该公司且未在充电，禁止透支；
|
* 每张卡片写入余额变更流水，失败时回滚并退还公司已扣金额。
|
*
|
* @param dto 分配参数（公司、卡片明细、备注）
|
* @return 分配后的公司概览（可分配余额为最新值）
|
*/
|
ChargingCardAllocateVO allocateQuota(ChargingCardAllocateDTO 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);
|
}
|
