README.md

📱 MoneyCheck (감정 기반 소비 분석 가계부)

크로스플랫폼 가계부 모바일 어플리케이션
React Native 기반으로 iOS와 Android에서 동작하며, 감정 기반 소비 분석 기능을 제공하는 스마트 가계부

---

📖 프로젝트 개요

• 프로젝트명: MoneyCheck
• 개발환경: React Native (Cross-platform)
• 과목명: 고급 모바일프로그래밍 (A반)
• 팀명: 7팀
• 팀원: 정웅, 옥지윤, 김경민, 임차민

본 애플리케이션은 사용자가 수입과 지출을 체계적으로 관리하고, **영수증 데이터를 AI(OCR)**를 통해 자동 처리할 수 있도록 설계되었습니다.
또한, 감정 기반 지출 분석, 예산 설정, 구독 관리 기능을 통합하여 개인의 재정 상태를 개선하고 장기적인 목표 달성을 지원합니다

---

✨ 주요 기능

• 📝 수입/지출 관리
  • 수기 입력 또는 영수증 스캔을 통한 자동 기록 (OCR 활용)
  • 카테고리별 수입/지출 내역 조회
• 🧾 구독 관리
  • 구독 서비스 통합 관리 (정기 결제 주기 및 금액 추적)
• 🎯 예산/목표 관리
  • 월별 예산 설정 및 초과 여부 확인
  • 사고 싶은 물건을 목표로 적금 계획 관리
• 😊 감정 기반 소비 분석
  • 오늘의 기분 입력 → 소비 습관과 감정의 상관관계 분석
  • 통계 화면에서 감정 기반 소비 패턴 시각화
• 📊 통계 및 피드백
  • 일/주/월 단위 소비 패턴 분석
  • 카테고리별 지출 비율 및 그래프 제공
• 👥 공동 관리 기능
  • 공동 목표 적금 관리
  • 팀 단위의 수입/지출 현황 공유

---

🖼️ 주요 화면

• [홈] 화면: 월별 수입/지출 요약, 목표 물건 카드, 구독 관리
• [가계부] 화면: 전체/수입/지출 내역, 날짜별 상세 기록
• [통계] 화면: 감정 기반 소비 패턴 분석 및 시각화
• [공동관리] 화면: 공동 목표 적금, 팀 단위 재정 관리
• [플로팅 버튼]: 수기 입력 및 영수증 스캔(OCR), 감정 입력

---

🖼️ 시연 영상

👉 클릭하면 시연 영상을 볼 수 있습니다.

---

🛠️ 기술 스택

• Frontend: React Native
• Backend: Firebase
• AI/OCR: Upstage OCR API
• AI/분석: OpenAI 기반 감정-소비 분석 모델
• Database: Firebase / SQLite (로컬 저장소)

---

📂 프로젝트 구조 (예시)

src/
 ├── components/     # 재사용 가능한 UI 컴포넌트
 ├── screens/        # 홈, 가계부, 통계, 공동관리 등 주요 화면
 ├── services/       # API, OCR, AI 분석 모듈
 ├── navigation/     # 네비게이션 구조
 └── assets/         # 이미지, 아이콘, 로고

---

⚡ 실행 방법

1. 저장소 클론

   git clone https://github.com/username/emotion-expense-tracker.git
   cd emotion-expense-tracker

2. 패키지 설치

   npm install

3. 앱 실행

   npx expo start

   • iOS: Expo Go 앱에서 QR 코드 실행
   • Android: 에뮬레이터 또는 Expo Go 실행

---

📡 요구사항 요약

기능적 요구사항

• 사용자 등록 및 로그인 (이메일, 카카오, 구글 연동)
• 수입/지출 기록 (수기 입력 및 OCR 자동 분류)
• 월별 예산 설정 및 관리
• 카테고리별/감정 기반 소비 분석
• 구독 서비스 관리
• 목표 물건 적금 관리

비기능적 요구사항

• 영수증 인식 10초 이내 처리
• 통계/차트 5초 이내 로드
• 크로스플랫폼 호환성 (iOS/Android 반응형 디자인)
• 모듈화된 구조와 문서화를 통한 유지보수 용이성

---

⚠️ 제약 사항

• 닉네임은 영어 10자 이내
• 비밀번호는 최소 8자 이상, 대소문자+숫자+특수문자 포함
• 영수증 스캔은 최소 300dpi 이상 권장
• API 호출은 분당 60회 제한

---

🚀 향후 발전 방향

• 소비 예측 기능 도입
• 개인 맞춤형 재무 관리 추천
• AI 기반 절약 플랜 자동 생성
• 다국어 지원 (한국어/영어)