Skip to content
@Finance-doc

Finance-doc

개방형 클라우드 플랫폼(K-PaaS) 활용 프로젝트 : Finance-doc 💰

🔥 프로젝트 소개

🗓️ 프로젝트 기간

: 2025년 9월 ~ 2025년 10월

👥 프로젝트 팀원

이름 강유림 김민주 김혜림 윤민섭 이경민
역할 Design FE BE, Oauth BE, CI/CD BE, NKS

✨ 파이낸스닥 서비스 소개

💸 파이낸스닥(FinanceDoc): 나만의 재무관리 의사 선생님

오늘날 많은 청년이 금융에 대한 관심은 높아졌지만, 실제로 자신의 자산·부채·소비 습관을 체계적으로 관리하거나 금융상품을 적절히 선택하는 데는 어려움을 겪고 있습니다.

특히 ‘빚 내서 투자(빚투)’, ‘영끌(영혼까지 끌어모아 대출)’와 같은 과도한 대출·투자 행태가 청년층에서 증가하고 있고, 반면 정작 금융지식이나 재무설계 경험은 부족하다는 지적이 많습니다.

이에 본 서비스 파이낸스닥(재무 주치의)는 청년들의 금융 여건과 소비·투자 습관을 진단하고, 개인 성향에 맞는 금융 설문을 통해 올바른 금융 · 투자 성향을 제안하며, 그에 맞춰 금융상품을 자연어로 추천함으로써 지속 가능한 금융 행동 변화를 유도하고자 합니다.

특히 MSA·NCP·NKS 기반으로 개발된 본 애플리케이션은, 기술적으로는 클라우드 네이티브 인프라 위에서 마이크로서비스 아키텍처로 구현하며, 기획적으로는 “청년 금융 자립”이라는 사회적 미션을 내세워 청년 세대가 재무적으로 독립하고 건강한 금융 생활을 영위할 수 있도록 돕는 것을 목표로 합니다.

image

💡 서비스 개발배경

image image

청년층 자산 운용 격차와 잘못된 방법

청년층의 부채와 대출액 급증

  • 20대 청년 가구주의 부채가 작년 대비 41% 급증, 평균 부채액 약 5천만 원 돌파 🔗 한경닷컴
  • 청년층(19-34세)의 평균 연소득이 약 3,092만원, 월평균 카드 사용액은 약 147만 원, 대출 보유 청년의 평균 대출잔액은 약 3,700만원 수준

🎯 서비스 개요

image image

파이낸스닥은 청년 층의 재무 주치의를 목표로 하는 금융 관리 서비스입니다.

단순 자산 기록 앱이 아닌, 사용자의 소비·저축 데이터를 기반으로 진단 → 처방 → 학습 세 단계의 프로세스를 통해 금융 습관을 개선하도록 돕습니다.🔥

image

파이낸스닥은 세 가지 금융 문제 ① 재무 관리 미숙, ② 투자 불안, ③ 금융지식 단절의 문제들을 AI·데이터 기반 맞춤형 분석과 추천으로 해결합니다.

1️⃣ ‘나의 금융 상태를 시각화’하여 스스로 인식할 수 있도록 돕고

2️⃣ ‘투자 성향 진단’을 통해 개인화된 상품 추천을 제공하며

3️⃣ ‘청년 눈높이 금융 교육 카드뉴스’로 금융 리터러시를 높입니다.


🛠️ 파이낸스닥 기술스택

1️⃣ 개발 환경 및 활용기술

