- 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>
1.6 KiB
1.6 KiB
가지급금 관리 (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 |
정산 처리 |
관련 문서
- 재무관리 개요
- Swagger:
/api-docs→ Loans 섹션