🛡️ GuardPay AI

금융 취약 계층을 위한 AI 기반 디지털 금융 교육 플랫폼

📋 목차

• 프로젝트 소개
• 주요 기능
• 기술 스택
• 시스템 아키텍처
• 시작하기
• API 문서
• 팀원 소개

🎯 프로젝트 소개

GuardPay AI는 금융 취약 계층(특히 어르신들)을 위한 디지털 금융 교육 플랫폼입니다.

추진 배경

복잡한 금융 앱과 증가하는 금융 사기로 어려움을 겪는 어르신들을 위해, 안심하고 금융 앱을 익힐 수 있는 맞춤형 교육 환경을 제공합니다.

핵심 가치

• 🎓 안전한 학습 환경: 실제 금융 거래 없이 안전하게 연습할 수 있는 모의 송금 시스템
• 🤖 AI 맞춤형 지원: Google Gemini 기반 금융 상담 챗봇으로 실시간 질의응답
• 🎮 게이미피케이션: 퀴즈와 보상 시스템으로 학습 동기 부여
• 📺 다양한 학습 콘텐츠: 금융 교육 영상 및 단계별 학습 프로그램

✨ 주요 기능

1. 회원 관리 및 인증

• ✅ 이메일/비밀번호 기반 회원가입 및 로그인
• ✅ 소셜 로그인 (Google, Kakao)
• ✅ JWT 기반 인증 (Access Token / Refresh Token)
• ✅ SMTP를 통한 비밀번호 재설정

2. 금융 교육 콘텐츠

• 📹 금융 교육 영상 라이브러리
• 📝 금융 지식 퀴즈
• 🎯 개인 맞춤형 학습 추천

3. 모의 송금 훈련

• 💳 가상 계좌를 통한 안전한 송금 연습
• 🎭 랜덤 송금 대상자 생성
• ✅ 단계별 송금 프로세스 학습
• 🏆 훈련 완료 시 포인트 지급

4. AI 금융 상담 챗봇

• 🤖 Google Gemini API 기반 대화형 챗봇
• 💬 금융 지식 및 사기 예방 상담
• 📊 개인 맞춤형 금융 조언

5. 리워드 시스템

• 🎁 학습 활동을 통한 포인트 적립
• 🛍️ 포인트 기프트샵
• 📈 개인 역량 진단 및 레벨 시스템

🛠 기술 스택

Frontend

Flutter 3.x
Dart

Backend

Spring Boot 3.5.5
Java 21
Spring Security (JWT 인증)
Spring Data JPA
Spring AI (OpenAI Integration)

Database

MariaDB (Production)
H2 Database (Development)

AI/ML

Google Gemini API

Infrastructure & DevOps

GitHub
GitHub Actions (CI/CD)
Swagger/OpenAPI 3.0 (API Documentation)

Collaboration Tools

Notion (문서화)
Figma (디자인)

🏗 시스템 아키텍처

┌─────────────────────────────────────────────────────────────┐
│                         Frontend                            │
│                      Flutter / Dart                         │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                         Backend                             │
│                   Spring Boot / Java                        │
│                                                             │
│  ┌──────────────┐  ┌──────────────┐  ┌─────────────────┐  │
│  │   Security   │  │   Data JPA   │  │   REST API      │  │
│  │   (JWT)      │  │              │  │   (Controllers) │  │
│  └──────────────┘  └──────────────┘  └─────────────────┘  │
└──────────────────────┬──────────────────┬───────────────────┘
                       │                  │
                       ▼                  ▼
         ┌─────────────────────┐  ┌──────────────────┐
         │   Database          │  │   AI / LLM       │
         │   MariaDB / H2      │  │   Google Gemini  │
         └─────────────────────┘  └──────────────────┘

🚀 시작하기

필수 요구사항

• Java 21+
• Gradle 7.x+
• MariaDB 10.x+ (또는 H2 for development)
• Flutter 3.x+

Backend 설정

1. 프로젝트 빌드 및 실행

./gradlew clean build
./gradlew bootRun

서버가 http://localhost:8080에서 실행됩니다.

Frontend 설정

cd flutter_app
flutter pub get
flutter run

📚 API 문서

API 문서는 Swagger UI를 통해 확인할 수 있습니다.

서버 실행 후 다음 URL에 접속하세요:

http://localhost:8080/swagger-ui/index.html

주요 API 엔드포인트

인증 API

• POST /api/auth/signup - 회원가입
• POST /api/auth/login - 로그인
• POST /api/auth/kakao - 카카오 로그인
• POST /api/auth/google - 구글 로그인
• POST /api/auth/reissue - 토큰 재발급
• POST /api/auth/password-reset-request - 비밀번호 재설정
• GET /api/auth/check-email - 이메일 중복 확인

챗봇 API

• POST /api/chat/financial-advice - 금융 상담 챗봇

📅 개발 일정

👥 팀원 소개

이름	학번	역할	GitHub
김민규	2171263	팀장, Backend 개발	@minmin
김지원	2371153	Backend 개발	@username
이준호	2371083	Frontend 개발	@username
박초은	2271112	Frontend 개발	@username

📝 요구사항 요약

기능 요구사항 (SFR)

• 총 20개의 기능 요구사항 정의
• 로그인/회원가입, 소셜 로그인, SMTP 이메일 인증
• 모의 송금 훈련, AI 챗봇, 영상 학습
• 퀴즈 시스템, 포인트 및 리워드 시스템

비기능 요구사항

• 성능 요구사항 (PER): 1개
• 인터페이스 요구사항 (INR): 1개

🎯 기대 효과

1. 디지털 금융 자립 지원
   • 안전한 실습 환경으로 금융 취약 계층의 디지털 금융 자립 지원
2. 금융 사기 예방
   • AI 챗봇을 통한 실시간 사기 예방 교육
3. 금융 안전 습관 형성
   • 게이미피케이션과 보상 시스템으로 지속적인 학습 동기 부여
4. 접근성 향상
   • 모바일 기반 플랫폼으로 언제 어디서나 학습 가능

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 관련 링크

• Notion 프로젝트 문서
• Figma 디자인
• API 명세서

📧 문의

프로젝트에 대한 문의사항이 있으시면 아래로 연락주세요:

• 이메일: [email protected]
• 이슈 트래커: GitHub Issues

---

Made with ❤️ by GuardPay Team