CODEF API 기반 자산 연동 전면 리팩토링

✏️ 기능 설명

현재 자산 연동 기능(계좌/카드/거래내역 등) 전체를 NH/IBK 오픈API 연동 구조에서 CODEF API 기반으로 전면 교체 및 리팩토링한다.
CODEF API는 다양한 금융기관의 데이터를 통합적으로 제공하므로,

• 계좌(보유계좌/잔액/거래내역)
• 카드(보유카드/승인내역)
• 대출/펀드/보험 등 기타 금융상품
  을 단일 연동 구조로 관리할 수 있다.
  이에 따라 계좌/카드/거래내역 동기화, 신규 등록, 상세 조회, 리포트/분석 로직, 예외처리, 인증·토큰·에러 응답 대응 등 전체 자산/소비 파이프라인 구조 및 데이터베이스/도메인/서비스/컨트롤러를 대대적으로 리팩토링한다.

📌 할 일

• CODEF API의 보유계좌/보유카드/거래내역(수시입출, 승인내역 등) 엔드포인트, 인증 방식, 파라미터 및 응답 구조 전체 정리
• 기존 NH/IBK 연동용 서비스, DTO, 파서, 클라이언트, 매퍼 등 모든 코드와 API 스펙 분석 및 영향도 체크
• 자산/카드/거래 테이블(account, card, account_transaction, card_transaction 등) 필드/매핑 구조 CODEF 응답에 맞춰 일치화(유형, 잔액, 만기, 상품명 등)
• CODEF 토큰/connectedId/organization 등 인증정보 구조 변경 및 저장 방식 설계
• 계좌/카드/거래 동기화 로직 전체 교체 (CODEF 기준 신규 저장/업데이트/비교/중복처리/삭제/상태 플래그 등)
• CODEF 거래내역, 승인내역 동기화/저장/분석/리포트 생성 흐름 전환
• API 호출 에러(토큰만료, 인증 실패, 추가인증, 빈값 등) 및 은행별 특이케이스(추가 파라미터 요구, SMS 등) 공통 예외 처리
• 기존 NH/IBK 연동 경로/패키지/컨트롤러/서비스/매퍼/클래스 삭제 및 코드 정리
• 전체 자산/소비/리포트/챌린지/추천 등 서비스 정상동작 확인 및 리그레션 테스트
• Swagger v2 명세서 및 내부 API 문서/도식화 모두 업데이트
• 전환/배포 이후 장애 모니터링 및 핫픽스 체계 구축

👊🏻 참고 자료

• CODEF 공식 문서 및 샘플 응답, 엔드포인트 정리본
• 기존 NH/IBK 연동 코드(특히, 인증/예외/중복처리/데이터 가공 파이프라인 구조)
• 주요 테이블(account, card, account_transaction, card_transaction, ledger 등) 전체 구조
• CODEF 은행/기관별 파라미터/응답 특이사항, 추가 인증/오류 사례 정리
• https://development.codef.io/ (테스트용 엔드포인트)
• https://api.codef.io/ (실서비스 엔드포인트)