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 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);
}