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

import cn.iocoder.yudao.module.mes.controller.pub.trace.vo.MesProTracePublicConfigRespVO;
import cn.iocoder.yudao.module.mes.controller.pub.trace.vo.MesProTracePublicRespVO;

/**
 * 公开扫码溯源 Service 接口
 * <p>
 * 面向公众（免登录），根据袋码 / 托盘码 / 批次码查询全程溯源信息。作为追溯体系的核心聚合入口，
 * 后续新增数据源（质检扩展、防伪验证、储运信息等）在聚合实现中追加信息区块即可。
 */
public interface MesProTracePublicService {

    /**
     * 根据追溯码查询全程溯源信息
     *
     * @param code 追溯码（袋码 / 托盘码 / 批次码，兼容整 H5 URL）
     * @return 全程溯源信息
     */
    MesProTracePublicRespVO queryTrace(String code);

    /**
     * 获得 H5 溯源页配置（生产经营者名称、追溯网址）
     * <p>
     * 两项均为种子标签四要素的组成部分，由后端统一下发，保证二维码内容、标签印刷内容与
     * H5 页面展示一致。
     *
     * @return 页面配置
     */
    MesProTracePublicConfigRespVO getPublicConfig();

}