聚全用户手册

Appearance

门禁管理 ​

Campus

适用角色 ​

门禁管理员、宿舍管理员、安保人员、学生处与班主任（查询本校学生出入情况）。

功能说明 ​

「门禁管理」负责门禁设备档案维护与各类出入记录查询，覆盖学生、教师在校门与宿舍两类场景。门禁设备支持完整的新增、编辑、删除；出入记录由门禁设备实时上报后自动入库，用户端只做查询和导出，不能人工增删改。

出入记录按「人员类别（学生／教师）」与「场景（校门／宿舍）」拆成四张查询列表，字段和用法基本一致，仅数据来源和"设备类别"展示文案不同。

菜单层级与名称以实际下发的客户环境为准。门禁模块依赖已接入的门禁硬件设备，设备上报能力以现场部署为准。

操作入口 ​

text
教学管理 > 门禁管理 > 门禁设备
教学管理 > 门禁管理 > 门禁访问记录 / 老师门禁访问记录
教学管理 > 门禁管理 > 宿舍访问记录 / 老师宿舍访问记录

截图待补：门禁设备列表与编辑表单、学生出入记录列表。

一、门禁设备 ​

门禁设备是记录来源的基础档案，登记后设备上报的刷卡／人脸／车辆通行数据才能正确归入对应学校与场景。

查询与列表 ​

  • 列表顶部可按城市、楼宇、学校、设备名称、状态、门禁类别筛选。
  • 列表默认按创建时间倒序展示。
  • 面向学生 App 等场景另有一个只读的"门禁列表"接口，只返回启用状态的设备，用户端无需关心。

新增／编辑设备 ​

  1. 点击工具栏「新增」，或行内「编辑」，弹出设备表单。
  2. 填写字段：
    • 学校（必填）：为空时提示「学校不能为空」。
    • 设备名称（必填）：为空时提示「设备名称不能为空」。
    • 设备地址（IP）（必填）：为空时提示「设备地址不能为空」。
    • 设备端口（必填）：为空时提示「设备端口不能为空」。
    • 登录账号（必填）：为空时提示「登录账号不能为空」。
    • 登录密码（必填）：为空时提示「登录密码不能为空」。
    • 楼宇（选填）：设备所在楼宇。
    • 门禁类别（选填）：宿舍／校门／车辆，新增时默认"校门"。
    • 是否为出口（选填）：出口／入口，决定该设备上报的记录显示为"出"还是"入"。
    • 状态（选填）：启用／停用，新增默认启用。
    • 备注（选填）。
  3. 点击「提交」保存。编辑时若设备已被删除，提示「数据不存在」；未带设备标识时提示「门禁不能为空」。

删除设备 ​

行内「删除」为物理删除，删除后不可恢复。删除不会校验该设备是否已有历史出入记录，请在确认设备已停用且不再需要时再操作。

关键字段口径 ​

  • 门禁类别：宿舍 / 校门 / 车辆。设备按类别决定上报的记录进入哪张记录表（宿舍类进宿舍记录、校门类进校门记录）。
  • 是否为出口：出口 / 入口。记录页据此显示"学校出口／学校入口"或"宿舍出口／宿舍入口"。
  • 状态：启用 / 停用。停用设备不出现在对外的门禁列表接口中。

二、出入记录（学生／教师 × 校门／宿舍） ​

以下四个子菜单都是只读查询 + 导出 Excel，记录由门禁设备实时上报后自动生成，不能人工新增、编辑或删除。四张表结构一致，差异见每节说明。

二·1 门禁访问记录（学生） ​

  • 数据来源：校门类设备上报的学生通行记录。
  • 可按学生姓名、学生手机号、设备名称、是否走读生、院系、专业、班级、班主任、开始／结束时间筛选。
  • 列表列：学生姓名、手机号、班级、班主任、专业、院系、设备名称、设备类别（据出入方向显示"学校出口／学校入口"）、出入时间、是否走读学生（是／否）。
  • 工具栏支持导出，文件名《学生出入记录.xlsx》。

二·2 老师门禁访问记录 ​

  • 数据来源：校门类设备上报的非学生（教职工／车辆）通行记录。
  • 可按人员类别、姓名、手机号、设备名称、学校名称、部门名称、开始／结束时间筛选。
  • 列表列：姓名、号码、学校、部门、设备名称、出入类别（"学校出口／学校入口"）、设备类别（"人员／车辆"）、出入时间、车牌号。
  • 工具栏支持导出，文件名《员工出入记录.xlsx》。

二·3 宿舍访问记录（学生） ​

  • 数据来源：宿舍类设备上报的学生通行记录。
  • 筛选与展示字段同"门禁访问记录（学生）"，仅设备类别显示为"宿舍出口／宿舍入口"。
  • 工具栏支持导出，文件名《学生宿舍出入记录.xlsx》。

二·4 老师宿舍访问记录 ​

  • 数据来源：宿舍类设备上报的非学生通行记录。
  • 筛选与展示字段同"老师门禁访问记录"，出入类别显示为"宿舍出口／宿舍入口"，设备类别固定显示"人员"。
  • 工具栏支持导出，文件名《员工出入记录.xlsx》。

关键规则与注意事项 ​

  • 出入记录由门禁设备自动上报生成，用户端只读，不能人工修改或补录。如记录缺失，应从设备联网与上报链路排查，而非在系统内手工添加。
  • 防重复上报：同一学生／教师／车牌在前后约 10 秒内的重复通行会被系统自动忽略，不会产生多条记录。
  • 请假联动：学生上报校门通行时，若该学生当时处于"已批准请假且在请假时间段内"，系统会自动关联生成一条请假出入记录，便于核对请假期间的进出情况。
  • 记录的设备类别／出入方向取决于门禁设备档案里配置的"门禁类别"和"是否为出口"，配置错误会导致记录归类或方向显示不符，维护设备时需核对。
  • 门禁记录查询按前端筛选条件返回，不按登录用户学校自动隔离；多校区场景请在筛选条件中限定学校／部门／班级范围。
  • 设备的登录账号、密码等属于对接凭据，请妥善保管，避免随意导出或外泄。

常见问题 ​

学生／教师明明进出了，却查不到记录 ​

先确认对应门禁设备是否已在"门禁设备"中登记且状态为启用、设备联网与上报是否正常；再检查查询的时间范围、学校／班级筛选是否正确。10 秒内的重复通行会被合并，属正常现象。

记录里"出口／入口"或"校门／宿舍"显示反了 ​

该显示取决于设备档案的"是否为出口"和"门禁类别"配置。请在"门禁设备"中核对并修正对应设备的这两项配置，修正后新产生的记录即会按正确口径显示。

能不能手动补一条出入记录 ​

不能。出入记录只能由门禁设备上报生成，系统不提供人工新增／编辑入口，以保证记录的真实性。

门禁设备能直接删除吗 ​

可以，但为物理删除且不可恢复，也不会保留其历史记录关联。建议先将设备停用，确认不再需要后再删除。

相关手册 ​

版本记录 ​

版本日期修改说明
v0.12026-07-27建立占位骨架
v0.22026-07-27补充适用角色、操作入口与相关手册引用
v1.02026-07-27依据后端源码补全门禁设备与四类出入记录的操作说明、规则与常见问题

聚全信息文档中心

Copyright © 2026 聚全信息