EMS 设备管理系统产品系统

面向显示模组（LCD/LCM）制造工厂的组装产线设备管理场景。产线工序多、设备多，生产过程中产生的设备报警与异常事件需要集中记录与管理。系统与 MES 的扫码过站管控配合使用：序号扫码后记录进 MES，扫码 NG 时触发设备报警，并将异常事件记录进 EMS。

EMS 是面向电子制造产线的设备监控与报警收集系统，主要功能如下：
1. 设备数据采集：设备端 Agent（C#）通过 Modbus TCP、三菱 MC 协议、基恩士 KV 上位链路读取 PLC 状态与报警，也支持日志文件采集；断网时先存本地，恢复后自动补传，重复上报不会重复入库。
2. 报警与异常管理：按统一的异常码规则解析报警，分级记录；提供实时看板、报警列表、异常码对照表，以及设备状态与位置示意图。
3. 稼动率与停机分析：按班别统计设备稼动率，归类停机原因，每日、每周自动生成 Excel 报表并邮件发给相关工程师。
4. 与 MES 联动：配合 MES 扫码过站管控，扫码 NG 时触发设备报警，并将异常事件记录进 EMS。
5. 与设备保养系统（CMMS）关联：设备与 CMMS 台账对应，便于从报警追溯到保养。
6. 统一登录与多语言：接入工厂统一单点登录，界面支持中文、英文、泰文、缅甸文，并提供手机端页面。

整体采用「设备端 Agent → 服务端 → Web 看板」三层架构，只做旁路采集，不替代设备原有软件。

1. 设备端（C#，.NET Framework 4.8 + netstandard2.0）：以 Windows 服务运行，配 WPF 配置界面。核心层只定义采集与上报接口，Modbus TCP、三菱 MC 3E、基恩士 KV 上位链路、日志文件四种驱动作为适配器接入；状态、报警、产量先写入本地 SQLite outbox，再通过 HTTPS 上报，失败自动重试，断网后补传，并支持在线自动更新。
2. 服务端（Python FastAPI + SQLAlchemy 2 + Alembic）：设备上报经幂等去重后入库；报警按五级异常码逐级匹配对照表，匹配不到的记为未知报警，等工程师建档后归类。心跳超时由定时扫描判定设备离线，并自动结束当前状态段、开启离线段。生产库为 MySQL，表结构由 Alembic 迁移管理，开发与单元测试用 SQLite。
3. 分析与报表：服务端按班别汇总稼动率、MTBF/MTTR、报警 Pareto，并支持导出 CSV；Excel 日报、周报由脚本生成，定时邮件发送。
4. 前端（Vue 3 + TypeScript + Element Plus + ECharts + Pinia + vue-i18n）：看板每 5 秒轮询，时间以服务端时间为基准，避免设备或浏览器时钟偏差；支持中、英、泰、缅四种语言和手机端页面。
5. 身份与权限：人员走统一单点登录换取本地令牌，服务端按管理员、工程师、维修、只读四个角色做权限守卫；设备走「设备编码 + 每台独立 API Key」认证，人员身份与设备身份相互独立。
6. 测试：后端用 pytest 和 Ruff，C# 用 xUnit；没有真机时，用自写的 Modbus TCP 从站模拟器跑通从采集到看板的全