🍽️ 구르맛 (Gourmet)

🎬 프로젝트 시연 영상

📖 프로젝트 개요

📅 개발 기간

👥 팀 구성 및 역할

✨ 주요 기능

🗺️ 1. 맛집 지도

📝 2. 실시간 리뷰 게시물

👤 3. 타임라인 & 마이페이지

🎓 대학생 인증 시스템

인증 프로세스

권한 관리

🛠️ 기술 스택

Frontend

Backend & Database

주요 패키지

🏗️ 시스템 설계

📊 데이터 흐름도

🗂️ 데이터베이스 구조

ERD (Entity Relationship Diagram)

테이블 상세 정보

🧩 메뉴 구조도

📱 화면 구성

🔐 인증 화면

스플래시 & 로그인

회원가입 - 대학생

회원가입 - 일반 회원

🗺️ 맛집 지도

지도 메인 화면

음식점 클릭

🍴 음식점 상세

메뉴 탭 & 리뷰 탭

📝 리뷰 작성 & 피드

리뷰 작성 화면

리뷰 피드

👤 마이페이지

타임라인 & 프로필

🚀 주요 구현 사항

1. 위치 기반 서비스

2. Firebase 통합

3. 실시간 업데이트

4. 이미지 처리

🎯 프로젝트 목표 및 성과

목표

성과

🔧 트러블슈팅

리뷰 좋아요/싫어요 기능 구현 시 데이터베이스 설계 문제

문제 상황: 단순 카운트만으로는 부족했던 초기 설계

Review 컬렉션 (초기 설계)
├── Review_number (Key, AUTO_INCREMENT)
├── Review_content (Field2, Domain)
├── Rating (Field3, Domain)
├── Date (Field6, Domain)
├── Good_rate (Field7, Domain) ← 좋아요 개수만 저장
├── Bad_rate (Field8, Domain) ← 싫어요 개수만 저장
├── User_id (Key2, Domain)
└── Restaurant_id (Key3, Domain)

// ❌ 초기 방식: 누가 눌렀는지 알 수 없음
Good_rate: 15 // 15명이 좋아요를 눌렀다는 것만 알 수 있음
Bad_rate: 3 // 하지만 "내가" 눌렀는지는 알 수 없음!

해결 방법: 사용자 목록 추적 배열 추가

Review 컬렉션 (개선된 설계)
├── Review_number (Key, AUTO_INCREMENT)
├── Review_content (string)
├── Rating (number)
├── Date (timestamp)
├── Good_rate (number) ← 좋아요 개수
├── Good_users (array) ← ✨ 좋아요 누른 사용자 UID 배열 (신규)
├── Bad_rate (number) ← 싫어요 개수
├── Bad_users (array) ← ✨ 싫어요 누른 사용자 UID 배열 (신규)
├── Content (string)
├── Images (array)
├── Nickname (string)
├── Restaurant_name (string)
└── UserId (string)

{
 Bad_rate: 0,
 Bad_users: [], // 싫어요 누른 사용자 목록
 
 Good_rate: 1,
 Good_users: [ // 좋아요 누른 사용자 목록
 "m8exH7avJ3fAwmBpBO0fjuqwQR73" // 이 사용자가 좋아요를 눌렀음
 ],
 
 Content: "여비는 진짜 레전드..맛집입니다. 아침부터 오프런했어요!!!",
 Date: "2024년 12월 3일 PM 2시 58분 3초 UTC+9",
 Images: [
 "https://firebasestorage.googleapis.com/.../image1.jpg",
 "https://firebasestorage.googleapis.com/.../image2.jpg"
 ],
 Nickname: "전상우입니다",
 Rating: 5,
 Restaurant_name: "삼방매",
 UserId: "OIuoJe03BkOjNU4ZLeHFiCjHiYW2"
}

구현 코드: 사용자별 상태 관리

// threadScreen.dart의 likeDislikeContainer 위젯
StreamBuilder(
 stream: FirebaseFirestore.instance
 .collection("Review")
 .doc(widget.documentId)
 .snapshots(),
 builder: (context, snapshot) {
 final doc = snapshot.data!.data();
 
 // ✅ Good_users 배열에 현재 사용자 UID가 있는지 확인
 isliked = doc!["Good_users"].contains(
 FirebaseAuth.instance.currentUser!.uid
 );
 
 // ✅ Bad_users 배열에 현재 사용자 UID가 있는지 확인
 isdisliked = doc!["Bad_users"].contains(
 FirebaseAuth.instance.currentUser!.uid
 );
 
 return Container(
 child: Row(
 children: [
 // 좋아요 버튼
 IconButton(
 onPressed: () async {
 // 좋아요 토글
 },
 icon: Icon(
 isliked ? Icons.thumb_up : Icons.thumb_up_outlined,
 color: isliked ? Colors.blue : Colors.grey,
 ),
 ),
 Text("${doc["Good_rate"]}"),
 
 // 싫어요 버튼
 IconButton(
 onPressed: () async {
 // 싫어요 토글
 },
 icon: Icon(
 isdisliked ? Icons.thumb_down : Icons.thumb_down_outlined,
 color: isdisliked ? Colors.red : Colors.grey,
 ),
 ),
 Text("${doc["Bad_rate"]}"),
 ],
 ),
 );
 }
)

