package cn.iocoder.yudao.module.mes.framework.config;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * MES 自定义配置项
 */
@Data
@Component
@ConfigurationProperties(prefix = "mes")
public class MesProperties {

    /**
     * H5 溯源页面地址（trace.html）基础 URL，用于生成携带追溯码参数的二维码内容。
     * <p>
     * 这是「追溯网址」的**兜底默认值**：运行时优先取字典 {@link MesTraceConfigResolver#DICT_TYPE}
     * 中「追溯网址」的配置值，可在管理后台「字典管理」中修改而无需重启；字典未配置（或被禁用、
     * 或填了非法地址）时才回退到此配置。
     * <p>
     * 本项仍为必填且参与启动校验：非本地环境配置为内网/占位符地址时启动将直接失败。
     * 这道防线必须在数据库可用之前就能拦住不合规配置，因此不能只依赖字典。
     */
    private String traceBaseUrl = "";

    /** 定位版追溯页是否必须先取得用户定位；仅本地调试配置为 false。 */
    private boolean traceLocationRequired = true;

    /**
     * 生产经营者名称（种子标签四要素之一）。
     * <p>
     * 同样是**兜底默认值**：运行时优先取字典 {@link MesTraceConfigResolver#DICT_TYPE} 中
     * 「生产经营者名称」的配置值。标签印刷与 H5 溯源页均取此值，禁止在前端硬编码。
     */
    private String operatorName = "";

    /**
     * 进口商名称（进口种子场景，标签四要素之一）。
     * <p>
     * 进口种子应标注进口商名称；为空时回退使用 {@link #operatorName}。
     * 运行时优先取字典中「进口商名称」的配置值。
     */
    private String importerName = "";

    /**
     * 是否处于进口种子场景：为 true 时标签与溯源页展示「进口商名称」而非「生产经营者名称」
     * <p>
     * 运行时优先取字典中「是否进口种子」的配置值。
     */
    private boolean imported = false;

    /**
     * 允许二维码编码纯码值（不带溯源 URL）。
     * <p>
     * 仅供本地/测试环境兼容历史码使用；生产环境必须为 false，否则会印出不含追溯网址的标签。
     * <p>
     * 本项**有意不纳入字典**：它是「允许印出不含追溯网址的标签」的开关，放进可后台编辑的字典，
     * 等于给种子标签的合规防线开了一个可被误操作的后门。因此只保留在配置文件中，由开发/运维把控。
     */
    private boolean allowPlainQrCode = false;

}