모바일 앱 스펙

Simple HR 프로젝트의 모바일 앱에 대한 수정 및 개선 요청사항을 정리한 페이지입니다. 2026년 06월 10일자 수정 요청사항(fix-task-0610.md), 2026년 07월 02일자 우선 수정사항(fix-taskNew-0702), 및 2026년 07월 06일자 우선 수정사항(fix-taskNew-0706), 2026년 07월 20일자 수정완료 사항(fix0720.md), 2026년 07월 23일자 수정사항(0723 수정사항), 2026년 07월 29일자 RN 앱 ↔ 웹모바일뷰 기능 격차 감사(RN 앱 ↔ 웹모바일뷰 기능 격차 감사 (0729)), 2026년 09월 01일자 모바일 배포 마무리 점검([FINAL-VERIFICATION.md])을 기준으로 작성되었습니다.

기본 원칙: 기업 사용자(직원)는 모바일 중점, 기업 관리자는 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 상태도 함께 반영

기본 구조

일정 캘린더 개선

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

근무 탭 레이아웃

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

임시휴일(선거) 표시

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

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

결재 목록 (MobileApprovalList)

[fix0720.md]

근로정책 인정시간

⚠️ 출퇴근관리 > 직원 상세에서 연장시간이 당일 근로정책에 맞춰 계산되어 올바르지 않게 보일 수 있습니다. 현재 수정 중입니다. [fix0720.md]

PC 출퇴근 (위치 권한)

GPS 출퇴근 스펙 참고

• 위치 권한이 허용되지 않았을 때 안내 문구와 [위치 권한 요청] · [허용 방법 보기] 버튼 항상 표시
• 권한이 차단된 경우 허용 방법을 단계별로 알려주는 안내창 추가
• 브라우저 특성상 한 번 차단한 위치 권한은 자동으로 되돌릴 수 없어 사용자가 직접 허용하도록 안내

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

신청서 / 기안서

출퇴근 드로어

휴가

미완료 (GPS·출장)

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

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

출퇴근 (GPS)

근태 결재

• Simple HR 프로젝트 개요
• 근로계약서 스펙 — 활성화 토글 및 모바일 안내 로직
• 휴가 관리 스펙 — 휴일 근로(OT_HOLIDAY), 임시휴일 연동
• 근태 관리 스펙 — 근무 탭 및 휴일 근로 시간 집계
• 모바일 UI/UX 개선 작업 (기업 사용자)
• 액션 아이템
• 의사결정 로그
• fix-task-0610.md — 원본 수정 요청사항- fix-taskNew-0702 (26년 07월 02일 우선수정사항) — 07월 02일 우선 수정사항
• GPS 출퇴근 스펙 — 브라우저 위치 허용 및 좌표 저장 로직
• 출장 관리 스펙 — 출장 중 GPS 출근 처리
• 결재 관리 스펙 — 근태결재 배지 및 신청서 처리
• 양식 편집기(폼 빌더) 스펙 — 신청서/기안서 양식 구성
• fix-taskNew-0706 (26년 07월 06일 우선수정사항) — 07월 06일 우선 수정사항
• fix0720.md — 07월 20일 수정완료 사항
• 0723 수정사항 (fix-task 2026-07-23) — 07월 23일 수정사항
• RN 앱 ↔ 웹모바일뷰 기능 격차 감사 (0729) — 07월 29일 RN 앱 기능 격차 감사
• 연차촉진 스펙 — RN 촉진 응답 누락 관련
• 근무 정책 스펙 — 근로정책 인정시간 및 정책 변경 연동
• [FINAL-VERIFICATION.md] — 모바일 배포 마무리 점검 (2026-09-01)

RN 앱 ↔ 웹모바일뷰 기능 격차 감사 (0729) [RN 앱 ↔ 웹모바일뷰 기능 격차 감사 (0729)]

기업 모바일은 RN 앱(mobile/src) + 웹 모바일뷰(frontend/src/components/user/mobile/MobileXXX.tsx) 이중 구조로 운영됩니다. 현장 피드백에서 웹모바일은 정상 동작하나 RN 앱에서 안 되는 기능이 많다는 문제가 제기되어, 12개 도메인을 웹모바일 기준으로 RN과 1:1 코드 대조 감사를 실시했습니다.

