package cn.iocoder.yudao.module.mes.service.trace.consumer;

import cn.iocoder.yudao.module.mes.dal.dataobject.trace.consumer.MesTraceConsumerScanEventDO;

/**
 * 消费者扫码访问事件 Service 接口
 * <p>
 * 记录公众溯源扫码访问情况。记录失败不得影响溯源查询主流程，故实现层需保证不抛异常。
 *
 * @author 超级管理员
 */
public interface MesTraceConsumerScanEventService {

    /**
     * 记录一次消费者扫码访问事件
     *
     * @param traceCode       扫码原始内容
     * @param normalizedCode  解析后的追溯码
     * @param sourceType      入口类型：BAG/PALLET/BATCH
     * @param batchId         生产批次编号，可空
     * @param success        是否查询成功
     * @param errorCode       失败编码，成功传 null
     * @return 事件记录（含主键与扫码地区）；记录失败返回 null
     */
    MesTraceConsumerScanEventDO recordScan(String traceCode, String normalizedCode, String sourceType, Long batchId,
                                           boolean success, String errorCode);

    /**
     * 根据 ID 查询事件（供校验/调试使用）
     *
     * @param id 主键
     * @return 事件
     */
    MesTraceConsumerScanEventDO getEvent(Long id);

}