SimpleHR 전체 개요 (홈)

sources: ['SimpleHR정리.txt', 'conversation', 'fix-task-0530.md', 'fix-task-0601.md', 'fix-task-0602.md', 'fix-task-0603.md', 'fix-task-0604.md', 'fix-task-0605.md', 'fix-task-0608', 'fix-task-0609', 'fix-task-0611', 'fix-task-0612', 'fix-task-0615']

SimpleHR은 기업의 인사·근태·급여·계약 업무를 통합 처리하는 SaaS 기반 HR 관리 시스템이다. 회사 기본 설정(로고·직인·회계 정책)에서 시작하여 조직 구조 편성, 직원 등록 및 온보딩, 근로 정책 적용, 출퇴근 기록 및 근태 집계, 급여 명세서 발행, 근로계약서 발송·날인, 결재 문서 관리, 그리고 요금제 과금까지 HR 업무 전 주기를 하나의 플랫폼에서 제공한다. 2026년 5월 26일 진행된 전반 검토 미팅을 시작으로 6월 한 달간 집중적인 버그 수정과 기능 개선이 이루어지고 있으며, 완료된 패치와 미완료 이슈가 날짜별 수정 태스크 파일로 상세히 기록되어 있다.

시스템 도입의 첫 단계는 회사 기본 설정이다. 관리자는 로고와 회사명을 등록하고, 근로계약서에 자동으로 삽입될 직인(서명)을 설정한다. 회계 정책 및 급여 기간 설정에서는 월급 지급일, 급여 산정 기간, 급여 기초 항목 등을 지정하며, 이 설정은 전사 또는 조직별로 달리 적용할 수 있다. 회의 기록에 따르면 초기 설정 완료 후 우측 skeleton이 노출되는 버그가 보고되어 수정 완료되었다. [fix-task-0602.md]

휴일 관리 (전체 적용·부서별 적용)는 공휴일 및 회사 지정 휴일을 전사 또는 부서 단위로 구분하여 관리하는 기능이다. 현재 전체 적용 탭과 부서별 적용 탭 분리는 미완료 상태이지만, 전사 휴일을 지정하면 모든 직원의 내 근무·일정관리 달력에 휴일로 즉시 표시된다. 휴일 설정은 근로 정책 유형 (소정·선택·간주·교대·변형 근무)의 소정근로일 산정, 근태 관리의 출결 집계, 급여 관리의 휴일 근로 가산 수당 계산에 직접 영향을 미친다. [fix-task-0608]

조직 관리 및 계층 구조는 SimpleHR의 뼈대를 이루는 기능이다. 최상위 본사 개념의 조직 아래 파견·지사·팀 단위의 하위 조직을 계층적으로 편성한다. 조직장을 지정하면 해당 인원에게 관리자 페이지 접근 권한이 자동 부여되며, 조직장은 자신과 하위 조직의 데이터만 열람·수정할 수 있다.

조직 구성에는 직무 관리 (직무·직급·직책 구성)가 필수적으로 연동된다. 초기에는 직위(직급)와 직책(보직)의 2단 구성이었으나, 2026-05-30 수정 이후 직무(담당 업무)를 추가한 3단 구성으로 확장되었다. 직위는 과장·대리·사원 같은 직급, 직책은 팀장·부장 같은 보직, 직무는 개발·기획·영업 같은 업무 성격을 의미한다. 신규 직원 등록 시 직무 선택이 가능해졌고, 선택된 직무는 근로계약서 관리 (작성·발송·이력)에도 자동 반영된다. [fix-task-0530.md]

직원 등록 및 온보딩은 신규 직원을 시스템에 추가하고 근로계약서·필수서류 작성까지 이어지는 온보딩 흐름의 시작점이다. 등록 방식은 화면 내 개별 등록과 엑셀 일괄 등록 두 가지이며, 엑셀 이관 시 중복 처리 로직이 미비하다는 점이 지적되어 추가 검토가 필요하다. 직원 등록 시에는 계약 형태(정규직·계약직·파견직), 근무지, 근로 정책 유형 (소정·선택·간주·교대·변형 근무), 직무, 급여 정보, 직위·직책을 입력한다. 급여 정보는 기본급·업무수당·직책수당·자격수당·직급수당·고정연장수당 항목만 허용되며, 급여 합계는 자동 계산된다. [fix-task-0530.md]

