大鹏投控-访客门禁管理系统 使用说明书
系统概述
本系统是大鹏投控企业园区的访客门禁二维码管理系统，对接达实 C3 门禁平台，实现访客预约、员工审批、二维码生成、远程开门、设备授权、门禁刷卡记录查询的全流程管理。
- 系统地址：http://119.145.17.34:5102
- 门禁点位：共 400 个（启用 383 个），覆盖 E座东区通道、E座西区通道、各栋消防梯、电梯厅、大堂门等
- 人脸设备：共 60 台（用于人脸通行授权）
- 远程开门方式：按门名称（doorName）签名远程开门（C3-Plus 签名接口）
相关软件
- 请在浏览器中打开该说明书网站，方便下载相关附件
- 微信版卡片联系 shenzhen2024lyzlyz 获取
- 安卓软件应用 与 电脑软件应用下载链接如下，点击下载即可
一、首页导航
打开系统首页，可以看到五个功能入口卡片：
| 卡片 | 功能 | 说明 |
|---|---|---|
| 访客预约 | 访客自行填写预约信息 | 无需登录，访客直接填写 |
| 员工审批 | 审批预约并生成二维码 | 需管理员登录 |
| 管理后台 | 账户池、一键开门、授权、记录查询、系统设置 | 需管理员登录 |
| 开发者模式 | 批量创建/批量审批测试、二维码测试 | 需管理员登录（仅超级管理员可用） |
| 使用说明书 | 查看在线帮助文档 | 跳转至本文档 |
页面底部显示联系方式（开发联系、电话、微信）和相关链接。
二、访客预约（访客端）
访客无需登录，直接访问系统首页，点击 "访客预约" 卡片进入预约页面。
填写字段说明
| 字段 | 说明 | 必填 |
|---|---|---|
| 访客姓名 | 来访人员的真实姓名 | 是 |
| 访客手机号 | 用于接收通行链接的短信通知 | 是 |
| 来访时间段 | 选择来访的开始和结束时间 | 是 |
| 来访门禁 | 勾选需要通行的门禁点位（可多选） | 是 |
| 经办人 | 选择负责审批的员工 | 是 |
| 来访事由 | 简述来访目的（如：商务拜访、参加会议等） | 否 |
门禁选择
预约页"来访门禁"默认展示人脸设备（刷脸闸机，多选），点击 "＋显示普通门禁设备" 可展开全部普通门锁点位一并勾选。人脸闸机与普通门锁至少选择一种。
提交后
提交预约后，系统生成预约记录，状态为"待审批"。经办人会收到审批通知，审批通过后访客将获得通行二维码。
三、员工审批（管理员端）
管理员登录后，点击首页 "员工审批" 卡片进入审批页面。
审批列表
页面顶部有四个分类标签页：
| 标签 | 说明 |
|---|---|
| 待审批 | 新提交的预约，等待审批 |
| 已通过 | 已审批通过的预约 |
| 已拒绝 | 已审批拒绝的预约 |
| 全部 | 查看所有预约记录 |
审批操作（通过后系统自动完成）
在待审批列表中，每条记录有两个操作按钮：
- 通过：同意预约 → 系统自动完成以下流程：
- 自动分时分配账户：按来访时间段在账户池中查找无冲突的账户；同一账户可在非重叠时段分配给不同访客
- 账户不足自动创建：时段冲突导致无可用账户时，自动创建新门禁账户（ID 以
Leon-开头）并加入账户池 - 授权：对所选门禁按时段授权（到期自动失效）；对人脸设备下发人脸授权（无卡号时自动转人脸授权兜底）
- 生成二维码：调用 C3 接口生成开门二维码与访客访问链接
- 拒绝：拒绝预约 → 状态标记为"已拒绝"
已通过记录操作
每条已通过的记录提供以下操作：
| 操作 | 说明 |
|---|---|
| 点击访问 | 查看访客通行凭证页面（含访客信息和权限信息） |
| 查看二维码 | 跳转到二维码展示页面 |
| 复制访客链接 | 一键复制访客通行链接，可通过微信等发送给访客 |
| 回收账户 | 回收已分配的门禁账户，释放回账户池供下次使用 |
四、访客通行凭证
审批通过后，访客会获得一个专属的通行链接（格式：/visit/预约编号/访问令牌）。打开该链接显示：
- 访客通行凭证页面
- 访客信息（姓名、手机号、来访时间等）
- 权限信息（可通行的门禁点位）
- 二维码（用于门禁扫码通行）
访客到达园区后，在门禁设备上扫描二维码即可通行。
五、一键远程开门（门禁控制）
管理员登录 → 管理后台 → "门禁控制" 标签页。系统共 383 个启用门禁，每个门禁独立一个按钮，按门名称直接远程开门（C3-Plus 签名接口，无需选择人脸设备）。
单个开门
- 在门禁列表中搜索或定位目标门禁，点击该行 "🔴 开门" 按钮
- 开门结果实时显示在下方，成功/失败一目了然
一键打开全部门
- 点击 "🚪 一键打开全部门" 按钮，系统后台并发按门名称逐个开门
- 执行过程实时显示进度（已完成 X/Y · 成功 Z）与逐门结果表格，无需等待页面响应
同步门禁
- 点击 "🔄 同步门禁" 从 C3 拉取全部门禁点位（新增/变更门禁后执行）
提示：远程开门只针对门禁点位；人脸设备用于"刷脸授权通行"，不参与远程开门。
六、设备权限授权（账户授权）
管理员登录 → 管理后台 → "设备权限授权"（账户管理页内）。可对指定账户统一授权门禁通行权限与人脸设备权限，一次提交同时下发。
| 配置 | 说明 |
|---|---|
| 授权账户 | 从账户池选择或输入外部账户编号 |
| 授权模式 | 永久授权 / 分时授权（按时段，到期自动失效） |
| 授权类型 | 授权下发（A）/ 取消授权（D） |
| 授权设备 | 默认人脸设备优先展示（多选）；点"＋显示普通门禁"可展开门锁一并勾选 |
提示：分时授权仅对门禁生效；人脸设备统一为永久授权/取消。
七、管理后台
管理员登录后，点击首页 "管理后台" 卡片进入。管理后台包含多个功能标签页。
7.1 账户管理
管理门禁平台的外部账户池。
账户池：显示所有门禁账户（EmpNo），包括使用状态（已分配/空闲）、分配给谁、分时时段等。每行"查看权限"按钮可弹出窗口实时显示该账户的门禁/人脸授权明细。
账户操作按钮：
- 回收过期账户：一键回收所有分时时段已结束的账户（仍有有效时段的保留），释放回空闲池
- 一键回收全部：回收所有已分配账户（谨慎使用）
- 添加账户：输入员工编号，将新的门禁账户加入账户池
账户分配记录：记录每次账户分配的历史（访客、门禁点位、经办人、时间）。
二维码生成记录：记录每次二维码生成的历史。
7.2 访客查询
访客开门记录查询：输入手机号或姓名搜索访客，查看其账户分配记录，可进一步查看刷卡明细。
外部账号通行记录查询：直接按外部账号编号或姓名（外部系统用户名，多为中文人名）查询该账号的所有通行记录（门禁刷卡 + 人脸通行合并展示），不经过访客归因。
通行证快速展示：输入账户编号直接调取 C3 生成开门二维码并展示通行证。
访客刷卡明细查询：精确查询门禁刷卡记录，支持访客/时间/门禁筛选。
7.3 门禁控制
- 一键远程开门：见本文档"五、一键远程开门"
- 人脸通行记录（实时查询）：按时间/员工编号/设备名称查询 C3 人脸通行记录
- 访客申请页设备显示设置：配置访客预约页展示哪些门禁与人脸设备（可隐藏不需要访客选择的）
7.4 管理员
管理系统管理员账户：创建管理员、启用/禁用、设置"可审批"权限（决定访客预约页经办人下拉选项）。
7.5 站点设置
自定义系统外观：首页自定义卡片、页面标题、主题配色（5 种）、微信分享卡片（OG 标签）、底部页脚、版权信息。
八、开发者模式（测试用）
管理员登录后，首页点击 "开发者模式" 卡片进入（或访问 /dev，仅超级管理员可用）。用于测试与演示，包含开发者专用内容：
| 功能 | 说明 |
|---|---|
| 批量创建申请 | 设置数量、访客前缀、门禁/人脸多选、时段，后台批量创建预约并实时打印过程日志 |
| 批量通过 | 一键批量审批（全部待审批 / 本次创建的），实时查看每一步（账户分时分配、自动创建 Leon- 账户、授权、二维码生成） |
| 本次创建结果 / 二维码测试 | 列表展示本次创建的预约，可点"显示二维码"查看任一账户的开门二维码进行扫码测试 |
| 一键收回授权 | 二维码旁"一键收回授权"按钮：取消该账户门禁/人脸授权、自动创建的 C3 账户离职、本地回收账户 |
| 最近任务 | 最近运行的批量任务与日志回看 |
提示：系统自动创建的访客账户编号均以
Leon-开头，用于区分系统创建与外部账户。
九、常见问题
Q1：访客预约后如何获取通行二维码？
经办人审批通过后，系统自动生成二维码。访客会收到通行链接，点击即可查看二维码。经办人也可通过"复制访客链接"按钮将链接发送给访客。
Q2：二维码可以放大查看或导出吗？
可以。在二维码展示页面，点击 "放大二维码" 按钮可全屏查看，点击 "导出标签卡片" 可将二维码导出为 PNG 图片。
Q3：账户池是什么？账户不够怎么办？
账户池是门禁平台（C3）的预置账户集合。审批通过后系统自动分时分配一个空闲账户给访客（同一账户可在不同非重叠时段分配给多位访客）。当所有账户时段冲突时，系统会自动创建新账户（编号 Leon-+时间戳）并授权，保证审批一定成功。回收账户后该账户重新变为"空闲"。
Q4：如何回收账户？
两种方式：单个预约在审批页点"回收账户"；批量可在管理后台账户池点"回收过期账户"（仅回收时段已结束的）或"一键回收全部"。
Q5：如何远程开某道门？
管理员登录 → 管理后台 → 门禁控制 → 搜索定位该门禁 → 点该行"🔴 开门"按钮，系统按门名称直接远程开门。
Q6：如何修改首页的卡片 / 更换主题？
管理员登录 → 管理后台 → 站点设置 → 在"首页自定义卡片"或"主题配色"区域编辑并保存。
Q7：审批人（经办人）是谁？
在"管理员"标签页中设置了"可审批"权限的管理员。访客预约时经办人下拉框只显示已启用且可审批的管理员。
Q8：如何查询某个人（按姓名）的通行记录？
管理后台 → 访客查询 → 外部账号通行记录查询 → 输入姓名（如"张三"）查询，系统自动按姓名匹配外部账号并合并展示其门禁刷卡与人脸通行记录。
Q9：人脸设备能远程开门吗？
不能。人脸设备（刷脸闸机）用于"人脸授权"后刷脸通行；远程开门仅针对门禁点位，按门名称开门。如需给人脸设备授权，在"设备权限授权"中选择人脸设备下发即可。
Q10：如何分享系统链接到微信？
系统已配置微信分享卡片（OG 标签），可在站点设置中自定义分享标题、描述和图片。分享后微信会自动展示卡片样式。