권혁성
ae7e139d12
- features/esign/README.md: 전자서명 (4모델, 16 API) - features/documents/README.md: 문서관리 (12모델, EAV 기반, 15 API) - features/ai/README.md: AI 리포트 (Gemini 2.0, 4 API) - features/equipment/README.md: 설비관리 (MNG 전용) - features/finance/ 9개 하위문서: 입출금, 급여, 가지급금, 세금계산서, 악성채권, 어음, 카드, 미지급비용, 채권현황, CEO 대시보드 - features/finance/README.md 재구조화 (14개 하위문서 목록) - features/barobill-kakaotalk/README.md 확장 (API 설정 + 세금계산서) - rules/numbering-rules.md: 채번규칙 (6세그먼트, 원자적 UPSERT) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# 급여관리 (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` | 상태 변경 |
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
- [재무관리 개요](README.md)
|
|
- Swagger: `/api-docs` → Payrolls / Salaries 섹션
|