근태 현황
개요
이 화면은 무엇인가요?
근태 현황 데이터를 조회하고 관리하는 화면입니다
attendance_records테이블의 데이터를 관리합니다.
누가 사용하나요?
- 전 직원: 출퇴근을 기록합니다
- 관리자: 근태 현황을 모니터링합니다
언제 사용하나요?
- 근태 현황 데이터를 신규로 등록할 때
- 기존 근태 현황 정보를 수정할 때
- 근태 현황 현황을 조회하거나 검색할 때
주요 기능
| 기능 | 설명 |
|---|---|
| 근태 현황 조회 | 근태 현황 목록을 조회하고 필터/정렬합니다 |
| 근태 현황 등록/수정 | 근태 현황 데이터를 등록하고 수정합니다 |
| 인쇄 | 근태 현황 정보를 인쇄합니다 |
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 방법 |
|---|---|---|---|
| 직원 | 시스템 users 테이블 참조 | ✅ | 직접 입력합니다 |
| 근무일 | 근무일 | ✅ | 날짜를 선택합니다 |
| 출근시간 | 출근시간 | 자동 기록됩니다 | |
| 퇴근시간 | 퇴근시간 | 자동 기록됩니다 | |
| 출근방법 | 출근방법 | app / qr / nfc / manual 중 선택합니다 | |
| 퇴근방법 | 퇴근방법 | app / qr / nfc / manual 중 선택합니다 | |
| 근태유형 | 근태유형 | 직접 입력합니다 | |
| 휴게시간(분) | 휴게시간(분) | 직접 입력합니다 | |
| 근무시간 | 근무시간 | 직접 입력합니다 | |
| 초과근무 | 초과근무 | 직접 입력합니다 | |
| 주간누적시간 | 주간누적시간 | 직접 입력합니다 | |
| 52시간경고 | 52시간경고 | 토글로 선택합니다 | |
| 주간근무상태 | 주간근무상태 | normal / warning / violation 중 선택합니다 | |
| 근무패턴ID | 근무패턴ID | 직접 입력합니다 | |
| 휴가신청ID | 휴가신청ID | 직접 입력합니다 | |
| HR동기화상태 | HR동기화상태 | standalone / synced 중 선택합니다 | |
| 출퇴근위치 | 출퇴근위치 | 직접 입력합니다 | |
| 비고 | 비고 | 직접 입력합니다 |
자주 묻는 질문 (FAQ)
Q. 근태 현황은(는) 어떤 업무에서 사용하나요?
근태 현황은(는) 그룹웨어(Groupware) 솔루션의 근태관리 기능에서 사용됩니다. 전 직원가 주로 활용하며, 출퇴근을 기록합니다
실무 시나리오
시나리오: 근태 현황 등록
상황: 전 직원가 새로운 근태 현황 데이터를 등록합니다.
- 근태 현황 화면에서
+ 신규를 눌러 등록 양식을 열합니다 - 필수 항목(직원, 근무일)을 입력합니다
- 저장 버튼을 눌러 데이터를 등록합니다
- 등록된 데이터를 목록에서 확인합니다
참고: 데이터 구조
테이블명: attendance_records
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
employee_id | 직원 | UUID *필수 | 시스템 users 테이블 참조 |
work_date | 근무일 | DATE *필수 | - |
check_in | 출근시간 | TIMESTAMP | - |
check_out | 퇴근시간 | TIMESTAMP | - |
check_in_method | 출근방법 | app / qr / nfc / manual | - |
check_out_method | 퇴근방법 | app / qr / nfc / manual | - |
attendance_type | 근태유형 | VARCHAR | - |
break_minutes | 휴게시간(분) | INT | - |
work_hours | 근무시간 | DECIMAL | - |
overtime_hours | 초과근무 | DECIMAL | - |
weekly_cumulative_hours | 주간누적시간 | DECIMAL | - |
is_52hr_warning | 52시간경고 | BOOLEAN | - |
weekly_hours_status | 주간근무상태 | normal / warning / violation | - |
shift_pattern_id | 근무패턴ID | UUID | - |
leave_request_id | 휴가신청ID | UUID | - |
hr_sync_status | HR동기화상태 | standalone / synced | - |
location | 출퇴근위치 | VARCHAR | - |
notes | 비고 | TEXT | - |
테이블 특성: 감사 추적, 인쇄 지원