# FATrace 用户说明书（WPLApp）

版本：v1.0 适用模块：FATrace.WPLApp（桌面应用）

## 1. 简介

FATrace 是一套用于食品添加剂生产过程追溯与运行监控的桌面应用。WPLApp 负责生产端的日常使用，包括：

- 实时运行信息查看与统计总览（Dashboard）
- 历史报警查询（History Alarm）
- 用户登录与状态显示
- PLC 通信状态指示与当前终端信息（底部状态栏）

本说明书面向一线操作员、现场工程、以及系统管理员，帮助快速上手并定位常见问题。

## 2. 安装与启动

- 安装：由管理员完成程序分发与安装（通常包含可执行文件与依赖项）。
- 运行：双击启动桌面应用，进入主界面。
- 字体资源：应用内置图标字体，界面会自动加载，无需额外配置。
- 数据库：应用使用 FreeSql 进行数据访问。数据库连接等参数由管理员预配置。

如启动失败、页面空白或频繁报错，请联系系统管理员检查运行环境与数据库连接配置。

## 3. 登录与账号

- 打开左侧菜单“用户登录”进入登录页。
- 输入“用户名”和“密码”，点击“登录”或直接按回车键。
- 登录成功后自动导航到 Dashboard；底部状态栏将显示“当前用户：已登录”。

注意：当前版本按用户表中明文密码进行校验，请妥善保管账号信息。若忘记密码，请联系管理员重置。

## 4. 主界面与导航

应用主界面由顶部、内容区域、底部状态栏组成。常用页面：

- Dashboard（统计与实时信息）
- 历史报警（History Alarm）
- 原料相关查询（如原料使用、原料入库等，若已在系统中启用）

通过左侧菜单切换页面。页面内容区支持自动刷新与数据联动，无需手动刷新按钮。

## 5. Dashboard（统计与实时信息）

Dashboard 提供生产运行的概览信息，包括：

- 统计卡片：按“日、月、年、累计”汇总原料使用重量（RawProUse）。
- 实时运行信息：系统拦截并呈现关键运行日志与事件（如扫码、喷码、过程提示等）。
- PLC 连接状态：以指示灯颜色直观显示当前 PLC 通信状态。
- 预留区域：用于后续扩展显示（如更多曲线、指标或提示）。

刷新机制：当产生关键业务事件（例如扫码处理）时，系统自动发布事件触发 Dashboard 刷新，无需手动点击。

使用建议：

- 关注统计卡片的趋势变化，快速判断当日与周期产量情况。
- 实时信息区域用于排查当班异常，如出现错误或报警文字，可结合“历史报警”页进一步定位。

## 6. 历史报警（History Alarm）

用于查询系统运行过程中记录的历史报警。功能特性：

- 支持按关键字、类别、时间范围进行过滤查询。
- 结果列表分页显示，便于快速定位。
- 报警内容来自系统在关键点输出的报警信息，出现后会自动写入数据库。

使用步骤：

1. 打开“历史报警”页。
2. 选择查询条件（时间范围、类别、关键字等）。
3. 点击查询，查看结果列表。

排查建议：

- 若报警持续出现，先检查 PLC 连接与设备状态，再根据报警文本采取现场处理措施。
- 如怀疑数据库未记录，关注是否出现数据库连接问题或权限异常。

## 7. 底部状态栏（FootView）

底部状态栏持续显示系统运行关键信息：

- PLC 通信指示灯：绿色表示连接正常；红色表示断开或异常。
- PLC 终端信息：显示配置的 IP:Port，便于对照设备。
- 当前用户与登录状态：显示当前登录用户及是否已登录。

当 PLC 状态改变时，这里会同步更新，便于第一时间发现通信问题。

## 8. 常见操作流程

- 开机与登录：启动应用 → 进入“用户登录” → 登录成功 → 自动跳转至 Dashboard。
- 查看产线运行：在 Dashboard 观察统计卡片与实时信息，注意异常提示。
- 报警定位与复盘：在“历史报警”中按时间段和关键字查询，结合现场记录进行处理与复盘。

## 9. 常见问题与排查

- 无法登录：
  - 确认用户名、密码输入正确；
  - 若提示“用户不存在”，请联系管理员检查用户表；
  - 若提示数据库错误，联系管理员检查数据库连接与网络。

- Dashboard 统计为空：
  - 确认数据库中是否存在有效的原料使用数据；
  - 等待系统产生新数据或触发刷新事件；
  - 检查时间范围与系统时间是否正确。

- 实时信息无更新：
  - 确认产线是否有新的扫码或业务事件；
  - 若日志区长时间无输出，可能产线空闲或通信异常。

- PLC 指示红色：
  - 检查 PLC 电源、网线、IP 配置；
  - 确认与应用配置一致（IP、端口）；
  - 联系电气与系统工程师排查网络或驱动问题。

- 历史报警无记录：
  - 近期是否确有报警触发；
  - 检查数据库是否可写；
  - 关注应用日志，必要时联系管理员。

## 10. 使用技巧

- 登录页支持“回车键”快捷登录。
- 关注底部状态栏的用户与 PLC 状态，能快速判断系统是否处于可用状态。
- 建议按班次定期查看“历史报警”，形成闭环处理与优化记录。

## 11. 安全与权限

- 账号仅限本人使用，请勿外借与分享。
- 退出离岗前可在“用户登录”页切换用户（如需要可联系管理员提供退出功能）。
- 如需更细粒度权限（基于岗位/等级），请与管理员沟通后续版本规划。

## 12. 版本与更新

- 本说明书适配当前应用版本的已上线功能。新增功能或 UI 调整将另行更新说明。
- 如需升级或安装补丁，请联系系统管理员统一安排。

## 13. 反馈与支持

- 使用中如遇到界面异常、统计不准、报警缺失等问题：
  - 记录问题发生时间、操作步骤、界面提示；
  - 截图或拍照（含底部状态栏与异常信息）；
  - 联系系统管理员或运维支持。

— 结束 —