SimpleHR project
Simple HR는 중소기업을 위한 HR SaaS 플랫폼으로, 직원 등록·근로계약·근태·휴가·결재·급여·교대근로 등 인사 관리 전 영역을 PC와 모바일에서 통합 제공한다. 2026년 5월 26일 킥오프 미팅에서 기능 전반의 현황 점검이 이루어졌고, 이후 매일 수정사항 로그를 쌓으며 빠른 속도로 개선 중이다. (주) 에이치앤티아웃소싱시스템을 첫 이관 대상으로 실전 데이터를 반영했으며, 요금제 시스템·초기 설정 가이드 개편·E2E 테스트 자동화가 동시 진행되고 있다.
플랫폼 전체 구조
미팅노트.txt 설계-요금제시스템.md
핵심 기능 영역 한눈에 보기
| 기능 영역 | 스펙 페이지 | 현황 |
|---|---|---|
| 직원 등록 및 관리 | 직원 등록 플로우 | |
| 관리자 등급·권한 | 관리자 등급 및 권한 관리 스펙 | |
| 직무 관리 | 직무 관리 (직위·직급·직무 3단 구성) | |
| 근로계약서 | work-contract-spec · employment-contract-spec | |
| 근무 정책 | 근무 정책 스펙 | |
| 근태 관리 | 근태 관리 스펙 | |
| GPS 출퇴근 | GPS 출퇴근 스펙 | |
| 교대·변형근로 | 교대(변형)근로 관리 스펙 | |
| 휴가 관리 | 휴가 관리 스펙 | |
| 휴일 관리 | 휴일 관리 스펙 | |
| 출장 관리 | 출장 관리 스펙 | |
| 결재 관리 | 결재 관리 스펙 | |
| 인사발령 결재 | 인사발령 결재선 스펙 | |
| 사직서 처리 | 사직서 처리 워크플로 스펙 | |
| 재직 상태 관리 | 직원 재직 상태 변경 워크플로 | |
| 양식 편집기 | 양식 편집기(폼 빌더) 스펙 | |
| 급여 관리 | 급여관리 스펙 | |
| 요금제·과금 | pricing-spec · pricing-policy | |
| 모바일 UI/UX | mobile-ui-improvements · mobile-app-spec | |
| 조직도 관리 | 조직도 관리 스펙 | |
| 초기 설정 가이드 | 초기 설정 가이드 구조 개편 스펙 (6→8단계) | |
| 토스트 알림 | 토스트 알림 공통 컴포넌트 스펙 | |
| 인증 세션 | 인증 만료 시 빈 페이지 노출 이슈 | |
| E2E 테스트 | E2E 테스트 시나리오 명세 |
요금제 구조
요금제 시스템 구현 설계에 따라 플랜별 기능 차등 및 구간별 과금이 적용된다. 플랜별 메뉴 접근 제한 설계는 Menu.visible_tiers JSONB 필드를 권위 소스로 삼아 미들웨어에서 제어한다.
| 플랜 | 1인당 단가 | 주요 제약 |
|---|---|---|
| PLAN_FREE (무료) | 0원 | 이러닝·전자근로계약서 제외 |
| PLAN_BASIC (베이직) | 2,000원 | 이러닝·전자근로계약서 제외 |
| PLAN_STD (스탠다드) | 3,000원 | 전체 메뉴 |
| PLAN_SPC (스페셜) | 10,000원 | 전체 메뉴 + 페이롤 연동 |
설계-요금제시스템.md
과금 공식 (PLAN_STD 예시):
- 재직인원 ≤ 5명 → 0원
- 5 < 재직인원 ≤ 10명 → 월 20,000원
- 재직인원 > 10명 → 20,000 + (재직인원 − 10) × 단가
근무 정책 ↔ 급여 연동 현황
근무 정책과 급여 계산 간의 연동은 근무 정책 ↔ 급여 연동 현황 및 이슈에서 상세히 분석되었다. payroll_service.py 내 할증률이 하드코딩되어 있어 WorkPolicy 설정이 급여에 반영되지 않는 구조적 문제가 존재한다. 급여 계산 하드코딩 이슈 목록 및 개선 방향에 5가지 이슈와 개선 방향이 정리되어 있다.
근로정책-급여-연동-현황분석.md
HNT 데이터 이관
(주) 에이치앤티아웃소싱시스템의 레거시 데이터를 Simple HR로 이관하는 작업이 진행되었다. 전체 현황은 데이터 이관 작업 스펙 (HNT)에, 배포 후 관리자 조치 순서는 배포 후 관리자 조치 체크리스트 (HNT 이관)에 정리되어 있다. 계약일 이중저장 불일치 보정 절차는 배포 직전 4단계 수동 보정 절차를 정의한다.
hnt-migration-status.md
일별 수정사항 로그 타임라인
- 2026-05-26킥오프 미팅 — 전체 기능 현황 점검, 액션 아이템 도출
- 2026-05-30버그 수정 및 기능 개선 요청 목록 정리 (직무 3단 구성, 근태 정책 변경 이력화 등)
- 2026-06-01관리자/사용자 모드 수정 요청 — 교대근로, 근로계약서, 재직 상태 세분화 등
- 2026-06-03모바일 홈 메뉴 개편, 일정관리 UX 개선, 알림 디자인 수정 완료
- 2026-06-15요금제 시스템 설계 문서 작성 (DB 스키마·API·플랜별 메뉴 제한)
- 2026-06-16HNT 데이터 이관 현황 정리 (6/16 기준)
- 2026-06-19연차 자동계산 개선, 휴가 잔액 이력, 급여명세서 기능 완료
- 2026-06-24퇴근 미체크 자동 처리 스케줄러 구현, 근무 정책 적용 시점 수정
- 2026-06-29대시보드 집계 보정, 사직서 처리, 급여관리 전 항목 완료
- 2026-06-30결재 시스템 재정립, 사직 처리 통합, 사용자 결재 페이지 탭 분리
- 2026-07-01출퇴근 관리 UI 개선, 결재 시스템 확장(사직·인사발령), 일괄 결재 처리
- 2026-07-02초기 설정 가이드 개편, GPS 출퇴근, 조직도 편집 복원, 사직서 프로세스 완성
- 2026-07-03사직서 프로세스 완성, 출퇴근 요청 승인 UI 개편, 탄력근로 기본 서류 수정
- 2026-07-06기업 사용자 모바일 및 관리자 PC 중심 우선 수정사항 반영
- 2026-07-09서류 신청 탭 통합, 사직서 Document 기반 전환, 급여-근로정책 연동 개선
- 2026-07-13모바일 사용자·PC 관리자 중점 개발·테스트 방향 명시 (완료 7건, 미완료 16건)
- 2026-07-14관리자 권한 구분, 근로정책 적용 시점, 교대근무 법정시간 초과 허용, 출퇴근 통계 오류 등 수정
- 2026-07-15근로정책 적용시점·이력 덮어쓰기 수정, 연장근로 직위 누락, 근로계약서 auto_renew 불일치 등 완료 — 미구현 버그 목록 병행 관리
주요 의사결정 요약
의사결정 로그에 전체 결정 사항이 추적되어 있다. 핵심 결정만 추리면 아래와 같다.
| # | 결정 내용 | 영향 영역 |
|---|---|---|
| 1 | Simple HR 먼저 안정화 후 LMS 관리 시스템 착수 | 프로젝트 전체 일정 |
| 2 | 연장근로는 신청 → 결재 승인 후에만 급여 반영 | attendance-management-spec |
| 3 | 근로계약서는 관리팀이 발송해야 직원이 열람 가능 | employee-registration-flow |
| 4 | HNT 소규모 데이터로 먼저 검증 후 유니S 투입 | 데이터 이관 순서 |
| 5 | 근로정책 수정 시점 이후부터만 새 정책 적용, 과거 기록 불변 | work-policy-spec |
| 6 | 기업 사용자는 모바일 중점, 기업 관리자는 PC 중점으로 UX 설계 | mobile-ui-improvements |
미팅노트.txt fix-task-0709
현재 미해결 이슈 및 진행 중 항목
fix-task-0703 (26년 07월 03일 수정사항) fix-task-0709 fix-task-0715 수정사항
연차 관련 기능 구조
연차 관련 기능은 여러 스펙 페이지에 걸쳐 설계되어 있다.
- 연차 자동계산 로직 스펙 — 입사일 기준 자동 계산, 버그 수정 이력
- 휴가 관리 스펙 — 유형별 부여·차감·승인 프로세스
- 휴가 잔액 변동 이력 스펙 —
GET /admin/leave/balances/historyAPI, UTC→KST 변환 - 연차 이월(Carryover) 기능 스펙 — API·카드 완료, 관리자 UI 미완성
- 연차촉진 스펙 — 대상자 탭, 2·3차 재시도 차단
테스트 및 품질 관리
E2E 테스트는 고정 테스트 계정(업체·최고관리자·직원)을 활용하며, 관리자↔사용자 연계 핵심 흐름(직원 등록→계약→출퇴근→연장근로→휴가→급여→결재→퇴직)을 커버한다.
- E2E 테스트 시나리오 - Part 1 관리자 (대시보드, 근태, 직원관리) — 관리자 페이지 핵심 시나리오
- E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오 — 허빈(관리자)·김소민(직원) 교차 흐름
- E2E 테스트 시나리오 명세 — 전체 문서화 현황 및 잔여 대분류
참고: 주요 소스 문서
| 문서 | 설명 |
|---|---|
| 미팅노트-txt | 2026년 5월 26일 킥오프 미팅 회의록 |
| 설계-요금제시스템-md | 요금제 시스템 구현 설계서 (DB·API·과금·메뉴 제한) |
| hnt-migration-status-md | HNT 데이터 이관 현황 (6/16 기준) |
| 근로정책-급여-연동-현황분석.md | |
| 초기-설정-가이드-구조-개편-설계 | 초기 설정 가이드 6→8단계 개편 설계 |
| bug-fix-status-0530 | 버그 수정 및 기능 개선 현황 (0622까지) |
| action-items | 진행 중인 액션 아이템 통합 목록 |