package com.ruoyi.quality.service;

import com.ruoyi.quality.dto.QualityTraceBatchOptionVo;
import com.ruoyi.quality.dto.QualityTraceForwardExportVo;
import com.ruoyi.quality.dto.QualityTraceForwardVo;
import com.ruoyi.quality.dto.QualityTraceReverseExportVo;
import com.ruoyi.quality.dto.QualityTraceReverseVo;

import java.util.List;

/**
 * 生产质量追溯：成品批号正向追溯、原料批号反向追溯
 */
public interface QualityTraceService {

    /**
     * 正向追溯：成品批号 → 生产订单/报工工序/投入物料/领料批次/检验与不合格处理/出库流向
     */
    QualityTraceForwardVo forward(String batchNo);

    /**
     * 反向追溯：原料批号 → 采购来源 + 使用该批号的订单 + 订单产出的成品批号
     */
    QualityTraceReverseVo reverse(String batchNo);

    /**
     * 正向追溯导出（成品批号→原料批号链路行）
     */
    List<QualityTraceForwardExportVo> forwardExportRows(String batchNo);

    /**
     * 反向追溯导出（原料批号→受影响成品批号行）
     */
    List<QualityTraceReverseExportVo> reverseExportRows(String batchNo);

    /**
     * 批号候选（前端搜索下拉）
     *
     * @param type finished=成品批号，material=原料批号
     */
    List<QualityTraceBatchOptionVo> batchOptions(String type, String keyword, Integer limit);
}