55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
|
# 가지급금 관리 (Loans)
|
||
|
|
|
||
|
|
> **최종 갱신**: 2026-02-27
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 1. 개요
|
||
|
|
|
||
|
|
임직원 가지급금(대여금)의 지급·정산·이자 계산·세금 시뮬레이션을 관리한다.
|
||
|
|
|
||
|
|
**핵심 기능:**
|
||
|
|
- 가지급금 지급/부분정산/완전정산
|
||
|
|
- 인정이자 자동 계산 (연도별 이율 적용)
|
||
|
|
- 세금 시뮬레이션 (법인세, 소득세, 지방소득세)
|
||
|
|
- 연도별 이자 보고서
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. 모델
|
||
|
|
|
||
|
|
**주요 필드:** user_id, loan_date, amount, purpose, settlement_date, settlement_amount, status, withdrawal_id
|
||
|
|
|
||
|
|
**상태:** outstanding (미정산) → partial (부분정산) → settled (정산완료)
|
||
|
|
|
||
|
|
**이자율:** 2024/2025: 4.6% (연리)
|
||
|
|
|
||
|
|
**세율:** 법인세 19%, 소득세 35%, 지방소득세 10%
|
||
|
|
|
||
|
|
**주요 메서드:** calculateRecognizedInterest(), calculateTaxes(), isEditable(), isDeletable(), isSettleable()
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. API 엔드포인트
|
||
|
|
|
||
|
|
| HTTP | URI | 설명 |
|
||
|
|
|------|-----|------|
|
||
|
|
| GET | `/v1/loans` | 가지급금 목록 |
|
||
|
|
| POST | `/v1/loans` | 가지급금 지급 등록 |
|
||
|
|
| GET | `/v1/loans/summary` | 요약 |
|
||
|
|
| GET | `/v1/loans/dashboard` | 대시보드 |
|
||
|
|
| GET | `/v1/loans/tax-simulation` | 세금 시뮬레이션 |
|
||
|
|
| POST | `/v1/loans/calculate-interest` | 인정이자 계산 |
|
||
|
|
| GET | `/v1/loans/interest-report/{year}` | 연도별 이자 보고서 |
|
||
|
|
| GET | `/v1/loans/{id}` | 가지급금 상세 |
|
||
|
|
| PUT | `/v1/loans/{id}` | 가지급금 수정 |
|
||
|
|
| DELETE | `/v1/loans/{id}` | 가지급금 삭제 |
|
||
|
|
| POST | `/v1/loans/{id}/settle` | 정산 처리 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 관련 문서
|
||
|
|
|
||
|
|
- [재무관리 개요](README.md)
|
||
|
|
- Swagger: `/api-docs` → Loans 섹션
|