근태관리
이 기능은 무엇인가요?
직원의 출퇴근 기록(QR/NFC/앱)과 연차 잔여 현황을 관리하는 기능입니다. 근로기준법 제53조 주 52시간 준수를 자동으로 모니터링합니다. 그룹웨어의 핵심 기능 중 하나로, 업무 효율성과 협업 생산성을 높여줍니다.
업무 프로세스 개요
포함된 화면
| 순서 | 화면명 | 설명 |
|---|---|---|
| 1 | 근태 현황 | 근태 기록 데이터를 관리합니다 |
| 2 | 연차 현황 | 연차 잔여 데이터를 관리합니다 |
관련 솔루션 연계
| 연계 솔루션 | 연계 내용 | 방향 |
|---|---|---|
| HR | 근태/연차 데이터 동기화 | Groupware ↔ HR |
| MES | 교대 패턴 연동 | MES → Groupware |
시작하기
- 출퇴근 기록: QR/NFC/앱으로 출퇴근을 기록합니다
- 연차 확인: 연차 현황에서 잔여 일수를 확인합니다
참고: 데이터 관계도
관련 워크플로우
- 근태 프로세스 시작 (startEvent): -
- 출근 기록 (humanTask): 직원이 앱/QR/NFC/수기로 출근을 기록합니다
- 퇴근 기록 (humanTask): 직원이 퇴근을 기록합니다
- 근무시간 계산 (autoTask): 출퇴근 시간 기반으로 근무시간, 초과근무시간을 자동 계산합니다
- 주간 누적시간 확인 (autoTask): 주간 누적 근무시간을 계산하고 52시간 초과 여부를 확인합니다
- 잔여연차 차감 (autoTask): 승인된 휴가일수를 잔여연차에서 차감합니다 (기본: groupware leave_balances, HR 배포 시: hr.leave_balances)
테이블 요약
근태 기록 (attendance_records)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
employee_id | 직원 | UUID (시스템참조) *필수 | 직원 (public.users 참조) |
work_date | 근무일 | DATE *필수 | - |
check_in | 출근시간 | TIMESTAMP | - |
check_out | 퇴근시간 | TIMESTAMP | - |
check_in_method | 출근방법 | ENUM(app, qr, nfc, manual) | - |
check_out_method | 퇴근방법 | ENUM(app, qr, nfc, manual) | - |
attendance_type | 근태유형 | VARCHAR | - |
break_minutes | 휴게시간(분) | INT | 법정 휴게시간 (근로기준법 제54조). 4시간 근무 시 30분, 8시간 근무 시 1시간 |
work_hours | 근무시간 | DECIMAL | 실근무시간 = (check_out - check_in) - break_minutes |
overtime_hours | 초과근무 | DECIMAL | - |
weekly_cumulative_hours | 주간누적시간 | DECIMAL | - |
is_52hr_warning | 52시간경고 | BOOLEAN | - |
weekly_hours_status | 주간근무상태 | ENUM(normal, warning, violation) | 2단계 경고: normal(<48h), warning(48~52h), violation(52h+). 근로기준법 제53조 |
shift_pattern_id | 근무패턴ID | UUID (FK) | - |
leave_request_id | 휴가신청ID | UUID (FK) | - |
hr_sync_status | HR동기화상태 | ENUM(standalone, synced) | - |
location | 출퇴근위치 | VARCHAR | 출퇴근 GPS 좌표 또는 위치명 (예: 37.5665,126.9780 / 본사 1층) |
notes | 비고 | TEXT | - |
연차 잔여 (leave_balances)
| 컬럼명 | 한글명 | 타입 | 설 명 |
|---|---|---|---|
employee_id | 직원 | UUID (시스템참조) *필수 | 직원 (public.users 참조) |
year | 연도 | INT *필수 | - |
total_days | 총부여일수 | DECIMAL *필수 | - |
used_days | 사용일수 | DECIMAL | - |
remaining_days | 잔여일수 | DECIMAL (계산) | - |
carried_over | 이월일수 | DECIMAL | - |
hr_sync_status | HR동기화상태 | ENUM(standalone, synced) | - |
업무 자동화
안내
화면에서 데이터를 저장하면 시스템이 관련된 다른 화면의 데이터를 자동으로 갱신합니다.
🔢 자동 계산
- 퇴근 기록 → 근무시간/초과근무 자동 계산: 퇴근을 기록하면 출퇴근 시간 기반으로 근무시간과 초과근무시간이 자동으로 계산됩니다 (휴게시간 자동 차감).
- 근태 갱신 → 주간 누적시간 자동 집계: 근태 기록이 갱신되면 주간 누적 근무시간이 자동으로 집계됩니다.
🚫 제약 조건
| 차단되는 동작 | 사유 | 해결 방법 |
|---|---|---|
| 주 52시간 초과 근무 시 법정근로시간 위반 경고 발생 | 근로기준법 제53조에 따라 주 52시간을 초과하는 근무는 법 위반입니다 | 48시간 초과 시 경고 확인 후 근무 조정, 52시간 초과 시 즉시 근무를 중단하세요 |