image
  • Frontend : React Native
  • Backend
    • Spring Boot : MSA 각 서비스의 핵심 개발 프레임워크
    • API Gateway : Spring Cloud Gateway(WebFlux기반) ⇒ 트래픽 분기, JWT 필터 기반 인증·인가 처리 및 유저에 대한 식별자 X-user-Id 헤더로 각 서비스에 전달 (JwtFilter implements WebFilter)
  • Crawler Server(보조 서비스) : Python 3.13.5 + BeautifulSoup + Requests ⇒ 금융 용어 데이터 크롤링 및 전처리
  • DB : PostgreSQL ⇒ MSA별 DB 분리 운영 (user-db, report-db, edu-db, recommend-db)
  • CI/CD
    • Docker : 서비스별 Dockerfile로 독립 이미지로 빌드 및 배포
    • Naver Cloud Platform Developer tools( Source commit, Source pipeline ) : 빌드–테스트–배포 전 과정 자동화
  • OpenAPI
    • Kakao OAuth 2.0 : 소셜 로그인 인증
    • OpenAI API : 투자 성향 기반 AI 금융 추천 서비스
  • 협업도구
    • 디자인 - Figma : UI/UX 프로토타입 설계 및 화면 플로우 관리
    • 기획/일정관리 - Notion : 프로젝트 일정 및 기능별 개발 진행내용 교류
    • 커뮤니케이션 - Discord
    • 코드 관리 및 리뷰 - Github

2️⃣ 서비스 전반 아키텍처

image
  • MSA 구조 기반의 금융 리포트 서비스, 금융상품 추천 서비스, 금융 리터러시 교육 서비스 및 회원관리 서비스
  • Naver Cloud + Docker + CI/CD 파이프라인으로 자동화된 배포 환경
  • Spring Cloud Gateway 중심의 통합 인증·보안 구조
  • PostgreSQL + JPA 기반의 안정적 데이터 처리
  • Kakao OAuth 연동으로 간편한 회원 인증
  • OpenAI API 활용으로 사용자 맞춤 리포트 생성
  • Python 크롤링 서버로 대규모 금융용어데이터 확보

3️⃣ CI/CD 파이프라인

image
  • 개발자가 GitHub → SourceCommit에 push 시, SourcePipeline이 자동으로 빌드·테스트·배포 수행
  • Docker 이미지가 NCP Container Registry에 저장되고 NKS(Kubernetes) 클러스터에 자동 배포됨
  • 서비스 무중단 배포를 위한 Rolling Update 지원

4️⃣ 서버 및 DB 인프라 아키텍처 (NKS 기반 MSA)

image
  • NKS계층
    • gateway-service: Spring Cloud Gateway, JWT 필터 기반 인증/인가 수행
      • 기술적 차별점 : Spring Security를 배제하고 Gateway 단에서 JWT를 직접 검증 → 경량화 & 확장성 확보
    • user-service: 로그인/회원 관리, JWT 발급 담당
    • report-service: 수입·지출·저축 기록, 목표 설정, 월별 리포트 생성
    • edu-service: 경제용어 학습/퀴즈 콘텐츠 제공
    • recommend-service: AI 기반 투자성향 분석 및 상품 추천
    • crawler-job: Python 크롤링 Job Pod (KDI, BOK 데이터 수집)
  • DB계층
    • 각 서비스별 DB 분리 (PostgreSQL Cluster)
    • PV/PVC + NCP Block Storage를 통한 데이터 영속성 확보
  • 리소스 최적화 및 운영개선 방안 초기 배포시 여러 서비스 파드들에서 메모리 부족(OOMKilled)문제가 발생했습니다. 이를 해결하기위해 서비스 규모에 따라 Replica 수를 조정했으며, 각 리소스의 Resource Limit/Request 설정을 통해 안정화된 서비스 배포가 이루어지도록 하였으며, Node추가배포로 안정적 메모리를 확보하였습니다.

🚀 파이낸스닥 핵심기능

image

파이낸스닥에서 제공되는 다양한 서비스들은 “청년이 스스로 재무습관을 점검하고 금융 역량을 키울 수 있는 개인 재무코칭 플랫폼”을 목표로 합니다. 각 서비스는 기록 → 인식 → 목표 → 실천 → 성장의 순환 구조로 이어지는 청년 맞춤형 금융 성장 사이클 ♻️ 을 함께하고 있습니다.

