SimpleHR project

요금제 시스템 구현 설계와 이용요금(과금) 정책 스펙에 따라 4개 플랜이 운영된다. [설계-요금제시스템.md]

과금 공식: 재직인원 5명 이하 무료 → 6~10명 월 20,000원 → 11명 이상 20,000 + (인원 − 10) × 단가. 플랜별 메뉴 접근 제한은 Menu.visible_tiers JSONB 필드를 권위 소스로 삼아 미들웨어 + 프론트엔드 양쪽에서 제어한다. [설계-요금제시스템.md]

• 온보딩: 6→8단계 개편으로 완료 판정 방식이 데이터 존재 → 명시적 배열 추적으로 전환됨 [초기 설정 가이드 구조 개편 설계]
• 직원 등록: 직원 등록 플로우 — 일괄 엑셀 등록, 부서 변경, 필수 서류 자동 생성 포함
• 근로계약서: 관리팀이 발송해야 직원이 열람 가능 (자동 생성 방식 비채택) [미팅노트.txt]
• GPS 출퇴근: GPS 출퇴근 스펙 — 반경 내 즉시 처리, 반경 외 관리자 승인
• 퇴근 미체크 자동 처리: 매일 KST 00:15 스케줄러 실행, AUTO_END_TIME / LEAVE_BLANK 두 모드 [fix-task-0624 (26년 06월 24일 수정사항)]
• 연장근로: 신청 → 결재 승인 후에만 급여 반영 (무단 연장 불인정) [미팅노트.txt]
• 사직서: 사직서 처리 워크플로 스펙 — Document 기반 전환 완료 [fix-task-0709]
• GPS/IP/QR 출퇴근 폴백: 2026-08-03 배포에서 GPS 정확도 부족 시 IP·QR 방식으로 자동 폴백하는 로직이 수정 완료되었다. fix-task 0803 — 수정완료 항목 [fix-task 0803 — 수정완료 항목]

근무 정책과 급여 정산 사이의 연동은 핵심 미해결 과제 중 하나다. 근무 정책 ↔ 급여 연동 현황 및 이슈와 급여 계산 하드코딩 이슈 목록에 상세 분석이 정리되어 있다. [근로정책-급여-연동-현황분석.md]

(주) 에이치앤티아웃소싱시스템 (사업자번호 166-81-63798, 직원 29명)을 첫 번째 이관 대상으로 삼아 검증 이관을 진행했다. [hnt-migration-status.md]

• 이관 완료 항목: 직원 기본정보, 근로계약서, 조직 구조, 출퇴근 레코드
• 미연결 항목: 일부 계약 form_id 누락, scheduled_end NULL 레코드 4건 (수동 처리)
• 배포 전 필수 조치: 계약일 이중저장 불일치 보정 절차 4단계 수행
• 배포 후 관리자 조치: 배포 후 관리자 조치 체크리스트 (HNT 이관) 참조

향후 유니S 데이터(규모 대형) 이관 전에 HNT 검증을 완료하는 순서로 진행한다. [미팅노트.txt]

의사결정 로그에 전체 결정 사항이 기록되어 있다. 핵심 결정만 요약하면:

E2E 테스트 시나리오 명세는 Playwright 기반으로 운영되며, 고정 테스트 계정(업체·최고관리자·직원)을 사용한다. Part 1 (관리자 대시보드·근태·직원관리)과 Part 3 (관리자↔사용자 연계)가 작성되었다. 2026-07-23 기준 모바일 API 계약 감사 결과 98개 엔드포인트 중 버그 6건(HIGH 1, medium 3, low 2)이 확인되어 보류 상태다. [기업사용자 모바일 API 계약 버그 감사 (2026-07-23)]

2026-07-29 기준 RN 앱 ↔ 웹모바일뷰 기능 격차 감사가 수행되었다. 기업 모바일의 이중 구조(RN 앱 vs 웹모바일뷰)를 12개 도메인에 걸쳐 코드 수준으로 1:1 대조한 결과, 출퇴근 QR·IP 방식 미지원 및 연차촉진 응답 부재가 최고 심각도 항목으로 확인되었다. 상세 비교표는 RN 앱 vs 웹모바일뷰 기능 격차 비교 참조. [RN 앱 ↔ 웹모바일뷰 기능 격차 감사 (0729)]