🏠그 집 어데고

🥈 삼성 청년 SW 아카데미(SSAFY) 특화 프로젝트 우수상 🥈

📌 프로젝트 개요

• 명칭 : 그집 어데고
• 소개 : COVID-19의 여파로 영업의 어려움을 겪고 있는 노포 상권을 활성화하기 위해 MZ세대를 타겟층으로 맞춤 노포를 추천해주는 서비스
• 진행 기간 : 2022.09.29(월) ~ 2022.10.07(금)
• UCC : Youtube 링크

---

🧑 팀원 소개

팀장	팀원	팀원	팀원
원찬호	김민주	김현열	허성은
FRONTEND	BACKEND	BACKEND	BACKEND
UI/ UX 와이어 프레임 설계 기획 및 디자인	AWS 및 CI/CD 구성 회원 및 AZTI API JWT 및 소셜 로그인	데이터 크롤링 CBF 추천 알고리즘 추천 API	리뷰, 식당 API CF 추천 알고리즘 S3 구축 및 DB 설계

---

🗂️ 주요 기능

User 관련

• 소셜 로그인(카카오)를 이용해 간편하게 회원가입/ 로그인이 가능하다.

• 회원 가입 시 사이트 내 자체 유형 테스트(AZTI)를 받아볼 수 있다.

• 회원 정보 수정이 가능하다.

• 회원 가입 시 진행한 AZTI 테스트의 재검사가 가능하다.

• 마이 페이지

  • 회원이 '좋아요'한 식당 목록을 제공한다.

  • 회원이 '가본곳'한 식당 목록을 제공한다.

  • 회원이 작성한 리뷰 목록을 제공한다.

노포 관련

• 메인 페이지

  • 컨텐츠 기반 필터링(CBF)와 행렬 분해(CF) 알고리즘을 결합한 노포 추천 리스트를 제공한다.

  • 활동 기록이 적은 사용자에게는 회원가입 시 진행했던 AZTI 결과에 따라 CBF 알고리즘 이용해 추천 리스트를 제공한다.

  • 사이트 내 활동 기록(좋아요)이 쌓이면 CF 알고리즘을 이용한 개인 맞춤형 추천 리스트를 제공한다.

• 상세 페이지

  • 해당 가게의 평균 평점, 개업 년도, 주소, 대표 메뉴 등의 정보를 제공한다.

  • 아이콘을 눌러 '좋아요' 등록과 '가본곳' 등록을 할 수 있다.

  • KAKAO MAP API를 이용해 구현한 지도로 해당 가게의 위치를 제공한다 .

  • '유사 식당'으로 아이템 기반 협업 필터링(CF) 알고리즘을 이용해 구현한 해당 노포와 유사한 가게의 추천 리스트를 제공한다.

  • 해당 가게에 작성된 리뷰 목록을 제공한다. 각 리뷰에는 작성일, 평점, 내용, 사진이 포함되어 있다.

Review 관련

• 리뷰 작성이 가능하다. 가게에 대한 평점, 내용, 사진을 첨부해 작성할 수 있다.
• 리뷰 삭제와 수정이 가능하다.

---

💻 기술 스택

💫 Front-end

💫 Back-end

💫 Big-data

💫 CI/CD

💫 Team Collaboration Tool

---

사용 방법

• frontend

npm i

npm run dev
or
npx vite

• backend

(intelij)
build

run

• backend-data

python -m venv venv

source venv/Scripts/activate

pip install -r requirements.txt

python manage.py runserver

프로젝트 파일 구조

Back

