package com.hotwj.platform.operationManagement.hourPackagePurchase.service;

import com.hotwj.platform.operationManagement.hourPackage.domain.bo.HotHourPackageBo;
import com.hotwj.platform.operationManagement.hourPackage.domain.vo.HotHourPackageVo;
import com.hotwj.platform.operationManagement.hourPackagePurchase.controller.vo.HotHourPackageWalletPurchaseReqVO;
import com.hotwj.platform.operationManagement.hourPackagePurchase.controller.vo.HotHourPackageWalletPurchaseRespVO;
import com.hotwj.platform.operationManagement.hourPackagePurchase.domain.vo.HotHourPackagePurchaseVo;
import com.hotwj.platform.operationManagement.hourPackagePurchase.domain.bo.HotHourPackagePurchaseBo;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.mybatis.core.page.PageQuery;

import java.util.Collection;
import java.util.List;

/**
 * 学时套餐购买记录Service接口
 *
 * @author shihongwei
 * @date 2026-04-28
 */
public interface IHotHourPackagePurchaseService {

    /**
     * 查询学时套餐购买记录
     *
     * @param id 主键
     * @return 学时套餐购买记录
     */
    HotHourPackagePurchaseVo queryById(Long id);

    /**
     * 分页查询学时套餐购买记录列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 学时套餐购买记录分页列表
     */
    TableDataInfo<HotHourPackagePurchaseVo> queryPageList(HotHourPackagePurchaseBo bo, PageQuery pageQuery);

    /**
     * 查询当前登录用户可购买的学时套餐列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 可购买学时套餐分页列表
     */
    TableDataInfo<HotHourPackageVo> queryAvailablePageList(HotHourPackageBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的学时套餐购买记录列表
     *
     * @param bo 查询条件
     * @return 学时套餐购买记录列表
     */
    List<HotHourPackagePurchaseVo> queryList(HotHourPackagePurchaseBo bo);

    /**
     * 查询当前登录用户的购买记录
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 当前登录用户购买记录
     */
    TableDataInfo<HotHourPackagePurchaseVo> queryCurrentUserPageList(HotHourPackagePurchaseBo bo, PageQuery pageQuery);

    /**
     * 使用钱包余额购买学时套餐
     *
     * @param reqVO 请求参数
     * @return 购买结果
     */
    HotHourPackageWalletPurchaseRespVO purchaseByWallet(HotHourPackageWalletPurchaseReqVO reqVO);

    /**
     * 新增学时套餐购买记录
     *
     * @param bo 学时套餐购买记录
     * @return 是否新增成功
     */
    Boolean insertByBo(HotHourPackagePurchaseBo bo);

    /**
     * 修改学时套餐购买记录
     *
     * @param bo 学时套餐购买记录
     * @return 是否修改成功
     */
    Boolean updateByBo(HotHourPackagePurchaseBo bo);

    /**
     * 校验并批量删除学时套餐购买记录信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}
