From a392895ee5e26173578ed85b89795dc73d245ae7 Mon Sep 17 00:00:00 2001
From: lion <120344285@qq.com>
Date: Wed, 29 Oct 2025 13:12:54 +0800
Subject: [PATCH] =?UTF-8?q?=E8=B0=83=E6=95=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 使用手册.md | 317 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 317 insertions(+)
 create mode 100644 使用手册.md

diff --git a/使用手册.md b/使用手册.md
new file mode 100644
index 0000000..9cf28db
--- /dev/null
+++ b/使用手册.md
@@ -0,0 +1,317 @@
+# 访客核销系统 使用手册
+
+## 一、系统概述
+
+迈柯唯访客核销系统是一个专门用于门岗访客管理的信息化系统，支持H5浏览器版本和Android APK版本。系统主要用于访客信息查询、核销、登记等功能，实现访客进出厂区的数字化管理。
+
+### 主要功能
+- ✅ 访客信息查询与核销
+- ✅ 身份证自动读取（H5版本）
+- ✅ 访客信息录入与更新
+- ✅ 车辆照片上传
+- ✅ 访客列表查看
+- ✅ 多平台支持（H5/APK）
+
+---
+
+## 二、系统登录
+
+### 2.1 访问方式
+
+**H5版本：**
+- 在浏览器中输入系统地址
+- 系统会自动检查登录状态
+- 未登录会自动跳转到登录页面
+
+**APK版本：**
+- 安装APK应用后打开
+- 首次使用需要登录
+
+### 2.2 登录操作
+
+1. 输入用户名和密码
+2. 点击"立即登录"按钮
+3. 系统验证成功后自动跳转到主页面
+
+---
+
+## 三、主界面操作
+
+### 3.1 界面布局
+
+主界面包含以下部分：
+
+#### 📌 头部导航
+- **访客列表**：点击可查看当前日期的访客记录
+
+#### 📝 查询表单
+包含以下几个查询字段：
+
+| 字段 | 类型 | 说明 | 必填 |
+|------|------|------|------|
+| 拜访日期 | 日期选择器 | 开始日期至结束日期 | ✅ |
+| 核验销码 | 输入框 | 访客二维码编号 | ✅ 三选一 |
+| 身份证件 | 输入框 | 身份证号码 | ✅ 三选一 |
+| ID卡 | 输入框 | 员工ID卡号 | ✅ 三选一 |
+
+**重要提示：** 三种查询方式（核验销码、身份证件、ID卡）需至少填写一项
+
+### 3.2 H5版本特殊功能
+
+#### 🔍 身份证读取功能
+1. 确保已连接身份证读卡器设备
+2. 在"身份证件"输入框右侧点击"查询身份证"按钮
+3. 系统自动读取身份证信息并填充到输入框
+4. 读取成功后自动触发查询
+
+**使用环境：**
+- 仅限H5版本
+- 需要安装身份证读卡器驱动
+- 读卡器需正确连接到电脑USB接口
+
+---
+
+## 四、查询访客信息
+
+### 4.1 查询步骤
+
+1. **设置查询日期**
+   - 点击"拜访日期"输入框
+   - 选择开始日期和结束日期
+   - 系统默认设置为当天
+
+2. **选择查询方式（三选一）**
+   
+   **方式一：核验销码**
+   - 输入访客二维码编号
+   - 支持扫码输入
+
+   **方式二：身份证件（H5版本）**
+   - 手动输入身份证号码，或
+   - 点击"查询身份证"按钮自动读取
+
+   **方式三：ID卡**
+   - 输入员工ID卡号
+
+3. **点击查询**
+   - 点击"查询"按钮
+   - 系统显示查询结果
+
+### 4.2 查询结果处理
+
+**查询成功的访客状态：**
+- ✅ **通过(待进厂)**：可进行核销操作
+- ✅ **已进厂**：可进行离厂核销
+
+**其他状态：**
+- ⭕ 其他状态的访客无法进行核销操作
+- 系统会显示当前状态提示
+
+---
+
+## 五、访客信息弹窗
+
+### 5.1 信息展示
+
+查询成功后，系统会弹出"访客信息"弹窗，包含以下信息模块：
+
+#### 📋 拜访信息
+- 拜访类型（普通访客/施工访客/物流车辆）
+- 拜访日期范围
+- 到访时段
+- 前往区域
+- 到访事由
+- 到访车辆信息
+- 车辆类型
+
+#### 👤 拜访人信息
+- 姓名
+- 联系电话
+- 证件类型和号码
+- 单位名称
+- CDA编号
+
+#### 👥 随访人员信息（如有）
+- 姓名、联系电话
+- 证件类型和号码
+- 多条记录会分隔显示
+
+#### 🏢 被访人信息
+- 被访人姓名
+- 陪同人（如有）
+- 收货人（如有）
+- 当前状态
+
+### 5.2 信息录入/编辑
+
+在弹窗底部可进行以下操作：
+
+#### 📝 ID卡输入
+- 输入人员ID卡号
+- 用于员工身份识别
+
+#### 📝 备注信息
+- 输入备注说明
+- 支持多行文本输入
+
+#### 📸 车辆照片上传（仅物流车辆）
+- 点击"+添加照片"按钮
+- 选择拍摄方式：
+  - **选择照片**：从手机相册选择
+  - **拍照**：使用相机拍摄
+- 最多支持上传9张照片
+- 可删除已上传的照片
+- 点击照片可预览大图
+
+### 5.3 底部操作按钮
+
+- **关闭**：关闭弹窗，不保存任何修改
+- **更新并核销**：保存修改并完成核销操作
+
+**操作流程：**
+1. 填写或修改ID卡、备注、照片等信息
+2. 点击"更新并核销"按钮
+3. 系统自动更新信息
+4. 更新成功后自动执行核销
+5. 核销完成后自动关闭弹窗
+
+---
+
+## 六、核销流程说明
+
+### 6.1 核销规则
+
+**进厂核销（状态：通过(待进厂)）**
+- 当访客状态为"通过(待进厂)"时
+- 点击"更新并核销"按钮
+- 系统自动将状态更新为"已进厂"
+
+**离厂核销（状态：已进厂）**
+- 当访客状态为"已进厂"时
+- 点击"更新并核销"按钮
+- 系统完成离厂核销操作
+
+### 6.2 核销注意事项
+
+1. **必须填写日期范围**
+   - 确保查询日期准确
+
+2. **至少提供一种查询信息**
+   - 核验销码、身份证件、ID卡至少填写一项
+
+3. **状态限制**
+   - 只有"通过(待进厂)"和"已进厂"状态的访客可以进行核销
+   - 其他状态需要先完成相应流程
+---
+
+## 七、访客列表查看
+
+### 7.1 查看步骤
+
+1. 点击主页头部"访客列表"按钮
+2. 系统显示当前选择日期范围的所有访客记录
+3. 列表固定在顶部的列标题：
+   - **姓名**
+   - **被访人**
+   - **状态**
+
+### 7.2 列表功能
+
+- **列标题**：固定在顶部，滚动时保持可见
+- **状态标签**：不同颜色表示不同状态
+- **空状态**：无访客记录时显示"暂无访客记录"
+- **关闭**：点击"关闭"按钮退出列表
+
+---
+
+## 八、状态说明
+
+系统中有以下访客状态：
+
+| 状态 | 说明 | 可操作 |
+|------|------|--------|
+| 🟠 待学习 | 访客需要完成安全学习 | ❌ |
+| 🔵 待审核 | 访客申请待审核 | ❌ |
+| 🟢 通过(待进厂) | 审核通过，等待进厂 | ✅ 可核销 |
+| 🔴 驳回 | 访客申请被驳回 | ❌ |
+| 🟢 已进厂 | 已进入厂区 | ✅ 可核销 |
+| ⚫ 已离厂 | 已完成离厂核销 | ❌ |
+| ⚫ 已取消 | 访客已取消访问 | ❌ |
+
+---
+
+## 九、系统环境差异
+
+### H5版本（浏览器）
+- ✅ 支持身份证自动读取
+- ✅ 支持"查询身份证"按钮
+- ✅ 身份证输入框占用70%宽度
+- ✅ 右侧显示查询按钮
+- ✅ 适合桌面电脑使用
+
+### APK版本（Android）
+- ❌ 不支持身份证读卡器
+- ❌ 不显示"查询身份证"按钮
+- ✅ 身份证输入框占用100%宽度
+- ✅ 适合移动设备使用
+- ✅ 支持相机拍照上传
+
+---
+
+## 十、常见问题
+
+### Q1: 为什么查询不到访客信息？
+**A:** 请检查以下几点：
+- 输入的信息是否正确
+- 选择的日期范围是否正确
+- 访客状态是否为"通过(待进厂)"或"已进厂"
+
+### Q2: 身份证读取失败怎么办？
+**A:** 
+- 确保读卡器已正确连接
+- 检查设备驱动是否安装
+- 确认身份证放置在正确位置
+- 可手动输入身份证号码
+
+### Q3: 如何上传车辆照片？
+**A:**
+- 仅在"物流车辆"类型时显示上传功能
+- 点击"+添加照片"按钮
+- 选择"选择照片"或"拍照"
+- 最多可上传9张
+
+### Q4: 查询后显示错误状态？
+**A:**
+- 访客可能处于"待审核"、"驳回"等状态
+- 需要先在管理后台完成相应流程
+- 只有"通过(待进厂)"和"已进厂"状态才能核销
+
+### Q5: 为什么"更新并核销"按钮不可用？
+**A:**
+- 可能正在处理中，请稍候
+- 确保网络连接正常
+- 检查是否处于更新状态
+
+### Q6: APK版本如何安装？
+**A:**
+- 下载APK安装包到手机
+- 在手机设置中允许"未知来源"安装
+- 点击APK文件进行安装
+
+---
+
+## 十一、技术支持
+
+如遇到问题，请联系系统管理员或技术支持团队。
+
+**系统地址：** https://visitor-test.ali251.langye.net
+
+---
+
+## 十二、版本信息
+
+- 系统版本：v1.0
+- 更新日期：2025年
+- 支持平台：H5、Android
+- 开发框架：uni-app + uView UI
+