버그 수정 및 기능 개선 현황 (0622)

Simple HR 프로젝트의 버그 수정 및 기능 개선 작업 현황을 정리한 페이지입니다. 모바일 환경과 PC 환경의 수정 완료 항목과 미완료 항목으로 구분하여 추적합니다. [fix-task-0624 (26년 06월 24일 수정사항)] [fix-task-0625 (26년 06월 25일 수정사항)] [fix-task-0713 (26년 07월 13일 수정사항)]

GPS 출퇴근 — 주요 개선사항

1. GPS 출근 클릭 불가 이슈 ✅

문제:

• 조직관리 > 근무지 관리에 정상 등록된 근무지(본사, G마켓사무실)에서 출근하기 클릭 시 다른 좌표 표시
• 출근하기 버튼 클릭 불가

원인:

• GPS high-accuracy timeout이 8초로 설정되어 있음
• 삼성 브라우저 등에서 GPS 칩 응답 전에 TIMEOUT 발생
• WiFi/IP 기반 low-accuracy 폴백으로 진입
• 부정확한 좌표(예: 중구) 반환 → 근무지 반경 밖 판정

조치: ✅

• timeout 8초 → 15초로 확대
• 폴백 진입 시 "WiFi/네트워크 기반으로 위치 확인 중" 안내 메시지 추가
• 삼성 브라우저에서 재확인 필요

2. GPS 이슈 사유 작성 후 출근 요청 처리 변경 ✅

문제: GPS 이슈 사유 작성 후 출근하기 누르면 클릭되지만, 1차 결제자 이상재 팀장에게 결재라인이 넘어감

조치: ✅

• 출퇴근 요청 시 즉시 출근/퇴근 처리로 변경
• 대시보드가 "근무중"으로 즉시 전환
• 관리자 반려 시 GPS_REQUEST 기록 자동 취소

3. 9시 이전 출근 체크 불가 ✅

문제: 9시 이전에 출근 버튼이 활성화되지 않음

조치: ✅ 데스크톱 출근 버튼 활성화 시점을 모바일과 동일하게 start_time 1시간 전으로 통일

4. 퇴근 시 GPS 인증 추가 ✅

문제: 현재는 출근 시에만 GPS 확인, 퇴근 시에는 미적용

조치: ✅

• 퇴근 버튼 클릭 시 CheckInLocationSheet 다이얼로그 표시
• 반경 안이면 직접 퇴근 처리
• 반경 밖이면 출퇴근 요청 폴백
• 다이얼로그 내부 "출근" 텍스트를 출근/퇴근 상황에 맞게 동적 표시

결재 관리 — 출퇴근 결재선 관리

출퇴근 결재선 삭제 차단 및 누락 시 자동 생성 ✅

조치: ✅

• 서버 시작 시 checkin_approval_line_id가 NULL인 테넌트에 기본 출퇴근 결재선 자동 생성
• 프론트 삭제 실패 시 "기본 출퇴근 결재선은 삭제할 수 없습니다" 토스트 메시지 표시

모바일 UI/UX 개선 — 관리자 화면

관리자 화면 오피스 페이지 전환 버튼 ✅

문제: 모바일 관리자 화면에서 오피스 페이지 전환 버튼 미표시

조치: ✅ 모바일 관리자 화면 페이지 전환 버튼 표시 추가

연차 이월(Carryover) 기능 관련

현황:

• ✅ API(change_type: "CARRYOVER") 구현 완료
• ✅ 사용자 카드에서 "이월 N일" 표시 구현 완료
• ❌ 관리자 UI에서 이월 지정 선택지 부재

미완료 항목:

급여관리 — 기본 정보 수정

급여 기초관리 계약형태 표시 ✅

문제: 급여관리 > 급여 기초관리 > 급여 기초에서 계약형태가 OUTSOURCE로 표시됨

조치: ✅ 계약형태 표시 수정

