学完能做到 让至少一台关键设备持续上报状态与产量，并能看到按班次/设备的 OEE 趋势。
开始之前
- 设备台账已建好（设备编码与现场贴牌一致）
- 有一个可运行在车间的采集网关 / 工控机，或先用系统里的设备模拟器
操作步骤
先建采集设备，拿令牌
「生产管理 → 设备采集」新增设备，填编码、名称、类型，并关联到已有设备档案。保存后会生成设备令牌，只完整显示一次，立即复制到网关配置里。令牌丢了不用重建设备，在详情页点「轮换令牌」即可。
确认指标口径
至少上报四个指标：run_status（run/idle/stop/fault）、output_count、good_count，以及一个工艺指标（temperature 或 spindle_speed）。OEE 的可用率看 run_status，性能看产量，良率看 good_count。指标编码要固定，不能今天叫 output、明天叫 output_count。
网关按固定频率上报
POST /api/iot/ingest，请求头 X-Device-Token，body 里 device_code 必须与令牌所属设备一致。返回 {code:200} 即成功。历史数据用 /api/iot/ingest/csv 批量补，不要用循环单条打。
没有真设备就先用模拟器
「设备采集 → 设备模拟器」可以按秒生成状态与产量，用来验证 OEE 链路和看板效果。上线前把模拟器停掉，否则真实数据会被模拟数据污染。
维护停机原因字典
「OEE 分析 → 停机原因字典」先建原因：换模、待料、故障、待检、无订单，并区分计划停机与非计划停机。系统每 5 分钟扫描一次状态变化自动生成停机记录，但原因需要人补——不补原因，分析只能得出「停了」。
看趋势而不是看单点
OEE 页按设备、班次、日期看趋势，先找「连续三天往下走」的设备，而不是盯某一天的低值。低于目标值的工单优先排查计划时间是否维护、产量是否漏采。
容易踩的坑
上报一直 401？
请求头必须是 X-Device-Token，不是 Authorization。设备停用后返回 403，不要误判成令牌失效。
OEE 一直是 0？
先看设备有没有上报 run_status 与产量，再看班次/产能档案有没有维护计划生产时间。两者缺一个，可用率就算不出来。
设备状态是人工改的，还能用吗？
可以先用人工状态跑起来，但要接受精度损失。采集的价值在于「不用人记」，人工维护的状态迟早会失真。