通行日志 · 筛选
先把范围收窄到那一扇门、那一段时间
筛选条件可以叠加，导出 CSV 时按当前筛选导出。
- 关键词
- 模糊匹配人员、房间与设备。
- 人员、房间、门
- 从选择器里精确收窄；选了房间后，门的候选只剩这间房的门。
- 通行方式
- 例如刷卡、二维码、访客码、远程开门，以及经开放接口发起的开门。
- 授权来源
- 个人授权、角色组、坐席管理、申请授权、访客邀请，或「未命中授权」。
- 通行结果
- 通行成功、无权限、权限已过期、次数用尽、设备异常。
- 时间范围
- 默认最近 24 小时，可选今天、最近 7 天、最近 30 天或自定义。没有限定人员、房间或设备时，一次查询最多跨 31 天；限定了对象就可以查更长的时段。
通行日志 · 视图
同一批记录，三种看法
01
表格
通行时间、人员、房间、通行方式、授权来源、结果与响应延迟。筛选栏旁的「异常分析」显示当前条件下的异常记录数。
02
时间轴
横轴是时间，按房间分行，圆点按通行结果着色，适合看一段时间里哪扇门在什么时候集中出问题。
03
热力图
星期 × 小时的网格，颜色越深通行次数越多；深夜时段（22:00 至次日 06:00）出现异常记录的格子用红色边框标出。热力图统计的是整个筛选时间窗，不受分页影响。
通行日志 · 详情
点开一条，回答「他为什么能开这扇门」
详情抽屉的核心是授权链路。它和授权中心的检查器讲的是同一件事，区别在于： 检查器回答「现在能不能」，通行日志回答「当时为什么能、为什么不能」。
- 开门结果
- 一句话说明，例如「已通过有效授权进入「实验室 A」」「没有任何有效授权允许进入「实验室 A」」「曾有授权，但授权已过期」「邀请授权次数已经用尽」。
- 授权链路
- 这次通行命中了哪个来源、授权人是谁、授权有效期是多少；访客通行还会显示该房间的邀请剩余次数。通行发生时系统会记下这几项的快照，事后修改或删除授权，不会改写这条记录当时的依据。
- 拒绝原因
- 失败时写出具体原因与失败环节：授权、设备或上游系统。设备异常会附上设备给出的原因和排查建议，授权问题会建议检查人员、房间与授权有效期。没有命中任何授权时，链路区直接写「未命中有效授权」。
- 相关记录
- 同一个人或同一间房在相近时间的其他通行记录，最多 10 条，用来判断是偶发还是连续失败。
- 未登记凭证
- 卡号在系统里找不到持卡人时，人员一栏显示「未登记凭证」而不是「未知人员」。原始卡号只有系统管理员和该房间的门禁管理人看得到。
可见范围
谁能看到哪些通行记录
- 系统管理员
- 查看全部通行日志与操作审计。
- 管理权限教师
- 只看自己门禁管理范围内房间的通行记录；详情里的相关记录同样只限这些房间。
- 普通教师与学生
- 只看本人的通行记录，页面上写明「仅展示你本人的通行记录」。这一限制由服务端执行，不是前端隐藏。
操作审计
谁在什么时候改了什么
操作审计是一张只读表，只对系统管理员开放：操作时间、操作人、操作类型、操作内容、目标、IP 地址。 操作类型分人员管理、门禁授权、设备管理、系统配置四组；目标是人员、房间、设备或角色组时可以点过去查看。 可以按操作人或关键词、操作类型、时间范围（今天、最近 7 天、最近 30 天、全部时间）筛选，并按当前筛选导出 CSV。
审批决定不在这张表里，而是记在申请本身：每张子审批单都写着审批人、审批时间、理由和调整内容。 访客邀请的每一次发送也记在邀请详情的发送记录里。
会写入操作审计的操作
- 授权：发放、撤销、续期、转为个人授权、重试下发、批量授权、一键清空
- 门禁管理范围与房间责任人的变更
- 角色组成员与房间的变更
- 外部人员的回收授权与归档，离职离校人员的权限回收
- 访客邀请的撤销
- 远程开门、常开、禁用通行等设备控制，设备与告警配置的修改
- 告警中心的确认、解决、静默与远程关门
- 系统设置的更新
边界
记录能做什么，不能做什么
操作审计不提供逐字段的修改前后对比视图。通行日志与操作审计是事后追溯的依据，不等同于安全认证， 也不能保证不出事故。保留天数在系统设置里可以分别配置，但当前版本不会按它自动删除历史记录， 数据保留与清理方式在签约前按部署方案说明。
常见问题
关于通行记录与操作审计
- 怎么查某个人某天为什么没能进门？
- 在通行日志里按人员、房间和时间范围筛选，结果选「无权限」等失败类型，点开记录看详情。详情会给出开门结果、命中或未命中的授权链路、具体原因与失败环节（授权、设备或上游系统），以及相近时间的相关记录。
- 操作审计能看到修改前后的对比吗？
- 不能。操作审计是只读列表，每条记录写明操作时间、操作人、操作类型、操作内容、目标与 IP 地址，部分设备配置类记录会在操作内容里写出「原值 → 新值」，但没有逐字段的修改前后对比视图。
- 通行日志和操作审计可以导出吗？
- 可以。两者都能按当前筛选条件导出 CSV。
- 谁能查看操作审计？
- 操作审计只对系统管理员开放。通行日志所有身份都能进入，但范围不同：系统管理员看全部，管理权限教师看自己管理范围内的房间，普通教师和学生只看本人记录。
- 日志会保存多久？
- 系统设置里分别有通行日志、操作审计和告警记录的保留天数配置，可设 1 到 3650 天。当前版本只保存这几项配置，不会按它自动删除历史记录；具体的数据保留与清理方式，签约前按部署方案说明。