🍽️ FoodWallet

식이 제한을 고려한 스마트 식품 안전 분석 앱

📱 프로젝트 소개

FoodWallet은 채식주의, 알레르기, 종교적 제한, 질병 등 다양한 식이 제한을 가진 사용자들이 안전하게 식품을 선택할 수 있도록 돕는 모바일 앱입니다.

주요 기능

• 🤳 사진 분석: 음식 사진을 찍으면 AI가 자동으로 성분을 분석
• 📷 QR 스캔: 제품의 QR 코드를 스캔하여 빠른 정보 확인
• 🛡️ 맞춤형 안전 정보: 개인의 식이 제한에 맞춘 상세 분석
• 📊 분석 기록: 과거 분석 내역 저장 및 조회
• 💚 추천 시스템: 사용자에게 안전한 음식 추천

🎨 디자인 컨셉

Apple 스타일의 미니멀하고 고급스러운 UI/UX 디자인을 적용했습니다.

컬러 팔레트

색상	HEX	용도
Primary (Blue)	#1E88E5	로고의 지갑 색상, 주요 액션
Secondary (Green)	#66BB6A	로고의 포크 색상, 안전/채식
Danger (Red)	#EF5350	위험, 알레르기 경고
Warning (Orange)	#FFA726	주의 필요
Neutral (Gray)	#1C1C1E ~ #F2F2F7	텍스트, 배경

🏗️ 기술 스택

• Flutter 3.10+ - 크로스 플랫폼 프레임워크
• Dart - 프로그래밍 언어
• Provider - 상태 관리
• Google Fonts - Inter 폰트 (Apple SF Pro 스타일)
• Image Picker - 사진 촬영/갤러리 선택
• QR Code Scanner - QR 코드 스캔

📂 프로젝트 구조

lib/
├── main.dart                      # 앱 엔트리 포인트
├── core/                          # 핵심 설정
│   └── theme/                     # 테마 (컬러, 텍스트 스타일)
├── screens/                       # 화면 페이지
│   ├── login/                     # 로그인 (소셜 로그인)
│   ├── onboarding/                # 초기 설정
│   ├── home/                      # 메인 홈
│   ├── food_analysis/             # 음식 분석
│   ├── qr_scan/                   # QR 스캔
│   ├── settings/                  # 사용자 설정
│   └── profile/                   # 마이페이지
└── widgets/                       # 공통 위젯
    └── common/                    # 재사용 가능한 컴포넌트

🚀 시작하기

요구사항

• Flutter SDK 3.10.0 이상
• Dart SDK 3.10.0 이상
• iOS 개발: Xcode 14.0 이상
• Android 개발: Android Studio

설치 및 실행

1. 저장소 클론

   git clone <repository-url>
   cd foodwallet_client

2. 의존성 설치

   flutter pub get

3. 이미지 자산 추가

   assets/images/ 폴더에 다음 이미지를 추가하세요:

   • app_logo.png (512x512 px) - 필수 앱 로고
   • google_logo.png (18x18 px) - 필수 Google 공식 로고
   • kakao_logo.png (18x18 px) - 필수 Kakao 공식 심볼

   자세한 내용:

   • LOGO_GUIDE.md - 앱 로고 설정 가이드
   • SOCIAL_LOGIN_GUIDE.md - 소셜 로그인 버튼 가이드라인
   • assets/images/DOWNLOAD_INSTRUCTIONS.md - 로고 다운로드 방법

4. 앱 실행

   # iOS 시뮬레이터
   flutter run -d ios
   
   # Android 에뮬레이터
   flutter run -d android
   
   # 또는 편의 스크립트 사용
   ./run_ios.sh

📱 화면 구성

1. 로그인 화면

• Google, Kakao, Apple 소셜 로그인
• 각 플랫폼의 공식 디자인 가이드라인 준수

2. 온보딩 (초기 설정)

• 4단계 설정 프로세스
• 종교, 채식주의, 알레르기, 질병 정보 입력
• 건너뛰기 옵션 제공

3. 메인 홈

• 사용자 식이 제한 요약
• 사진 분석 / QR 스캔 버튼
• 최근 분석 기록
• 추천 음식 리스트

4. 음식 분석

• 사진 촬영 또는 갤러리 선택
• AI Vision 분석 결과
  • 음식명, 재료
  • 알레르기 위험도
  • 종교적 제한 위반 여부
  • 질병 관련 주의사항
  • 대체 음식 추천

5. QR 스캔

• 실시간 QR 코드 스캔
• 제품 정보 상세 표시
• 영양 정보 및 안전도 평가

6. 설정

• 개인 식이 제한 정보 관리
• 실시간 저장 및 업데이트

7. 마이페이지

• 프로필 정보
• 분석 통계
• 앱 설정 및 로그아웃

🎯 향후 개발 계획

백엔드 & 인증

• 실제 소셜 로그인 구현 (Firebase Authentication)
• 백엔드 서버 구축 및 연동
• 분석 기록 저장/조회 기능
• 사용자 데이터 동기화

AI & 인식 기능

• AI Vision API 연동 (Google Cloud Vision / OpenAI GPT-4 Vision)
• OCR (광학 문자 인식) 기능 🆕
  • 과자/식품 포장의 원재료명 텍스트 자동 인식
  • 영양성분표 데이터 자동 추출
  • 알레르기 유발 성분 자동 탐지
  • 한글/영문 다국어 인식
• 실시간 음식 인식 및 분류
• 영양 정보 정확도 향상

추가 기능

• 즐겨찾기 기능
• 푸시 알림
• 다국어 지원 (i18n)
• 다크 모드
• 커뮤니티 기능

💡 OCR 기능: QR 코드가 없는 제품도 포장지의 텍스트를 촬영하여 자동으로 분석할 수 있습니다!
자세한 내용은 OCR_PLAN.md 참조

📖 문서

프레젠테이션 & 데모

• 📊 PRESENTATION.md - 대회/투자자용 프레젠테이션 🆕
  • 비개발자를 위한 쉬운 설명
  • 시연 시나리오 포함
  • 비즈니스 가치 중심

개발 문서

• 개발 가이드 - 상세한 개발 문서
• 카메라 기능 가이드 - 실제 카메라 사용법
• OCR 개발 계획 - 텍스트 인식 기능 계획
• 소셜 로그인 가이드 - 공식 디자인 가이드라인
• 앱 로고 가이드 - 앱 로고 설정 방법
• 이미지 자산 가이드 - 이미지 자산 추가 방법

🤝 기여

이 프로젝트는 현재 개발 중입니다. 기여를 환영합니다!

📄 라이선스

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

👨‍💻 개발자

• 개발: FoodWallet Team
• 디자인: Apple-inspired Minimal Design

---

FoodWallet - 안전한 식사를 위한 스마트한 선택 🍽️