backend
  ├── build 
  ├── gradle
  ├── out
  ├── src
  │   ├── main
  │   │   └── generated
  │   │   │   └── com.ssafy.nopo.db.entity
  │   │   └── java
  │   │   │   └── com.ssafy.nopo
  │   │   │   │   ├── api
  │   │   |   |   │   ├── controller
  │   │   |   |   │   ├── request
  │   │   |   |   │   ├── response
  │   │   |   |   │   └── service
  │   │   │   │   ├── common
  │   │   |   |   │   └── auth
  │   │   |   |   |   │   ├── client
  |   │   │   |   |   │   └── jwt
  │   │   |   |   │   ├── exception
  │   │   |   |   │   └── util
  │   │   │   │   ├── config
  │   │   │   │   ├── db
  │   │   |   |   │   ├── entity
  │   │   |   |   │   └── repository
  │   │   │   │   ├── NopoApplication
  │   │   └── resources
  │   │   │   └── application.properties
  │   └── test
  ├── gitignore
  ├── build.gradle
  ├── Dockerfile
  ├── gradlew
  ├── gradlew.bat
  └── settings.gradle

Back-data

backend-data
  ├── main
  │   ├── migrations
  │   └── template/main
  ├── recommend
  │   ├── crawling
  │   ├── csvfile
  │   ├── migrations
  │   ├── recom
  |   │   ├── cbf.py
  |   │   ├── database.py
  |   │   ├── knn.py
  |   │   └── test.py
  │   ├── admin.py
  │   ├── apps.py
  │   ├── models.py
  │   ├── tests.py
  │   ├── urls.py
  │   └── views.py
  ├── wherehouse
  │   ├── asgi.py
  │   ├── settings.py
  │   ├── urls.py
  │   └── wsgi.py
  ├── gitignore
  ├── Dockerfile
  ├── manage.py
  ├── requirements.txt
  ├── gradlew.bat
  └── settings.gradle

Front

FRONTEND
  ├── node_modules
  ├── public
  └── src
  │   ├── api
  |   │   ├── api
  |   │   ├── index.ts
  |   │   ├── reqType.ts
  |   │   ├── resType.ts
  |   │   └── settings.ts
  │   ├── assets
  │   ├── Form
  |   │   ├── ReviewComp
  |   │   ├── NewReviewForm.tsx
  |   │   └── ReviewForm.tsx
  │   ├── needConfirm
  |   │   ├── NeedConfirm.tsx
  |   │   ├── RestoInfo.tsx
  |   │   └── SearchCompo.tsx
  │   ├── pages
  |   │   ├── CommonComp
  |   │   ├── DetailPage
  |   │   ├── MainPage
  |   │   ├── MyPage
  |   │   ├── SearchPage
  |   │   ├── StartPage
  |   │   ├── UserComponents
  |   │   ├── userStore
  |   │   └── IndexPage.tsx
  │   ├── style
  |   |   └── style.css
  │   ├── App.css
  │   ├── App.tsx
  │   ├── index.css
  │   ├── main.tsx
  │   ├── PrivateRoute.tsx
  │   └── vite-env.d.ts
  ├── gitignore
  ├── Dockerfile
  ├── index.html
  ├── package-lock.json
  ├── package.json
  ├── tsconfig.json
  ├── tsconfig.node.json
  └── vite.config.ts
   

협업 툴

• GIt
• Notion
• JIRA
• MatterMost
• Webex

협업 환경

• Gitlab
  • 버전 관리
  • 이슈 발행 해결
  • MR시, 코드 리뷰를 진행
• JIRA
  • 매주 목표 량을 설정하여 Sprint 진행
  • 업무 할당량을 Story point로 설정하고, In-progress => Done 순으로 작업
• Notion
  • 아침마다 scrum을 진행하고 회의가 있을 때마다 회의록에 기록
  • 컨벤션 정리
  • 문서 관리

프로젝트 산출물

• API
• ERD
• 프로토타입
• 아키텍처
• 컨벤션

그집 어데고 화면

• 로그인

• AZTI 테스트

• 카카오톡 공유하기

• 메인페이지

• 써치페이지

• 마이페이지

• 써치페이지 디테일

• 노포디테일페이지

• 좋아요 등록 취소

• 방문한 곳 등록 취소

• 리뷰 작성

• 리뷰 삭제