0723 수정사항 (fix-task 2026-07-23)

기업 사용자(모바일 중점) 및 기업 관리자(PC 중점)를 대상으로 한 2026-07-23 수정사항 모음. 프론트엔드 UI 개편, 결재 버그 수정, 백엔드 API 파라미터 추가 등 다수 항목 포함. [0723 수정사항 (fix-task 2026-07-23)]

주요 완료 항목 상세

결재 스텝퍼 개편 및 enum 버그 수정

• user/applications/history/page.tsx 결재 현황을 색 박스 → 원형 스텝퍼로 개편(승인=초록 / 반려=빨강 / 대기=회색, ChevronRight 커넥터).
• 기존 버그: step.action을 DocumentStatus(APPROVED/REJECTED)로 비교해 승인·반려 단계가 항상 '대기'로 표시되는 문제. 실제 값은 DocumentApprovalAction(APPROVE/REJECT). commit 03240409 최초 도입 이후 이 화면 한 곳만의 격리 버그.
• 좌우 여백 max-w-1000 → 1200(서류신청과 통일) + 제출일 whitespace-nowrap 적용.

서류 신청 PC 섹션 통합

• 기존 "기안서" + "서류 신청" 2섹션 → 단일 목록 + 종류 필터(전체/기안서/서류) 통합.
• 카드 그리드 → 자료실(resources) 스타일 표준 테이블로 전환. 모달은 합치지 않음(결재선·제출 로직 얽힘 + 실서버 회귀 리스크). 모바일 현행 유지.

사직 결재 상태전환 버그 수정

• 증상: 관리자 인사관리 > 사직처리에서 결재 완료된 사직서가 계속 '결재중(PENDING)'에 잔류, 직원 퇴직 처리(EMP_RETIRED·계정 RESIGNED·세션 무효화) 누락.
• 원인: 사직서 식별 로직이 form_category(단수)만 검사하는데, 문제 양식의 대표 분류가 OPTIONAL이고 RESIGNATION은 form_categories(복수)에만 존재. 07-03 commit feb6ef22에서 유입.
• 수정: 등록 시 category_filter(복수 지원)와 동일하게 복수 분류까지 인정. dev 4건 SQL 보정 완료, prod 밀린 건 0. 회귀 테스트 추가(494a1be6).
• 관련: 사직서 처리 워크플로 스펙

서류 결재 exclude_attendance 파라미터 추가

• /v2/approvals(list_approvals)에 exclude_attendance 파라미터 추가(기본 False → 기존 5개 호출처 무영향).
• True 시 ATTENDANCE/VACATION/OVERTIME/CHECKIN 문서를 서버에서 제외. 사용자 서류 탭이 이 옵션 + 서버 페이징 사용 → 200건 상한 제거, total·페이지 수 정확화.
• ⚠️ 배포 순서: 백엔드 먼저.
• 관련: 결재 관리 스펙

• 연차촉진 설정값 미적용 — 알림 채널/시기/기한/auto_schedule DB 저장만, 로직 미반영. 연차 만료일 기준(회계연도말 vs 입사일) 미결정.
• 일정관리 반복 일정 미구현 — recurrence_type 저장되나 확장 로직 부재.
• 일정관리 알림 발송 미구현 — reminder 저장되나 발송 로직 부재.
• 플랫폼 공지 소비자 노출·읽음추적 미구현 — sysadmin 발행/저장 완비, 소비자 측 API·화면 전무.
• 근태 엑셀 시간대 분해 미구현(P1·보류 2026-07-23) — breakdown 8컬럼 + away_minutes write 전무 → 엑셀 항상 0. 노동법 규칙 5건 확정 선행 필요(급여 직결).

• 인사관리 > 직원상태: 재직·휴직·퇴직만 남기고 휴가 등 제거, 각 플로우 구현.
• 기업 사용자 출퇴근 현황 페이지 UI 개선 (/user/attendance).
• 기업사용자 모바일 API 계약 버그 6건 — report/mobile-api-bug-audit.md 참조 (18개 feature·98개 엔드포인트 감사, 오탐 0, 전부 CONFIRMED). 관련: 모바일 앱 스펙

• 결재 관리 스펙
• 사직서 처리 워크플로 스펙
• 모바일 앱 스펙
• 연차촉진 스펙
• E2E 테스트 시나리오 명세
• 근태 관리 스펙