适用场景

一卡通项目的核心是"一个人员一条主数据"：人事系统是源，门禁考勤消费是下游。主数据不统一，后面全是人工对账。

配置步骤（人员与权限数据同步）

# 1) 确定主数据源（HR 系统或 AD）
# 2) 建立同步任务：增量优先，定时（如每 30 分钟）
# 3) 字段映射：工号、姓名、部门、卡号、有效期
# 4) 失败处理：重试 + 告警 + 日志

关键参数与建议

  • 人员主数据来源唯一（HR/AD），其他系统只读同步
  • 权限模型：按角色/部门建组，避免逐个授权
  • 考勤规则提前确认：班次、跨天、加班、请假与例外处理
  • 数据同步要有失败重试与告警，不能靠人工补
  • 离职流程与账号回收打通，避免权限遗留

容易踩的坑

  • 双向同步造成数据互相覆盖
  • 无失败重试，人事入职当天门禁开不了
  • 离职未同步停用，权限长期遗留

验证与巡检

# 验证：HR 新增/离职各一条，确认 30 分钟内同步到门禁
  • 巡检：同步日志无异常、人员数与 HR 一致

小结

一卡通验收重点在"数据一致性"：人员数与 HR 一致、权限与岗位一致、考勤报表与人工核算结果一致。三条都过才算交付。

> 说明：文中命令为通用写法，不同型号/版本可能略有差异，落地前请对照设备实际版本的官方文档；带外管理与安全设备变更建议先在测试设备验证。