Appearance
校园门禁操作指南
校园门禁模块用于管理校园出入口的通行权限，包括门禁设备配置、通行规则设置、通行记录查询等功能。
功能入口
- PC端：登录后台 → 左侧菜单「总务管理」→「校园门禁」
- 小程序端：首页 →「校园门禁」图标
4
核心功能模块（设备/规则/记录/黑名单）
3
种通行方式（刷卡/人脸/二维码）
180
天通行记录保存周期
1-2
分钟规则同步到设备
操作步骤
1
添加门禁设备
录入设备信息并关联通行区域
→
2
配置通行规则
设置人员范围、时间段与通行方式
→
3
查看通行记录
查询、导出并关注异常通行
→
4
管理黑名单
限制人员通行并自动报警
步骤1：添加门禁设备
截图说明：校园门禁主界面，标注顶部「设备管理」「通行规则」「通行记录」「黑名单管理」四个标签页入口；重点标注「设备管理」标签下的「添加设备」按钮位置（位于列表右上角）
- 进入校园门禁页面，点击「设备管理」标签。
- 点击「添加设备」按钮。
- 填写设备信息：设备名称（如"校门东侧闸机"）、设备编号、安装位置、设备类型（闸机/门锁/道闸）。
- 选择关联的通行区域（如"正门入口"）。
- 点击「保存」，完成设备添加。
提示：设备编号需要与硬件设备上的标识一致，确保系统能正确识别。
步骤2：配置通行规则
截图说明：通行规则配置界面，标注右上角「新建规则」按钮位置；标注规则名称输入框、适用人员范围选择区（按角色/按班级/按部门）、通行时间段设置区、通行门禁设备多选区、通行方式单选项（刷卡/人脸识别/二维码）以及底部「保存」按钮
- 点击「通行规则」标签。
- 点击「新建规则」按钮。
- 设置规则名称，如"学生上学时段通行"。
- 选择适用人员范围：按角色（学生/教师/访客）或按班级/部门。
- 设置通行时间段：例如「周一至周五 07:00-08:30」。
- 选择通行的门禁设备。
- 设置通行方式：刷卡/人脸识别/二维码。
- 点击「保存」，规则生效。
步骤3：查看通行记录
截图说明：通行记录查询界面，标注顶部筛选条件区（时间范围、人员姓名、设备名称、通行状态下拉框）；标注记录列表中的时间、人员、设备、通行状态列；标注列表右上角「导出」按钮；标注异常通行记录的红色标记样式及可点击的「查看详情」链接
- 点击「通行记录」标签。
- 可通过筛选条件查询：时间范围、人员姓名、设备名称、通行状态（成功/失败）。
- 点击「导出」按钮可将记录导出为Excel文件。
- 异常通行记录会用红色标记，可点击查看详情。
步骤4：管理黑名单
截图说明：黑名单管理界面，标注右上角「添加黑名单」按钮位置；标注黑名单人员列表（含人员姓名、加入时间、有效期、状态列）；标注「添加黑名单」弹窗中的人员选择框、有效期设置区以及「移除」操作按钮
- 点击「黑名单管理」标签。
- 点击「添加黑名单」，选择人员并设置有效期。
- 黑名单人员通行时系统会自动报警。
- 有效期过后自动解除，也可手动「移除」。
注意事项
- 门禁设备需要保持网络畅通，离线状态无法实现远程开门。
- 人脸识别门禁需要提前录入人脸信息，请确保照片清晰、正面。
- 通行规则修改后约1-2分钟同步到设备，请耐心等待。
- 定期检查设备运行状态，发现故障及时报修。
- 通行记录默认保存180天，重要数据请及时导出备份。
常见问题
Q：学生刷卡后门禁没反应怎么办？ A：首先检查卡片是否损坏或消磁，确认该学生是否在通行规则适用范围内。如仍无法解决，请联系设备管理员检查硬件。
Q：如何为学生批量开通门禁权限？ A：在「通行规则」中新建规则，人员范围选择「按班级」，勾选需要开通的班级即可批量生效。
Q：临时访客如何使用门禁？ A：访客需先在「访客管理」模块完成预约，审批通过后系统会自动生成临时通行二维码，在有效期内扫码通行。
Q：门禁设备离线了怎么处理？ A：检查设备网络连接和电源，确认设备IP地址是否正常。如硬件故障，请通过「报修管理」提交维修申请。
Q：能否查看某个学生一个月的通行记录？ A：可以。在「通行记录」页面选择时间范围为近30天，输入学生姓名搜索即可查看。支持导出Excel存档。
功能入口详细说明
PC 端菜单路径
登录管理后台 → 左侧导航栏展开「总务管理」→ 点击「校园门禁」，进入校园门禁管理主页面。主页面顶部有四个标签页入口：
| 标签页名称 | 功能说明 |
|---|---|
| 设备管理 | 管理所有门禁设备的增删改查 |
| 通行规则 | 配置人员、时间、设备的通行策略 |
| 通行记录 | 查询和导出所有通行流水记录 |
| 黑名单管理 | 管理禁止通行的人员名单 |
小程序端入口
打开微信小程序 → 首页功能图标区域 → 点击「校园门禁」图标。小程序端主要提供以下功能：
- 查看通行记录（仅本人/本班级）
- 远程开门（需有权限）
- 临时通行二维码生成
所需权限角色
| 角色 | 可用功能 |
|---|---|
| 超级管理员 | 所有功能，包括设备管理、规则配置、黑名单管理、记录导出 |
| 安全管理员 | 设备管理、通行规则配置、通行记录查询、黑名单管理 |
| 班主任 | 查看本班学生通行记录（仅本班数据） |
| 宿管员 | 查看所管宿舍区域的通行记录 |
| 普通教师 | 查看本人通行记录 |
| 家长 | 小程序端查看子女通行记录 |
支持平台
| 平台 | 支持功能范围 |
|---|---|
| Web 管理后台 | 全部功能（设备管理、规则配置、记录查询、黑名单管理） |
| 微信小程序（教师端） | 通行记录查询、远程开门 |
| 微信小程序（家长端） | 查看子女通行记录、临时二维码 |
页面布局说明
设备管理页面
页面顶部：
- 页面标题：「设备管理」
- 操作按钮区：「添加设备」按钮（蓝色主按钮，位于右上角）、「批量导入」按钮、「刷新」按钮
- 搜索栏：支持按设备名称或设备编号模糊搜索
页面主体： 设备列表以表格形式展示，包含以下列：
| 列名 | 说明 | 示例 |
|---|---|---|
| 设备名称 | 设备的自定义名称 | 校门东侧闸机 |
| 设备编号 | 硬件唯一标识 | DEV-20250101-001 |
| 设备类型 | 闸机/门锁/道闸 | 闸机 |
| 安装位置 | 设备安装的物理位置 | 正门入口 |
| 通行区域 | 关联的逻辑通行区域 | 正门入口区域 |
| 在线状态 | 设备当前网络连接状态 | 在线/离线 |
| 最后心跳时间 | 设备最后一次通信时间 | 2025-03-15 14:30:22 |
| 操作 | 可用操作按钮 | 编辑/删除/重启 |
分页规则： 默认每页显示 20 条记录，可切换为 50/100 条/页。底部显示总记录数和当前页码。
通行规则页面
页面顶部：
- 页面标题：「通行规则」
- 操作按钮区：「新建规则」按钮（蓝色主按钮）、「批量启用」「批量禁用」按钮
- 筛选条件：按规则状态（启用/禁用）、适用人员角色、设备名称筛选
页面主体： 规则列表以表格形式展示：
| 列名 | 说明 |
|---|---|
| 规则名称 | 自定义的规则名称 |
| 适用人员 | 适用的人员范围描述 |
| 通行时段 | 允许通行的时间段 |
| 关联设备 | 规则覆盖的门禁设备数量 |
| 通行方式 | 刷卡/人脸/二维码 |
| 状态 | 启用（绿色）/ 禁用（灰色） |
| 创建时间 | 规则创建时间 |
| 操作 | 编辑/启用/禁用/删除 |
通行记录页面
页面顶部：
- 页面标题：「通行记录」
- 操作按钮区：「导出」按钮（绿色）、「高级筛选」按钮
- 筛选条件区：时间范围选择器、人员姓名输入框、设备名称下拉框、通行状态下拉框（全部/成功/失败/异常）
页面主体： 记录列表以表格形式展示：
| 列名 | 说明 |
|---|---|
| 通行时间 | 精确到秒的通行时间 |
| 人员姓名 | 通行人员姓名 |
| 人员类型 | 学生/教师/访客/其他 |
| 班级/部门 | 所属班级或部门 |
| 设备名称 | 通行的门禁设备 |
| 通行方式 | 刷卡/人脸/二维码 |
| 通行状态 | 成功（绿色）/ 失败（红色）/ 异常（橙色） |
| 失败原因 | 通行失败的具体原因 |
| 操作 | 查看详情 |
黑名单管理页面
页面顶部：
- 页面标题：「黑名单管理」
- 操作按钮区：「添加黑名单」按钮（红色主按钮）
- 搜索栏：支持按人员姓名、手机号搜索
页面主体： 黑名单列表以表格形式展示：
| 列名 | 说明 |
|---|---|
| 人员姓名 | 被加入黑名单的人员 |
| 人员类型 | 学生/教师/访客/其他 |
| 身份证号/学号 | 人员唯一标识 |
| 加入时间 | 加入黑名单的时间 |
| 有效期 | 截止时间或永久 |
| 加入原因 | 管理员填写的原因 |
| 状态 | 生效中（红色）/ 已过期（灰色） |
| 操作 | 移除/延期 |
筛选和搜索功能
设备管理筛选
- 搜索框：输入设备名称或设备编号，支持模糊匹配
- 设备类型筛选：下拉框选择 闸机/门锁/道闸
- 在线状态筛选：下拉框选择 全部/在线/离线
- 通行区域筛选：下拉框选择已配置的通行区域
通行规则筛选
- 规则状态筛选：下拉框选择 全部/启用中/已禁用
- 适用角色筛选：下拉框选择 学生/教师/访客/全部
- 设备筛选：下拉框选择关联的门禁设备
通行记录筛选
- 时间范围：日期选择器，支持快捷选项（今天/近7天/近30天/自定义范围）
- 人员搜索：输入姓名或学号/工号，支持模糊匹配
- 班级/部门筛选：下拉框选择，支持多级联动（年级→班级）
- 设备筛选：下拉框选择具体门禁设备
- 通行状态筛选：下拉框选择 全部/成功/失败/异常
- 通行方式筛选：下拉框选择 全部/刷卡/人脸识别/二维码
黑名单筛选
- 搜索框：输入人员姓名或手机号
- 状态筛选：下拉框选择 全部/生效中/已过期
- 人员类型筛选：下拉框选择 学生/教师/访客/其他
添加设备字段说明
点击「添加设备」按钮后弹出设备信息编辑弹窗，各字段说明如下：
| 字段名 | 数据类型 | 是否必填 | 默认值 | 取值范围/说明 |
|---|---|---|---|---|
| 设备名称 | 文本 | 是 | 无 | 2-30个字符，如"校门东侧闸机" |
| 设备编号 | 文本 | 是 | 自动生成 | 需与硬件标识一致，全局唯一 |
| 设备类型 | 下拉选择 | 是 | 闸机 | 闸机/门锁/道闸 |
| 安装位置 | 文本 | 是 | 无 | 描述设备的物理安装位置 |
| 通行区域 | 下拉选择 | 是 | 无 | 从已配置的通行区域中选择，支持多选 |
| 设备IP地址 | 文本 | 否 | 无 | 设备局域网IP，如 192.168.1.100 |
| 设备端口 | 数字 | 否 | 8080 | 1-65535 |
| 备注 | 文本域 | 否 | 无 | 最多200字 |
通行规则字段说明
点击「新建规则」按钮后弹出规则编辑页面，各字段说明如下：
| 字段名 | 数据类型 | 是否必填 | 默认值 | 取值范围/说明 |
|---|---|---|---|---|
| 规则名称 | 文本 | 是 | 无 | 2-50个字符 |
| 适用人员范围 | 多选 | 是 | 无 | 按角色（学生/教师/访客/后勤）或按班级/部门选择 |
| 通行日期 | 多选 | 是 | 周一至周五 | 周一至周日，可多选 |
| 通行开始时间 | 时间选择 | 是 | 07:00 | 格式 HH:MM，步长5分钟 |
| 通行结束时间 | 时间选择 | 是 | 08:30 | 格式 HH:MM，步长5分钟，须晚于开始时间 |
| 关联门禁设备 | 多选 | 是 | 无 | 从已添加的设备中选择，支持全选 |
| 通行方式 | 单选/多选 | 是 | 刷卡 | 刷卡/人脸识别/二维码，可多选 |
| 是否允许尾随 | 开关 | 否 | 关闭 | 开启后允许一次刷卡多人通行 |
| 有效期 | 日期范围 | 否 | 永久 | 可设置规则起止日期，不填则永久有效 |
| 优先级 | 数字 | 否 | 0 | 0-100，数值越大优先级越高，多条规则冲突时以高优先级为准 |
数据状态说明
设备在线状态
| 状态 | 颜色标记 | 含义 | 可执行操作 |
|---|---|---|---|
| 在线 | 绿色圆点 | 设备正常联网，可接收指令 | 编辑、重启、删除、远程开门 |
| 离线 | 红色圆点 | 设备断网，无法接收指令 | 编辑、删除（不可远程开门/重启） |
通行状态
| 状态 | 颜色标记 | 含义 |
|---|---|---|
| 成功 | 绿色 | 验证通过，正常放行 |
| 失败 | 红色 | 验证未通过，拒绝通行（如卡未授权、人脸不匹配） |
| 异常 | 橙色 | 触发异常规则（如黑名单人员通行、非时段通行尝试、尾随检测报警） |
规则状态
| 状态 | 颜色标记 | 含义 | 可执行操作 |
|---|---|---|---|
| 启用 | 绿色标签 | 规则生效中，已同步到设备 | 编辑、禁用、删除 |
| 禁用 | 灰色标签 | 规则未生效，设备不执行此规则 | 编辑、启用、删除 |
黑名单状态
| 状态 | 颜色标记 | 含义 | 可执行操作 |
|---|---|---|---|
| 生效中 | 红色标签 | 黑名单有效，该人员通行时触发报警 | 移除、延期 |
| 已过期 | 灰色标签 | 黑名单已过期，自动解除 | 删除记录、重新添加 |
批量操作
批量导入设备
- 在设备管理页面点击「批量导入」按钮
- 下载 Excel 导入模板，模板包含以下列：设备名称、设备编号、设备类型、安装位置、通行区域、IP地址、端口
- 填写完成后上传文件，系统自动校验数据格式
- 校验通过后批量创建，校验失败则返回错误行号和原因
批量导入通行规则
- 在通行规则页面点击「批量导入」按钮
- 下载模板，填写规则名称、适用角色/班级、通行时段、设备、通行方式等
- 上传后系统校验并批量创建
导出通行记录
- 在通行记录页面设置好筛选条件后，点击「导出」按钮
- 导出格式为 Excel（.xlsx），文件名格式：
通行记录_YYYYMMDD_HHmmss.xlsx - 单次导出上限 10000 条记录，超出请缩小筛选范围
导出黑名单
- 在黑名单管理页面点击「导出」按钮
- 导出格式为 Excel（.xlsx），包含所有黑名单记录
权限说明
功能权限差异
| 功能 | 超级管理员 | 安全管理员 | 班主任 | 宿管员 | 普通教师 | 家长 |
|---|---|---|---|---|---|---|
| 添加/编辑/删除设备 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 新建/编辑/删除规则 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 查看通行记录 | 全部 | 全部 | 仅本班 | 仅管辖区域 | 仅本人 | 仅子女 |
| 导出通行记录 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 管理黑名单 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 远程开门 | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 查看子女通行记录 | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
数据权限范围
- 超级管理员/安全管理员：可查看和管理全校所有门禁设备和通行记录
- 班主任：仅能查看所管辖班级的学生通行记录
- 宿管员：仅能查看所管辖宿舍楼栋/区域的通行记录
- 家长：小程序端仅能查看自己子女的通行记录
关联功能
与「访客管理」模块联动
- 访客预约审批通过后，系统自动在对应时间段内为访客生成临时通行二维码
- 访客通行记录同步写入门禁模块的通行记录中
- 访客预约过期后，二维码自动失效
与「人脸识别」模块联动
- 门禁人脸识别依赖「人脸管理」模块中已录入的人脸数据
- 学生/教师的人脸信息变更后，门禁设备在1-2分钟内自动更新人脸库
- 新生入学批量录入人脸后，需确保已配置对应的通行规则
与「学生管理」模块联动
- 学生毕业/转学/退学时，系统自动清除该学生的门禁通行权限
- 班级调整时，通行规则中"按班级"选择的人员范围自动更新
与「报修管理」模块联动
- 门禁设备离线或故障时，可在设备列表中直接点击「一键报修」跳转至报修管理页面，自动填充设备信息
与「家长接送」模块联动
- 放学时段通行规则可与家长接送模块的放学时间联动
- 学生被接送确认后，门禁系统记录该学生离校时间
常见问题（详细版）
Q：学生刷卡后门禁没反应怎么办？ A：请按以下步骤排查：
- 确认卡片是否损坏或消磁（可用其他闸机测试）
- 在「通行规则」中确认该学生是否在适用人员范围内
- 在「通行记录」中查看是否有该学生的失败记录及失败原因
- 检查设备是否在线（设备管理页面查看在线状态）
- 如以上均正常，请联系设备管理员检查硬件
Q：如何为学生批量开通门禁权限？ A：在「通行规则」中新建规则，人员范围选择「按班级」，勾选需要开通的班级即可批量生效。也可以点击「批量导入」，下载模板后按模板格式填写学生信息并上传。
Q：临时访客如何使用门禁？ A：访客需先在「访客管理」模块完成预约，审批通过后系统会自动生成临时通行二维码，在有效期内扫码通行。访客二维码过期后自动失效，无需手动清理。
Q：门禁设备离线了怎么处理？ A：检查设备网络连接和电源，确认设备IP地址是否正常。可在设备管理中点击「重启」尝试远程重启设备。如硬件故障，请通过「报修管理」提交维修申请，或在设备列表中点击「一键报修」。
Q：能否查看某个学生一个月的通行记录？ A：可以。在「通行记录」页面选择时间范围为近30天，输入学生姓名搜索即可查看。支持导出Excel存档。
Q：通行规则修改后多久生效？ A：规则保存后，系统会在1-2分钟内自动同步到关联的门禁设备。在同步完成前，设备仍按旧规则执行。可在规则列表中查看"最后同步时间"确认是否已同步成功。
Q：如何设置不同年级不同时段通行？ A：需要创建多条通行规则。例如：初一年级规则设置为 07:00-07:20，初二年级 07:20-07:40，初三年级 07:40-08:00。每条规则分别选择对应年级的班级，关联相同的门禁设备即可。
Q：黑名单人员通行时如何报警？ A：黑名单人员尝试通行时，门禁设备会发出声光报警，同时系统向安全管理员推送报警通知（小程序消息+后台弹窗）。管理员可在通行记录的「异常」分类中查看详细信息，包括通行时间、设备位置和抓拍照片。
Q：一个学生可以同时属于多条通行规则吗？ A：可以。系统支持规则叠加，只要学生满足任一规则的通行条件即可通行。如果多条规则的时间段有重叠，以优先级最高的规则为准。
Q：设备支持远程开门吗？ A：支持。在设备管理列表中，点击在线设备对应操作列的「远程开门」按钮，设备将立即开门。此操作需要安全管理员及以上权限。远程开门操作会记录在操作日志中。