package com.ruoyi.quality.service;

import com.ruoyi.quality.dto.QualityInspectStatDto;
import com.ruoyi.quality.dto.QualityPassRateDto;
import com.ruoyi.quality.dto.QualityMonthlyDetailDto;
import com.ruoyi.quality.dto.QualityParameterStatDto;
import com.ruoyi.quality.dto.QualityMonthlyPassRateWrapperDto;
import com.ruoyi.quality.dto.QualityTopParameterDto;

import java.util.List;

/**
 * <p>
 * 质量管理的报表管理 服务类
 * </p>
 *
 * @author 芯导软件（江苏）有限公司
 * @since 2026-01-13 03:39:49
 */
public interface QualityReportService {

    List<QualityInspectStatDto> getInspectStatistics();

    List<QualityPassRateDto> getPassRateStatistics();

    List<QualityMonthlyPassRateWrapperDto> getMonthlyPassRateStatistics(String year);

    List<QualityPassRateDto> getYearlyPassRateStatistics(String year);

    List<QualityMonthlyDetailDto> getMonthlyCompletionDetails(String year);

    QualityTopParameterDto getTopParameters(Integer inspectType);

    /**
     * 获取月度合格率环比统计数据
     * @param year 年份
     * @param month 月份（1-12）
     * @return 包含环比数据的合格率列表（原材料/半成品/成品）
     */
    List<QualityPassRateDto> getMonthlyPassRateWithComparison(String year, Integer month);
}