TaxCheck 백엔드 API 구현

[foxihyun]

✨ Description

프론트 /taxcheck에서 사용 중인 입력 기반 세금 점검 규칙을 Spring Boot API로 구현하고 분석 결과를 저장·조회합니다.

TaxCheck 결과는 법률상 확정 판정이나 세무 자문이 아니라, 사용자가 추가 확인할 항목과 필요 자료를 안내하는 MVP 참고 정보로 제공합니다.

📌 구현 범위

API·DTO 명세

• GET /api/tax-checks 분석 이력 조회
• GET /api/tax-checks/{taxCheckId} 분석 상세 조회
• POST /api/tax-checks/analyze 입력 분석 및 결과 저장
• POST /api/tax-checks/{taxCheckId}/simulate 조건 변경 모의 계산
• 요청·응답 DTO와 Validation 정의
• 공통 ApiResponse 형식 적용

도메인 구현

• domain/taxcheck 하위 Controller·Service·Repository·Entity·DTO·Rule 구성
• 기존 User, Paycheck, 선택적 Document 연계
• 귀속연도·연간 급여·급여 기록 개월 수 계산
• 금액 계산에 BigDecimal 사용
• TaxCheck 분석 결과 저장

MVP 규칙

• 입국일 기준 국내 체류일 참고값 및 거주자 검토 상태
• 주택청약저축 가입·무주택·납입증명서 보유 여부 확인
• 외국인 근로자 19% 단일세율 참고값
• 적용 가능성·조건 미충족·추가 검토·판단 불가 상태 구분
• 확인된 정보·부족 자료·다음 행동·근거 출처 응답

테스트

• 183일 경계값 테스트
• 입국일·급여 기록·설문 응답 누락 테스트
• 주택청약 조건 조합 테스트
• 급여 기록 0개월·3개월 미만 테스트
• Service/Rule 단위 테스트
• Controller 또는 API 통합 테스트
• gradlew.bat test 통과

✅ 완료 조건

• 프론트 TaxCheck가 localStorage 계산 대신 API 분석 결과를 사용할 수 있습니다.
• 분석 결과 목록·상세·분석·시뮬레이션 API가 문서와 일치합니다.
• 법률상 확정 판정처럼 표현하지 않고 참고 정보와 확인 필요 항목을 제공합니다.
• IDE·Gradle 자동 생성 파일은 커밋에 포함하지 않습니다.

🔗 참고

• docs/API_SPEC.md TaxCheck API
• docs/DB_SCHEMA.md TAX_CHECK 테이블
• Front lib/paycycle/taxcheck.ts 기존 MVP 규칙