정책 선택 로직 개선 ✅

정책 1: 개인은 부서 안에서의 정책 중 하나만 선택 가능 ✅

정책 2: 부서 안에 정책이 없다면 개인은 정책을 가질 수 없음 ✅

우선 수정 항목

근무지 복수 지정 버그 수정 ✅

문제: 근무지 2곳 지정 시 한 곳만 지정됨 (화면에 추가 선택 UI는 있으나 활성화가 하나만 됨)

원인: 조직도관리 > 조직 근무지 설정 시 출/퇴근 근무지 비활성 버그 발생. 기존에는 개별로 여러 근무지 설정 시 출/퇴근 근무지가 활성화되었음.

조치: ✅

• 복수 근무지 지정 허용 수정
• 직원 상세에서 중복 등록 시 등록된 모든 근무지의 배지가 초록색으로 표시

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

비밀번호 초기화 후 로그인 오류 수정 ✅

문제: 유니에스 정다빈 사원 초대 기간 만료 후 비밀번호 초기화 후 로그인 시 에러 메시지만 출력

조치: ✅

• /onboarding(미존재) → /change-password 리다이렉트 수정
• 비밀번호 변경 후 is_first_login = False 처리 추가
• /change-password 브랜드 컬러 초록색 통일, 권한 없는 직접 접근 차단
• 직원 관리 > 직원 상세 드로어 우측 상단 자물쇠 비번 초기화 명시

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

기안서 목록 필수서류(REQUIRED) 클릭 시 내용 없음 버그 수정 ✅

문제: 기업 사용자 > 신청결재 > 기안서 작성 목록에서 필수서류 항목 클릭 시 문서 내용이 없다고 표시 (해당 문서에 양식이 존재함에도)

조치: ✅

• 필수서류(REQUIRED)를 기안서 목록에서 기본 제외
• 필수서류는 프로필 페이지에서 제출·확인, 결재 관리는 기존대로 유지

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

PC 출퇴근 등록 불가 수정 ✅

문제: PC에서 출퇴근 등록 시 "지역이 아니라고 나옴"

조치: ✅

• 선택/탄력근무 출근 허용시간(flex_start_from~flex_start_to) 검증 추가
• 퇴근 에러 메시지를 "X ~ Y 입니다" 형식으로 통일
• 허용시간 밖에서 출근 버튼 차단 시 "출퇴근 요청하기" 폼 자동 노출 (관리자 승인 경로)
• 출근 요청(checkin-request)은 허용시간 검증 미적용 (사유 작성 → 관리자 승인/반려)
• 연장근로 신청 시 같은 날 시간대 겹침 방지(OT_TIME_OVERLAP) 백엔드+프론트엔드 적용
• 프론트 3곳(PC 위자드·대시보드 빠른 신청·모바일)에서 날짜/시간 입력 시 겹침 실시간 검증 + 빨간 글씨 안내 + 버튼 차단
• 통합 테스트(test_checkin_allow_time.py, test_overtime_time_overlap.py) 추가

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

회사 양식 관리 — 삭제 기능 수정 ✅

문제: 양식 삭제 시 실패

조치: ✅ 삭제 방식을 hard delete → soft delete(is_deleted, deleted_at) 전환

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

연장근로 자동 승인 → 결재선 선택 기능 추가 ✅

문제: 연장 근로 신청 시 자동 승인됨

조치: ✅

• 결재선 직접 선택 기능 추가 (PC 위자드·대시보드 빠른 신청·모바일 3곳)
• approval_line_id 설정 시 auto_approve 비활성화, Document(OVERTIME)에 결재선 포함
• 결재선 미선택 시 자동 결재 흐름(조직도 기반) 미리보기 표시
• 자동 결재선도 없는 경우 경고 메시지 + 신청 버튼 차단
• 통합 테스트 3건 추가

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

급여관리 — 근태 연동 수당 항목 누락 수정 ✅

