휴일 관리 스펙

휴일 관리는 Simple HR 기업 관리자 페이지(/admin)에서 제공하는 기능으로, 전사 또는 부서 단위로 휴일을 지정하고, 직원의 근태 현황 및 일정관리 달력에 반영하는 역할을 합니다. 0608 수정사항에 신규 요구사항과 완료 처리 내역이 함께 기록되어 있습니다.

1. 전체 / 부서별 적용 구분 탭 (미완료)

• 요구사항: 휴일관리 화면에 전체 적용 / 부서별 적용 구분 탭을 추가해야 함
• 현황: 미완료 ([ ]) fix-task-0608.md

2. 휴일 달력 반영 (완료)

기업 관리자 페이지에서 회사지정 휴일을 생성하면, 전사 직원의 내근무 및 일정관리 달력에 [공휴일] 로 표시됩니다. fix-task-0608.md

• 휴일 생성 조건: 유형 회사지정 + 적용대상 전사
• 이미 구현 완료된 기능으로, 별도 수정 불필요

2-1. 휴일근로 급여 반영 (완료)

휴일을 지정하면 직원 화면의 일정관리·근무관리에 휴일로 표시되며, 해당 날짜 근로 시 휴일근로로 인식되어 급여관리에 자동 반영됩니다. [fix-task-0624 (26년 06월 24일 수정사항)]

• 휴일근로 8시간 초과 자동 분리 (근기법 §56②): 일자별 OT_HOLIDAY 8시간 이내는 1.5배, 초과분은 2.0배로 자동 분리 후 급여 반영
• 프로덕션 소급 대상 0건 확인 완료

2-2. 부서별 스코프 휴일 노출 버그 수정 (완료)

[fix-task-0624 (26년 06월 24일 수정사항)]

• 문제: DEPARTMENT 스코프로 지정된 휴일이 전 직원의 캘린더 자동 레이어에 노출되던 버그
• 조치: 캘린더 자동 레이어에 부서별 스코프 필터 적용 완료 — 해당 부서 직원에게만 표시되도록 수정

3. 휴일 지정 시 근태 현황 표시 및 휴일근무 구분 (완료)

0714 수정사항 및 0702 수정사항에서 확인된 동작 및 수정 내역입니다. [fix-task-0714 (26년 07월 14일 수정사항)] [fix-task-0702 (26년 07월 02일 수정사항)]

구현 완료 내용:

• 관리자가 휴일을 등록하면 해당일 직원들의 근태가 자동으로 "휴일" 로 표시됨
• 직원이 휴일근로 신청 후 승인을 받으면 출근 가능
• 승인 없이는 출근 불가
• 승인 후 출근하면 근태 상태가 "휴일근무" 로 변경되어 단순 휴일과 실제 근무를 구분

수정 전 문제:

• 휴일근로 신청을 하고 출근 버튼을 눌러 출근해도 근태관리에서 상태가 "근무중"이 아닌 "휴일"로 표시되어 실제 근무 여부를 구분하기 어려웠음

휴일 근무 프로세스 요약:

4. 휴일 출근자 통계 집계 수정 (완료)

0714 수정사항에서 출퇴근관리 통계의 집계 오류가 함께 수정되었습니다. [fix-task-0714 (26년 07월 14일 수정사항)]

• 출퇴근관리 화면 상단 통계(출근/지각/결근/휴가 수)에서 휴일에 출근한 직원이 집계에서 빠지던 문제 수정
• 휴일 출근자 → "출근" 으로 정상 집계
• 휴일 미출근자 → "미출근" 으로 표시
• 외근자 → "출근" 으로 정상 집계
• 회사 전체 휴일뿐 아니라 특정 부서에만 지정한 휴일도 동일하게 처리 — 해당 부서 직원에게만 적용

5. 오피스·관리자 페이지 알림 분리 (완료)

• 문제: 한 사용자의 모든 알림이 오피스 페이지와 관리자 페이지 양쪽에 동시에 표시됨
• 조치: 오피스와 관리자 페이지의 알림을 분리 처리 완료 fix-task-0608.md

휴일 관리와 함께 근무 환경 설정의 일부로, 근무지 지도가 표시되지 않는 문제의 원인과 조치가 함께 기록되어 있습니다. fix-task-0608.md

• 원인: 해당 근무지의 좌표가 설정되지 않은 경우 지도 미표시
• 조치: /admin/locations 에서 주소 입력 시 좌표 자동 생성, 여러 근무지 설정 시 모든 근무지가 지도에 표시됨

일정관리 화면에서 연속되는 일정이 개별 일정처럼 끊어져 표시되던 문제가 수정되었습니다. fix-task-0608.md

• 문제 예시: 6월 17일~21일 연속 일정이 개별로 보임
• 조치: 연속 일정 등록 시 끊어져 있던 띠 형태 표시를 연결하여 표시하도록 수정

work_days OFF 요일 출근 차단 미구현

근무 정책 스펙 및 근태 관리 스펙과 연관된 미구현 사항입니다. [fix-task-0714 (26년 07월 14일 수정사항)]

• _resolve_scheduled_for_day()에서 ShiftSchedule과 Holiday만 확인하고, work_days의 OFF 요일은 체크하지 않음
• 예: 토요일을 OFF로 설정해도 Holiday로 등록하지 않으면 출근이 차단되지 않음
• 조회 시(get_my_attendance)에는 합성 ATT_HOLIDAY 레코드로 "휴무" 표시는 되지만, check_in() 시점에 is_off 판정에 work_days가 반영되지 않아 실제 출근 차단이 안 됨
• 수정 대상: backend/app/services/attendance_service.py — _resolve_scheduled_for_day() 함수에 work_days OFF 요일 → is_off=True 반환 추가
• 기존 check_in() 흐름(is_off=True → OT_HOLIDAY 승인 확인 → 없으면 차단, 있으면 허용)을 그대로 타므로, 연장근로(휴일근무) 승인 시 비근무 요일에도 출근 가능하게 됨

• 근태 관리 스펙 — 출퇴근 관리와 연동
• 근무 정책 스펙 — 근무 정책 내 휴일 설정 연계
• 교대(변형)근로 관리 스펙 — 교대근로 시 휴일 적용 방식
• 관리자 등급 및 권한 관리 스펙 — 부서별 적용 권한 관련
• 결재 관리 스펙 — 휴일근로 신청 결재 연동
• 급여관리 스펙 — 휴일근로 가산 급여 반영
• 휴가 관리 스펙 — 휴가와 휴일 구분 관련
• 모바일 앱 스펙 — 모바일 달력 내 휴일 표시