初期稳定版本260119

FATrace.WPLApp/Report/UserManual.md

@@ -1,12 +1,12 @@
-# FATrace 用户说明书（WPLApp）
+# 称重产线系统用户说明书
 
-版本：v1.0 适用模块：FATrace.WPLApp（桌面应用）
+版本：v1.0 适用模块：（桌面应用）
 
 ![image-20260113113929437](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260113113929437.png)
 
 ## 1. 简介
 
-FATrace 是一套用于食品添加剂生产过程追溯与运行监控的桌面应用。WPLApp 负责生产端的日常使用，包括：
+称重产线系统是一套用于食品添加剂生产过程追溯与运行监控的桌面应用。客户端负责生产端的日常使用，包括：
 
 - 实时运行信息查看与统计总览（Dashboard）
 - 历史报警查询（History Alarm）
@@ -34,6 +34,8 @@ FATrace 是一套用于食品添加剂生产过程追溯与运行监控的桌面
 
 如启动失败、页面空白或频繁报错，请联系系统管理员检查运行环境与数据库连接配置。
 
+电脑的登录密码默认是：123456
+
 ## 3. 登录与账号
 
 - 打开左侧菜单“用户登录”进入登录页。
@@ -44,7 +46,7 @@ FATrace 是一套用于食品添加剂生产过程追溯与运行监控的桌面
 
 - 登录成功后自动导航到 Dashboard；底部状态栏将显示“当前用户：已登录”。
 
-注意：请妥善保管账号信息。若忘记密码，请联系管理员重置。
+注意：请妥善保管账号信息。若忘记密码，请联系管理员重置。初始默认用户和密码都是：123
 
 ## 4. 主界面与导航
 
@@ -166,7 +168,13 @@ Dashboard 提供生产运行的概览信息，包括：
 
 ![image-20260113114357676](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260113114357676.png)
 
-本功能用于读取QR系统FTP每天生成的 Excel 文件（多 Sheet），并将各 Sheet 数据分别存入数据库表，同时将文件移动到归档目录，便于对账与追溯。
+==**本功能用于云服务管理系统FTP每天生成的 Excel 文件（多 Sheet），并将各 Sheet 数据分别存入数据库表，同时将文件移动到归档目录，便于对账与追溯。**==
+
+==**系统每个小时进行FTP下载的Excel文件检测，检测到文件后进行数据保存到数据库供查询使用，然后把数据归档到【D:\Archive】中保存**==
+
+![image-20260116162637789](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116162637789.png)
+
+既是：整个系统的数据在除了云端保存外，本地数据库和文件也会备份保存供使用
 
 ### 10.1 文件放置与命名规则
 
@@ -178,6 +186,10 @@ Dashboard 提供生产运行的概览信息，包括：
 
 ### 10.2 配置项说明（App.config）
 
+> [!IMPORTANT]
+>
+> ==建议工程师进行更改配置==
+
 配置文件位置：`FATrace.WPLApp/App.config`（部署后为程序同目录的配置文件）。
 
 - `ExcelImportSourceDir`
@@ -187,9 +199,9 @@ Dashboard 提供生产运行的概览信息，包括：
   - Excel 文件归档目录。
   - 导入完成后，程序会将源文件移动到该目录。
 
-### 10.3 Sheet 与数据表映射
+### 10.3 Sheet 与数据表映射（约定规则，使用者无需关注）
 
-Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下列规则导入：
+FTP下载的Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下列规则导入：
 
 - 工厂-入库 → `FactoryInbound`
 - 工厂-领料 → `FactoryMaterialWithdrawal`
@@ -204,8 +216,17 @@ Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下
 注意：
 
 - 导入时从每个 Sheet 的第 2 行开始读取（第 1 行为表头）。
+
 - 如果整行为空会被跳过。
 
+  
+
+  **Excel中Sheet**
+
+![image-20260116163023848](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163023848.png)
+
+
+
 ### 10.4 重复导入与归档规则
 
 - **防重复**：当 `FileImportLog` 表中已存在相同文件名且状态为 `Success` 的记录时，该文件会被跳过，不会重复导入。