등록 완료 후에는 직원 이메일로 초대 링크가 발송되며, 직원이 가입 절차를 거쳐 계정을 활성화한다. 입사일이 오늘 이후인 경우 근로계약서 작성 완료 전까지 계정 사용이 제한된다. [fix-task-0602.md]

직원 재직 상태 관리 (재직·휴직·휴가·병가·퇴직)는 등록된 직원의 상태를 재직·휴직·휴가·병가·퇴직·기타로 세분화하여 추적하는 기능이다. 상태 변경은 근로자 신청 → 관리자 승인 → 상태 표시 흐름으로 처리되며, 휴직서·휴가신청서·병가신청서·사직서 등 해당 서류 제출과 연동된다. [fix-task-0601.md]

SimpleHR은 근로 정책 유형 (소정·선택·간주·교대·변형 근무) 5가지를 지원한다. 소정 근무는 정해진 출퇴근 시간 기준, 선택(유연) 근무는 허용 시간 범위 내 자유 출근, 간주 근무는 외근 영업직처럼 출근 기록 없이도 근무 인정, 교대 근무는 주간·야간 등 순환 패턴, 변형 근무는 인원 변동(휴가·결근)에 따라 근무 시간 패턴을 사전 정의하고 근무표에 적용하는 방식이다. 출근 시간 기록은 실제 시간·고정 시간·단위 시간(올림) 중 선택할 수 있으며, 주 52시간 초과 여부 자동 체크 기능도 포함되어 있다. [SimpleHR정리.txt]

교대·변형 근무 구현에서 교대 부서 조회 하이브리드 방식 (policy_service.py)이 중요하다. policy_service.py의 부서 조회 로직은 관리자가 UI에서 부서별 근로정책을 할당한 경우의 DepartmentWorkPolicy 경로와, 시드 데이터처럼 직원에게 직접 shift_team_name이 배정된 경우의 Employee fallback 경로 두 가지로 구성된 하이브리드 방식으로 작동한다. [fix-task-0602.md]

근태 관리는 일별 출퇴근 현황, 주·월 단위 집계, 지각·연차·조퇴 등 상세 표시를 담당한다. GPS 기반 모바일 출퇴근을 지원하나 GPS 정확도 한계가 있으며, 퇴근 미기록 시 자동 처리 방식은 별도 결정이 필요하다. 조직장은 자신의 소속 조직 데이터만 열람 가능하도록 권한 제어가 적용된다. [SimpleHR정리.txt]

연장 근로 신청·승인·급여 반영 흐름은 신청 → 결재 승인 → 급여 자동 반영 순으로 구성되어야 하나, 승인 후 급여 자동 반영은 현재 미구현 상태이다. 연장 근로 현황 페이지에서 신청 후 목록이 갱신되지 않는 버그는 2026-06-04 패치에서 수정되었다. [fix-task-0604.md]

근로계약서 관리 (작성·발송·이력)와 근로계약서 관리 (작성·연장·날인·검증)는 SimpleHR에서 가장 많은 이슈가 보고된 영역이다. 직원 등록 시 계약시작일을 입사일과 독립적으로 입력할 수 있도록 필드가 분리되었으며, 계약시작일 입력 후에만 계약서 양식 선택이 가능하고, 양식 선택 시 EmployeeContract draft가 자동 생성된다. 계약 연장 시에는 기존 계약서를 기반으로 기간을 수정한 뒤 재날인하며, 1차·2차·N차 연장 이력이 목록에 표시된다. 계약 연장 방식은 계약연장·자동연장·무기한으로 구분될 예정이다. [fix-task-0604.md] [fix-task-0605.md]

