第 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,截图转发给无关的人也打不开。