총평: RN 이식이 웹모바일보다 후속으로 진행되며 최근/핵심 기능이 미반영. 특히 출퇴근 인증방식(QR·IP) 과 휴가 촉진 응답이 RN에 통째로 빠져 실사용을 직접 차단.

종합 현황

🔴 실사용 차단 (HIGH) — 우선 처리

1. 출퇴근 QR·IP 방식이 RN에 전무

RN CheckInSheet.tsx:161은 check_in_method:'GPS'만 하드코딩되어 있어 QR 스캔·사내망 IP 출퇴근 경로가 전혀 없음. 웹모바일은 GPS/QR/IP 방식 선택을 모두 지원. → QR 전용·IP 전용 근무지 직원은 앱으로 출퇴근 불가. GPS 출퇴근 스펙 참고.

2. 휴가 연차촉진 응답이 RN에 전무

웹모바일 MobileVacation.tsx에는 근기법 61조 촉진 응답(배너·1차 응답·2차 응답)이 완비되어 있으나 RN vacation에는 전무. 연차촉진 스펙 참고.

3. 조직도 부서 칩 필터 누락

웹 MobileDirectory.tsx의 distinct 부서 칩 필터가 RN DirectoryScreen.tsx에 없음(서버 페이지네이션 이유로 의도적 제거). → 부서 기준 직원 탐색 수단 소실.

4. 프로필 필수서류 제출·조회 누락

웹 MobileProfile.tsx:376-505의 필수서류 아코디언(UPLOAD/PASTE/SIGN 처리, 재제출/취소, 상태 배지)이 RN에 전무. RN ProfileScreen.tsx는 PC 안내만 표시.

🟠 MEDIUM — 보조/완결성

• 휴가 촉진 응답 이력 섹션 — RN에 신청 이력만 있고 촉진 응답 이력 없음
• 결재 '전체' 통합 탭(근태+서류 날짜순 합본) — RN은 근태/서류 2탭만
• 결재 서류 본문 리치 렌더 — RN은 하드코딩 ~15개 라벨 key-value 표로 대체, 커스텀 폼은 raw key 노출
• 조직도 임직원 상세 '메시지 보내기' — RN 미구현
• 대시보드 허용시간 밖(EARLY/LATE) → 출퇴근요청 폴백 분기 — RN은 권한거부/반경밖만 폴백
• 대시보드 계약 미서명(ATT_CONTRACT_UNSIGNED) '날인하러가기' 액션 — RN 토스트에 액션 버튼 미지원
• 출퇴근 인증방식 선택 드롭다운 + 마지막 방식 기억 — RN 단일 GPS
• 출퇴근 폴백 요청 시 GPS 주소(역지오코딩) 첨부 — RN은 좌표만, 결재자에게 주소 미노출
• 신청서 서명/도장 입력 — RN은 'PC에서 작성' 안내만
• 신청서 리치 붙여넣기(PASTE) — RN은 plain 텍스트만, 서식·표 유실
• 프로필 서류함(계약서/보관함/제증명서) + 계약서 보기·PDF·서명 — RN 전무
• 프로필 자격증·면허 목록 + 만료/임박 배지 — RN 전무
• 프로필 계약 게이트 배너 상태별 구분(hard/hard_pending) — RN은 단일 카드로 축소

🟡 LOW — 소소한 격차

• 공지 본문 하이퍼링크 — RN logic.ts:127이 인라인 태그 제거해 href 소실
• 연장근로 사유 입력 maxLength=500(RN) vs 웹 무제한 — 긴 사유 RN 잘림
• 근무표 개인화 헤드라인('{이름}님의 이번 주 근무') — 웹만, RN은 고정 타이틀
• 출퇴근 개인화 헤더 H1, GPS 지속추적/수동 재조회 — RN은 1회 측정
• 대시보드 위치권한 사전경고 배너, 위치 수동 재조회, 최근 공지 딥링크 — RN 축소
• 메시지 새 대화 picker 부서 계층 트리(웹) vs 평면 칩(RN), 프로필 사진(웹) vs 이니셜(RN)
• 결재 상세 '~님 결재중' 대기 결재자 표시 — RN 상세 시트 미표시

