[ Feature ] - account-service 거래 분류 및 TXN_ANALYSIS 저장 연동

[bigwaveBigwave]

관련 이슈

• Resolves : [ Feature ] - account-service 분류 대상 거래 조회 및 TXN_ANALYSIS 저장 연동 #94

작업 사항

• AccountTransactionAnalysisClient 공통 인터페이스 추가
• 분류 대상 거래 조회 DTO 및 TXN_ANALYSIS 저장 요청 DTO 추가
• account-service의 ACCOUNT_TRANSACTION 기반 분류 대상 출금 거래 조회 기능 추가
• TXN_ANALYSIS 도메인·Mapper·XML·Service 구현
• account_transaction_id 기준 유니크 제약조건 및 upsert 저장 로직 적용
• classified_at 저장 시점 자동 기록
• AI-service에서 account-service 거래 조회 Client 연동
• FastAPI 소비 분류 결과를 TXN_ANALYSIS 저장 DTO로 변환 및 전달
• 거래 ID 개수·1:1 매핑 검증 추가
• 사용자별 예외 격리 및 분류 대상 거래 없음 처리
• AI 리포트 상세·목록 조회 API의 userId 쿼리 파라미터 제거
• JWT Authentication에서 로그인 사용자 ID 추출 방식 적용
• Authorization: Bearer {accessToken} 기반 사용자 식별 적용
• 공통 모듈·account-service·ai-service 빌드 성공 확인
• 로컬 Spring 서버 기동 및 localhost:8080 접속 확인

참고 사항

• FastAPI는 소비 분류 결과만 반환하고 DB 저장은 수행하지 않음
• TXN_ANALYSIS 저장은 account-service가 담당
• account_transaction_id 유니크 제약조건으로 동일 거래 재분류 시 기존 결과 갱신
• 배치 내부의 userId는 서비스 간 내부 처리용 값이므로 유지
• 외부 AI 리포트 조회 API에서는 JWT를 사용하므로 userId 쿼리 파라미터를 사용하지 않음

최종 API 형식:

GET /api/ai-reports
GET /api/ai-reports/{yearMonth}
Authorization: Bearer {accessToken}

현재 월간 배치의 전체 사용자 조회 Client는 아직 연결되지 않아 실제 사용자별 배치 실행은 후속 작업으로 진행 예정