Simple HR 프로젝트 개요

Simple HR은 기업 인사 관리를 위한 HR SaaS 플랫폼으로, PC 및 모바일 환경을 모두 지원한다. 직원 등록·계약·근태·결재·교대근로·휴가 등 HR 전반을 커버하며, 별도의 홈페이지를 통해 사용 신청 및 요금제 안내를 제공한다.

현재 요금제 시스템 구현 설계가 진행 중이며, 플랜별 메뉴 제한, DB 스키마, API, 프론트엔드 변경사항을 포괄한다.

요금제 시스템 구현 설계에 따라 다음을 구현한다:

플랜 구조

[설계-요금제시스템.md]

과금 공식

재직인원 ≤ 5명     → 0원
5 < 재직인원 ≤ 10명 → 월 20,000원 (PLAN_FREE는 0원)
재직인원 > 10명     → 20,000 + (재직인원 - 10) × 1인당 단가

예: 스탠다드 11명 = 20,000 + 1 × 3,000 = 23,000원 [설계-요금제시스템.md]

핵심 변경사항

DB 스키마

• billing_plans 테이블 신규 생성 (플랜 코드, 단가, 기본료 관리)
• billing_snapshots 테이블 신규 생성 (월별 과금 스냅샷 및 이력)
• tenant_billing_overrides 테이블 (업체별 커스텀 단가, 구조만 우선)
• tenants.plan_code 필드 기존 → PLAN_FREE/BASIC/STD/SPC로 통일

API (시스템관리자)

• GET /v2/system/billing-plans — 플랜 목록 조회
• PUT /v2/system/billing-plans/{plan_code} — 단가 수정
• GET /v2/system/usage — 테넌트별 사용량 및 과금 실시간 조회
• POST /v2/system/billing-snapshots/generate — 월별 스냅샷 생성
• PATCH /v2/system/tenants/{id}/trial — 체험판 연장/단축/정식 전환

API (회사 최고관리자, 읽기 전용)

• GET /v2/admin/billing/current — 현재 월 과금 정보
• GET /v2/admin/billing/history — 청구 이력

플랜별 메뉴 제한

• Menu.visible_tiers JSONB 필드를 권위 소스로 사용
• 이러닝·전자근로계약서 메뉴만 ["PLAN_STD", "PLAN_SPC"]로 제한
• 나머지 메뉴는 ["PLAN_FREE", "PLAN_BASIC", "PLAN_STD", "PLAN_SPC"]
• menu_permission_guard 미들웨어에 플랜 체크 추가

프론트엔드

• 시스템관리자: 요금제 관리, 회사 관리 플랜 드롭다운, 사용량 대시보드, 라이센스 메뉴 관리
• 회사 최고관리자: 정산 페이지 신규 추가 (플랜, 인원, 단가, 기본료, 추가분, 합계, 청구 이력)

[설계-요금제시스템.md]

• 수정 로그: fix-task-0612.md, fix-task-0610.md, fix-task-0603.md, fix-task-0602.md, fix-task-0601.md
• 의사결정: 의사결정 로그
• 액션 아이템: 액션 아이템
• 버그 수정 현황: 버그 수정 및 기능 개선 현황 (0612)
• 직원 재직 상태 변경: 직원 재직 상태 변경 워크플로
• 요금제 설계: 설계-요금제시스템.md