/SimpleHR project
SimpleHR project

SimpleHR project

conceptedited by Cairni · 방금 · AIv40

Simple HR는 중소기업을 위한 HR SaaS 플랫폼으로, 직원 등록·근로계약·근태·휴가·결재·급여·교대근로 등 인사 관리 전 영역을 PC와 모바일에서 통합 제공한다. 2026년 5월 26일 킥오프 미팅에서 기능 전반의 현황 점검이 이루어졌고, 이후 매일 수정사항 로그를 쌓으며 빠른 속도로 개선 중이다. (주) 에이치앤티아웃소싱시스템을 첫 이관 대상으로 실전 데이터를 반영했으며, 요금제 시스템·초기 설정 가이드 개편·E2E 테스트 자동화가 동시 진행되고 있다.


플랫폼 전체 구조

미팅노트.txt 설계-요금제시스템.md


핵심 기능 영역 한눈에 보기

요금제 구조

요금제 시스템 구현 설계에 따라 플랜별 기능 차등 및 구간별 과금이 적용된다. 플랜별 메뉴 접근 제한 설계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단계 수동 보정 절차를 정의한다.

AI · 출처 클릭
이관 대상 직원 수
29명
사업자번호
166-81-63798
퇴근 미체크 보정 (6/17~6/24)
19건
hnt-migration-status.md
scheduled_end NULL 수동 처리
4건
hnt-migration-status.md

hnt-migration-status.md


일별 수정사항 로그 타임라인

AI · 출처 클릭
  1. 2026-05-26
    킥오프 미팅 — 전체 기능 현황 점검, 액션 아이템 도출
  2. 2026-05-30
    버그 수정 및 기능 개선 요청 목록 정리 (직무 3단 구성, 근태 정책 변경 이력화 등)
  3. 2026-06-01
    관리자/사용자 모드 수정 요청 — 교대근로, 근로계약서, 재직 상태 세분화 등
  4. 2026-06-03
    모바일 홈 메뉴 개편, 일정관리 UX 개선, 알림 디자인 수정 완료
  5. 2026-06-15
    요금제 시스템 설계 문서 작성 (DB 스키마·API·플랜별 메뉴 제한)
  6. 2026-06-16
    HNT 데이터 이관 현황 정리 (6/16 기준)
  7. 2026-06-19
    연차 자동계산 개선, 휴가 잔액 이력, 급여명세서 기능 완료
  8. 2026-06-24
    퇴근 미체크 자동 처리 스케줄러 구현, 근무 정책 적용 시점 수정
  9. 2026-06-29
    대시보드 집계 보정, 사직서 처리, 급여관리 전 항목 완료
  10. 2026-06-30
    결재 시스템 재정립, 사직 처리 통합, 사용자 결재 페이지 탭 분리
  11. 2026-07-01
    출퇴근 관리 UI 개선, 결재 시스템 확장(사직·인사발령), 일괄 결재 처리
  12. 2026-07-02
    초기 설정 가이드 개편, GPS 출퇴근, 조직도 편집 복원, 사직서 프로세스 완성
  13. 2026-07-03
    사직서 프로세스 완성, 출퇴근 요청 승인 UI 개편, 탄력근로 기본 서류 수정
  14. 2026-07-06
    기업 사용자 모바일 및 관리자 PC 중심 우선 수정사항 반영
  15. 2026-07-09
    서류 신청 탭 통합, 사직서 Document 기반 전환, 급여-근로정책 연동 개선
  16. 2026-07-13
    모바일 사용자·PC 관리자 중점 개발·테스트 방향 명시 (완료 7건, 미완료 16건)
  17. 2026-07-14
    관리자 권한 구분, 근로정책 적용 시점, 교대근무 법정시간 초과 허용, 출퇴근 통계 오류 등 수정
  18. 2026-07-15
    근로정책 적용시점·이력 덮어쓰기 수정, 연장근로 직위 누락, 근로계약서 auto_renew 불일치 등 완료 — 미구현 버그 목록 병행 관리

주요 의사결정 요약

의사결정 로그에 전체 결정 사항이 추적되어 있다. 핵심 결정만 추리면 아래와 같다.

#결정 내용영향 영역
1Simple HR 먼저 안정화 후 LMS 관리 시스템 착수프로젝트 전체 일정
2연장근로는 신청 → 결재 승인 후에만 급여 반영attendance-management-spec
3근로계약서는 관리팀이 발송해야 직원이 열람 가능employee-registration-flow
4HNT 소규모 데이터로 먼저 검증 후 유니S 투입데이터 이관 순서
5근로정책 수정 시점 이후부터만 새 정책 적용, 과거 기록 불변work-policy-spec
6기업 사용자는 모바일 중점, 기업 관리자는 PC 중점으로 UX 설계mobile-ui-improvements

미팅노트.txt fix-task-0709


현재 미해결 이슈 및 진행 중 항목

주요 이슈 현황AI · 출처 클릭
미해결 / 확인 필요4
인증 만료 시 빈 페이지 노출 (Safari 재현 빈도 높음)
급여 계산 할증률 하드코딩 — WorkPolicy 미반영 5건
PC 출퇴근 체크 불가 문제
시스템 확인 요청 이슈 (관리자 권한, 결재선, 근로정책, 계약형태 변경 등)
진행 중4
연차 이월(Carryover) 관리자 UI 및 자동 이월 정책 구현
만근 수당 지급 기준 확정 및 구현
E2E 테스트 시나리오 잔여 대분류 완료
직원 일괄 등록 UI 및 과금 자동계산 개선
최근 완료5
사직서 처리 워크플로 구현 완료 (Document 기반 전환)
초기 설정 가이드 6→8단계 개편 완료
퇴근 미체크 자동 처리 스케줄러 구현
조직도 편집 기능 복원 (부서 추가·삭제·드래그·조직장 지정)
인사발령 결재선 연동 및 관리자 인박스 통합

fix-task-0703 (26년 07월 03일 수정사항) fix-task-0709 fix-task-0715 수정사항


연차 관련 기능 구조

연차 관련 기능은 여러 스펙 페이지에 걸쳐 설계되어 있다.


테스트 및 품질 관리

E2E 테스트는 고정 테스트 계정(업체·최고관리자·직원)을 활용하며, 관리자↔사용자 연계 핵심 흐름(직원 등록→계약→출퇴근→연장근로→휴가→급여→결재→퇴직)을 커버한다.


참고: 주요 소스 문서

문서설명
미팅노트-txt2026년 5월 26일 킥오프 미팅 회의록
설계-요금제시스템-md요금제 시스템 구현 설계서 (DB·API·과금·메뉴 제한)
hnt-migration-status-mdHNT 데이터 이관 현황 (6/16 기준)
근로정책-급여-연동-현황분석.md
초기-설정-가이드-구조-개편-설계초기 설정 가이드 6→8단계 개편 설계
bug-fix-status-0530버그 수정 및 기능 개선 현황 (0622까지)
action-items진행 중인 액션 아이템 통합 목록

All documents

Made with CairniExplore public wikis →