SimpleHR project

모바일 앱 스펙

conceptedited by Cairni · 방금 · AIv4

개요

Simple HR 프로젝트의 모바일 앱에 대한 수정 및 개선 요청사항을 정리한 페이지입니다. 2026년 06월 10일자 수정 요청사항(fix-task-0610.md), 2026년 07월 02일자 우선 수정사항(fix-taskNew-0702), 및 2026년 07월 06일자 우선 수정사항(fix-taskNew-0706)을 기준으로 작성되었습니다.

기본 원칙: 기업 사용자(직원)는 모바일 중점, 기업 관리자는 PC 중점으로 개발합니다. fix-taskNew-0702 (26년 07월 02일 우선수정사항)

근로계약서 안내 배너

근로계약서 스펙의 활성화 토글 로직에 따라 모바일 앱에 다음과 같이 안내 배너를 표시해야 합니다.

MobileDashboard (대시보드)

조건: SOFT 게이트 (계약시작일 < 입사일)
표시: 황색(노란색) 배너 표시
참고: 근로계약서 활성화 토글 재수정

MobileProfile (프로필)

HARD 게이트: 빨강(Err) 배너 표시 (계약시작일 >= 입사일)
hard_pending 상태: 파란색 배너 표시
현재는 모바일에서 아무런 안내가 없어 PC와 일관성이 없음

휴일 근로 신청 연동

휴가 관리 스펙에서 APPROVED 상태의 OT_HOLIDAY(휴일근로) 신청이 존재할 경우 모바일 출근 화면 로직을 다음과 같이 개선해야 합니다.

출근하기 버튼 제어

휴일/연차일 경우: 기본적으로 출근하기 버튼 비활성화
APPROVED OT_HOLIDAY 존재 시: 버튼 활성화 (휴일이어도 출근 허용)
check_in 프로세스에서 OT_HOLIDAY 승인 여부를 확인하고 차단/허용 분기 처리

출근 상태 표시

기존: "오늘 출근 전이에요"
개선: 휴일/연차 시 "오늘은 [휴일명/휴가명]이에요" 표시
APPROVED OT_HOLIDAY 상태도 함께 반영

대시보드 및 UI 개선

기본 구조

일정 캘린더 개선

휴가 관리에서 연속일정이 끊겨서 나오는 현상 수정
예: 여름휴가 같은 멀티데이 휴가가 중단 없이 표시되도록 수정
카테고리 필터 추가: 개인/회의/출장/업무 선택 시 해당 일정만 표시

근무 탭 레이아웃

일자별 전체 내용이 한 페이지에 표시되도록 줄 간격 축소
근태 관리 스펙과 연계

임시휴일(선거) 표시

관리자가 전사로 등록한 임시휴일이 직원 모드에서 휴무로 표시
출근하기 버튼 비활성화
연차와 동일한 방식 적용

수정 현황

항목	상태	참고
근로계약서 안내 배너 (MobileDashboard SOFT)	✅ 완료
근로계약서 안내 배너 (MobileProfile HARD/hard_pending)	✅ 완료
휴일 근로 신청 시 출근 버튼 활성화	✅ 완료
출근 상태 메시지 개선 ("오늘은 [휴일명]이에요")	✅ 완료
일정 캘린더 연속일정 끊김 수정	✅ 완료
일정 카테고리 필터 (개인/회의/출장/업무)	✅ 완료
임시휴일 휴무 표시 및 출근 비활성화	✅ 완료

07월 06일 우선 수정사항 (모바일 관련)

fix-taskNew-0706 (26년 07월 06일 우선수정사항)

신청서 / 기안서

항목	상태	비고
모바일 신청서 첨부파일 제출 구현	✅ 완료	MobileFormSubmitSheet에 UPLOAD 타입 파일 선택 UI 및 업로드 로직 추가
신청서/기안서 신규 작성 시 문서 종류 선택 단계 제거	✅ 완료	불필요한 선택 단계 제거
근태 결재 신청 페이지에 결재선 선택 UI 추가	✅ 완료	결재선 드롭다운, 선택 시 결재 흐름 프리뷰, 미선택 시 자동 결재선 프리뷰, submit 시 approval_line_id 전달
근태결재 신청 제목 형식 통일	✅ 완료	[출장], [휴가], [특별휴가] 등 대괄호 형식으로 통일
사용자 결재 페이지 위임하기 버튼 제거	✅ 완료	우측 상단 "위임 설정" 버튼 제거

출퇴근 드로어

항목	상태	비고
출퇴근 요청 드로어 본문 통일	✅ 완료	근태 신청(출장/외출/조퇴) 기안서도 테이블 형식으로 통일, 요청 시각·근무지·요청 위치(gps_address) 표시 추가

휴가

항목	상태	비고
경조사 휴가 신청 시 사유 선택란 추가	✅ 완료	PC·모바일 모두 경조사(FAMILY_EVENT) 선택 시 sub_reasons 드롭다운 표시

미완료 (GPS·출장)

항목	상태	비고
출장 잦은 직원 GPS 출근 위치 저장	⬜ 미완료	GPS로 출근 가능하되 출근하기 버튼 클릭 시 현재 위치 저장 — gps-attendance-spec

07월 02일 우선 수정사항 (모바일 관련)

fix-taskNew-0702 (26년 07월 02일 우선수정사항)

사용자 모바일 — 신청서/기안서

항목	상태	비고
신청서 - 제출방식: 첨부파일 첨부 기능 구현	✅ 완료	MobileFormSubmitSheet에 UPLOAD 타입 파일 선택 UI 및 업로드 로직 추가 fix-taskNew-0706 (26년 07월 06일 우선수정사항)
신규 신청서/기안서 작성 시 문서 종류 선택 UI 제거	✅ 완료	불필요한 선택 단계 제거 fix-taskNew-0706 (26년 07월 06일 우선수정사항)
신청 결재 > 서류 작성 탭 이름 → 기안서 신청 으로 수정	✅ 완료

출퇴근 (GPS)

항목	상태	비고
브라우저 위치 허용 팝업 띄우기 (GPS 출퇴근 사용 시)	✅ 완료	중요 — gps-attendance-spec
출장 중 GPS 출근: 출근하기 누르면 현재 위치 저장되도록	⬜ 미완료	GPS로 출근 가능하되, 출근하기 버튼 클릭 시 현재 위치 저장 구현 필요 — business-trip-management-spec

근태 결재

항목	상태	비고
근태결재 관리 배지 오작동 수정 (알림 존재하나 리스트에 서류 미표시 등)	✅ 완료	신청 알림은 존재하나 대응 서류가 목록에 미표시되는 문제 해결 fix-taskNew-0706 (26년 07월 06일 우선수정사항) — approval-management-spec
관리자 출퇴근 요청 승인 시 해당 직원 근로 정책 시간을 기본값으로 표시	✅ 완료	fix-taskNew-0706 (26년 07월 06일 우선수정사항) — work-policy-spec