145 lines
6.0 KiB
Markdown
145 lines
6.0 KiB
Markdown
# 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. 反馈与支持
|
||
|
||
- 使用中如遇到界面异常、统计不准、报警缺失等问题：
|
||
- 记录问题发生时间、操作步骤、界面提示；
|
||
- 截图或拍照（含底部状态栏与异常信息）；
|
||
- 联系系统管理员或运维支持。
|
||
|
||
— 结束 —
|