package com.cf.imes.module.executor.service.veneer;

import com.cf.imes.framework.common.pojo.PageResult;
import com.cf.imes.module.executor.controller.admin.veneer.vo.UnplannedVeneerPlateDataReqVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.UnplannedVeneerPlateDataRespVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageGoodsPageReqVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageGoodsRespVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageOrderPageReqVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageOrderRespVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManagePlateListReqVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManagePlateRespVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageRemoveReqVO;
import com.cf.imes.module.executor.controller.admin.veneer.vo.VeneerManageReselectReqVO;

import java.util.List;

/**
 * 贴皮管理 Service。
 */
public interface VeneerManageService {

    /**
     * 分页查询存在可维护未排单贴皮的订单。
     *
     * @param req 订单查询条件
     * @return 订单分页结果
     */
    PageResult<VeneerManageOrderRespVO> getOrderPage(VeneerManageOrderPageReqVO req);

    /**
     * 分页查询存在可维护未排单贴皮的板材。
     *
     * @param req 板材查询条件
     * @return 板材分页结果
     */
    PageResult<VeneerManageGoodsRespVO> getGoodsPage(VeneerManageGoodsPageReqVO req);

    /**
     * 分页查询存在待排单贴皮的订单。
     *
     * @param req 订单查询条件
     * @return 未排贴皮订单分页结果
     */
    PageResult<VeneerManageOrderRespVO> getUnplannedOrderPage(VeneerManageOrderPageReqVO req);

    /**
     * 分页查询存在待排单贴皮的板材。
     *
     * @param req 板材查询条件
     * @return 未排贴皮板材分页结果
     */
    PageResult<VeneerManageGoodsRespVO> getUnplannedGoodsPage(VeneerManageGoodsPageReqVO req);

    /**
     * 按订单查询可维护的未排单板件贴皮列表。
     *
     * @param req 查询条件，必须包含订单ID列表，可按房间和柜体筛选
     * @return 未排单板件贴皮列表
     */
    List<VeneerManagePlateRespVO> getOrderPlateList(VeneerManagePlateListReqVO req);

    /**
     * 按板材查询可维护的未排单板件贴皮列表。
     *
     * @param req 查询条件，必须包含板材商品编码列表
     * @return 未排单板件贴皮列表
     */
    List<VeneerManagePlateRespVO> getGoodsPlateList(VeneerManagePlateListReqVO req);

    /**
     * 按订单或板材查询未排贴皮、原板件及板件造型数据。
     *
     * @param req 互斥查询范围及可选房间、柜体条件
     * @return 未排贴皮排单基础数据
     */
    UnplannedVeneerPlateDataRespVO getUnplannedPlateData(UnplannedVeneerPlateDataReqVO req);

    /**
     * 批量为未排单板件贴皮重新选择贴皮库数据。
     *
     * @param req 板件贴皮记录ID及新贴皮库ID
     */
    void reselectVeneer(VeneerManageReselectReqVO req);

    /**
     * 批量移除待排单板件贴皮，并在原板件无剩余有效贴皮时恢复其分解状态。
     *
     * @param req 待移除的板件贴皮记录ID列表
     */
    void removeVeneer(VeneerManageRemoveReqVO req);
}
