KR Actual Salary (한국 연봉 실수령액 계산기)

한국의 연봉을 입력받아 월/연 실수령액을 정확하게 계산하는 CLI 도구입니다.

📋 개요

이 도구는 한국의 세법과 사회보험 제도를 기반으로 연봉에서 실제 받을 수 있는 실수령액을 계산합니다. 2025년 기준의 세율과 사회보험료율을 적용하여 정확한 계산을 제공합니다.

주요 기능

• 간편한 입력: 연봉을 만원 단위로 입력 (예: 5000 → 5,000만원)
• 정확한 계산: 2025년 기준 세법 및 사회보험 제도 반영
• 상세한 내역: 각종 공제 항목별 상세 내역 제공
• CLI 인터페이스: 터미널에서 바로 사용 가능

계산 항목

사회보험 (근로자 부담)

• 국민연금: 4.5% (월 39만원~590만원 구간)
• 건강보험: 3.545%
• 장기요양보험: 건강보험료의 12.95%
• 고용보험: 0.9%

세금

• 소득세: 누진공제식 (6%~45% 구간별 세율)
• 지방소득세: 소득세의 10%
• 근로소득세액공제: 산출세액의 55% (한도 적용)

공제

• 비과세 수당: 월 20만원 (식대)
• 근로소득공제: 총급여 기준 구간별 공제
• 기본공제: 1인당 150만원

🚀 설치 및 사용법

설치

# 프로젝트 클론
git clone <repository-url>
cd kr-actual-salary

# 의존성 설치
yarn install

# 빌드
yarn build

사용법

# 개발 모드로 실행
yarn dev

# 빌드된 버전 실행
yarn start

실행 후 연봉을 만원 단위로 입력하세요:

연봉을 "만원 단위"로 입력해주세요 (예: 5000) > 5000

출력 예시

======================================
     KR Actual Salary (간편 계산기)     
======================================
연봉을 "만원 단위"로 입력해주세요 (예: 5000) > 5000
--------------------------------------
연봉(총액): 50,000,000원
월 총액   : 4,166,666원
비과세(월): 200,000원
과세급여(월): 3,966,666원
--------------------------------------
공제(월):
  - 국민연금: 178,500원
  - 건강보험: 140,618원
  - 장기요양: 18,230원
  - 고용보험: 35,700원
  - (소계) 사회보험 합계: 373,048원
  - (소계) 소득세/지방세: 1,234,567원
  - (소계) 공제 합계   : 1,607,615원
--------------------------------------
월 실수령액: 2,559,051원
연 실수령액: 30,708,612원
--------------------------------------

🧪 테스트

# 테스트 실행
yarn test

# 테스트 UI 실행
yarn test:ui

# 테스트 한 번만 실행
yarn test:run

📁 프로젝트 구조

kr-actual-salary/
├── src/
│   ├── index.ts          # 메인 로직
│   └── index.test.ts     # 테스트 파일
├── dist/                 # 빌드 결과물
├── package.json
├── tsconfig.json
├── vitest.config.ts
└── README.md

🔧 기술 스택

• TypeScript: 타입 안전성 보장
• Node.js: CLI 실행 환경
• Vitest: 테스트 프레임워크
• tsup: 빌드 도구
• Yarn: 패키지 관리자

📊 계산 정확성

이 도구는 다음 기준을 적용합니다:

• 2025년 기준 세율 및 사회보험료율
• 2023~2024 귀속 소득세 누진공제 구간
• 정확한 공제 계산: 근로소득공제, 세액공제, 인적공제
• 사회보험 상/하한 적용 (국민연금)

⚠️ 주의사항

• 이 도구는 참고용으로만 사용하세요
• 실제 세금 계산은 세무 전문가와 상담하시기 바랍니다
• 세법 변경 시 정확성에 차이가 있을 수 있습니다
• 개인별 상황(부양가족, 추가소득 등)에 따라 결과가 다를 수 있습니다

📝 라이선스

MIT License

기여하기

버그 리포트나 기능 제안은 이슈로 등록해주세요. 풀 리퀘스트도 환영합니다!

---

면책조항: 이 도구는 교육 및 참고 목적으로만 사용되어야 하며, 실제 세무 신고나 법적 구속력이 있는 계산에는 사용하지 마세요.