klp-oa/klp-wms/src/main/java/com/klp/service/IWmsCoilPendingActionService.java

package com.klp.service;

import com.klp.domain.vo.WmsCoilPendingActionVo;
import com.klp.domain.bo.WmsCoilPendingActionBo;
import com.klp.common.core.domain.PageQuery;
import com.klp.common.core.page.TableDataInfo;

import java.util.Collection;
import java.util.List;
import java.util.Date;
import com.klp.domain.vo.TheoryCycleRegressionResultVo;

/**
 * 钢卷待操作Service接口
 *
 * @author Joshi
 * @date 2025-11-03
 */
public interface IWmsCoilPendingActionService {

    /**
     * 查询钢卷待操作
     */
    WmsCoilPendingActionVo queryById(Long actionId);

    /**
     * 查询钢卷待操作列表
     */
    TableDataInfo<WmsCoilPendingActionVo> queryPageList(WmsCoilPendingActionBo bo, PageQuery pageQuery);

    /**
     * 查询钢卷待操作列表
     */
    List<WmsCoilPendingActionVo> queryList(WmsCoilPendingActionBo bo);

    /**
     * 新增钢卷待操作
     */
    Boolean insertByBo(WmsCoilPendingActionBo bo);

    /**
     * 修改钢卷待操作
     */
    Boolean updateByBo(WmsCoilPendingActionBo bo);

    /**
     * 校验并批量删除钢卷待操作信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 更新操作状态
     */
    Boolean updateStatus(Long actionId, Integer status);

    /**
     * 开始处理操作
     */
    Boolean startProcess(Long actionId);

    /**
     * 完成操作
     */
    Boolean completeAction(Long actionId);

    /**
     * 取消操作
     */
    Boolean cancelAction(Long actionId);

    /**
     * 还原操作（将已删除的记录恢复为正常状态）
     */
    Boolean restoreAction(Long actionId);

    /**
     * 计算理论节拍线性回归（默认近6个月），同时返回散点用于前端绘图并将结果缓存。
     */
    TheoryCycleRegressionResultVo calcTheoryCycleRegression(Date startTime, Date endTime);

    /**
     * 计算理论节拍线性回归（可选择是否返回散点；并对散点数量进行上限控制）。
     *
     * @param includePoints 是否返回散点 points（默认 false，避免结果过大）
     * @param maxPoints     最大散点数（includePoints=true 时生效）
     */
    TheoryCycleRegressionResultVo calcTheoryCycleRegression(Date startTime, Date endTime, Boolean includePoints, Integer maxPoints);
}