fix-task-0629 (26년 06월 29일 수정사항)

2026년 6월 29일 기준 수정사항 로그. 총 8개 섹션, 전 항목 완료(✅). [fix-task-0629 (26년 06월 29일 수정사항)]

1. 우선 수정

• 대시보드 출장 직원 수 불일치: work_state=BUSINESS_TRIP이나 attendance_status=ATT_PRESENT인 불일치 데이터가 원인. 대시보드 집계에 보정 로직 적용.
• 회계·급여 정책: UI/CRUD 완비 확인. payroll_service.py(238–254)에 주요 항목(salary_calc_start_day, salary_pay_day, salary_holiday_rule, annual_leave_basis 등) 반영 확인.
• 중소기업 감면: 대상 여부·감면율 end-to-end 동작(UI→API→DB→급여계산). 시작일/종료일 date picker 및 백엔드 필드 추가. 급여명세서 소득세 항목에 감면율·원래세액·감면액 표시 추가. 연간 한도 200만 원 누적 체크는 미구현(추후 필요 시 구현 예정).

2. 사직서 처리

• 직원 관리 내 별도 사직 처리 탭 구현; 관리자가 직접 사직 처리 수행.
• 사직서 드로어: 그라데이션 제거 + 관리자 직접 등록 건 안내 메시지 추가.
• 관련 페이지: 사직서 처리 워크플로 스펙

3. UI 개선 — 드로어 디자인

• SlideDrawer에 bannerHeight=0 지원 → 배너 없는 플랫 헤더 모드.
• 직원 상세 드로어: 그라데이션 배너 제거 → 아바타·이름·재직배지·입사일·버튼 구성.
• employment_status EMP_ 접두어 없는 데이터 fallback 처리(dev DB 1건 보정, prod 이상 없음 확인).

4. 급여관리

• 4대보험 요율 관리자 설정 UI 불필요 결론: 세무사 수령 서류를 엑셀로 등록하는 방식이므로 엑셀 입력값 우선·fallback만 요율 자동계산으로 현재 구현이 요구사항 충족.
• 관련 페이지: 급여관리 스펙

5. 근로정책 급여 연동

• 출장 일정(business_trip_enabled): BusinessTripRequest 모델 추가, 신청/승인/반려 API, 승인 시 해당 기간 근무일에 ATT_BUSINESS_TRIP 상태 AttendanceRecord 자동 생성. 통합 테스트 3종 추가. UTC→로컬 타임존 날짜 1일 밀림 버그 수정 포함.
• 탄력근로 시작 날짜(flexible_start_date): WorkPolicy/WorkPolicyHistory에 컬럼 추가, 스키마·스냅샷·직렬화 전체 반영. 통합 테스트 추가. 프론트 폼 로드 시 누락 수정.
• 관련 페이지: 근무 정책 ↔ 급여 연동 현황 및 이슈, 근무 정책 스펙

6. 사용자 출퇴근현황 (/user/attendance)

• 상태코드 매핑을 ATT_STATUS_MAP으로 12개 전체 통일.
• API 필드명 전면 교체: total_work_minutes → recognized_work_hours, overtime_minutes → overtime_hours 등.
• 정정 모달 필드명 수정(work_date→target_date, new_check_in_time→corrected_check_in, attendance_record_id 추가) + 백엔드 미지원 파일 업로드 UI 제거.
• 근로시간 추이 차트: 하드코딩 제거 → 최근 4주간 API 호출로 동적 생성.
• 엑셀 다운로드: 주간/월간 데이터를 BOM 포함 UTF-8 CSV로 생성·다운로드.
• NORMAL 이외 work_state 시 타임라인에 근무상태 이벤트 추가.

7. 관리자 근태관리 (/admin/attendance)

• 출퇴근 정정 요청 승인/반려 UI 신규 구현.
• 백엔드 API: GET /admin/attendance/corrections, PUT /admin/attendance/corrections/{id}.
• 프론트 API 클라이언트: attendanceApi.listCorrections(), attendanceApi.reviewCorrection().
• 관리자 근태 페이지에 "정정 요청" 탭 추가; PENDING 목록 표시, 승인/반려 버튼 + 코멘트 입력, 처리 후 알림 자동 발송.
• 관련 페이지: 근태 관리 스펙