package com.ruoyi.account.service;
|
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
import com.baomidou.mybatisplus.extension.service.IService;
|
import com.ruoyi.account.api.dto.AppUserWhitelistAllocateDTO;
|
import com.ruoyi.account.api.dto.AppUserWhitelistQueryDTO;
|
import com.ruoyi.account.api.dto.AppUserWhitelistSaveDTO;
|
import com.ruoyi.account.api.model.TAppUserWhitelist;
|
import com.ruoyi.account.api.vo.AppUserWhitelistAllocateVO;
|
import com.ruoyi.account.api.vo.AppUserWhitelistMatchVO;
|
import com.ruoyi.account.api.vo.AppUserWhitelistImportResultVO;
|
import org.springframework.web.multipart.MultipartFile;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* 白名单用户服务
|
*/
|
public interface TAppUserWhitelistService extends IService<TAppUserWhitelist> {
|
|
Page<TAppUserWhitelist> pageList(AppUserWhitelistQueryDTO queryDTO);
|
|
TAppUserWhitelist detail(Long id);
|
|
void saveWhitelist(AppUserWhitelistSaveDTO saveDTO);
|
|
void deleteByIds(String ids);
|
|
/**
|
* 批量解绑车队：仅清空车队归属（fleet_id 置空），公司、余额、状态等不受影响；
|
* 未绑定车队的选中记录忽略不计，返回实际解绑数量
|
*/
|
int unbindFleet(List<Long> ids);
|
|
AppUserWhitelistImportResultVO importWhitelist(MultipartFile file) throws Exception;
|
|
AppUserWhitelistMatchVO matchWhitelist(Long appUserId, Integer siteId);
|
|
/**
|
* 按公司查询未删除的白名单用户列表（公司详情-充电用户信息聚合使用）
|
*/
|
List<TAppUserWhitelist> listByCompany(Integer companyId);
|
|
/**
|
* 额度分配概览：公司总账户余额（累计充值到账）与可分配余额
|
*/
|
AppUserWhitelistAllocateVO getAllocateOverview(Integer companyId);
|
|
/**
|
* 白名单额度分配：公司可用余额累加到白名单用户余额（划拨），并写入公司额度分配流水
|
*/
|
AppUserWhitelistAllocateVO allocateQuota(AppUserWhitelistAllocateDTO allocateDTO);
|
|
/**
|
* 锁定白名单账户余额（企业账户流程-分配模式，实扣冻结：余额立即扣减并计入锁定金额）
|
*
|
* @return 锁定后可用余额；余额不足时抛 ServiceException
|
*/
|
BigDecimal lockBalance(Long whitelistId, BigDecimal amount);
|
|
/**
|
* 结算白名单账户余额（解锁锁定额并按实际消费扣减，允许扣成负数）
|
*
|
* @return 结算后可用余额
|
*/
|
BigDecimal settleBalance(Long whitelistId, BigDecimal lockedAmount, BigDecimal actualAmount);
|
|
/**
|
* 释放白名单账户锁定金额（未产生消费/订单回滚时使用）
|
*
|
* @return 释放后可用余额
|
*/
|
BigDecimal unlockBalance(Long whitelistId, BigDecimal amount);
|
}
|
