三、考勤配置（两种考勤模式）
菜单入口：HRM人力 → 考勤配置。本章是整个考勤体系的配置中心，也是最需要先读懂的一章：系统存在两种互斥的考勤模式，由全局参数一次性切换，配置入口和打卡规则完全不同。
3.1 两种考勤模式总览（先选模式，再做配置）
| 对比项 | 组织结构模式（值=1） | 考勤组模式（值=2） |
|---|---|---|
| 配置对象 | 部门（按部门统一一套规则） | 考勤组（跨部门自由组队） |
| 上下班时间来源 | 部门考勤配置里直接填写的上下班时间 | 班次（固定班次/排班制/智能排班） |
| 班次概念 | 无 | 有（班次配置 + 排班管理） |
| 迟到/早退判定 | 上班时间 + 全局宽限期 | 班次灵活规则（宽限/对调）+ 班次时间 |
| 打卡位置限制 | 部门配置的坐标+半径 | 考勤组配置的坐标+半径 |
| 适用场景 | 行政班整齐划一的小公司 | 多班次、跨部门排班的中大型工厂 |
如何切换模式
在 系统参数配置（HRM人力 → 系统参数配置）中找到参数 attendance.mode：
1= 组织结构模式2= 考勤组模式
修改后即时生效。两个注意点：
- 考勤组模式要求员工已加入考勤组：模式为 2 时，未加入任何考勤组的员工打卡会被拦截，提示"您尚未加入考勤组，请联系管理员"；
- 模式切换不迁移数据：两种模式的配置各自独立维护，切换后旧模式的打卡记录保留、新模式按新规则判定。
与"排班类型"的区别（常见混淆）
考勤组模式下，每个考勤组还要选一种排班类型（scheduleType）：
| 排班类型 | 说明 | 班次来源 |
|---|---|---|
| 1 固定班次 | 每周固定哪几天上班、各上什么班 | 按星期配置的周模板 |
| 2 排班制 | 逐日排班 | 按日期维护的排班明细 |
| 3 智能排班 | 按周期规则自动排 | 排班周期配置 |
"组织模式 vs 考勤组模式"是全局二选一；"固定/排班/智能"只是考勤组内部的班次安排方式。
3.2 组织结构模式的配置
菜单入口：HRM人力 → 考勤配置 → 组织模式配置。
按部门维护一整套考勤规则，页面按部门树展示。核心配置项：
| 配置组 | 字段 | 说明 |
|---|---|---|
| 作息 | 上班时间 / 下班时间 | 迟到早退的判定基准；支持跨天班次（下班时间小于上班时间即次日） |
| 旷工 | 旷工判定分钟数 | 缺卡多久计旷工 |
| 考核标准 | 每月允许迟到天数 / 早退天数 / 缺卡次数 / 旷工天数 | 超标用于月度考核与罚款计算 |
| 罚款 | 迟到/早退/缺卡/旷工 单次罚款金额 | 参与薪资核算的扣款项 |
| 打卡位置 | 经纬度 + 半径 | 开启位置打卡后，超出范围不能打卡 |
页面操作：查询、新增、编辑、删除、导出。
业务规则：父部门继承
- 子部门未配置时，自动继承最近一级有配置的父部门（"我的考勤"里会标注"继承自：xx部门"）；
- 建议只在公司级/一级部门配置，特殊部门再单独覆盖；
- 打卡判定使用本部门配置（不向上继承），配置继承仅用于"我的考勤"展示——给子部门配了规则就按子部门的算。
页面操作（组织模式管理，台账视图）：查询、编辑、删除、导出。
3.3 考勤组模式的配置
考勤组模式的配置链路较长，按下面的顺序搭建：
节假日模板 → 班次配置（含灵活规则） → 考勤组配置（选排班类型+加成员） → 排班管理（排班制才需要）3.3.1 节假日管理
菜单入口：考勤配置 → 节假日管理。
维护年度节假日模板（系统预置 + 自定义），供考勤组和薪资参数计算使用：
- 模板类型：1 系统预置 / 2 自定义；
- 日期明细类型：1 法定节假日 / 2 调休 / 3 自定义；调休上班日标记
isWorkday=Y； - 支持通过外部节假日 API 自动获取年度数据（系统参数
holiday.api.url）。
页面操作：查询、新增、编辑、删除、获取法定节假日、导出。
3.3.2 班次配置
菜单入口：考勤配置 → 班次配置。
| 字段 | 说明 |
|---|---|
| 上下班时间 | 判定基准；下班早于上班 = 跨天班次（夜班） |
| 休息起止/时长 | 扣除工时统计 |
| 灵活规则 | 见下表，考勤组模式判迟到的核心 |
| 加班转换规则 | 加班 X 分钟 → 次日可晚到 Y 分钟（N 天内有效） |
班次附属的两类灵活规则（考勤组模式专属，组织模式不生效）：
| 规则类型 | 机制 |
|---|---|
| 异常宽限（type=2） | 晚到 ≤ N 分钟直接不算迟到（不要求补时） |
| 灵活对调（type=1） | 晚到 ≤ maxLateArrive 且当日晚走时长 ≥ 晚到时长 → 记正常；晚走不足按差额记迟到。早退侧对称：早走需有等量早到抵扣 |
计算顺序：先应用异常宽限 → 再应用灵活对调 → 都不适用按标准计算（晚于上班即迟到）。
页面操作：查询、新增、编辑、删除、导出。
3.3.3 考勤组配置
菜单入口：考勤配置 → 考勤组配置。
| 配置组 | 字段 | 说明 |
|---|---|---|
| 基本信息 | 考勤组名称、排班类型 | 固定班次 / 排班制 / 智能排班 |
| 成员 | 组成员列表（含加入时间） | 一人只在最早加入的组生效；换组需先移出 |
| 班次 | 固定班次：按星期几勾选班次 | 周模板，例如周一~周五早班、周六早班 |
| 节假日 | 节假日模板、法定假日是否自动排休、周休息日 | 休息规则 |
| 弹性 | 允许员工自选班次（未排班时打卡可带班次）/ 允许员工打卡 | 自选班次用于自由度高的组 |
| 打卡位置 | 坐标 + 半径 | 组级位置限制 |
页面操作：查询、新增、编辑、删除、导出、成员管理。
业务规则：
- 排班类型为"固定班次"时按星期取班次；"排班制"按日期取（见排班管理）；
- 员工属于多个组时，按最早加入的组判定；
- 打卡时若当日未排班且组未开"允许员工自选班次" → 拦截提示"今日未排班，无法打卡"。
3.3.4 排班管理
菜单入口：考勤配置 → 排班管理。
排班制考勤组的逐日排班界面：
- 按人按日期维护班次（手动排班），或按排班周期自动生成（周期排班）；
- 支持特殊日期调整（临时换班）；
- 排班数据是打卡时取班次的唯一来源（排班制）。
页面操作：查询、排班、周期排班、删除、导出。
3.4 考勤规则台账（排查利器）
菜单入口：HRM人力 → 考勤配置 → 考勤规则台账。
只读视图，回答一个高频问题："这个员工到底用的是哪套打卡规则？"
每个员工一行，展示：当前生效模式、所在考勤组、排班类型、今日班次与上下班时间。组织模式无组信息；多组归属时提示"按最早加入的生效"。
页面操作：查询（只读台账，用于配置核对与问题排查）。
3.5 配置完成后的检查清单
- 系统参数
attendance.mode与规划的模式一致； - 组织模式：目标部门（或其上级）已有配置；考勤组模式：全员已入组、组内有班次；
- 排班制组：近期日期已排班（未排班无法打卡）；
- 位置打卡已开启时，坐标半径设置合理（系统参数
attendance.check.location）； - 全局迟到宽限期
attendance.late.grace.period（默认 0 分钟）按需调整。
配置完成后进入 考勤情况与补卡 日常使用。