模块接口索引¶

适用基线：测试环境目标 / dev 分支 / 2026-07-15。阅读对象：测试、实施、运维（主）；集成开发（顺带）。本页按模块给出代表性管理端路径与业务文档入口；非全量清单。字段级定义以环境 Knife4j 为准。

业务目的与适用范围¶

知道业务在哪个模块，但不确定管理端路径落在哪——用本页做抽样索引。它帮助快速跳到业务文档，并给出已取证的代表性路径；不替代 Swagger，也不编造未证实模块（如 PS）的伪路径。

读完本页，应能：按模块找到入口与抽样路径；知道补全量目录的正确做法是导出/浏览 Knife4j 后回填业务页。

你要…	做法
做页面联调	先打开业务模块页，再在本表找代表性路径，最后到 Knife4j 看字段。
做外部集成	先看跨系统集成场景，再回本表与业务页。
补全量目录	按服务导出/浏览 Knife4j，把高频接口回填到业务页「相关接口」表。
找调用约定	调用约定与文档发现

路径均为控制器映射的相对路径（不含环境主机与可能的网关前缀）。

写实示例

给定： 要联调 MES 工单下发。 做法： 打开计划管理看业务规则 → 本表 MES 节见 /mes/work-order 族 → Knife4j 核 publish 等具体方法与入参。不要把本表当成 SDK 或全量目录。

能力	代表性路径	业务文档
拉取权限信息	`GET /system/auth/get-permission-info`	租户与认证、RBAC
用户/角色/菜单维护	`/system/user`、`/system/role`、`/system/menu` 等（CRUD 族）	用户与权限

能力	说明	业务文档
文件、导入导出、消息、日志	平台公共能力；具体路径按 Knife4j Infra/System 标签查阅	基础设施
接口调用信息与异步重试	交换可观测与恢复	数据交换与集成可靠性
积木报表	业务页嵌入查看，带登录 Token 线索	报表

细则与按钮级接口以各分组「维护与查询参考」及页面相关接口表为准。

能力	代表性路径（已在文档取证中出现）	业务文档
工艺路线	`/mes/basic-processroute-info`（含图形更新、按产品查等）	工艺管理
生产订单（MES）	`/mes/production-order-main`	计划管理
ERP 订单转换等	`/mes/production-order`（关闭/取消/锁定/验证转换/执行转换）	同上
工单下发/状态	`/mes/work-order`（publish、start、pending、finish…）；并行组子路径	同上
工位作业领取/报工	`/mes/wo-workstation-job`	终端操作
正向/逆向追溯	`/mes/forward-trace`、`/mes/reverse-trace`	追溯管理
线边客户端	`/mes/line-client-info`	基础建模

自动触发与 WMS/MES 回写以各组证据为准；GAP-071（报工 NG→QMS）未证实。

模块	说明	业务文档
EAM	报修维修、巡检保养、备件协同等；台账主数据多在 DBC	EAM
ANDON	问题主记录与响应到岗；不替代维修工单	ANDON

能力族	说明	业务文档
采购订单 / 要货预测与计划 / 发货协同 / 跟踪 / 结算	供应商协同；推送 WMS 的 ASN/计划等已有证据线索	SCP
库存执行	不在 SCP 内完成；以 WMS 为准	WMS 各页

SCP 可能独立部署与独立 Knife4j 入口。

能力族	说明	业务文档
物料、工厂、BOM、工序等主数据	主数据权威多在 DBC	DBC

无后端/菜单实现证据；不提供伪路径。见PS 排程管理与资料缺口清单。

能力	代表性路径（前端已取证）	业务文档
采集点	`/iotgw/collect-point-info`（page/get/create/update/delete/export-excel）	采集点
设备参数配置	`/iotgw/asset-param-config`	同上
采集设备	`/iotgw/asset-collect-info`	设备管理
参数采集日志	`/iotgw/param-collect-logs`	同上
MQTT 客户端状态	`/iotgw/mqtt-client-status`	同上
MES/WMS 消费	业务服务经 `iotgw` API 包读参/发消息（非本表逐条展开）	边缘接入模型

网关实现仓外（GAP-072）；OpenAPI 以环境 Knife4j 的 iotgw 标签为准。

能力	代表性路径	业务文档
AGV / IOT 回调	`/agv/agvCallbackService/agvCallback`、`/iotCallback`	点位主数据见 DBC；数采配置见数采
潜伏式 AGV 点位	DBC 维护页	潜伏式AGV点位配置

完整 AGV 任务说明书未单列为模块批次；勿与数采配置台混淆。