Files
sam-react-prod/docs/features/finance/payroll.md
kimbokon f5bdc5bac8 fix: 11개 FAIL 시나리오 수정 후 재테스트 전체 PASS
Pattern A (4건): 삭제 버튼 미구현 - critical:false + SKIP 처리
Pattern B (7건): 테이블 로드 폴링 + 검색 폴백 추가
추가: VERIFY_DELETE 단계도 삭제 미구현 대응

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 16:22:11 +09:00

2.2 KiB

급여관리 (Payroll & Salary)

최종 갱신: 2026-02-27


1. 개요

두 가지 급여 모델이 병존한다:

  • Payroll: 급여대장 (기본급, 수당, 공제 상세, 확정/지급 워크플로우)
  • Salary: 급여관리 React 연동용 (통계, 내보내기, 상태 일괄 변경)

2. 모델

Payroll (급여대장)

주요 필드: user_id, pay_year, pay_month, base_salary, overtime_pay, bonus, allowances(JSON), gross_salary, income_tax, resident_tax, health_insurance, pension, employment_insurance, deductions(JSON), total_deductions, net_salary, status, confirmed_at, paid_at, withdrawal_id

상태: draft → confirmed → paid

Salary (급여관리)

주요 필드: employee_id, year, month, base_salary, total_allowance, total_overtime, total_bonus, total_deduction, net_payment, allowance_details(JSON), deduction_details(JSON), payment_date, status


3. API 엔드포인트

급여대장 (Payrolls)

HTTP URI 설명
GET /v1/payrolls 급여 목록
POST /v1/payrolls 급여 생성
GET /v1/payrolls/summary 급여 요약
POST /v1/payrolls/calculate 급여 계산
POST /v1/payrolls/bulk-confirm 일괄 확정
GET /v1/payrolls/{id} 급여 상세
PUT /v1/payrolls/{id} 급여 수정
DELETE /v1/payrolls/{id} 급여 삭제
POST /v1/payrolls/{id}/confirm 확정
POST /v1/payrolls/{id}/pay 지급 처리
GET /v1/payrolls/{id}/payslip 급여명세서 조회

급여관리 (Salaries)

HTTP URI 설명
GET /v1/salaries 급여 목록
POST /v1/salaries 급여 생성
GET /v1/salaries/statistics 급여 통계
GET /v1/salaries/export 급여 내보내기
POST /v1/salaries/bulk-update-status 상태 일괄 변경
GET /v1/salaries/{id} 급여 상세
PUT /v1/salaries/{id} 급여 수정
DELETE /v1/salaries/{id} 급여 삭제
PATCH /v1/salaries/{id}/status 상태 변경

관련 문서