修改订单业务流程和其他功能修改

puzhibing

2026-09-29 a70433b2ee5bb37823ab73422a01251343cb5f58

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
package com.ruoyi.account.api.feignClient;
 
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.account.api.dto.VinManagementQueryDTO;
import com.ruoyi.account.api.factory.VinManagementFallbackFactory;
import com.ruoyi.account.api.model.TVinManagement;
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.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;
 
import java.math.BigDecimal;
import java.util.List;
 
/**
 * VIN 管理内部服务
 */
@FeignClient(contextId = "VinManagementClient", value = ServiceNameConstants.ACCOUNT_SERVICE,
        fallbackFactory = VinManagementFallbackFactory.class)
public interface VinManagementClient {
 
    @GetMapping("/t-vin-management/inner/ids-by-app-user")
    R<List<Long>> getVinIdsByAppUserId(@RequestParam("appUserId") Long appUserId);
 
    /**
     * 根据VIN码查询未删除的VIN记录（订单侧VIN鉴权使用）
     */
    @GetMapping("/t-vin-management/inner/get-by-vin")
    R<TVinManagement> getVinByCode(@RequestParam("vin") String vin);
 
    /**
     * 根据VIN记录ID批量查询（订单侧列表/详情回填VIN码、车牌号、手机号使用）
     */
    @PostMapping("/t-vin-management/inner/list-by-ids")
    R<List<TVinManagement>> getVinByIds(@RequestBody List<Long> ids);
 
    /**
     * 按车队分页查询VIN码车辆（车队管理-查看车队抽屉使用，query.fleetId 必须传入）
     */
    @PostMapping("/t-vin-management/inner/page-by-fleet")
    R<Page<TVinManagement>> getVinPageByFleet(@RequestBody VinManagementQueryDTO query);
 
    /**
     * 按公司查询未删除的VIN码列表（公司详情-充电用户信息聚合使用）
     */
    @GetMapping("/t-vin-management/inner/list-by-company")
    R<List<TVinManagement>> listByCompany(@RequestParam("companyId") Integer companyId);
 
    /**
     * 按车队统计未删除的VIN车辆数（车队管理-列表"VIN码车辆数"使用）
     */
    @GetMapping("/t-vin-management/inner/count-by-fleet")
    R<Long> countByFleet(@RequestParam("fleetId") Integer fleetId);
 
    /**
     * 锁定VIN余额（VIN码充电申请，分配模式，按「余额-锁定金额」条件更新，余额不足返回失败；返回锁定后剩余可用金额）
     */
    @PostMapping("/t-vin-management/inner/lock-balance")
    R<BigDecimal> lockBalance(@RequestParam("vinId") Long vinId, @RequestParam("amount") BigDecimal amount);
 
    /**
     * 结算VIN余额（解锁锁定额并按实际消费扣减，允许扣成负数；返回扣减后余额）
     * <p>订单号非空时按订单号幂等（同事务写消费流水），补偿重试不会重复结算</p>
     */
    @PostMapping("/t-vin-management/inner/settle-balance")
    R<BigDecimal> settleBalance(@RequestParam("vinId") Long vinId,
                                @RequestParam("lockedAmount") BigDecimal lockedAmount,
                                @RequestParam("actualAmount") BigDecimal actualAmount,
                                @RequestParam(value = "orderCode", required = false) String orderCode,
                                @RequestParam(value = "userInfo", required = false) String userInfo,
                                @RequestParam(value = "userName", required = false) String userName,
                                @RequestParam(value = "remark", required = false) String remark);
 
    /**
     * 释放VIN锁定金额（未产生消费时使用，返回释放后余额）
     */
    @PostMapping("/t-vin-management/inner/unlock-balance")
    R<BigDecimal> unlockBalance(@RequestParam("vinId") Long vinId, @RequestParam("amount") BigDecimal amount);
}