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.VinManagementAllocateDTO;
|
import com.ruoyi.account.api.dto.VinManagementExcelDTO;
|
import com.ruoyi.account.api.dto.VinManagementQueryDTO;
|
import com.ruoyi.account.api.dto.VinManagementSaveDTO;
|
import com.ruoyi.account.api.model.TVinManagement;
|
import com.ruoyi.account.api.vo.VinManagementAllocateVO;
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
public interface TVinManagementService extends IService<TVinManagement> {
|
IPage<TVinManagement> selectPageList(VinManagementQueryDTO query);
|
boolean saveVin(VinManagementSaveDTO dto);
|
boolean updateVin(VinManagementSaveDTO dto);
|
boolean deleteVins(List<Long> ids);
|
|
/**
|
* 批量解绑车队：仅清空车队归属（fleet_id 置空），公司、初始分配额度、状态等不受影响
|
*
|
* @return 实际解绑的VIN数量（未绑定车队的记录不计入）
|
*/
|
int unbindFleet(List<Long> ids);
|
|
boolean updateStatus(Long id, Integer status);
|
List<VinManagementExcelDTO> selectExportList(VinManagementQueryDTO query);
|
String importVins(List<VinManagementExcelDTO> items);
|
List<TVinManagement> selectAppletVehicleList(Long appUserId);
|
boolean bindAppletVehicle(Long appUserId, String keyword);
|
boolean unbindAppletVehicle(Long id, Long appUserId);
|
List<Long> getVinIdsByAppUserId(Long appUserId);
|
|
/**
|
* 根据VIN码查询未删除的VIN记录（含禁用状态，由调用方判断）
|
*/
|
TVinManagement getByVin(String vin);
|
|
/**
|
* 按公司查询未删除的VIN码列表（公司详情-充电用户信息聚合使用）
|
*/
|
List<TVinManagement> listByCompany(Integer companyId);
|
|
/**
|
* 额度分配概览：公司可分配余额与总账户余额
|
*/
|
VinManagementAllocateVO getAllocateOverview(Integer companyId);
|
|
/**
|
* VIN码额度分配：公司可用余额划入VIN初始分配额度（累加后返回最新概览）
|
*/
|
VinManagementAllocateVO allocateQuota(VinManagementAllocateDTO dto);
|
|
/**
|
* 锁定VIN账户余额（VIN码充电申请，分配模式实扣冻结：余额立即扣减并计入锁定金额）
|
*
|
* @param vinId VIN记录ID
|
* @param amount 锁定金额（大于0）
|
* @return 锁定后剩余可用余额
|
*/
|
BigDecimal lockBalance(Long vinId, BigDecimal amount);
|
|
/**
|
* 结算VIN账户余额（解锁锁定额并按实际消费扣减，允许扣成负数）
|
*
|
* @param vinId VIN记录ID
|
* @param lockedAmount 申请时锁定额（用于释放）
|
* @param actualAmount 实际消费金额
|
* @return 结算后可用余额
|
*/
|
BigDecimal settleBalance(Long vinId, BigDecimal lockedAmount, BigDecimal actualAmount);
|
|
/**
|
* 释放VIN锁定金额（未产生消费时使用）
|
*
|
* @param vinId VIN记录ID
|
* @param amount 释放金额（大于0）
|
* @return 释放后可用余额
|
*/
|
BigDecimal unlockBalance(Long vinId, BigDecimal amount);
|
}
|
