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.CompanyAllocateRecordQueryDTO;
import com.ruoyi.account.api.model.TCompanyAllocateRecord;
import com.ruoyi.account.api.vo.CompanyAllocateSummaryVO;

import java.math.BigDecimal;

public interface TCompanyAllocateRecordService extends IService<TCompanyAllocateRecord> {

    /**
     * 按公司分页查询分配记录（操作时间倒序）
     */
    IPage<TCompanyAllocateRecord> selectRecordPage(CompanyAllocateRecordQueryDTO query);

    /**
     * 写入一条公司额度分配流水（分配为正数、回收为负数），操作人取当前登录账号。
     * 公司为空或金额为 0 时不写流水，返回 false。
     *
     * @param userType      分配对象类型：1=VIN码，2=刷卡，3=白名单手机号
     * @param userInfo      分配对象信息（VIN码/卡号/手机号）
     * @param userName      分配对象名称（可为空）
     * @param companyId     所属公司ID
     * @param changeSource  变更来源：1=新增用户，2=编辑用户，3=额度分配
     * @param beforeBalance 分配前用户账户余额
     * @param amount        本次变动金额（正数=分配，负数=回收）
     * @param remark        备注
     */
    boolean recordAllocate(int userType, String userInfo, String userName, Integer companyId, int changeSource,
                           BigDecimal beforeBalance, BigDecimal amount, String remark);

    /**
     * 写入一条消费流水（change_type=2，VIN码充电结算调用）。
     * 以「充电订单号+变更类型」幂等：已存在同订单消费流水时直接返回 true，不重复写入。
     *
     * @param companyId         所属公司ID
     * @param userType          分配对象类型：1=VIN码，2=刷卡，3=白名单手机号
     * @param userInfo          分配对象信息（VIN码/卡号/手机号）
     * @param userName          分配对象名称（可为空）
     * @param beforeBalance     消费前用户账户余额
     * @param amount            本次变动金额（消费传负数）
     * @param chargingOrderCode 充电订单号（幂等键之一）
     * @param remark            备注
     * @return 是否写入成功（已存在视为成功）
     */
    boolean recordConsume(Integer companyId, Integer userType, String userInfo, String userName,
                          BigDecimal beforeBalance, BigDecimal amount, String chargingOrderCode, String remark);

    /**
     * 写入一条消费流水（结算场景，允许金额为 0）。
     * <p>与 {@link #recordConsume} 语义一致，仅放开「金额为0不写流水」限制：
     * 0 消费订单同样需要落一条流水，作为「该订单已结算」的幂等标记，
     * 保证结算失败回退后的补偿重试不会重复结算（同事务写入）。</p>
     *
     * @return 是否写入成功（已存在视为成功）
     */
    boolean recordSettleConsume(Integer companyId, Integer userType, String userInfo, String userName,
                                BigDecimal beforeBalance, BigDecimal amount, String chargingOrderCode, String remark);

    /**
     * 判断指定充电订单是否已在账户侧落消费流水（结算幂等判定使用）
     */
    boolean existsConsumeRecord(String chargingOrderCode);

    /**
     * 批量查询已落消费流水的订单号集合（订单侧兜底扫描判定使用）
     *
     * @param orderCodes 待判定的充电订单号
     * @return 已存在消费流水的订单号集合，无匹配返回空集合
     */
    java.util.List<String> listConsumedOrderCodes(java.util.List<String> orderCodes);

    /**
     * 统计公司名下三类主体（VIN码/刷卡/白名单手机号）可用余额与充电锁定金额合计（只读，
     * 账户模式从分配切换为共享前的校验与预加回使用）。
     *
     * @param companyId 所属公司ID
     */
    CompanyAllocateSummaryVO sumAllocatedBalance(Integer companyId);

    /**
     * 回收公司名下三类主体全部分配余额至公司账户（账户模式：分配→共享）。
     * <p>内部按固定顺序抢占 VIN/卡/白名单三把公司级并发锁，与额度分配操作串行；
     * 余额清零与流水写入同事务，幂等（重复调用时无余额可回收，返回 0，不重复写流水）。</p>
     *
     * @param companyId            所属公司ID
     * @param operatorName         操作人账号
     * @param companyName          公司名称（企业账户流水 userInfo，可为空）
     * @param companyBalanceBefore 回退前公司可用余额（企业账户正数流水 beforeBalance）
     * @return 本次实际回收总额（元，无余额时返回 0）
     */
    BigDecimal recycleAllocatedBalance(Integer companyId, String operatorName, String companyName,
                                       BigDecimal companyBalanceBefore);
}