착수 권장 순서

1. 1.출퇴근 QR·IP (RN) — 실사용 직접 차단. RN CheckInSheet에 인증방식 선택 + QR 스캔·IP 경로 추가. 최우선.
2. 2.휴가 촉진 응답 (RN) — vacation/api.ts에 promotion 래퍼 2개 + 배너 + 응답 시트(1차/2차) + 내역.
3. 3.프로필 필수서류·서류함·자격증 (RN) — UPLOAD·PASTE 제출, 계약서/서류/제증명서 조회, 자격증 목록.
4. 4.신청서 서명·붙여넣기·본문 리치 렌더 (RN) — TemplatePreview 엔진 이관 규모 검토.
5. 5.결재 통합탭 / 조직도 필터·메시지 / 대시보드 폴백·계약 액션 — 완결성.

[FINAL-VERIFICATION.md]

목적: 코드·Expo 개발 환경에서 확인할 수 없는 스토어 서명, 외부 HTTPS 링크 연결, 오프라인 콜드스타트와 실제 기기 동작을 최종 릴리스 후보 빌드에서 확인한다.

현재 판정 (2026-09-01)

• /set-password/[token] 화면과 simplehr.co.kr 링크 수신 설정이 구현되어 있다.
• Expo Go 확인은 최종 증빙이 아니다. Bundle ID, package name, Associated Domains·App Links 서명을 사용하지 않는다.
• EAS development·preview 빌드는 화면 진입과 토큰 처리의 사전 확인에만 사용한다.
• iOS는 TestFlight production 빌드, Android는 Play internal production AAB와 같은 서명의 빌드에서 확인해야 완료다.
• Android App Link 최종 판정은 보류. Play Console 접근 권한과 Play 앱 서명 SHA-256 미확인. 업로드 키나 EAS 키를 Play 앱 서명 키라고 가정하지 않는다.
• 운영 assetlinks.json에 REPLACE_WITH_PLAY_APP_SIGNING_SHA256 자리표시자가 2026-09-01 기준 여전히 잔존. 수정된 프런트 배포 후 재확인 필요.
• 저장 세션 갱신이 네트워크·5xx로 일시 실패하면 로그인 화면으로 보내지 않고 세션·푸시·오프라인 캐시를 유지한 연결 복구 안내를 표시하도록 구현. 수동 재시도, NetInfo offline→online 전환, 포그라운드 복귀 시 단일 요청으로 세션을 재확인.
• 오프라인 복구 코드와 자동 검증은 완료. 실제 오프라인 콜드스타트 판정은 TestFlight·Play internal RC에서 보류.

자동 검증 현황 (2026-09-01 14:33 KST)

• 일시적 refresh 실패 시 unauthenticated가 아닌 offline 전환 + 저장 세션·푸시 등록 유지 — 단위 테스트 확인 ✅
• 수동 다시 연결 / NetInfo offline→online / 포그라운드 복귀 세션 복구 및 단일 refresh 요청 공유 — 확인 ✅
• 401·403 확정 거부 시에만 로그인 상태·푸시 등록 정리; 진행 중 복구 결과가 새 세션을 덮어쓰지 않음 — 확인 ✅
• iOS·Android Expo export 성공 ✅

⚠️ 위 자동 검증은 RN 로직과 번들 생성을 증명하지만, 스토어 서명 빌드의 네이티브 NetInfo·SecureStore 콜드스타트 증빙은 아니다.

릴리스 후보 점검 단계

1단계 — 최종 빌드 전

• 최종 RC SHA, 앱 버전, iOS build number, Android versionCode 기록
• production origin: API https://simplehr.co.kr, WebSocket wss://simplehr.co.kr 확인
• iOS AASA가 https://simplehr.co.kr/.well-known/apple-app-site-association에서 HTTP 200·리다이렉트 없이 제공되고 P2A3SM9Q2G.kr.co.simplehr.mobile과 /set-password/* 포함 확인
• iOS production signed entitlements에 com.apple.developer.associated-domains·applinks:simplehr.co.kr 포함 확인
• Play Console → 앱 무결성에서 앱 서명 키 인증서 SHA-256 확인 (업로드 키 아님)
• 운영 assetlinks.json HTTP 200·application/json·리다이렉트 없음, kr.co.simplehr.mobile 및 Play 앱 서명 SHA-256만 유효하게 포함 확인
• Google Digital Asset Links 조회에서 statement 반환 + MALFORMED_CONTENT·자리표시자 오류 없음 확인

