覆盖访客到访全链路:从预约、审批到通行与管理
访客填写姓名、电话、来访事由与被访员工即可提交预约,自动生成通行二维码,免现场登记。
被访员工实时接收预约消息,一键通过或驳回,待审批 / 已通过 / 已驳回状态清晰明了。
访客记录、员工与设备管理、统计报表一应俱全,园区访客管理一站搞定。
支持门禁设备接入与 API 扩展,灵活对接园区硬件,按需定制扩展能力。
从发起预约到通行留痕,全流程线上化
访客填写来访信息,选择被访员工提交预约
被访员工实时收到通知,一键通过或驳回
审批通过后出示二维码,门禁刷码放行
通行数据自动同步后台,统计报表随时可查
模拟访客预约流程,右侧实时预览审批与通行二维码
园区管理员的一站式访客管控中心
全部到访记录列表,支持按日期、姓名、状态筛选查询与导出。
员工账号、审批权限与部门信息管理,支持批量维护。
门禁设备在线状态实时监控,设备异常及时告警。
访客量趋势、热门来访时段、部门到访分布可视化。
待审批 / 已通过 / 已驳回集中处理,审批时效一目了然。
开放 API 与设备接入能力,支持与第三方系统联动。
系统背后的技术实现:架构、核心代码、踩坑与版本现状
单应用 57 路由+设置蓝图 7 路由,共 64 路由;鉴权装饰器集中收敛,页面与接口分层清晰。
无签名通道优先、签名通道回退;会话复用连接,幂等查询有限重试,授权写操作保持单次。
JSON 文件原子写入(临时文件+同步+改名),无数据库;运行数据与代码分离,数据永不入库。
PBKDF2 密码哈希(旧口令登录即升级)、会话密钥随机持久化、查询防枚举限流、手机脱敏展示。
同一账户服务多访客的非重叠时段,池不足自动创建 V+15 位合规编号,到期回收并撤权。
刷卡与刷脸记录按分配时段二次校验,只归属到当前访客,解决共享账户的张冠李戴。
for a in accounts: # 遍历账户池
if a.get("disabled"): # 跳过停用账户
continue
conflict = False
for ta in a.get("time_allocations", []):
# 时段重叠即冲突:vs < te and ts < ve
if vs < te and ts < ve:
conflict = True
break
if not conflict:
return a["emp_no"] # 返回首个无冲突账户
C3 人员编号硬上限 16 位,旧自动编号 19 位导致池空后整条兜底链路失效;现改为 V+15 位并做唯一性重试。
空值参与签名导致全接口报签名错误;现签名集合排除空值,请求体仍保留原样空字段,10/10 接口恢复。
无分时记录的已分配账户曾被视为过期直接回收;现改为保留,仅全窗口结束才回收并撤人脸权限。