🚀 LuFin - 청소년 경제 교육 플랫폼

👥 팀원 소개

이재현 (팀장)	김서현	신유영	양은서	조홍균	최민주
marunturtle	seohye-ki	shinyou28	yes2489	NekoShoot	minjumost

📚 프로젝트 개요

LuFin은 청소년들에게 경제적 개념을 재미있고 실용적으로 가르치면서 자산 관리 능력을 키우는 교육 플랫폼입니다. 초등학교 고학년과 교사들을 대상으로, 실제 경제 활동을 시뮬레이션하며 학습할 수 있는 환경을 제공합니다.

🎯 프로젝트 목표

• 경제 교육의 게임화를 통한 학습 동기 부여
• 실전적인 금융 시뮬레이션 경험 제공
• 신용 관리와 자산 관리 능력 향상
• 경제적 의사결정 능력 개발

🛠 기술 스택

Frontend Core

• React 19 - 최신 React 버전을 활용한 컴포넌트 기반 개발
• TypeScript - 정적 타입 시스템으로 안정적인 코드베이스 구축
• Vite - 빠른 개발 환경과 빌드 성능 제공

Backend Core

• Spring Boot - 엔터프라이즈급 백엔드 프레임워크
• JPA/Hibernate - 객체지향 데이터베이스 접근
• Redis - 세션 관리 및 캐싱
• MySQL - 관계형 데이터베이스

State Management

• Zustand - 간단하고 효율적인 상태 관리 솔루션

UI/UX

• Tailwind CSS - 유틸리티 기반의 모던한 스타일링
• Material-UI (MUI) - 풍부한 UI 컴포넌트 라이브러리
• Framer Motion - 부드러운 애니메이션과 인터랙션
• Headless UI - 접근성이 뛰어난 UI 컴포넌트
• React Icons - 다양한 아이콘 세트
• Pretendard - 한글 최적화 폰트

Data Visualization

• Chart.js - 직관적인 차트와 그래프 구현
• React Chart.js 2 - React용 Chart.js 래퍼

Routing & Navigation

• React Router DOM - 클라이언트 사이드 라우팅

Development Tools

• ESLint - 코드 품질 관리
• Prettier - 코드 포맷팅
• TypeScript ESLint - TypeScript 전용 린팅

✨ 주요 기능

1. 🎮 게임화된 경제 학습

• 가상 화폐 시스템을 통한 실전 경제 활동 체험
• 미션 기반 보상 시스템으로 학습 동기 부여
• 실시간 신용 점수 시스템

2. 💰 금융 시뮬레이션

• 주식 투자 시뮬레이션
• 대출 및 적금 시스템
• 가상 상점 운영

3. 📊 데이터 시각화

• 실시간 포트폴리오 현황
• 거래 내역 및 수익률 차트
• 신용 점수 변화 추적

4. 👥 멀티 유저 시스템

• 교사/학생 역할 구분
• 클래스별 독립적인 경제 시스템
• 실시간 상호작용

💳 신용 시스템 상세

신용 등급 체계

• 15단계 신용등급 (A+, A, A-, B+, B, B-, C+, C, C-, D+, D, D-, F+, F, F-)
• 0~100점 범위의 신용점수 시스템
• 5점 단위 변동으로 안정적인 등급 관리

신용점수 변동 요소

1. 적금 활동

   • 매일 적금 납입: +0.2점
   • 만기 적금 수령: +2점

2. 대출 관리

   • 이자 정상 납입: +1점
   • 이자 연체: -4점
   • 원금 상환 성공: +3점
   • 원금 상환 실패: -10점

3. 미션 수행

   • 미션 성공: +2점
   • 미션 실패: -2점

4. 직업 활동

   • 직업 획득: +3점
   • 주급 수령: +2점
   • 자진 퇴사: -3점
   • 해고: -5점

신용 회생 시스템

• F- 등급(30점 미만) 도달 시 회생 절차 시작
• 교사 승인 후 35점(F+)으로 조정
• 단계적 금융 활동 제한 해제
• D- 등급 도달 시 정상 활동 가능

🎯 특장점

Frontend 특장점

1. 실전적인 경제 교육

   • 실제 금융 시스템을 모방한 시뮬레이션
   • 실시간 시장 상황 반영
   • 리스크 관리 학습

2. 게임화된 학습 경험

   • 미션 기반 보상 시스템
   • 실시간 피드백
   • 경쟁 요소를 통한 동기 부여

3. 직관적인 UI/UX

   • 모던하고 깔끔한 디자인
   • 반응형 레이아웃
   • 부드러운 애니메이션

4. 확장 가능한 아키텍처

   • 모듈화된 컴포넌트 구조
   • 타입 안정성
   • 효율적인 상태 관리

Backend 특장점

1. 도메인 자동 연동 시스템

   • 상태 기반 자동 트리거
   • 단일 요청으로 복합 도메인 처리
   • 명시적 트랜잭션 제어

2. 데이터 정합성 보장

   • 비관적 Lock 기반 동시성 제어
   • 도메인별 경쟁 조건 방지
   • 타임아웃 제어 시스템

3. 보안 중심 설계

   • KISA 기반 시큐어 코딩
   • PBKDF2 + Salt 암호화
   • 토큰 기반 인증 시스템

4. 실전 금융 시뮬레이션

   • 실제 은행 시스템 모방
   • 자동화된 이자 계산
   • 실시간 거래 처리

📝 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.