谁能邀请、能邀请到哪
系统管理员、管理权限教师、普通教师和学生都可以发起访客邀请，区别在于可选房间的范围，以及要不要先经过批准。
填写邀请
必填访客姓名和可访问房间，再定有效日期与起止时间、开门次数；访问目的、访客邮箱和手机号选填。可以「保存草稿」稍后再发，也可以直接「创建邀请」。
只能邀请到自己有关的门
可选房间按发起人收敛：教职工可以选本人有权进入或负责管理的房间，学生只能选本人有权进入的房间。选了范围外的房间，提交会被拒绝。
教职工创建即出码
教职工创建后立即生成二维码和可复制的邀请链接，邀请状态为「可使用」。访客不需要注册，也不需要先填写资料。
学生邀请先经导师批准
学生提交后进入「待批准」，批准前不生成二维码，也没有邀请链接。审批人是学生的导师；没有导师时转交同院系的思政或辅导员，识别不到时回落给系统管理员。
有效期、开门次数、房间范围
邀请详情里有一条常驻提示：链接可被转发，安全由有效期、开门次数与房间范围共同约束； 访客无需注册，不进入正式人员库。三项约束在现场扫码时逐一判定，任一不满足就拒绝开门并记下原因。
- 有效期
- 精确到起止时刻。未到开始时间，落地页显示「尚未生效」；过了结束时间显示「已过期」，现场扫码同样被拒。
- 开门次数
- 1、2、3、5 次或不限次数，默认 1 次。次数按房间分别计算：邀请了两间房、每间限 1 次，访客两间各能进一次；只有全部房间都用尽，邀请才算「次数已用尽」。
- 房间范围
- 只在邀请列出的房间有效。访客在别的门前扫码会被拒绝，原因记为房间不匹配；房间被禁用通行时同样被拒。
列表和详情里，状态叫法一致
- 草稿
- 已保存、未发出，还没有可用的通行码。
- 待批准 / 批准拒绝
- 学生发起的邀请在导师处理前后的状态。被拒时学生看得到理由，可以修改后重新提交；待批准期间也可以自己撤回。
- 可使用 / 已发送
- 通行码有效，访客可以凭码开门。已发送表示邀请邮件已经发出。
- 已使用
- 开门次数已经用尽。
- 已过期 / 已撤销
- 过了有效期，或被邀请人主动撤销。撤销后 5 秒内可以撤回这次操作。
- 发送失败
- 邮件没有发出去，记录里写着失败原因，可以重试发送。
发出去了没有，来了没有，都查得到
发送记录
邀请通过邮件发给访客，发送前可以预览邮件主题与正文。每一次发送都按时间轴记下发送人、收件地址和成功或失败，失败的带错误信息并可重试。当前只支持邮件，短信位置标注为「后续支持」且不可用。
通行记录
邀请详情里列出访客每一次扫码的时间、门、进出方向和结果；每个房间的已用次数单独显示，例如「1 / 2 次」。同一条记录也会出现在通行日志里，授权来源标为「访客邀请」。
失效即灰化
邀请过期、被撤销或次数用尽后，详情里的二维码变灰并标出失效原因，撤销按钮不再出现。
列表与指标
访客邀请页顶部是今日有效、进行中、未使用、本周邀请四个指标，列表按全部、进行中、草稿、已完成分组，可以按访客名、目的或接待人搜索；有待自己批准的学生邀请时，另有「待我批准」分组。
不登录就能打开的那一页，只给最少的信息
访客落地页是系统里少数不需要登录的页面之一。既然链接可以被任意转发，页面就按「被陌生人看到」来设计。
- 访问方式
- 邀请链接本身就是凭证，链接里带一个随机 token。打开它不需要登录，任何拿到链接的人看到的内容完全相同。
- 页面上有什么
- 只有邀请当前的状态（可通行、尚未生效、已过期、次数已用尽、已撤销）和可通行时的二维码。访客姓名、来访目的、房间、有效期、次数和邀请人都不在这个页面上，接口本身也不返回这些内容。
- 现场怎么用
- 访客到达后打开邀请链接，在门禁读头前出示页面上的二维码扫码开门。这要求现场设备支持扫码。
- 公开地址提醒
- 邀请链接需要访客在机构网络外也能打开。如果系统配置的公开访问地址是内网地址，邀请详情会提示「校外访客可能无法打开邀请链接」，链接照常生成。
来一次的，和常来的，分开管
临时来访与外部协作看起来相似，管理方式不同。前者一份邀请到期即止，后者需要档案、负责人和到期管理。
- 访客
- 一次来访，一份邀请。访客不建人员档案、不进入正式人员库，授权挂在邀请上而不是挂在人身上，来源标为「访客」。适合面试、参观、临时会议这类短时来访。
- 外部人员
- 保洁、外协、顾问、合作方、承包商这类不在机构统一身份平台里、但要持续进出的人。由本系统建档，必须填写负责人、分组和有效期，可以设置到期前 1、3、7、14 或 30 天提醒，支持续期、批量续期和 CSV 批量导入。授权和内部人员一样，走个人授权或角色组；外部人员分组可以作为角色组成员。
- 回收与归档
- 外部人员有两个语义分明的操作：「回收授权」只收回授权、人员状态保留；「归档」回收现有授权并把人员移入归档视图，历史记录保留，归档可以撤销并恢复本次回收的授权。访客则只需撤销邀请。
关于访客通行码
- 访客通行码的链接被转发了怎么办？
- 链接可以被转发，持有链接的人都能看到同一个通行码，所以它不是实名核验。安全由三项约束共同保证：有效期、每个房间的开门次数和房间范围。发现问题时可以随时撤销邀请，撤销后通行码立即失效。落地页本身也不显示访客姓名、房间、有效期等信息。
- 访客需要注册账号或填写资料吗？
- 不需要。教职工创建邀请后立即生成二维码和链接，访客打开链接即可出示通行码。访客不会进入正式人员库。
- 学生可以邀请访客吗？
- 可以，但需要导师批准，批准前不生成二维码和链接。学生只能邀请访客进入本人有权进入的房间。没有导师时转交同院系的思政或辅导员，识别不到时由系统管理员处理。
- 访客邀请可以用短信发送吗？
- 当前只支持邮件发送，发送前可以预览邮件内容，每次发送都有记录。短信通道尚未实现。邀请链接也可以复制后由邀请人自行转发。
- 长期来的保洁或外协人员也用访客邀请吗？
- 不建议。持续进出的人应建为外部人员：必须有负责人和有效期，可以续期、设置到期提醒，授权走个人授权或角色组，离场时回收授权或归档。访客邀请适合一次性的短时来访。