二维码与通行凭证 · 访客门禁管理系统展示说明书架构日志
第 10 章

📄二维码与通行凭证

页面

审批通过后自动生成二维码。系统里有两个视角的二维码页面,用途不同。


两个页面的区别

页面 谁用 特点
/qr/<id> 经办人 信息全:二维码 + 门禁 + 账户 + 导出标签卡片 + 复制链接
/visit/<id>/<token> 访客本人 信息精简:二维码 + 有效期 + 通行门禁 + 接待人

两个页面都有实时倒计时。


倒计时状态

页面顶部会显示二维码的有效状态:

显示 颜色 含义
距生效还有 N 天 HH:MM 紫色 还没到来访时间,二维码暂不可用
距离失效还有 N 天 HH:MM:SS 蓝色 正在有效期倒计时
距离失效还有 HH:MM:SS 橙色 不足 1 小时,尽快通行
已过期 红色 已超过来访时段,二维码失效

倒计时每秒刷新,不用手动刷新页面。


经办人视角(/qr)

审批人二维码页

四个操作

按钮 作用
放大二维码 全屏显示,方便给访客看;按 ESC 或点任意处关闭
导出标签卡片 导出整张卡片为 PNG,可打印贴在访客证上
复制访客链接 复制访客专属链接,微信直接发给访客
复制二维码内容 复制二维码原始内容

展示的信息

访客姓名、倒计时、二维码、手机号、来访时段、门禁点位、人脸闸机、经办人、平台账户编号、二维码生成时间。


访客视角(/visit)

访客用手机打开专属链接看到的页面。

三种状态

状态 显示
等待审批 ⏳ 尚未通过审批 + 刷新重试按钮
正常 倒计时 + 二维码 + 有效期 + 可通行门禁 + 接待人
已过期 ⏰ 凭证已过期,二维码已失效 + 刷新重试

访客页的三个人性化细节

  • 手机号脱敏:只显示 138****8000,转发链接也不怕泄露完整号码
  • 门禁太多时折叠:超过 5 个只显示前 5 个 + 总数,点「展开全部」再看全
  • 提前打开显示「尚未生效」:还没到来访时间会明确提示 X 天/小时后生效,而不是误导性的"距离失效"
  • 时间显示为人性化格式(如"10月27日 周二 09:00"),鼠标悬停可看原始时间

扫码失败怎么办

页面底部有提示:

💡 请确认:① 手机屏幕亮度已调高;② 二维码完整在取景框内;③ 未超过上方倒计时显示的有效时间。


访客专属链接

项目 说明
格式 /visit/预约号/访问令牌
令牌 SHA-256 生成的 32 位唯一串,服务端常量时间比较
有效期 与预约时段一致,过期自动失效
访问 浏览器打开即可,无需登录
错误令牌 返回 403

安全:令牌错一位就是 403,截图转发给无关的人也打不开。


← 员工审批 远程开门 →