⭐️ 핵심철학 : 파이낸스닥의 금융서비스는 단순히 돈을 관리하는 도구가 아니라, 청년 사용자의 성장을 지원하는 여정을 함께합니다.

  • 재무 리포트 기능 ( 기록/인식/목표단계 ) : 소비·수입·저축을 직접 기록하고 자신의 소비 패턴을 시각적으로 인식합니다. 청년 스스로 소비 및 수입 목표를 설정하고 달성할 수 있도록 합니다.
  • 금융상품 추천 기능 ( 실천단계 ) : 투자 성향 테스트로 자신의 금융투자 성향을 파악하고, 그에 맞춘 개인화된 금융실천전략, 상품으로 제시합니다.
  • 금융 리터러시 교육( 성장단계 ) : 금융지식과 용어를 학습하여 장기적인 재무 역량을 향상하고 재무분야에 친숙해지도록 합니다.

📊 핵심 기능(1) - 재무 리포트

📍 기록+인식+목표단계 :: 소비·수입·저축을 직접 기록하고, 목표 달성률과 재무건강 점수를 시각화

image image

✔️ 월별 달력에서 카테고리별 소비/수입/저축 내역을 기록

✔️ 월별 소비/수입 목표 설정 및 달성률 계산

✔️ 실시간 지출 분석 및 파이차트로 시각화

✔️ 월별 리포트(재무 진단서) 제공

  • 목표 달성률
  • 최근 6개월간 소비 추이 그래프로 확인
  • 재무 건강 점수 계산
image

💡 기대효과 :: 청년 사용자가 자신의 소비 패턴을 체계적으로 인식하고, 재무목표를 직접 설정하고 달성해보며, 재무습관을 개선하도록 유도


💰 핵심 기능(2) - AI 기반 금융 상품 추천

📍 실천단계 :: 투자 성향 분석 + OpenAI API 기반 금융상품 추천 리포트

image

✔️ TOSS 금융 성향 테스트를 참고한 5문항 테스트 설계

✔️ 사용자 정보(월 소득, 저축률, 관심 분야 등) 기반으로 OpenAI API에 프롬프트 전달 → 개인화된 투자상품 추천 리포트 생성

✔️ 추천리포트에는 3가지 금융상품 및 명확한 추천 이유를 포함

💻 프롬프트 엔지니어링 전략

: 사용자 프로필 + 과거 응답 패턴을 포함한 Context Prompt 설계

image

💡 기대효과: AI를 통해 개인의 재무 데이터를 실질적 행동(투자·저축 전략)으로 연결, 청년층의 ‘금융 실천력’을 향상시킴.


📚 핵심 기능(3) - 금융 리터러시 카드 뉴스

📍 성장단계 :: 공공데이터 기반의 금융지식 확산, 재미와 학습을 결합한 금융 리터러시 교육제공

image

✔️ 교육용 데이터 출처

✔️ 300여개의 금융, 경제 용어를 크롤링 및 전처리하여 독립된 edu-db에 저장

✔️ 금융용어 카드 뉴스 : 간단하게 2문장 이내의 금융용어 정의 제공, 출처 페이지 링크 삽입으로 깊이있는 원문학습 가능

✔️ 금융용어 퀴즈 : 5문제의 랜덤한 금융용어 맞추기 문제 출제, 정답당 20점으로 부여해 최대 100점의 점수 획득가능 ⇒ 게이미피케이션으로 학습동기 유발

💡기대효과: 공공데이터를 기반으로 한 학습형 콘텐츠를 통해 청년층의 금융지식 수준을 향상시키고, 지속적인 자기계발을 유도.


🌍 파이낸스닥 서비스 기대효과

image image

👤 청년 개인의 변화

: 재무 자립 역량 강화, 합리적 금융 의사결정 능력 향상, 지속 가능한 금융 리터러시 학습

🌐 사회·경제적 측면의 효과

: 청년 부채 문제 완화, 금융 격차 완화 및 포용 금융 실현, 지속 가능한 사회적 금융문화 조성

Popular repositories Loading

  1. Frontend Frontend Public

    TypeScript 1

  2. Backend Backend Public

    Java

  3. gateway-service gateway-service Public

    Java

  4. edu-service edu-service Public

    Java

  5. recommend-service recommend-service Public

    Java

  6. report-service report-service Public

    Java

Repositories

Showing 10 of 10 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…