361 lines
14 KiB
Markdown
361 lines
14 KiB
Markdown
# FATrace.App 用户操作手册（SOP）
|
||
|
||
## 1. 文档说明
|
||
|
||
- **适用范围**
|
||
称重客户端，用于原料入库、称重打印、消耗记录入库与历史数据查询。
|
||
- **目标读者**
|
||
产线操作员、确认者/班组长、IT 运维。
|
||
- **术语约定**
|
||
- **入库重量/剩余重量**：单位为 **Kg**。
|
||
- **称重重量**：单位为 **g**。
|
||
- **内袋二维码**：打印在内袋标签上的二维码内容（系统生成）。
|
||
|
||
## 2. 系统概述
|
||
|
||
称重客户端用于在产线对特定原料进行：
|
||
|
||
- **原料入库建档**：录入批号、保质期、入库重量（Kg），形成一条“分拆中”的原料记录。
|
||
|
||
- **实时称重 + 打印内袋二维码**：从称重仪表获取稳定重量（g），生成二维码并调用斑马打印机打印标签。
|
||
|
||
- **消耗记录入库**：每次打印成功后写入使用记录，并更新该原料剩余重量。
|
||
|
||
- **历史数据查询**：按日期范围、原料名称/编码关键字、批号查询消耗明细。
|
||
|
||
|
||
|
||
## 3. 运行环境与依赖
|
||
|
||
- **操作系统**
|
||
Windows 10/11。
|
||
|
||
- **网络与设备**
|
||
|
||
- SQL Server 数据库（称重服务器）
|
||
- 称重仪表
|
||
- 斑马打印机
|
||
|
||
|
||
|
||
## 4. 安装与部署（IT/工程师运维）
|
||
|
||
### 4.1 部署方式
|
||
|
||
- **推荐**：使用发布后的程序目录（含可执行文件、依赖 DLL、`App.config`、`NLog.config` 等）。
|
||
- **注意**：首次部署时确保程序目录对当前登录用户具有读写权限（日志目录会写入到程序目录下）。
|
||
|
||
### 4.2 单实例程序限制
|
||
|
||
**==程序启动时会检测是否已运行；若已运行会提示“程序已运行，不能再次打开！”。==**
|
||
|
||
## 5. 配置说明（必须掌握）
|
||
|
||
### 5.1 数据库连接（App.config）
|
||
|
||
文件：`FATrace.App/App.config`
|
||
|
||
系统实际使用的连接键为：`connecting`。
|
||
|
||
- **connecting**：FATrace 主库（SQL Server）连接字符串
|
||
|
||
**修改建议**
|
||
|
||
- **[服务器地址]**：`Data Source=...`
|
||
- **[数据库名]**：`Initial Catalog=...`
|
||
- **[账号密码]**：`User ID=...;Password=...`
|
||
- 如启用证书校验，需按现场策略配置 `TrustServerCertificate` 等参数。
|
||
|
||
### 5.2 PLC 配置（App.config）
|
||
|
||
`PLCIP / PLCPort / PLCScan` 为保留配置项；若现场版本启用 PLC 通信，请由 IT 运维按实际设备信息配置。
|
||
|
||
### 5.3 打印机与称重仪表配置（当前版本说明）
|
||
|
||
当前版本中：
|
||
|
||
- 打印机 IP/端口：在主窗体中默认值为 `_printerIp=192.0.1.21`、`_printerPort=9100`
|
||
- 称重仪表 IP/端口：在主窗体加载时使用示例值 `192.168.0.80:10251`
|
||
|
||
如果现场设备地址不同：
|
||
|
||
- **建议由开发/IT 运维修改为配置化**（后续可以将 IP/Port 放入 `App.config` 并提供配置界面）。
|
||
- 在未配置化前，需更新代码并重新发布程序。
|
||
|
||
### 5.4 日志配置（NLog.config）
|
||
|
||
文件：`FATrace.App/NLog.config`
|
||
|
||
- **错误日志**：`${basedir}/Log/${shortdate}/ErrorMessage.txt`
|
||
- **操作日志**：`${basedir}/OperationLogs/${shortdate}/OperationLog.txt`
|
||
- **保留天数**：默认 `maxArchiveDays=60`
|
||
|
||
## 6. 界面结构与功能入口
|
||
|
||
主界面由“左侧导航栏 + 右侧 Tab 页面”组成。
|
||
|
||
|
||
|
||
### 6.1 左侧导航栏
|
||
|
||
- **主界面**：进入生产主页面（需要已登录）
|
||
- **历史数据**：进入历史查询页面
|
||
- **用户登录**：进入登录页面
|
||
- **退出**：关闭程序
|
||
|
||
### 6.2 右侧页面
|
||
|
||
- **生产主页面**：原料选择、入库信息录入、实时称重显示、打印与剩余重量显示
|
||
|
||
|
||
|
||
- **用户登录页面**：确认者/操作者登录
|
||
|
||
|
||
|
||
- **历史数据页面**：按条件查询并显示 `RawProUse` 历史记录
|
||
|
||
|
||
|
||
### 6.3 状态栏（底部）
|
||
|
||
|
||
|
||
- **用户**：显示当前确认者用户
|
||
- **称重状态**：称重仪表连接/通信状态
|
||
- **服务器通信状态**：数据库心跳状态
|
||
- **打印机状态**：打印机在线/离线状态
|
||
|
||
## 7. 角色与权限（业务规则）
|
||
|
||
### 7.1 登录角色
|
||
|
||
- **确认者用户**：用于确认生产记录的责任人（系统登录校验账号）
|
||
- **操作者用户**：用于记录实际操作人（当前版本为文本输入，不做账号校验）
|
||
|
||
### 7.2 用户来源
|
||
|
||
系统登录会在数据库表 `TbUser` 中按 `UserName` 查询并校验密码。
|
||
|
||
- **账号不存在**：提示“当前用户不存在！”
|
||
- **密码错误**：提示“密码错误！”
|
||
- **登录成功**：提示“登录成功！”并切换到主界面
|
||
|
||
## 8. 日常操作 SOP（产线操作员）
|
||
|
||
### 8.1 开机前检查（每日/每班）
|
||
|
||
> **==图片示例：称重连接失败，打印机未正常连接==**
|
||
>
|
||
> 
|
||
|
||
- **[数据库连接]**
|
||
状态栏“服务器通信状态”应显示“服务器正常”。
|
||
|
||
- **[称重仪表]**
|
||
状态栏“称重状态”应显示“称重已连接/称重通讯正常”。
|
||
|
||
- **[打印机]**
|
||
状态栏“打印机状态”应显示“打印机在线”。
|
||
|
||
- **[标签耗材]**
|
||
确认打印机纸张/碳带充足，标签尺寸与模板匹配。
|
||
|
||
|
||
|
||
***==确保4个设备连接正常（绿色展示）==***
|
||
|
||
|
||
|
||
### 8.2 登录（必须）
|
||
|
||
1. 点击左侧 **用户登录**。
|
||
|
||
2. 输入：
|
||
- 确认者用户名
|
||
- 操作者用户名
|
||
- 密码（校验确认者账号）
|
||
|
||
3. 点击 **登录**。
|
||
|
||
4. 登录成功后进入主界面；状态栏显示“确认者用户：xxx”。
|
||
|
||
|
||
|
||
### 8.3 选择原料（开始生产前）
|
||
|
||
1. 在主页面左上区域点击原料按钮。
|
||
|
||
|
||
|
||
***注意：***
|
||
|
||
**==在拆包分小包之前要确认当前是哪种原料，您可以点击对应的添加剂进行选中操作==**
|
||
|
||
**==在你选中后一个原料后，系统会根据选中原料查询之前是否有大包未使用完毕的添加剂，如果有的话，直接在之前未使用完毕的原料上继续分拆操作，可以开始称重操作==**
|
||
|
||
**==否则您需要新填写一个原料信息，如下：==**
|
||
|
||
|
||
|
||
**==上面信息填写完毕后，请点击【确认】按钮，代表一个新的原料开始要拆分使用了==**
|
||
|
||
**==如果当前原料还剩余很多但是因为一些其他的原因不能再使用了，需要使用另一包开始拆分使用，那么您可以点击【清零当前原料】清空当前原料信息，然后进行新原料的输入操作==**
|
||
|
||
|
||
|
||
2. 系统会检查该原料是否存在“分拆中”的记录：
|
||
- **存在**：自动加载该原料的入库重量、批号、保质期、剩余重量。
|
||
- **不存在**：视为新原料，需进行入库信息录入。
|
||
|
||
**重要规则**
|
||
|
||
- **同一原料在未分拆完成前，系统优先使用最新一条“分拆中”记录。**
|
||
|
||
### 8.4 原料入库建档（新原料/新批次）
|
||
|
||
适用场景：该原料首次使用，或上一批次已分拆完成，需要建立新的入库记录。
|
||
|
||
1. 在“入库信息”区域录入：
|
||
- **入库重量（Kg）**：必须为正数
|
||
- **批号**：不能为空、长度不超过 20
|
||
- **保质期（月）**：必须为正整数
|
||
2. 点击 **确认**。
|
||
3. 保存成功后：
|
||
- 系统写入保存（状态为 Splitting/分拆中）
|
||
- 剩余重量初始化为入库重量
|
||
|
||
### 8.5 实时称重检查
|
||
|
||
- “实时重量”文本框会显示称重仪表的稳定重量值。
|
||
- 若实时重量长时间不更新：优先检查称重状态、网线、仪表 IP/端口配置是否正确。
|
||
|
||
### 8.6 称重打印（核心流程）
|
||
|
||
适用场景：每次从大包装分装到小包装/内袋时。
|
||
|
||
1. 确认已选择原料且已录入批号/保质期/原料编码。
|
||
2. 确认称重仪表显示稳定重量（g）。
|
||
3. 点击 **打印**。
|
||
4. 系统弹窗确认：选择 OK 执行，Cancel 取消。
|
||
5. 打印成功后系统将自动：
|
||
- 生成内袋二维码（包含原料编码、批号、重量、保质期、产地编码、日产量序号等信息）
|
||
- 写入称重使用记录到服务器
|
||
- 更新该原料的剩余重量信息
|
||
|
||
**重量与单位说明**
|
||
|
||
- 实时称重 ``：g
|
||
- 剩余重量 ``：Kg
|
||
- 系统计算：`新剩余(Kg) = 旧剩余(Kg) - 称重(g)/1000`
|
||
|
||
### 8.7 剩余重量不足/分拆完成处理
|
||
|
||
==**打印完成后系统会做剩余重量检查：**==
|
||
|
||
- ==**当剩余重量非常接近 0 或小于本次称重折算值时：**==
|
||
- ==**系统会提示并将该原料记录置为“分拆完成”**==
|
||
- ==**清空当前选中原料与输入框**==
|
||
- ==**操作员应按现场实际将大包装清空并更换下一批/下一包**==
|
||
|
||
|
||
|
||
### 8.8 手动清零（异常处理/强制结束）
|
||
|
||
如果现场需要强制结束当前原料（例如称重异常、原料报废/更换、需要重新建档）：
|
||
|
||
1. 点击 **清零当前的原料**。
|
||
|
||
2. 系统将把当前原料使用状态更新为“分拆完成”。
|
||
|
||
3. 返回后可重新选择原料并重新建档。
|
||
|
||
|
||
|
||
|
||
|
||
### 8.9 用户的管理（在工作站上操作）
|
||
|
||
因为当前是工控机是触控电脑，没有鼠标，不方便输入一些姓名和文字等信息，所以把当前的确认者和操作者的一些增加、修改、删除等操作放到工作站上进行管理，具体操作说明请见服务器侧【UserManual.pdf】
|
||
|
||
|
||
|
||
## 9. 历史数据查询 SOP（班组长/质检/追溯）
|
||
|
||
### 9.1 进入历史数据页面
|
||
|
||
点击左侧 **历史数据**。
|
||
|
||
### 9.2 查询条件说明
|
||
|
||
- **开始时间/结束时间**：按日期选择，系统按整日（00:00:00 至 23:59:59）进行查询
|
||
- **原料名称**：下拉可选，也可手工输入；支持按原料名称或原料编码关键字模糊匹配
|
||
- **批号**：精确匹配（输入完整批号）
|
||
|
||
### 9.3 执行查询
|
||
|
||
|
||
|
||
点击 **查询**，结果显示在表格中。
|
||
|
||
列头已转换为中文（如：原料编号、称重重量(g)、称重时间、操作员、确认者、出库时间等）。
|
||
|
||
## 10. 数据口径与数据库表说明（IT/工程师追溯必读）
|
||
|
||
- **RawProInput（原料入库/分拆主表）**
|
||
- 记录一包/一批原料的入库重量与剩余重量
|
||
- 状态：Splitting（分拆中）/SplitComplete（分拆完成）
|
||
- **RawProUse（称重使用明细）**
|
||
- 每次打印产生一条记录
|
||
- 字段包括：原料信息、内袋二维码、称重重量、剩余重量、称重时间、操作员/确认者等
|
||
- **DayCount（日计数）**
|
||
- 用于生成二维码中的日产量序号
|
||
- **TbUser（用户表）**
|
||
- 登录认证来源（用户名/密码/权限等级）
|
||
|
||
## 11. 日志与问题排查（IT 运维）
|
||
|
||
### 11.1 日志位置
|
||
|
||
- **错误日志**：`程序目录/Log/日期/ErrorMessage.txt`
|
||
- **操作日志**：`程序目录/OperationLogs/日期/OperationLog.txt`
|
||
|
||
### 11.2 常见异常与处理
|
||
|
||
- **[服务器异常]**
|
||
- 现象：状态栏“服务器异常”，或查询/保存提示失败
|
||
- 排查：检查 `App.config` 连接字符串、SQL Server 服务状态、网络连通性、防火墙
|
||
- **[称重未连接/不更新]**
|
||
- 现象：实时重量不刷新，状态栏显示未连接
|
||
- 排查：检查称重仪表 IP/端口、仪表是否开启 TCP Server、网络是否通、现场交换机端口是否隔离
|
||
- **[打印机离线/打印失败]**
|
||
- 现象：状态栏提示离线，或弹窗“打印失败”
|
||
- 排查：检查打印机 IP、网络、耗材、9100端口是否被策略阻断；必要时用 Ping 验证可达
|
||
- **[重复启动失败]**
|
||
- 现象：提示“程序已运行，不能再次打开！”
|
||
- 处理：在任务管理器中结束旧进程或联系 IT 排查是否有后台残留
|
||
|
||
## 12. 维护与数据安全建议
|
||
|
||
- **[数据库备份]**
|
||
建议 SQL Server 设置每日自动备份，并保留至少 30 天。
|
||
- **[日志清理]**
|
||
NLog 默认保留 60 天，若磁盘压力大可调整 `maxArchiveDays`。
|
||
- **[时间同步]**
|
||
生产追溯依赖时间准确性，建议电脑加入域或配置 NTP 同步。
|
||
- **[网络稳定]**
|
||
称重与打印均依赖局域网；建议独立 VLAN/交换机端口，避免办公网高峰抖动。
|
||
|
||
## 13. 常见问题（FAQ）
|
||
|
||
- **Q：为什么重量显示有时不是两位小数？**
|
||
- A：称重来源可能为浮点值；显示建议使用固定格式（如 `00.00`）。存库建议按业务要求统一四舍五入后再保存。
|
||
- **Q：打印出来二维码内容是什么？**
|
||
- A：二维码包含原料编码、批号、重量（固定格式去掉小数点）、保质期、产地编码与日产量序号，用于后续追溯。
|
||
- **Q：电脑如何开机**
|
||
- A：**==工控机通电后自动开机==，关掉后可以断电，请不要在运行时直接断电，可能会导致工控机损坏**
|
||
|
||
## 14. 版本记录
|
||
|
||
- **V1.0**：初版 SOP（安装/配置/登录/入库/称重打印/历史查询/日志排查）
|