通行证

通行证：功能与构成

建筑工地的通行管理。它不是工人名单，而是项目、人员、组织、区域、通行证、凭证载体、设备和事件之间的关联。区域：项目的一部分、准入级别、负责人、规则（日期和时段、是否需要培训或许可以及有效期）。通行证：长期、临时、访客、承包商、受限；持证人是公司员工或“联系人”中隶属项目组织的人员；可冻结、撤销（必须填写原因），重新发放时关联原通行证。

凭证载体：RFID、NFC、QR 或自定义代码；同一个 UID 不会出现在两张有效通行证上，QR 包含随机代码而非个人数据，并在窗口内直接绘制，无需外部服务。准入判定由服务器上的一个函数完成，并给出拒绝原因：未知卡片、通行证已过期、已冻结或已撤销、不在允许时段、区域不允许、未培训或无许可。通行记录只增不改（数据库和接口的触发器禁止修改和删除）；保安的手动记录标注“手动”，并由作者签名。手机上的保安岗：用摄像头扫描 QR（浏览器支持时）或输入编号，大字显示判定结果，登记进出；拒绝通行时，同一通行证和区域在 10 分钟内只通知保安一次。

承包商：指派组织的人员、区域、期限和负责人，批量发放和撤销通行证；承包商只能看到自己人员的通行证。未来 7 天内到期的通行证属于项目问题，并每天通知发证人。组织结束参与时，应用只提示其仍有效的通行证，不会冻结任何人。坦率说明边界：没有连接或测试过任何实体控制器、读卡器或闸机，经过验证的是软件逻辑。

设备在自己发送心跳之前一直是“未连接”；系统是否“在线”只由它决定。应用不能开门，也不会假装能开门：判定结果以应答形式回传给设备，由设备硬件执行。接入方式为带 HMAC-SHA256 签名的 webhook（server/adapters）。