# scan_pywebview

**Repository Path**: xujianwei151/scan_pywebview

## Basic Information

- **Project Name**: scan_pywebview
- **Description**: 扫描条码工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-28
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**📖 扫描条码小工具操作文档**

**1\. 项目概述**

​**扫描条码小工具**​ 是一款用于管理条码扫描数据的桌面应用。Admin管理员可进行用户管理和数据导入，普通用户则专注于条码扫描操作。

​**核心功能**​：

- ​**Admin管理员**​：用户管理（新增、删除、修改）、Excel数据上传、
- ​**普通用户**​：扫描条码、修改个人信息。
- ​**技术栈**​：
    - ​**前端**: Vite, Vue3, Vue-Router, Pinia, Element-Plus, ECharts
    - ​**后端**: PyWebView, SQLite
    - ​打包: PyInstaller

**2\. 快速开始**

**2.1 安装与运行**

- ​**启动应用**​：在桌面找到并运行 "浦江联通_农行服务SN核对.exe"。

**2.2 首次登录**

- 系统预置了 ​**Admin 和值班账号,**，请使用以下凭证登录：
    - ​**用户名**​：用户姓名拼音
    - ​**初始密码**​：123
    - **管理员初始密码**​：1111Aa\*
- ​**普通用户**账号需由 Admin 管理员创建后分配。

**3\. 用户操作指南**

**3.1 Admin 管理员功能**

**3.1.1 用户管理**

- ​**新增用户**​：
    - 点击导航栏的【用户管理】。
    - 点击【新建用户】按钮。
    - 填写用户名、真实姓名、密码、邮箱，并选择角色（普通用户）。
    - 点击【确认】保存。
- ​**删除用户**​：
    - 在用户列表中找到要删除的用户。
    - 点击该行操作列中的【删除】按钮。
    - 在弹出确认框中点击【确认】。
- **编辑用户**​：
    - 在用户列表中找到要编辑的用户。
    - 点击该行操作列中的【编辑】按钮。
    - 编写用户名、真实姓名、密码、邮箱，角色
    - 在弹出确认框中点击【确认】。

⚠️ ​**注意**​：无法删除当前已登录的 admin 自身账户。

**3.1.2 上传 Excel 数据**

- 点击导航栏的【上传SN】。
- 点击【选择Excel文件】。​**请确保Excel表格的列包含：条码号、机柜号、配置项（目前数据库只针对这3列,跳过第一行表头数据）**。
- 文件选择成功后，点击【确认上传】。
- 系统会解析数据并显示预览。确认无误后，点击【确认导入】将数据存入数据库。
- 上传成功或失败都会有提示信息。

**3.1.3 查看数据统计**

- 点击导航栏的【首页】。
- 此处通过图表展示扫描总量、今日扫描量、数据趋势等（由ECharts渲染）,admin用户新增最近12个月上架趋势。

<div align="center">
  <img  width="92%" style="border-radius:10px;margin-top:20px;margin-bottom:20px;box-shadow: 2px 0 6px gray;" src="https://gitee.com/xujianwei151/scan_pywebview/raw/master/img/1.png" />
</div>



**3.2 普通用户功能**

**3.2.1 扫描条码**

- 登录后首页即打开扫描管理。
- 听到"嘀"声，表示识别成功,会弹出以下对话框，确认没问题，按回车键直接确认，扫描数据（条码信息、扫描时间、扫描用户）会自动保存，空格键取消。

<div align="center">
  <img  width="92%" style="border-radius:10px;margin-top:20px;margin-bottom:20px;box-shadow: 2px 0 6px gray;" src="https://gitee.com/xujianwei151/scan_pywebview/raw/master/img/2.png" />
</div>
- 可在【扫描下方】中查看当前用户的历史记录。
- 当出现多个机房同时上架，用户在客户提供的纸质单完成核对，在登录自己用户到SN管理进行手动核对确认。
<div align="center">
  <img  width="92%" style="border-radius:10px;margin-top:20px;margin-bottom:20px;box-shadow: 2px 0 6px gray;" src="https://gitee.com/xujianwei151/scan_pywebview/raw/master/img/3.png" />
</div>
6．高级筛选目前只做了SN号和机柜U位号的模糊匹配

7\. 个人中心进行个人用户信息密码修改

**4\. 故障排除（FAQ）**

| **问题现象** | **可能原因及解决方案** |
| --- | --- |
| 未查询到SN | 1\. SN管理查看SN号是否已经上传。  <br>2\. SN号是否扫错(大小写问题)。 |
| 登录失败 | 1\. 检查用户名和密码是否正确。  <br>2\. 联系Admin管理员确认账号是否被删除或权限有误。 |
| Excel表格上传失败 | 1\. 检查文件格式是否为 .xlsx 或 .xls。  <br>2\. 检查文件是否被其他程序打开。  <br>3\. 检查表格列名和格式是否符合系统要求。 |

**文档更新记录**​

| **版本** | **更新日期** | **更新内容** | **更新人** |
| --- | --- | --- | --- |
| V1.0 | 2025-09-25 | 初始版本创建 | **许建伟** |