@@ -213,12 +234,18 @@ Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下
 
 ## 11. 文件导入日志
 
+![image-20260116163222065](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163222065.png)
+
+
+
 入口：左侧菜单 → 数据管理 → 文件导入日志。
 
 用途：用于查看每次 Excel 文件导入的执行情况，便于定位导入失败原因与核对数据。
 
 日志字段说明：
 
+每次检测到文件时都会产生一个【文件导入日志】供查询使用
+
 - **文件名**：导入的 Excel 文件名。
 - **开始时间/结束时间**：导入流程的起止时间。
 - **状态**：`Success` / `Failed` / `Running`。
@@ -234,44 +261,118 @@ Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下
 
 ## 12. 工厂/OEM 数据查询
 
+![image-20260116163347396](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163347396.png)
+
 入口：左侧菜单 → 工厂/OEM 数据查询。
 
-说明：这些页面展示的是 Excel 导入后的数据（字符串字段为主），主要用于“展示、对账、追溯”。
+说明：这些页面展示的是 Excel 导入后的数据，主要用于“展示、对账、追溯”。
 
 ### 12.1 工厂数据
 
 - 工厂-入库
-  - 条件：产地、原料代码、原料名称、登录日期范围（基于 `LoginDateTime`）。
+  - 条件：产地、原料代码、原料名称、登录日期范围。
+  
+    ![image-20260116163754198](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163754198.png)
+  
+    内容区域的上侧为查询条件，你可以根据需要输入查询的条件，然后点击【查询】，然后下方的表格就会展示信息。
+  
+    较多数据展示时会分页展示，您可以切换到指定的页码进行查看分析
+  
+    
+  
 - 工厂-领料
-  - 条件：产地、原料代码、原料名称、登录日期范围（基于 `LoginDateTime`）。
+  - 条件：产地、原料代码、原料名称、登录日期范围。
+  
+    ![image-20260116163811495](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163811495.png)
+  
 - 工厂-出入库
-  - 条件：产地、原料代码、原料名称、入库时间日期范围（基于 `InTime`）。
+  - 条件：产地、原料代码、原料名称、入库时间日期范围。
+  
+    ![image-20260116163824509](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163824509.png)
+  
 - 工厂-原料生产信息
-  - 条件：原料编号、原料名称、批号、称重时间日期范围（基于 `WeightTime`）。
+  - 条件：原料编号、原料名称、批号、称重时间日期范围。
+  
+    ![image-20260116163838905](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163838905.png)
+  
 - 工厂-成品出库
-  - 条件：产地、原料代码、原料名称、批号、登录日期范围（基于 `LoginDateTime`）。
+  - 条件：产地、原料代码、原料名称、批号、登录日期范围。
+  
+    ![image-20260116163851927](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163851927.png)
 
 ### 12.2 OEM 数据
 
 - OEM-入库
-  - 条件：产地、原料代码、原料名称、批号、登录日期范围（基于 `LoginDateTime`）。
+  - 条件：产地、原料代码、原料名称、批号、登录日期范围。
+  
+    ![image-20260116163904147](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163904147.png)
+  
 - OEM-出库
-  - 条件：产地、原料代码、原料名称、批号、登录日期范围（基于 `LoginDateTime`）。
+  - 条件：产地、原料代码、原料名称、批号、登录日期范围。
+  
+    ![image-20260116163915264](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163915264.png)
+  
 - OEM-出入库
-  - 条件：产地、原料代码、原料名称、入库时间日期范围（基于 `InTime`）。
+  - 条件：产地、原料代码、原料名称、入库时间日期范围。
+  
+    ![image-20260116163923134](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163923134.png)
+  
 - OEM-原料使用信息
-  - 条件：内袋二维码、原料代码、原料名称、产地、原料使用时间日期范围（基于 `RawUseTime`）。
+  - 条件：内袋二维码、原料代码、原料名称、产地、原料使用时间日期范围。
 
