Y-FIN.

청년들의 금융(Finance) 고민을 끝(Finish)내다.

---

1. 기술스택

• Backend : Spring Boot / OAuth2
• Database : PostgreSQL
• Infra : Docker / Docker Compose

2. 기능 요약

• OAuth2 로그인(Google, Kakao)
• JWT 기반 인증
• 사용자 / 약관 / 카테고리 관리
• 동적 입력 로직
• 사용자 맞춤 금융 상품 추천

3. API 명세

/auth

기능	Method	API Path
로그아웃	POST	/logout
토큰 리프레시	POST	/refresh

/oauth2

기능	Method	API Path
구글 계정 로그인	GET	/authorization/google
카카오 계정 로그인	GET	/authorization/kakao

/user

기능	Method	API Path
유저 정보 조회	GET	/me
유저 정보 수정	PATCH	/me
회원 탈퇴	DELETE	/me

/term

기능	Method	API Path
약관 목록 조회	GET	/
약관 동의	POST	/agree

/category

기능	Method	API Path
카테고리 목록 조회	GET	/api/categories

/search

기능	Method	API Path
동적 폼 조회	POST	/search/dynamic-form
맞춤 상품 추천	POST	/search/products
상품명 검색	GET	/search/products

맞춤 상품 추천 응답의 productDetails에는 추천 목록에 포함된 상품의 상세 정보가 함께 반환됩니다. 상품 단위가 아니라 옵션(productPropertyId) 단위로 1건씩이며, 리스트 카드와 productPropertyId로 짝지어 쓰도록 설계되어 있습니다. 적합도순 탭과 금리순 탭이 같은 상품에서 서로 다른 옵션을 고를 수 있어, 한 상품에서 최대 2건이 나올 수 있습니다.

검색 중 조회한 상품 엔티티와 리스트가 고른 옵션을 그대로 재사용하므로 카드와 상세의 적합도·금리 값이 일치합니다. 노출하는 옵션 집합(금리표·가입기간·키워드)은 요청자가 가입 가능한 옵션 기준이라 상품별 상세 API(/search/products/{id}/detail, 전체 가입가능 옵션 기준)보다 좁을 수 있습니다. 개인화 조건을 충족하지 못한 요청에서는 상세 API와 동일하게 수익 지표가 잠긴 상태로 반환됩니다.

추천 요청은 1단계 필수값인 월 납입 희망액·저축 기간·은행 거래 조건을 모두 요구합니다. 탭 B와 개인화 수익 지표는 로그인한 사용자가 1단계 필수값과 단계2 필수값(생년월일·개인 연 소득·가구원 수·가구 소득·거래 이력 3종)을 모두 입력한 경우에만 활성화됩니다. 거래 이력 목록은 빈 목록이면 "해당 없음"으로 응답한 것이고 null이면 미입력한 것으로 처리합니다.

상품별 상세 API는 공개 정보 조회를 위해 단계 입력을 강제하지 않습니다. 다만 개인화 수익 지표를 조회하려면 추천 카드가 선택한 productPropertyId를 명시하고 위 개인화 조건을 모두 충족해야 합니다. productPropertyId가 없으면 로그인 여부와 관계없이 공개 대표 정보만 반환하며 수익 지표와 금리표는 잠급니다.

/favorites

기능	Method	API Path
찜 목록 조회 (프로필 기반)	POST	/favorites/list
찜 목록 조회 (기본)	GET	/favorites
찜 추가	POST	/favorites
찜 삭제	DELETE	/favorites/{productPropertyId}
찜 여부 확인	GET	/favorites/{productPropertyId}/status
찜 개수 조회	GET	/favorites/count

/calculator

기능	Method	API Path
적금/예금 최종 수익 계산기	POST	/calculator

4. 개발현황

Update : 2026/07/13

도메인	진행상황	비고
Auth	완료	OAuth2 기반 SNS 로그인, JWT(Access Token + Refresh Token)
User	완료	유저 정보 조회 및 수정
Term	완료	약관 조회 및 약관 동의 기록 , 버전 관리
Category	완료	키워드 데이터 저장 및 전달
Search	완료	사용자 맞춤 적합도 계산 및 사용자 적합도 순과 금리 순 정렬
Calculator	완료	프로필 기반 금리/적합도 재계산, 정부·은행 상품별 수익률 산출
MyFin	완료	찜 목록 관리 (추가/삭제/조회), 최신순 정렬, 최대 20개 제한
data	진행 중	금감원, 온통청년 API 데이터 전처리 및 저장