jieunlee0106 / nnz_pjt

🎈위치 기반 & QR 코드를 이용한 굿즈(goods) 나눔 앱

🎁 나너주, 나와 너의 굿즈나눔 🎁

프로젝트 기간 : 2023.04.10 ~ 2023.05.19 (6주)

지금 플레이스토어에서 나너주를 만나보세요!

📝 목차

• 개요
• 설계
• 기능
• Front-end
• Back-end

🗂 개요

💗 나너주란?

팬들 간의 제작 굿즈 나눔 앱

🧐 기획의도

기존 굿즈 나눔 방식은 트위터에 자신이 만든 굿즈를 올리며 리트윗 혹은 마음을 눌러 굿즈 받을 사람을 선별합니다.

하지만 다음과 같은 불편함이 있습니다.

• 나눔을 하는 위치를 알기가 어렵다.
• 계속 트위터 공지를 주시하고 있어야 한다.
• 재고 수량 파악이 어렵다.
• 원하는 공연에 대한 굿즈 나눔을 모아보기 힘들다.
• 웨이팅 현황 파악이 힘들어 직접 현장에 가봐야 판단 가능하다.

이러한 불편함을 개선하기 위해 '나너주'를 만들었습니다.

🏃 Team Group

BE 김종성

FE 김지환

BE 염유리

BE 유영훈

FE 이지은

FE 하세진

✅ 핵심 기능

🎙️ 크롤링 스케줄링을 통해 최신 공연 정보 조회

• 네이버 공연 정보를 기반으로 하루에 한 번 새로운 공연 정보를 크롤링해요.
• 다양한 카테고리의 공연을 제공해요.
  • 농구, 야구, 클래식, 콘서트, E스포츠, 가족/아동, 카트라이더: 드리프트, 리그 오브 레전드, 뮤직페스티벌 뮤지컬, 오버워치, 공연제, 축구, 스포츠, 스타크래프트2, 연극

🤲 나눔 생성

• 나눔을 생성하고 트위터 게시글 생성을 연동할 수 있어요.
• 신청된 인증에 대해 수락/거절할 수 있어요.
• 나눔자는 당일에 본인을 찾을 수 있는 정보를 등록할 수 있어요.
  • 구글맵으로 정확한 위치 정보 제공
  • 정확한 시간과 착장 정보 제공
• QR코드 인증으로 빠르게 나눔할 수 있어요.

🙋 나눔 참여

• 인증이 필수이면 신청할 때 사진을 첨부하여 신청해야해요.
• 관심있는 나눔을 찜할 수 있어요.
• QR코드 인증으로 빠르게 나눔받을 수 있어요.

👪 사용자 간 소통

• 팔로우 기능
• 서로 트위터 팔로우가 됐는지 확인할 수 있어요.

🤳 PUSH 알림

• 내가 팔로우한 사용자가 나눔 생성 때
• 내가 생성한 나눔이 마감될 때
• 내가 찜한 나눔이 오픈할 때
• 내가 참여한 나눔의 당일이 됐을 때

📐 설계

🛠️ 기술 스택

❤ Front End

💙 Back End

🖤 Database

💚 CI/CD

💜 Tools

💖 IDE

🌟 서비스 아키텍쳐

🗃️ 산출물

Figma 🔗

ERD

요구사항 명세서 🔗

API 명세서 🔗

📱 기능

메인 페이지

카테고리 상세

공연 상세

나눔 생성

나눔 받기

QR 인증

마이페이지 & 나눔 관리

🖌️ Front-end

라이브러리

name	description	version	link
Flutter_secure_storage	디바이스 내부에 정보를 저장하기 위해 보안에 최적화된 스토리지	8.0.0	flutter_secure_storage
Get	상태 관리 라이브러리	4.6.5	get
dio	서버와 통신을 하기 위해 필요한 패키지	5.0.3	dio
firebase	나눔 오픈 시 알림 정보 전달	2.12.0
geolocator	사용자의 위치 정보 조회	9.0.01
google_maps_	flutter에서 calendar에 event를 표시하기 위해 필요한 패키지	2.0.111
oauth1	트위터 연동 글 작성	2.0.0
flutter_dotenv	환경변수를 관리하기 위해 필요한 패키지	6.1.1	flutter_dotenv
image_picker	디바이스 이미지 업로드	0.8.7+4

디렉토리

📦lib
 ┣ 📂src
 ┃ ┣ 📂bindings
 ┃ ┣ 📂components
 ┃ ┃ ┣ 📂category
 ┃ ┃ ┣ 📂find_password_form
 ┃ ┃ ┣ 📂gray_line_form
 ┃ ┃ ┣ 📂home_page_form
 ┃ ┃ ┣ 📂my_page_form
 ┃ ┃ ┣ 📂my_shared
 ┃ ┃ ┣ 📂notification
 ┃ ┃ ┣ 📂other_user_from
 ┃ ┃ ┣ 📂profile_edit_form
 ┃ ┃ ┣ 📂propose_form
 ┃ ┃ ┣ 📂register_form
 ┃ ┃ ┣ 📂search_form
 ┃ ┃ ┣ 📂sharing_detail
 ┃ ┃ ┣ 📂sharing_register_form
 ┃ ┃ ┃ ┣ 📂category
 ┃ ┃ ┣ 📂tag
 ┃ ┃ ┣ 📂test_message
 ┃ ┣ 📂config
 ┃ ┣ 📂controller
 ┃ ┣ 📂model
 ┃ ┣ 📂pages
 ┃ ┃ ┣ 📂category
 ┃ ┃ ┣ 📂home
 ┃ ┃ ┣ 📂search
 ┃ ┃ ┣ 📂share
 ┃ ┃ ┗ 📂user
 ┃ ┣ 📂services

🧱 Back-end

라이브러리

name	description	version
Spring Boot	스프링 애플리케이션 프레임워크	2.7.11
Spring Cloud	마이크로서비스 개발에 필요한 아키텍처를 쉽게 구성할 수 있도록 지원하는 Spring Boot 기반 프레임워크	2021.0.6
MySQL	관계형 데이터베이스	8.0.32
nnz-common	각 서비스 프로젝트에 공통으로 필요한 기능을 담아 제작한 라이브러리	0.4.5
Docker	컨테이너 기반의 오픈소스 가상화 플랫폼	23.0.4
firebase sdk	FCM PUSH 알림 제공을 위한 SDK	9.1.1
Kafka	데이터 동기화를 위한 메시지 브로커	3.1.2
Redis	"키-값" 구조의 데이터를 관리하기 위한 비관계형 데이터베이스	7.0.11

서비스 프로젝트 설명

name	description	port
nanum-service	나눔과 관련된 서비스	8083
user-service	사용자와 관련된 서비스	8081
show-service	공연과 관련된 서비스	8082
tag-service	태그와 관련된 서비스	8084
crawling-service	크롤링 스케줄링 작업을 진행하는 서비스	8002
admin-service	관리자와 관련된 서비스	8001
gateway-service	MSA 환경에서 사용되는 API Gateway	8000
discovery-service	각 서비스의 위치를 등록한 디스커버리 서비스	8761