미완료 이슈로는 날인 날짜 오류(23일 생성 시 22일 표시), 시작일·종료일과 계약서 내 근로개시일 불일치, 계약만료 7일 전 관리자 알림 및 직원 목록 배지 표시(완료), 작성일보다 서명일이 앞서는 날짜 정합성 오류 등이 있다. [fix-task-0605.md] [fix-task-0611]

휴가 관리 (연차·특별 휴가)는 연차(0.5일 단위 사용)와 특별 휴가(병가·출산 휴가·생리 휴가·여름 휴가 등)를 구분 관리한다. 연차를 제외한 모든 휴가는 신청 시에만 발급되도록 정책이 수정되었으며, 이는 병가처럼 사전에 발생 여부를 알 수 없는 휴가 유형에 대한 과다 발급을 방지하기 위한 조치이다. 시스템 도입 전 사용한 휴가를 수동으로 차감하는 기능(사유 기록 포함)도 필요하다는 요구 사항이 제기되어 있다. [fix-task-0604.md] [SimpleHR정리.txt]

만근 수당 (기준·구현 현황·이슈)은 결근·지각이 있어도 만근 수당이 지급되는 문제가 미완료 상태로 이월되어 있는 항목이다. 만근 수당 지급 기준이 시스템에 명확히 정의되지 않아 개선이 필요하다.

급여 관리는 기본급·연장 수당 등 급여 항목 기초 설정, 급여 명세서 생성·발송을 담당한다. 회계 정책 및 급여 기간 설정에서 월급 지급일과 급여 기간을 설정하면 해당 정책에 따라 명세서가 산정된다. 연장 근로 승인 후 급여 자동 반영 흐름은 현재 미구현 상태로, 연장 근로 신청·승인·급여 반영 흐름과의 연동이 향후 과제로 남아 있다. [SimpleHR정리.txt]

권한 관리는 역할(Role)과 조직 범위(Scope) 두 축으로 구성된다. 역할은 최고관리자·중간관리자·조직관리자·일반관리자·일반 직원으로 구분되며, 기업 최초 가입 시 4종 관리자 유형이 자동 생성되고 첫 번째 관리자에게 최고관리자 권한이 자동 부여된다. 이전에는 기업 가입 후 최고관리자 설정에 실패하는 버그가 있었으며, 2026-06-12 수정에서 해결되었다. 일반 관리자는 지정된 권한 조직에 속한 직원만 조회할 수 있으며, 권한 조직이 0개인 경우 직원관리 화면에 아무도 표시되지 않는 문제가 보고·안내 개선 조치되었다. [fix-task-0612] [fix-task-0608]

초기 설계에서는 급여 관리자·인사 관리자 역할이 별도로 존재했으나, 현재는 통합된 관리자 체계로 운영 방향이 변경되었다. [SimpleHR정리.txt]

결재 및 문서 조회 (기안서·신청서·사직서 흐름)는 기안서·신청서·사직서 등 다양한 결재 문서의 작성·조회·승인 흐름을 처리한다. 사직서는 '신청'이 아닌 '제출(결재에 올리기)' 흐름으로 변경되었으며, 관리자 결재 관리에서 휴가·연장근로 상세(유형·기간·일수·사유)와 기안서·신청서의 소속·직위 정보가 구조화되어 표시된다. 기업 사용자 결재 화면의 깜빡임 제거 및 UI 개선도 2026-06-15 기준 완료되었다. [fix-task-0615]

회사 양식 및 서류 관리에서는 직원이 반드시 제출해야 하는 필수 서류와 자유롭게 신청하는 신청 서류를 구분하여 관리한다. 양식 내 회사명·사용자명·고용 형태 등 자동 완성 변수 지원이 구현되어 있으며, 결재선 설정과 필수 서류·근로계약서·직원 서류를 한 화면에서 현황 확인하는 통합 조회 기능은 개선 과제로 남아 있다. [SimpleHR정리.txt]

SimpleHR은 PC와 모바일 앱을 동시에 지원한다. 모바일 UI 개선 (기업사용자 홈·일정·알림)을 통해 홈 하단 메뉴 순서가 휴가·일정관리·급여·서류 순으로 변경되었고, 일정관리 화면이 모바일 스타일로 전환되었으며, 알림 배경이 흰색으로 통일되어 디자인 시스템에 맞춰졌다. [fix-task-0603.md]

