package com.ruoyi.account.api.feignClient;
|
|
import com.ruoyi.account.api.factory.AppUserWhitelistFallbackFactory;
|
import com.ruoyi.account.api.model.TAppUserWhitelist;
|
import com.ruoyi.account.api.vo.AppUserWhitelistMatchVO;
|
import com.ruoyi.common.core.constant.ServiceNameConstants;
|
import com.ruoyi.common.core.domain.R;
|
import org.springframework.cloud.openfeign.FeignClient;
|
import org.springframework.web.bind.annotation.GetMapping;
|
import org.springframework.web.bind.annotation.PostMapping;
|
import org.springframework.web.bind.annotation.RequestParam;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* 白名单用户远程服务
|
*/
|
@FeignClient(contextId = "AppUserWhitelistClient", value = ServiceNameConstants.ACCOUNT_SERVICE, fallbackFactory = AppUserWhitelistFallbackFactory.class)
|
public interface AppUserWhitelistClient {
|
|
/**
|
* 根据用户和站点判断是否命中白名单规则
|
*
|
* @param appUserId APP用户ID
|
* @param siteId 站点ID
|
* @return 白名单命中结果
|
*/
|
@GetMapping("/t-app-user-whitelist/match")
|
R<AppUserWhitelistMatchVO> matchWhitelist(@RequestParam("appUserId") Long appUserId, @RequestParam("siteId") Integer siteId);
|
|
/**
|
* 按公司查询未删除的白名单用户列表（公司详情-充电用户信息聚合使用）
|
*
|
* @param companyId 公司ID
|
* @return 白名单用户列表
|
*/
|
@GetMapping("/t-app-user-whitelist/inner/list-by-company")
|
R<List<TAppUserWhitelist>> listByCompany(@RequestParam("companyId") Integer companyId);
|
|
/**
|
* 锁定白名单账户余额（企业账户流程-分配模式，实扣冻结：余额立即扣减并计入锁定金额）。
|
*
|
* @return data 为锁定后可用余额；余额不足时 R 的 code != 200
|
*/
|
@PostMapping("/t-app-user-whitelist/inner/lock-balance")
|
R<BigDecimal> lockBalance(@RequestParam("whitelistId") Long whitelistId,
|
@RequestParam("amount") BigDecimal amount);
|
|
/**
|
* 结算白名单账户余额（解锁锁定额并按实际消费扣减，允许扣成负数）。
|
*
|
* @return data 为结算后可用余额
|
*/
|
@PostMapping("/t-app-user-whitelist/inner/settle-balance")
|
R<BigDecimal> settleBalance(@RequestParam("whitelistId") Long whitelistId,
|
@RequestParam("lockedAmount") BigDecimal lockedAmount,
|
@RequestParam("actualAmount") BigDecimal actualAmount);
|
|
/**
|
* 释放白名单账户锁定金额（未产生消费/订单回滚时使用）。
|
*
|
* @return data 为释放后可用余额
|
*/
|
@PostMapping("/t-app-user-whitelist/inner/unlock-balance")
|
R<BigDecimal> unlockBalance(@RequestParam("whitelistId") Long whitelistId,
|
@RequestParam("amount") BigDecimal amount);
|
}
|
