📍 PinKonkuk

▶ 실행 영상

Flutter 기반 장소 기록 애플리케이션 PinKonkuk은
건국대학교 학생들이 캠퍼스 공간에 가상의 메모를 남길 수 있도록 하기 위해 만든 애플리케이션입니다.
사용자는 위치 기반으로 장소를 기록하고, 사진과 메모를 추가하여 자신만의 장소 다이어리를 작성할 수 있습니다.

---

✨ 주요 기능

1. 핀 추가

• ➕ 사용자는 특정 장소에 대한 제목, 메모, 카테고리, 서브 카테고리, 위치 정보 및 이미지를 추가하여 새로운 핀을 저장할 수 있습니다.
• 📍 위치 정보는 Geolocator 패키지를 사용하여 실시간으로 가져옵니다.
• 💾 저장된 핀 데이터는 SQLite 데이터베이스에 저장되며, 앱을 재실행해도 유지됩니다.

2. 핀 목록 보기

• 📋 저장된 모든 핀을 리스트 형태로 볼 수 있으며, 리스트에는 제목, 장소 이름, 카테고리, 위도, 경도가 표시됩니다.
• 🔍 특정 핀을 선택하여 세부 정보를 확인할 수 있습니다.

3. 핀 삭제

• 🗑️ 저장된 핀 항목의 삭제가 가능하며, 삭제 후 자동으로 리스트가 갱신됩니다.

4. 카테고리 필터링

• 🏷️ 주요 카테고리(새내기, 맛집, 스터디, 건축 등)와 서브 카테고리(학교 투어, 노래방, 가성비 등)를 제공하여 사용자는 관심 있는 항목만 선택하여 볼 수 있습니다.

5. 이미지 추가

• 🖼️ 핀에 이미지를 추가할 수 있으며, 사용자는 Image Picker를 통해 갤러리에서 이미지를 선택할 수 있습니다.

---

🛠️ 사용한 기술

1. 개발 언어

• 🌐 Dart

2. 프레임워크

• 🖥️ Flutter

3. 데이터베이스

• 📂 SQLite (패키지: sqflite, sqflite_common_ffi)

4. 기타 라이브러리

• 📡 Geolocator: 위치 정보 수집
• 📷 Image Picker: 갤러리에서 이미지 선택

---

🧩 주요 클래스 설명

1. DBHelper

• 🏦 SQLite 데이터베이스를 초기화하고 CRUD(Create, Read, Update, Delete) 작업을 수행하는 클래스입니다.
• 주요 메서드:
  • insertPin(Map<String, dynamic> pin): 새로운 핀 데이터를 데이터베이스에 삽입합니다.
  • getPins(): 모든 핀 데이터를 데이터베이스에서 불러옵니다.
  • deletePin(int id): 특정 ID에 해당하는 핀 데이터를 삭제합니다.

2. MainPage

• 🏠 메인 화면으로, 핀 목록을 보여주고 필터링 기능과 핀 추가 기능을 제공합니다.
• 주요 기능:
  • 📍 현재 위치 정보 가져오기: Geolocator를 사용하여 실시간 위치를 가져옵니다.
  • 🎛️ 핀 리스트 필터링: 선택한 카테고리와 서브 카테고리에 맞는 핀만 보여줍니다.
  • 🔄 리스트 갱신: 핀 추가, 삭제 시 데이터베이스에서 핀 데이터를 다시 로드하여 UI를 갱신합니다.

3. AddEntryPage

• ➕ 새로운 핀을 추가하는 화면입니다.
• 사용자는 제목, 메모, 장소 이름, 카테고리, 서브 카테고리, 이미지를 입력할 수 있으며, 현재 위치 정보는 자동으로 가져옵니다.

4. ViewEntryPage

• 🔍 특정 핀의 세부 정보를 보여주는 화면입니다.
• 핀에 저장된 제목, 메모, 장소 이름, 카테고리, 위치 정보 및 이미지를 볼 수 있습니다.

---

🗂️ 데이터베이스 구조

컬럼 이름	데이터 타입	설명
id	INTEGER	고유 ID, 자동 증가
title	TEXT	핀 제목
note	TEXT	핀에 대한 메모
placeName	TEXT	장소 이름
latitude	REAL	위도
longitude	REAL	경도
category	TEXT	주요 카테고리
imagePath	TEXT	이미지 경로

---

🚀 실행 방법

의존성 설치
프로젝트 디렉터리에서 다음 명령어를 실행하여 필요한 패키지를 설치합니다:

flutter pub get