package cn.iocoder.yudao.module.finance.dal.mysql.ledger;

import cn.iocoder.yudao.module.finance.dal.dataobject.ledger.FinLedgerEntryDO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.Collection;
import java.util.List;

/**
 * 总账 / 明细账 Mapper
 *
 * 只统计已过账（status = posted）的凭证分录；总账、明细账的余额在 Service 层按期间重算，
 * 保证口径与凭证状态一致
 *
 * @author 超级管理员
 */
@Mapper
public interface FinLedgerMapper {

    /**
     * 查询指定科目（可多个）在指定日期区间内的已过账分录
     *
     * @param subjectCodes 科目编码集合
     * @param startDate    开始日期（含）
     * @param endDate      结束日期（含）
     * @param status       凭证状态
     * @return 分录列表（按凭证日期、凭证编号、行号升序）
     */
    List<FinLedgerEntryDO> selectEntryList(@Param("subjectCodes") Collection<String> subjectCodes,
                                           @Param("startDate") LocalDate startDate,
                                           @Param("endDate") LocalDate endDate,
                                           @Param("status") Integer status);

    /**
     * 查询指定科目（可多个）在指定日期之前的已过账分录净额，即期初余额
     *
     * @param subjectCodes 科目编码集合
     * @param date         日期（不含）
     * @param status       凭证状态
     * @return 净额，借方为正、贷方为负
     */
    BigDecimal selectBalanceBeforeDate(@Param("subjectCodes") Collection<String> subjectCodes,
                                       @Param("date") LocalDate date,
                                       @Param("status") Integer status);

}