| | |
| | | |
| | | 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.AppUserWhitelistExcelDTO; |
| | | import com.ruoyi.account.api.dto.AppUserWhitelistQueryDTO; |
| | | import com.ruoyi.account.api.dto.AppUserWhitelistSaveDTO; |
| | | import com.ruoyi.account.api.dto.AppUserWhitelistStatusDTO; |
| | | 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; |
| | | |
| | | /** |
| | | * 白名单用户服务 |
| | |
| | | |
| | | void deleteByIds(String ids); |
| | | |
| | | /** |
| | | * 批量解绑车队:仅清空车队归属(fleet_id 置空),公司、余额、状态等不受影响; |
| | | * 未绑定车队的选中记录忽略不计,返回实际解绑数量 |
| | | */ |
| | | int unbindFleet(List<Long> ids); |
| | | |
| | | /** |
| | | * 导出白名单用户列表:与列表查询同一筛选口径(含合作商数据范围),并回填公司与车队名称、账户信息 |
| | | */ |
| | | List<AppUserWhitelistExcelDTO> selectExportList(AppUserWhitelistQueryDTO queryDTO); |
| | | |
| | | /** |
| | | * 启用/停用白名单用户:仅允许 1=启用、2=停用,合作商账号仅能操作自身可见的数据 |
| | | */ |
| | | boolean updateStatus(AppUserWhitelistStatusDTO statusDTO); |
| | | |
| | | AppUserWhitelistImportResultVO importWhitelist(MultipartFile file) throws Exception; |
| | | |
| | | AppUserWhitelistMatchVO matchWhitelist(Long appUserId, Integer siteId); |
| | | |
| | | /** |
| | | * 解析白名单账户可用余额(小程序充电页余额显示):按所属公司账户模式, |
| | | * 共享模式=公司可用余额,分配模式=白名单用户余额,账户模式未知按共享处理; |
| | | * 公司信息查询失败时降级返回 null(由调用方保持原余额显示) |
| | | */ |
| | | BigDecimal resolveWhitelistAccountBalance(AppUserWhitelistMatchVO match); |
| | | |
| | | /** |
| | | * 按公司查询未删除的白名单用户列表(公司详情-充电用户信息聚合使用) |
| | | */ |
| | | 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); |
| | | } |