package com.mes.device.service;

import com.mes.device.entity.GlassInfo;

import java.util.List;
import java.util.Map;

/**
 * 玻璃信息服务接口
 * 
 * @author mes
 * @since 2024-11-20
 */
public interface GlassInfoService {

    /**
     * 根据玻璃ID查询玻璃信息
     * 
     * @param glassId 玻璃ID
     * @return 玻璃信息，如果不存在返回null
     */
    GlassInfo getGlassInfo(String glassId);

    /**
     * 根据玻璃ID获取玻璃长度
     * 
     * @param glassId 玻璃ID
     * @return 玻璃长度（mm），如果不存在返回null
     */
    Integer getGlassLength(String glassId);

    /**
     * 根据玻璃ID列表批量查询玻璃信息
     * 
     * @param glassIds 玻璃ID列表
     * @return 玻璃信息列表
     */
    List<GlassInfo> getGlassInfos(List<String> glassIds);

    /**
     * 根据玻璃ID列表批量获取玻璃长度映射
     * 
     * @param glassIds 玻璃ID列表
     * @return 玻璃ID到长度的映射Map
     */
    Map<String, Integer> getGlassLengthMap(List<String> glassIds);

    /**
     * 创建或更新玻璃信息
     * 
     * @param glassInfo 玻璃信息
     * @return 是否成功
     */
    boolean saveOrUpdateGlassInfo(GlassInfo glassInfo);

    /**
     * 批量创建或更新玻璃信息
     * 
     * @param glassInfos 玻璃信息列表
     * @return 是否成功
     */
    boolean batchSaveOrUpdateGlassInfo(List<GlassInfo> glassInfos);

    /**
     * 查询最近扫码的玻璃ID列表
     * 
     * @param minutesAgo 查询最近多少分钟内的记录，默认2分钟
     * @param maxCount 最大返回数量，默认20
     * @param workLine 工作线号（可选，用于过滤）
     * @return 玻璃ID列表
     */
    List<String> getRecentScannedGlassIds(Integer minutesAgo, Integer maxCount, String workLine);

    /**
     * 批量更新玻璃状态
     */
    boolean updateGlassStatus(List<String> glassIds, String status);

     /**
     * 获取 MES 工程导入 URL
     *
     * @return MES 工程导入 URL
     */
    String getMesEngineeringImportUrl();

    /**
     * 将前端上传的 Excel 行数据转换为 MES 导入工程所需的 JSON 结构
     *
     * @param excelRows 前端解析后的行数据，字段示例：
     *                  glassId,width,height,thickness,quantity,orderNumber,filmsId,flowCardId,productName,customerName
     * @return 符合 MES 接口要求的请求体 Map
     */
    Map<String, Object> buildEngineerImportPayload(List<Map<String, Object>> excelRows);

    /**
     * 根据工程号查询玻璃信息列表
     *
     * @param engineeringId 工程号
     * @return 玻璃信息列表
     */
    List<GlassInfo> getGlassInfosByEngineeringId(String engineeringId);

    /**
     * 从Excel数据保存玻璃信息到本地数据库，并关联engineering_id
     *
     * @param excelRows Excel行数据
     * @param engineeringId 工程号
     */
    void saveGlassInfosFromExcel(List<Map<String, Object>> excelRows, String engineeringId);

    /**
     * 扫码交互后更新玻璃信息状态（将state从0改为1）
     *
     * @param glassId 玻璃ID
     * @param width 宽度（可选）
     * @param height 高度（可选）
     * @param workLine 产线编号（可选）
     * @return 是否更新成功
     */
    boolean updateGlassStateAfterScan(String glassId, Integer width, Integer height, Integer workLine);

    /**
     * 根据工程号删除玻璃信息
     *
     * @param engineeringId 工程号
     * @return 删除的玻璃数量
     */
    int deleteGlassInfosByEngineeringId(String engineeringId);
}