lib/
├── core/               # 공통 유틸리티, 상수, 위젯
│   ├── constants/      # 앱 상수, 컬러, 타이포그래피
│   ├── errors/         # 예외 처리
│   ├── network/        # 네트워크 클라이언트
│   ├── utils/          # 유틸리티 함수
│   └── widgets/        # 공통 위젯
├── data/               # 데이터 레이어
│   ├── api/            # API 클라이언트
│   ├── datasources/    # 데이터 소스 (로컬/원격)
│   ├── models/         # 데이터 모델
│   └── repositories/   # 레포지토리 구현
├── domain/             # 도메인 레이어
│   ├── entities/       # 비즈니스 엔티티
│   ├── repositories/   # 레포지토리 인터페이스
│   └── usecases/       # 유즈케이스
└── presentation/       # 프레젠테이션 레이어
    ├── pages/          # 화면
    ├── providers/      # Riverpod 프로바이더
    └── widgets/        # UI 위젯

🚀 시작하기

요구사항

Flutter SDK 3.8.1 이상
Dart SDK 3.0 이상
Android Studio / VS Code
iOS: Xcode 14.0+ (iOS 빌드 시)

설치 방법

저장소 클론

git clone https://gitea.chizstudio.com/julian/lunchpick.git
cd lunchpick

의존성 설치

flutter pub get

API 키 설정 네이버 Client ID/Secret은 환경 변수로 주입합니다. 민감 정보는 base64로 인코딩한 뒤 --dart-define으로 전달하세요.

# macOS/Linux
NAVER_CLIENT_ID=$(printf 'YOUR_NAVER_CLIENT_ID' | base64)
NAVER_CLIENT_SECRET=$(printf 'YOUR_NAVER_CLIENT_SECRET' | base64)

flutter run \
  --dart-define=NAVER_CLIENT_ID=$NAVER_CLIENT_ID \
  --dart-define=NAVER_CLIENT_SECRET=$NAVER_CLIENT_SECRET

# 테스트 실행 시에도 동일하게 전달
flutter test \
  --dart-define=NAVER_CLIENT_ID=$NAVER_CLIENT_ID \
  --dart-define=NAVER_CLIENT_SECRET=$NAVER_CLIENT_SECRET

로컬 개발에서만 임시로 평문을 사용하려면 base64 인코딩을 생략할 수 있습니다.

코드 생성

flutter pub run build_runner build --delete-conflicting-outputs

개발 모드 실행

# iOS
flutter run -d ios

# Android
flutter run -d android

# Web (실험적)
flutter run -d chrome

프로덕션 빌드

# Android APK
flutter build apk --release

# Android App Bundle
flutter build appbundle --release

# iOS
flutter build ios --release

🧪 테스트

단위 테스트 실행

flutter test

특정 테스트 파일 실행

flutter test test/unit/domain/usecases/recommendation_engine_test.dart

테스트 커버리지

flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

📝 문서

자세한 문서는 doc/ 디렉토리를 참조하세요:

🤝 기여하기

브랜치 전략

main: 프로덕션 배포 브랜치
develop: 개발 브랜치
feature/*: 기능 개발
bugfix/*: 버그 수정
hotfix/*: 긴급 수정

커밋 컨벤션

type(scope): 간단한 설명

상세 설명 (선택사항)

Resolves: #이슈번호

타입:

feat: 새로운 기능
fix: 버그 수정
docs: 문서 수정
style: 코드 포맷팅
refactor: 리팩토링
test: 테스트 코드
chore: 빌드, 패키지 관련

Pull Request 가이드라인

develop 브랜치에서 feature 브랜치 생성
작업 완료 후 PR 생성
코드 리뷰 후 머지
브랜치 삭제

📄 라이센스

이 프로젝트는 MIT 라이센스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 연락처

개발자: NatureBridgeAI
이메일: contact@naturebridgeai.com
이슈 트래커: GitHub Issues

_{Built with ❤️ by NatureBridgeAI}

Languages

Dart 75.7%

HTML 17.5%

C++ 3.3%

CMake 2.6%

Ruby 0.4%

Other 0.5%