토스트 알림 UI 통일 (PC 기업 관리자)는 PC 기업 관리자 화면 전반의 인라인 토스트 알림을 공통 컴포넌트로 일원화한 작업이다. 이를 통해 각 화면마다 다르게 표시되던 성공·오류·경고 알림이 일관된 디자인으로 통합되었다. [fix-task-0605.md]

SimpleHR 모바일 앱 미완료 이슈에는 2026-06-08 기준 사용자 문의 조치 현황과 미완료 항목이 정리되어 있다. 인증이 풀렸음에도 관리자 페이지에 데이터 없는 상태로 접근 가능한 보안 이슈도 미완료 항목으로 남아 있다. [fix-task-0605.md]

SimpleHR 이용요금 및 과금 방식과 이용요금 및 과금 방식은 직원 수 구간별 요금 체계와 플랜별 메뉴 제공 범위를 정의한다. 요금제 관리 (시스템 관리자·체험판·정산)에서 시스템 관리자는 단가·좌석·과금 구간을 직접 편집하고, 체험판 적용 여부 및 일수를 지정하며, 만료 후 연장 또는 정식 전환을 처리한다. 최고관리자용 정산 페이지에서는 이용 인원·금액 등을 확인할 수 있다. 자동 합산 청구 기능은 아직 미완료 상태이다. [fix-task-0615]

CI/CD 및 배포 파이프라인은 코드 푸시 시 자동 빌드·배포가 이루어지는 구조로 구성되어 있다. Playwright 기반 E2E 테스트를 통과한 후 자동 배포되며, 기능 변경 시 테스트 코드도 함께 수정해야 배포가 정상적으로 진행된다. [SimpleHR정리.txt]

데이터 이관 계획은 기존 운영 시스템(HNT, 유니S 등)의 출퇴근 기록·직원 정보를 SimpleHR로 이전하는 작업이다. HNT 데이터를 먼저 적재한 후 유니S 데이터를 이관하며, TFT 소규모 환경에서 검증 후 약 3,000명 수준의 대규모 환경에 적용한다. 전환 시 약 1분간 서비스 중단이 발생할 수 있고, DB 구조 변경 시 기존 데이터와의 통합 문제, 백업 복원 복잡성 등이 주요 위험 요소이다. 2026-06-15 기준 실제 데이터 이관과 테스트 계정 생성은 미완료 상태이다. [fix-task-0615]

날짜별 수정 태스크 파일은 개발 진행 상황의 공식 기록이다. 2026-05-30 패치 노트 상세 (기업관리자·조직·직원 등록 수정사항)에서는 교대·변형근로 이력 보존, 직무 관리 신설, 직원 등록 급여 정보 개편이 다루어졌다. 2026-06-04 패치 노트 상세 (PC·모바일 수정사항)에서는 근로계약서 입사일·계약시작일 분리, 교대 근무 패턴 오류 수정, 토스트 알림 버그 수정 등이 완료되었다. 2026-06-08 패치 노트에서는 근로정책·출퇴근관리·근로계약서·휴일관리 전반의 수정 사항과 사용자 문의 13건 조치가 이루어졌다.

6월 1일~5일 패치 수정 내역 편찬에 따르면 해당 기간 총 30건 중 완료 9건, 미해결 21건이 기록되었다. 0610 수정사항 및 이슈에서는 직원 부서 변경 기능, 출퇴근관리 날짜별 재직인원 연동, 근무 일정 UI 표시 개선 3건이 미처리 항목으로 식별되었다. SimpleHR 주요 이슈 및 개선 사항 페이지에서 전체 미완료 항목을 통합하여 확인할 수 있다.

현재 완료 대기 중인 주요 미완료 작업은 remaining-tasks에서 확인할 수 있다.

테스트 접속이 필요한 경우 샘플 계정 페이지를 참조한다. LMS 운영사를 대상으로 한 별도 내부 관리 시스템 요구 사항은 LMS 관리 시스템 페이지에서 확인할 수 있다.