문제: 근태 연동 수당 항목(PAY_OVERTIME 등 5개) 누락

조치: ✅

• DEFAULT_PAY_ITEMS에 PAY_OVERTIME, PAY_NIGHT, PAY_HOLIDAY, PAY_HOLIDAY_OT, PAY_ANNUAL_LEAVE 추가
• _ensure_pay_items()에 누락 항목 자동 backfill 로직 추가
• lifespan startup에서 전 테넌트 backfill 실행 (advisory lock 내)

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

근무 정책 ↔ 급여 연동 — 0625 수정 완료 항목

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

회사 양식 관리 — 제출방식 개선 ✅

조치: ✅

• PASTE_UPLOAD 제출방식 추가: 붙여넣기 + 첨부파일 동시 제출 가능, 엑셀 자료 그대로 붙여넣기 지원
• 제출방식 전환 시 양식 내용 초기화 확인 팝업 추가

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

휴일 관리 — 휴일근로 급여 반영 및 캘린더 표시 ✅

조치: ✅

• 휴일근로 8시간 초과 자동 분리 (근기법 §56②): 일자별 OT_HOLIDAY 8시간 이내 1.5배, 초과분 2.0배 자동 분리 및 급여 반영 완료. 프로덕션 소급 대상 0건 확인.
• 캘린더 자동 레이어 휴일 부서별 스코프 필터 적용: DEPARTMENT 스코프 휴일이 전 직원에게 노출되던 버그 수정. 해당 부서 직원에게만 표시되도록 수정.

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

근로계약서 — 버그 수정 ✅

탄력근로제 서면 합의서가 근로계약서로 표시되는 버그 ✅

원인: 나의 정보에서 근로계약서는 가장 최근에 발송된 서류가 나오게 되어 있으나, 최근에 발송된 탄력근로제 서면 합의서가 근로계약서라는 이름으로 노출됨

조치: ✅ 최근 날짜의 근로계약서만 필터링되도록 처리

계약형태 불일치 버그 ✅

원인: 계약직으로 신규 생성 시 정규직 근로계약서 양식이 나오는 버그

조치: ✅

• contract_type 기반 양식 자동 매핑(_resolve_form_id_by_contract_type) 추가
• 관리자 미리보기에서도 contract_type에 맞는 양식으로 폴백
• per_employee 서브쿼리에 CONTRACT 카테고리 필터 적용 (REQUIRED 계약이 max를 점유해 CONTRACT 계약 누락되던 버그 수정)

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

근로 정책 — 수정 시점 반영 기능 ❌

문제: 근로 정책 수정 시 수정 시점을 입력할 수 없고, 수정 즉시 과거 자료까지 소급 적용됨

조치 필요: 수정 시점을 입력하고, 해당 시점 이후부터 정책 변경이 적용되도록 구현 필요

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

퇴근 미체크 자동 처리 스케줄러 ✅

조치: ✅

• 매일 KST 00:15 실행, 최근 7일 이내 퇴근 미체크(check_out_time IS NULL) 레코드를 근로정책 unchecked_checkout_policy 설정에 따라 자동 처리
• AUTO_END_TIME → scheduled_end 시간으로 퇴근 자동 기록 + 근무시간/상태 재계산
• LEAVE_BLANK → 스킵 (빈 값 유지)
• advisory lock(820620)으로 multi-worker 중복 방지
• 급여 영향 없음 (급여는 OvertimeRequest 기반, AttendanceRecord.overtime_hours 직접 읽지 않음)

배포 후 수동 보정: HNT 기준 6/17~6/24 19건은 스케줄러 자동 처리 대상. 2~3월 4건(scheduled_end NULL)만 필요 시 관리자 UI에서 수동 처리. form_id=NULL 레거시 계약 보정: HNT 0건 확인 완료. 디비안츠 CONTRACT_SHORT DRAFT/RENEWED 2건만 잔존 (조치 불필요).

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