-注意：以上页面的日期条件会对字符串时间字段做数据库端转换比较（例如 `TRY_CONVERT(datetime, LoginDateTime)`）。若 Excel 中日期格式不规范，可能导致该条数据无法被日期条件命中。
+注意：以上页面的日期条件会对字符串时间字段做数据库端转换比较。若 Excel 中日期格式不规范，可能导致该条数据无法被日期条件命中。
 
-## 13. 常见操作流程
+## 13. 用户管理
+
+![image-20260116171719902](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116171719902.png)
+
+入口：左侧菜单 → 系统 → 用户管理。
+
+功能说明：
+
+- 对登录 WPLApp 桌面应用的用户进行管理（增删改查）。
+- 支持设置用户权限等级（管理员、操作员、访客）。
+- **注意**：仅管理员权限账号可进行编辑操作。
+
+操作步骤：
+
+1. **查询**：输入用户名或选择等级，点击“查询”。
+2. **新增**：点击“新增”，填写用户名、密码与等级，保存。
+3. **编辑**：选中列表中的用户，点击“编辑”修改信息。
+4. **删除**：选中列表中的用户，点击“删除”（无法删除当前登录用户）。
+
+## 14. 称重用户管理
+
+![image-20260116171738944](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116171738944.png)
+
+入口：左侧菜单 → 系统 → 称重用户。
+
+功能说明：
+
+- 对生产端 FATrace.App 称重程序的用户进行管理。
+- 称重端采用双人复核登录模式，因此包含“确认者”与“操作者”两个角色字段。
+- **注意**：仅管理员权限账号可进行编辑操作。
+
+操作步骤：
+
+1. **查询**：输入确认者或操作者名称，点击“查询”。
+2. **新增**：点击“新增”，填写确认者、操作者姓名与密码，保存。
+3. **编辑**：选中列表中的用户，点击“编辑”修改信息。
+4. **删除**：选中列表中的用户，点击“删除”。
+
+## 15. 常见操作流程
 
 - 开机与登录：启动应用 → 进入“用户登录” → 登录成功 → 自动跳转至 Dashboard。
+
+  ![](C:\Users\chong\AppData\Roaming\Typora\typora-user-images\image-20260116163633224.png)
+
 - 查询生产数据：进入“原料使用查询/原料入库查询” → 设置条件 → 查询 → 需要时导出 Excel。
+
 - 导入外部 Excel：将 `.xlsx` 文件放入 `ExcelImportSourceDir` 目录 → 等待系统后台导入 → 到“文件导入日志”确认状态为 `Success` → 如需对账，使用“工厂/OEM 数据查询”查看导入数据。
+
 - 报警定位与复盘：在“历史报警”中按时间段和关键字查询，结合现场记录进行处理与复盘。
 
-## 14. 常见问题与排查
+## 16. 常见问题与排查
 
 - 无法登录：
   - 确认用户名、密码输入正确；
@@ -308,24 +409,24 @@ Excel 中各 Sheet 必须使用固定名称（中文 Sheet 名），系统按下
   - 检查数据库是否可写；
   - 关注应用日志，必要时联系管理员。
 
-## 15. 使用技巧
+## 17. 使用技巧
 
 - 登录页支持“回车键”快捷登录。
 - 关注底部状态栏的用户与 PLC 状态，能快速判断系统是否处于可用状态。
 - 发生导入问题时优先查看“文件导入日志”，比直接看数据库更直观。
 
-## 16. 安全与权限
+## 18. 安全与权限
 
 - 账号仅限本人使用，请勿外借与分享。
 - 退出离岗前可在“用户登录”页切换用户（如需要可联系管理员提供退出功能）。
 - 如需更细粒度权限（基于岗位/等级），请与管理员沟通后续版本规划。
 
-## 17. 版本与更新
+## 19. 版本与更新
 
 - 本说明书适配当前应用版本的已上线功能。新增功能或 UI 调整将另行更新说明。
 - 如需升级或安装补丁，请联系系统管理员统一安排。
 
-## 18. 反馈与支持
+## 20. 反馈与支持
 
 - 使用中如遇到界面异常、统计不准、报警缺失、导入失败等问题：
   - 记录问题发生时间、操作步骤、界面提示；