# FATrace.App 用户操作手册（SOP）

 ## 1. 文档说明

 - **适用范围**
   称重客户端，用于原料入库、称重打印、消耗记录入库与历史数据查询。
 - **目标读者**
   产线操作员、确认者/班组长、IT 运维。
 - **术语约定**
   - **入库重量/剩余重量**：单位为 **Kg**。
   - **称重重量**：单位为 **g**。
   - **内袋二维码**：打印在内袋标签上的二维码内容（系统生成）。

 ## 2. 系统概述

 称重客户端用于在产线对特定原料进行：

 - **原料入库建档**：录入批号、保质期、入库重量（Kg），形成一条“分拆中”的原料记录。

 - **实时称重 + 打印内袋二维码**：从称重仪表获取稳定重量（g），生成二维码并调用斑马打印机打印标签。

 - **消耗记录入库**：每次打印成功后写入使用记录，并更新该原料剩余重量。

 - **历史数据查询**：按日期范围、原料名称/编码关键字、批号查询消耗明细。

   ![image-20260116144602471](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116144602471.png)

 ## 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 页面”组成。

![image-20260116145200152](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145200152.png)

 ### 6.1 左侧导航栏

 - **主界面**：进入生产主页面（需要已登录）
 - **历史数据**：进入历史查询页面
 - **用户登录**：进入登录页面
 - **退出**：关闭程序

 ### 6.2 右侧页面

 - **生产主页面**：原料选择、入库信息录入、实时称重显示、打印与剩余重量显示

   ![image-20260116145253025](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145253025.png)

 - **用户登录页面**：确认者/操作者登录

   ![image-20260116145313862](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145313862.png)

 - **历史数据页面**：按条件查询并显示 `RawProUse` 历史记录

   ![image-20260116145330211](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145330211.png)

 ### 6.3 状态栏（底部）

![image-20260116145400609](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145400609.png)

 - **用户**：显示当前确认者用户
 - **称重状态**：称重仪表连接/通信状态
 - **服务器通信状态**：数据库心跳状态
 - **打印机状态**：打印机在线/离线状态

 ## 7. 角色与权限（业务规则）

 ### 7.1 登录角色

 - **确认者用户**：用于确认生产记录的责任人（系统登录校验账号）
 - **操作者用户**：用于记录实际操作人（当前版本为文本输入，不做账号校验）

 ### 7.2 用户来源

 系统登录会在数据库表 `TbUser` 中按 `UserName` 查询并校验密码。

 - **账号不存在**：提示“当前用户不存在！”
 - **密码错误**：提示“密码错误！”
 - **登录成功**：提示“登录成功！”并切换到主界面

 ## 8. 日常操作 SOP（产线操作员）

 ### 8.1 开机前检查（每日/每班）

> **==图片示例：称重连接失败，打印机未正常连接==**
>
> ![image-20260116145400609](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145400609.png)

 - **[数据库连接]**
   状态栏“服务器通信状态”应显示“服务器正常”。
   
 - **[称重仪表]**
   状态栏“称重状态”应显示“称重已连接/称重通讯正常”。
   
 - **[打印机]**
   状态栏“打印机状态”应显示“打印机在线”。
   
 - **[标签耗材]**
   确认打印机纸张/碳带充足，标签尺寸与模板匹配。
   
   
   
   ***==确保4个设备连接正常（绿色展示）==***
   
   

 ### 8.2 登录（必须）

 1. 点击左侧 **用户登录**。

 2. 输入：
    - 确认者用户名
    - 操作者用户名
    - 密码（校验确认者账号）

 3. 点击 **登录**。

 4. 登录成功后进入主界面；状态栏显示“确认者用户：xxx”。

    ![image-20260116145846017](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145846017.png)

 ### 8.3 选择原料（开始生产前）

 1. 在主页面左上区域点击原料按钮。

    ![image-20260116145926213](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116145926213.png)

    ***注意：***

    **==在拆包分小包之前要确认当前是哪种原料，您可以点击对应的添加剂进行选中操作==**

    **==在你选中后一个原料后，系统会根据选中原料查询之前是否有大包未使用完毕的添加剂，如果有的话，直接在之前未使用完毕的原料上继续分拆操作，可以开始称重操作==**

    **==否则您需要新填写一个原料信息，如下：==**

    ![image-20260116151640708](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116151640708.png)

    **==上面信息填写完毕后，请点击【确认】按钮，代表一个新的原料开始要拆分使用了==**

    **==如果当前原料还剩余很多但是因为一些其他的原因不能再使用了，需要使用另一包开始拆分使用，那么您可以点击【清零当前原料】清空当前原料信息，然后进行新原料的输入操作==**

    

 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. 返回后可重新选择原料并重新建档。

    ![image-20260116154854918](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116154854918.png)

    

### 8.9 用户的管理（在工作站上操作）

因为当前是工控机是触控电脑，没有鼠标，不方便输入一些姓名和文字等信息，所以把当前的确认者和操作者的一些增加、修改、删除等操作放到工作站上进行管理，具体操作说明请见服务器侧【UserManual.pdf】

![image-20260116160606467](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116160606467.png)

 ## 9. 历史数据查询 SOP（班组长/质检/追溯）

 ### 9.1 进入历史数据页面

 点击左侧 **历史数据**。

 ### 9.2 查询条件说明

 - **开始时间/结束时间**：按日期选择，系统按整日（00:00:00 至 23:59:59）进行查询
 - **原料名称**：下拉可选，也可手工输入；支持按原料名称或原料编码关键字模糊匹配
 - **批号**：精确匹配（输入完整批号）

 ### 9.3 执行查询

![image-20260116160635748](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116160635748.png)

 点击 **查询**，结果显示在表格中。

 列头已转换为中文（如：原料编号、称重重量(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（安装/配置/登录/入库/称重打印/历史查询/日志排查）