Yii打卡考勤核算需分离打卡记录与规则表，按日匹配班次计算状态；用Command+ActiveRecord批量处理，事务保障一致性；支持手动覆盖、重新核算及请假联动。
在Yii框架中实现打卡考勤系统的考勤核算，核心在于准确解析打卡记录、合理定义工作制度（如班次、弹性时间、迟到早退规则），并按业务逻辑自动计算出勤结果（正常、迟到、早退、缺勤、加班等）。关键不是堆砌代码，而是把企业考勤规则映射成可执行的程序逻辑。
一、结构设计：打卡记录与考勤规则分离
打卡数据（AttendanceRecord）和考勤规则（WorkSchedule、ShiftRule）应分表存储。打卡表只存原始数据：员工ID、打卡时间、设备ID、打卡类型（上班/下班）、状态（有效/无效）。规则表定义班次起止时间、允许迟到/早退分钟数、是否启用弹性打卡、休息时长等。
- 一个员工可绑定多个排班规则（如轮班制），按日期匹配生效规则
- 打卡时间统一转为服务器时区时间再比对，避免时区混乱
- 建议为打卡记录添加唯一索引（employee_id + date + type），防止重复提交
二、核算逻辑：按日逐条处理打卡对
核算不直接遍历所有打卡，而是以“自然日+员工”为单位，先查当天上下班打卡各最多1条有效记录（取最早上班卡、最晚下班卡），组成打卡对。再用该对匹配当日适用的班次规则：
- 上班卡早于班次开始时间 → 提前打卡，若在弹性范围内（如提前30分钟）仍算正常
- 上班卡晚于班次开始时间 → 计迟到分钟数 = 实际打卡时间 − 班次开始时间（超过允许阈值才标“迟到”）
- 无上班卡但有下班卡 → 视为旷工半天（需结合公司政策，也可设为异常待人工确认）
- 下班卡晚于班次结束时间 → 计加班时长，但需排除休息时段（如18:00–19:00为晚餐时间，则19:00后才算加班）
三、Yii中落地要点：用Command+ActiveRecord组合实现
避免在Controller里写核算逻辑。推荐新建 CalculateAttendanceCommand 控制台命令，配合事务与批量处理：
- 使用 ActiveQuery::batch() 分批读取待核算员工ID，防内存溢出
- 每批次内用 AttendanceRecord::find()->where(['date' => $date, 'employee_id' => $ids]) 一次查出全部打卡
- 核算结果写入 AttendanceResult 表（含字段：employee_id、date、status、late_minutes、overtime_minutes、remark）
- 在命令中调用 Transaction 包裹写入，失败则整批回滚
四、支持灵活配置与人工干预
实际考勤总有例外：请假、出差、外勤打卡、系统故障补录。核算模块必须留出覆盖入口：
- AttendanceResult 表加 is_manual 字段，标记是否由HR后台手动修改
- 提供“重新核算单日”按钮，触发 Command 重跑指定日期，自动覆盖非手动记录
- 请假单（LeaveApplication）提交后，自动更新对应日期的 AttendanceResult.status = 'leave'，跳过打卡比对