2단계 — 스토어 내부 배포

• eas build -p ios --profile production 실행 → build ID·source SHA 기록
• eas build -p android --profile production 실행 → AAB build ID·source SHA 기록
• iOS production 빌드 → TestFlight, Android production AAB → Play internal 업로드
• QA 기기에 내부 배포 채널에서 받은 빌드 새로 설치 (Expo Go·preview APK 결과로 대체 불가)
• 양 플랫폼 Bundle ID/applicationId = kr.co.simplehr.mobile, QA 빌드와 제출 후보 build ID 일치 확인

3단계 — 실제 기기 링크 확인

iOS (TestFlight)

• Mail·메시지·메모 앱에서 https://simplehr.co.kr/set-password/{token} 탭 시 Safari 대신 SimpleHR 비밀번호 설정 화면 진입 확인
• 메모 앱에서 링크 길게 눌렀을 때 SimpleHR 앱으로 열기 선택지 표시 확인
• 미동작 시 AASA 응답·Team ID·Bundle ID·signed entitlements·Apple CDN 캐시 확인 후 새 설치 재검증

Android (Play internal)

• USB 디버깅으로 연결 후 아래 명령에서 simplehr.co.kr: verified 확인:

  adb shell pm verify-app-links --re-verify kr.co.simplehr.mobile
  adb shell pm get-app-links kr.co.simplehr.mobile

• 이메일의 https://simplehr.co.kr/set-password/{token} 링크 탭 시 브라우저·앱 선택창 없이 SimpleHR 화면 직접 진입 확인
• 링크 수동 허용 설정으로 성공시켜 완료 처리 불가

공통 폴백·완료 기준

• 앱 미설치 기기에서 같은 링크가 웹 비밀번호 설정 페이지로 열리는지 확인
• 웹에서 새 비밀번호 설정 완료 후 모바일 앱에서 새 비밀번호로 로그인 확인
• 만료·잘못된 토큰 시 흰 화면·무한 로딩 대신 명시적 오류와 재시도 경로 표시 확인
• 양 플랫폼 같은 RC build에서 위 항목 통과 후에만 외부 링크 연결을 완료로 기록

4단계 — 오프라인 콜드스타트·세션 복구

iOS (TestFlight production)

• 정상 QA 계정 로그인·홈 진입 확인 후 앱 완전 종료
• Wi-Fi·셀룰러 모두 끈 상태에서 앱 재기동 시 로그인 화면·흰 화면 대신 SimpleHR에 연결할 수 없어요 안내 + 다시 연결 버튼 표시 확인
• 오프라인 상태에서 다시 연결 탭 시 중복 입력 차단·실패 후 안내 화면 복귀·저장 로그인 정보 유지 확인
• 앱 종료 없이 네트워크 복구 시 자동으로 저장 세션 재확인 후 홈 진입 확인 (자동 복구 없으면 제출 후보 승격 불가)

Android (Play internal production AAB)

• 정상 QA 계정 로그인·홈 진입 확인 후 앱 완전 종료
• 비행기 모드·Wi-Fi·모바일 데이터 차단 상태에서 앱 재기동 시 로그인 화면·흰 화면 대신 SimpleHR에 연결할 수 없어요 안내 + 다시 연결 버튼 표시 확인
• 오프라인 상태에서 다시 연결 탭 시 중복 입력 차단·실패 후 안내 화면 복귀·저장 로그인 정보 유지 확인
• 앱 종료 없이 네트워크 복구 시 자동으로 저장 세션 재확인 후 홈 진입 확인 (자동 복구 없으면 제출 후보 승격 불가)

완료 기준: iOS·Android 모두 같은 RC에서 오프라인 안내와 네트워크 복구 후 자동 재진입이 확인되어야 이 항목을 완료로 기록. 한 플랫폼이라도 로그인 화면으로 잘못 이동하거나 앱 재실행으로만 복구되면 심사 제출 보류.