系统运行中 · v2.2

大鹏投控 · 访客门禁管理系统

面向投控园区的智慧访客通行解决方案:访客在线预约、员工一键审批、扫码门禁通行、全程数据留痕。告别纸质登记,让每一次到访都安全、高效、可追溯。

4核心模块
3 分钟平均预约耗时
100%到访记录可追溯
7×24h系统可用
CORE FEATURES

四大核心模块

覆盖访客到访全链路:从预约、审批到通行与管理

📝

访客预约

访客填写姓名、电话、来访事由与被访员工即可提交预约,自动生成通行二维码,免现场登记。

✅

员工审批

被访员工实时接收预约消息,一键通过或驳回,待审批 / 已通过 / 已驳回状态清晰明了。

📊

管理后台

访客记录、员工与设备管理、统计报表一应俱全,园区访客管理一站搞定。

🔧

开发者模式

支持门禁设备接入与 API 扩展,灵活对接园区硬件,按需定制扩展能力。

WORKFLOW

四步完成一次到访

从发起预约到通行留痕,全流程线上化

1

访客预约

访客填写来访信息,选择被访员工提交预约

2

员工审批

被访员工实时收到通知,一键通过或驳回

3

扫码通行

审批通过后出示二维码,门禁刷码放行

4

记录留痕

通行数据自动同步后台,统计报表随时可查

LIVE DEMO

在线预约演示

模拟访客预约流程,右侧实时预览审批与通行二维码

* 演示环境仅本地模拟,不会提交至生产系统。生产系统访问地址:119.145.17.34:5102

访客待审批
预约单号—
被访员工张经理 · 投控总部
通行凭证二维码审批后生成
ADMIN

管理后台

园区管理员的一站式访客管控中心

📋

访客记录

全部到访记录列表,支持按日期、姓名、状态筛选查询与导出。

👥

员工管理

员工账号、审批权限与部门信息管理,支持批量维护。

🚪

设备管理

门禁设备在线状态实时监控,设备异常及时告警。

📈

统计报表

访客量趋势、热门来访时段、部门到访分布可视化。

⏱️

审批中心

待审批 / 已通过 / 已驳回集中处理,审批时效一目了然。

🔌

开发者模式

开放 API 与设备接入能力,支持与第三方系统联动。

FAQ

常见问题

访客如何发起预约?▾
进入系统首页「访客预约」,填写姓名、联系电话、来访事由、被访员工与来访时间,提交后等待员工审批即可。
预约需要多久才能审批?▾
被访员工会实时收到预约通知,可一键通过或驳回。通常数分钟内即可完成审批,审批结果会同步更新。
到访时如何通行?▾
审批通过后系统自动生成通行二维码,访客在门禁处出示二维码刷码即可进入,通行记录自动同步至管理后台。
如何查询历史到访记录?▾
管理员可在后台「访客记录」中按日期、姓名、状态筛选查看全部到访记录,并支持导出。
遇到技术问题如何联系?▾
技术支持电话:195****3095,微信:见管理员。系统问题与设备对接均可联系技术支持。
TECH

技术纵深

系统背后的技术实现:架构、核心代码、踩坑与版本现状

🧩

Flask 应用

单应用 57 路由+设置蓝图 7 路由,共 64 路由;鉴权装饰器集中收敛,页面与接口分层清晰。

🔗

C3 双通道

无签名通道优先、签名通道回退;会话复用连接,幂等查询有限重试,授权写操作保持单次。

💾

文件存储

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 接口恢复。

🕳️

踩坑三 · 误回收

无分时记录的已分配账户曾被视为过期直接回收;现改为保留,仅全窗口结束才回收并撤人脸权限。

当前基线9690cd4(2026-10-25)
回归验证test_ux_round2 10/10 · test_ux_round3 5/5
服务状态● 运行中 · 119.145.17.34:5102
数据规模门禁 404(启用 387)· 人脸 60 台
代码仓库Gitea · LZ-TK-Station · TK-QR-Gate(main)
SYSTEM

系统信息

系统访问地址119.145.17.34:5102
当前版本v2.2
服务状态● 运行中
技术支持电话195****3095
技术支持微信见管理员
部署平台Leon-Web-Host

准备好让园区访客管理更智能了吗?

访客预约 · 员工审批 · 扫码通行 · 数据留痕,即刻体验完整流程

📖 说明书📐 说明文档🕘 日志