필수서류(REQUIRED) 구조 변경 — EmployeeContract → Document 전환 ✅

조치: ✅

• REQUIRED 양식 제출 시 Document 생성 → 결재선 승인 → 결재관리에서 처리
• 승인 시 EmployeeDocument 자동 생성 side-effect 추가
• 관리자 발송(EmployeeContract) 경로에서 REQUIRED 카테고리 제외 (CONTRACT 포함 시 허용)
• 필수서류 목록에 Document 결재 상태 반영
• 서류 보관함에 doc_content/form_content 필드 추가 + 내용 보기 모달
• 기존 데이터: 이미 EmployeeContract로 생성된 REQUIRED 건은 기존 방식으로 승인 처리 후, 이후 건부터 Document로 전환

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

기안서 양식 목록 필터링 버그 ✅

조치: ✅

• 탄력근로제서면합의서(REQUIRED)가 기안서 목록에 노출되던 문제: 기안서 페이지에서 form_category: "OPTIONAL" 필터 적용으로 REQUIRED/CONTRACT 양식 분리 완료
• 서류신청 페이지도 form_category: "APPLICATION" 필터 적용
• 기안서 목록에서 CONTRACT 문서종류 영문 노출 → DOC_TYPE_CONFIG에 CONTRACT 라벨 매핑 추가 ("계약")
• 양식 분류 OPTIONAL 라벨을 "양식"에서 "기안서"로 변경 (신청서(APPLICATION)와 구분 명확화)

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

모바일 결재 페이지 개선 ✅

조치: ✅

• 결재 상세 시트에서 v2 양식 JSON 대신 TemplatePreview 렌더링 지원
• 빈 values 양식(PASTE_UPLOAD 등)은 "입력된 내용이 없습니다." 안내 표시 (PC 동일)
• 카드 미리보기에서 JSON 대신 텍스트 값 추출 표시
• REQUIRED/CONTRACT 배지 한글화 ("필수서류"/"계약")
• 상세 시트 로딩 시 JSON 깜빡임 수정 (templateLoading 초기값 개선)

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

상태: 미완료

• 페이징 처리 전사적 통일 필요
• 탄력근로제 서면 합의서가 근로계약서로 표시되는 버그 → ✅ 0624 수정 완료 [fix-task-0624 (26년 06월 24일 수정사항)]
• 계약형태 불일치(계약직 생성 시 정규직 양식 출력) → ✅ 0624 수정 완료 [fix-task-0624 (26년 06월 24일 수정사항)]

급여대장 관리

상태: 미완료

• 급여대장(/admin/payroll/ledger) 엑셀 다운로드
• 나야넷 기본틀 양식 다운로드 기능 구현 필요

근무 정책 ↔ 급여 연동 미구현 항목

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

사용자 교대 일정 (/user/shift-schedule) — mock→실 API 연동 미완료

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

• GPS 출퇴근 스펙
• 결재 관리 스펙
• 연차 이월(Carryover) 기능 스펙
• 급여관리 스펙
• 근로계약서 스펙
• 모바일 UI/UX 개선 작업 (기업 사용자)
• 액션 아이템
• 의사결정 로그
• Simple HR 프로젝트 개요
• 인증 만료 시 빈 페이지 노출 이슈
• 토스트 알림 공통 컴포넌트 스펙
• 휴일 관리 스펙
• 근무 정책 스펙
• 근무 정책 ↔ 급여 연동 현황 및 이슈
• 교대(변형)근로 관리 스펙
• 양식 편집기(폼 빌더) 스펙
• fix-task-0624 (26년 06월 24일 수정사항)
• fix-task-0625 (26년 06월 25일 수정사항)
• fix-task-0713 (26년 07월 13일 수정사항)
• 연차촉진 스펙
• 교대(변형)근로 관리 스펙
• 근로계약서 스펙