# 访客核销系统 使用手册

## 一、系统概述

迈柯唯访客核销系统是一个专门用于门岗访客管理的信息化系统，支持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