种子二维码标签国标合规 - 前端联调方案

背景

依据《农作物种子标签二维码编码规则》与《农作物种子标签通则》（GB 20464-2024），
每个二维码对应唯一的最小销售单元种子且不得重复使用，二维码必须包含四项信息并按顺序排列：

1. 品种名称
2. 生产经营者名称（进口种子为进口商名称）
3. 单元识别代码（不超过 20 个字符，数字或字母数字组合）
4. 追溯网址

本次改造将「生产经营者名称」与「追溯网址」收敛为后端统一数据源，并让已作废的追溯码对外失效。

涉及页面

• H5 扫码溯源页 trace.html（已完成改造，无需前端另行处理）
• 管理后台 - 赋码管理页（菜单 mes/pro/bagCode/index，前端工程中**当前缺失**，需新建）
• 管理后台 - 托盘码管理页 / 批次生产管理页（二维码预览与导出，如有）

API

1. 新增：获得溯源页配置

GET /public/mes/trace/config

请求参数： 无

响应示例：

{
  "code": 0,
  "data": {
    "operatorName": "新疆塔里木河种业股份有限公司",
    "traceUrl": "http://1.95.78.124:9008/prod/trace.html",
    "imported": false
  },
  "msg": ""
}

响应字段：

2. 追溯查询响应新增字段

GET /public/mes/trace/query?code=xxx

响应字段新增：

响应示例：

{
  "code": 0,
  "data": {
    "sourceType": "BAG",
    "requestCode": "0286267849370923",
    "codeStatus": "VALID",
    "operatorName": "新疆塔里木河种业股份有限公司",
    "traceUrl": "http://1.95.78.124:9008/prod/trace.html",
    "batchBound": false,
    "itemCode": "xxx",
    "itemName": "塔河4号",
    "itemUnitMeasureName": "48千克"
  }
}

字段展示规则

H5 溯源页（追溯查询区块）

四要素必须按国标顺序展示，其余信息排列其后：

H5 溯源页（生产明细折叠区）

国标要求追溯网址应可查询「种子加工批次」及「物流销售信息」，因此以下区块**对外展示**（默认折叠不展开）：

以下区块**仅内部可见，不对外展示**（如需一并展示，将 detailSections(d, false) 改为 detailSections(d, true)）：

管理后台 - 赋码管理页

业务规则说明

配置项

后端配置项（application-*.yaml 的 mes 前缀）：

注意事项

• 前端禁止再硬编码生产经营者名称与追溯网址，必须通过 /public/mes/trace/config 获取，否则会与二维码内容不一致。
• 追溯网址在二维码内容与页面展示之间只有 mes.trace-base-url 一个真值源，前端展示时不要自行拼接 /prod 等路径。
• 已作废码的判定覆盖三种入口：袋码（状态 30）、托盘码（状态 20）、批次码（状态 40），三者的作废枚举值不同，前端不要共用常量判断。
• 存量标签需重新导出：改造前导出的二维码内容已固化，其中追溯网址可能为内网地址且标签缺少四要素，需重新导出印刷。
• 袋序号改为原子分配：原先由「查库内最大值再 +1」得到，并发生成会产生重复袋序号（袋序号会印在标签上）；现已改为 Redis 原子自增分配，并用库内最大值校正基准。序号**只保证不重复、不回退，不保证连续**（并发下不同请求拿到不同区段，属正常）。
• 管理后台赋码管理页面（mes/pro/bagCode/index）在前端工程中缺失，业务人员目前无法自助查看/导出二维码，建议补充。