package cn.iocoder.yudao.module.finance.service.ledger;

import cn.iocoder.yudao.module.finance.controller.admin.ledger.vo.FinLedgerReqVO;
import cn.iocoder.yudao.module.finance.controller.admin.ledger.vo.FinLedgerRespVO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 总账 / 明细账 Service 接口
 *
 * @author 超级管理员
 */
public interface FinLedgerService {

    /**
     * 获得总账列表
     *
     * 按期间逐月汇总：期初余额 -> 各月「本月合计」 -> 本期累计
     *
     * @param reqVO 查询条件
     * @return 总账行列表
     */
    List<FinLedgerRespVO> getGeneralLedgerList(@Valid FinLedgerReqVO reqVO);

    /**
     * 获得明细账列表
     *
     * 逐条分录展示并结转余额：期初余额 -> 逐条明细（每逢月末插「本月合计」） -> 本期累计
     *
     * @param reqVO 查询条件
     * @return 明细账行列表
     */
    List<FinLedgerRespVO> getDetailLedgerList(@Valid FinLedgerReqVO reqVO);

}