// 좋아요 버튼 클릭 시
IconButton(
 onPressed: () async {
 isliked = !isliked; // 상태 토글
 
 await FirebaseFirestore.instance
 .collection("Review")
 .doc(widget.documentId)
 .update({
 // ✅ 카운트 증가/감소
 "Good_rate": FieldValue.increment(isliked ? 1 : -1),
 
 // ✅ 사용자 UID를 배열에 추가/제거
 "Good_users": isliked
 ? FieldValue.arrayUnion([FirebaseAuth.instance.currentUser!.uid])
 : FieldValue.arrayRemove([FirebaseAuth.instance.currentUser!.uid])
 });
 },
 icon: Icon(
 isliked ? Icons.thumb_up : Icons.thumb_up_outlined,
 color: isliked ? Colors.blue : Colors.grey,
 ),
)
// 싫어요 버튼도 동일한 방식
IconButton(
 onPressed: () async {
 isdisliked = !isdisliked;
 
 await FirebaseFirestore.instance
 .collection("Review")
 .doc(widget.documentId)
 .update({
 "Bad_rate": FieldValue.increment(isdisliked ? 1 : -1),
 "Bad_users": isdisliked
 ? FieldValue.arrayUnion([FirebaseAuth.instance.currentUser!.uid])
 : FieldValue.arrayRemove([FirebaseAuth.instance.currentUser!.uid])
 });
 },
 icon: Icon(
 isdisliked ? Icons.thumb_down : Icons.thumb_down_outlined,
 color: isdisliked ? Colors.red : Colors.grey,
 ),
)

개선 효과

사용자 A가 리뷰 화면 진입
↓
좋아요 개수: 15개 표시
↓
❌ 내가 눌렀는지 모름 → 빈 아이콘(👍🏻) 표시
↓
좋아요 버튼 클릭
↓
❌ 중복 체크 불가 → 개수만 증가 (16개)
↓
화면 나갔다가 다시 진입
↓
❌ 상태 초기화 → 또 빈 아이콘 표시

사용자 A가 리뷰 화면 진입
↓
Good_users 배열 확인
↓
✅ 내 UID가 있음 → 채워진 아이콘(👍) 표시
↓
좋아요 버튼 클릭 (토글)
↓
✅ arrayRemove로 UID 제거 → 중복 방지
✅ increment(-1)로 개수 감소
↓
화면 나갔다가 다시 진입
↓
✅ Good_users 배열 확인 → 상태 유지

NoSQL의 유연성 경험

 기존 문서에 새 필드 추가 시:
 
 RDB (MySQL, PostgreSQL)
 ❌ ALTER TABLE 필요
 ❌ 기존 데이터 마이그레이션 필요
 ❌ 스키마 변경 시간 소요
 
 NoSQL (Firestore)
 ✅ 그냥 필드 추가하면 끝
 ✅ 기존 데이터 영향 없음
 ✅ 즉시 반영

 // ✅ 필드가 없어도 안전하게 처리
 isliked = (doc["Good_users"] ?? []).contains(
 FirebaseAuth.instance.currentUser!.uid
 );
 
 // ✅ 새 문서 생성 시 필드 추가
 await FirebaseFirestore.instance
 .collection("Review")
 .add({
 "Good_rate": 0,
 "Good_users": [], // 신규 필드
 "Bad_rate": 0,
 "Bad_users": [], // 신규 필드
 // ... 기타 필드
 });

📂 프로젝트 구조

gourmet_app/
├── lib/
│ ├── main.dart # 앱 진입점
│ ├── firebase_options.dart # Firebase 설정
│ ├── screens/
│ │ ├── loginScreen.dart # 로그인 화면
│ │ ├── signupScreen.dart # 회원가입 화면
│ │ ├── mapScreen.dart # 지도 메인 화면
│ │ ├── restaurantDetailsScreen.dart # 음식점 상세 화면
│ │ ├── uploadScreen.dart # 리뷰 작성 화면
│ │ ├── threadScreen.dart # 리뷰 피드 화면
│ │ └── myPageScreen.dart # 마이페이지 화면
│ └── components/
│ └── restourantInfo.dart # 음식점 정보 컴포넌트
├── docs/ # 문서 및 이미지
│ ├── data-flow-diagram.png
│ ├── database-erd.png
│ ├── database-table.png
│ ├── menu-structure.png
│ └── screen-*.png
├── images/ # 앱 내 리소스
│ └── loading.png
└── pubspec.yaml # 패키지 의존성 관리

🔧 개발 환경 설정

요구 사항