Files
sam-react-prod/docs/features/finance/loans.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

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 정산 처리

관련 문서