고용주와 근로자를 위한 스마트 급여 관리 플랫폼
PayCheck는 소규모 사업장의 고용주와 근로자를 위한 급여 관리 솔루션입니다.
아르바이트생의 근무 일정 관리부터 한국 노동법을 준수한 급여 자동 계산, 간편 송금까지 급여 관리의 모든 과정을 디지털화하여 수기 계산 오류를 방지하고 노동법 위반 리스크를 최소화합니다.
- 소규모 사업장에서 엑셀이나 수기로 급여를 계산하며 발생하는 계산 오류
- 야간수당, 휴일수당, 주휴수당 등 복잡한 노동법 규정 준수의 어려움
- 5인 미만/이상 사업장에 따른 차등 적용 규정 혼란
- 근로자의 급여 내역 확인 및 정정 요청 프로세스 부재
| 기능 | 설명 |
|---|---|
| 사업장 관리 | 여러 사업장 등록 및 5인 미만/이상 구분 설정 |
| 근로자 관리 | 근로 계약 체결, 시급 설정, 근무 스케줄 관리 |
| 근무 일정 관리 | 캘린더 기반 일정 등록, 일괄 등록, 실시간 수정 |
| 급여 자동 계산 | 기본급, 야간·휴일·연장·주휴수당 자동 산출 |
| 정정 요청 처리 | 근로자의 근무 시간 정정 요청 승인/반려 |
| 간편 송금 | 토스 딥링크 연동 급여 송금 |
| 기능 | 설명 |
|---|---|
| 근무 일정 확인 | 월별 근무 일정 및 캘린더 뷰 |
| 근무 완료 처리 | 당일 근무 완료 확인 |
| 정정 요청 | 근무 시간 오류 시 정정 요청 |
| 급여 명세서 | 상세 급여 내역 및 공제 항목 확인 |
| 송금 내역 | 급여 수령 이력 조회 |
- 카카오 소셜 로그인 - 간편한 회원가입 및 로그인
- 실시간 알림 - SSE 기반 일정 변경, 급여 송금, 정정 요청 알림
- 알림 설정 - 푸시, 이메일, SMS 알림 개별 설정
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ React Frontend │────▶│ Spring Boot │────▶│ MySQL │
│ │ │ Backend API │ │ │
└─────────────────┘ └────────┬────────┘ └─────────────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Kakao │ │ Toss │ │ 공공데이터│
│ OAuth │ │ Payment │ │ 공휴일 │
└──────────┘ └──────────┘ └──────────┘
- Framework: Spring Boot 3.5
- Language: Java 21
- Database: MySQL 8.0
- ORM: Spring Data JPA / Hibernate
- Security: Spring Security + JWT
- API Docs: Swagger (springdoc-openapi)
- Test: JUnit 5 + JaCoCo
- Framework: React 18
- Language: TypeScript
- State: React Query
- Styling: Tailwind CSS
- CI/CD: GitHub Actions
- Code Review: CodeRabbit AI
| 레포지토리 | 설명 | 기술 스택 |
|---|---|---|
| PayCheck-backend | Spring Boot 백엔드 API | Java 21, Spring Boot 3.5, JPA |
| PayCheck-frontend | React 프론트엔드 | React 18, TypeScript |
| PayCheck-design | 디자인 리소스 | Figma |
- 5인 미만/이상 사업장 구분에 따른 차등 적용
- 야간수당 (22:00~06:00, 50% 가산)
- 휴일수당 (주말/공휴일, 50% 가산)
- 연장수당 (일 8시간/주 40시간 초과, 50% 가산)
- 주휴수당 (주 15시간 이상 근무 시)
- 복합 가산 처리 (휴일 야간 연장 = 150% 가산)
- 비즈니스 도메인별 패키지 분리
- 풍부한 도메인 모델 (Rich Domain Model)
- 명확한 Aggregate 경계 설정
- Command/Query 서비스 분리로 책임 명확화
- 복잡한 조회 로직과 비즈니스 로직 분리
- 리소스별 Permission 클래스
- 소유권 검증 (고용주의 사업장, 근로자의 계약)
- Method Security 기반 선언적 권한 관리
| 문서 | 설명 |
|---|---|
| API 명세서 | REST API 상세 명세 |
| ERD | 데이터베이스 설계 |
| 급여 계산 정책 | 급여 계산 로직 상세 |
| 유저 플로우 | 사용자 시나리오 |
| 역할 | 이름 | 담당 |
|---|---|---|
| Backend | - | Spring Boot API 개발, 급여 계산 엔진 |
| Frontend | - | React UI/UX 개발 |
| Design | - | 서비스 디자인 |
이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참조하세요.