README.md
3.95 KB
CafeRecommend
목차
About The Project
카카오 지도 API를 활용하여 사용자가 원하는 카페들을 지도상에서 추천해주는 서비스 입니다.
Demo Link
https://2015104153.oss2021.tk:3000
Getting Started
Prerequisite
Execution
- 구글 클라우드 생성 및 프로젝트 등록 후 ClientID 발급 (https://cloud.google.com/)
- 카카오 Developer 가입 후 애플리케이션 추가 후 Javascript API키 발급 (https://developers.kakao.com/)
- sql폴더에 정의된 테이블 생성문 MySQL에서 실행
- KHU-HUB repo clone
sh git clone http://khuhub.khu.ac.kr/2015104153/CafeRecommend
- 디렉토리 이동 후 npm 패키지 설치
sh npm install
- 발급받은 ClientID를
index.js
,index.ejs
, Javascript API키는map.ejs
에 각각 넣기JS var CLIENT_ID = "발급받은 ClientID" // index.js
<meta name="google-signin-client_id" content="발급받은 ClientID"> // index.ejs
<script type="text/javascript" src="//dapi.kakao.com/v2/maps/sdk.js?appkey=발급받은API키&libraries=services"></script> // map.ejs
- MySQL connection 연결 설정 (index.js)
JS var connection = mysql.createConnection({ host: "IP주소 입력 (localhost 또는 AWS 서버 주소)", user: "계정 입력", password: "암호 입력", database: "스키마이름 입력", });
- 프로그램 실행
sh npm run start
Usage
Login & SignUp
프로그램 실행 시 최초에 나타나는 화면입니다. 구글 로그인 버튼 클릭 시에는 구글계정으로만 로그인을 수행합니다. 계정이 등록된 경우에는 바로 Map 화면으로 이동하며 그렇지 않은 경우 회원가입화면에서 닉네임(중복 불가), 나이, 성별입력 및 선호도를 선택을 수행합니다.
Map
프로젝트 메인 화면입니다. 지도에 줌인.줌아웃이 가능하며 초기에는 사용자의 현재 위치를 기준으로 위치로 이동합니다. API를 통해 제공된 45개의 카페가 마커형태로 나타나며 클릭 시 상세정보를 보여줍니다. 이때 후기등록 버튼 클릭시에는 후기 등록 화면으로 이동합니다.
Review
후기입력화면입니다. 총 4가지를 1~5점 범위에서 입력받습니다. 4가지를 모두 입력받아야 하며 등록 완료시에는 alert메시지가 나오고 Map화면으로 돌아갑니다.
Recommend
Map에서 화면 하단의 추천 버튼 클릭 시 나타나는 화면입니다. 추천 버튼을 클릭하면 가입 시 선택했던 선호도에 맞는 카페만을 지도에 보여줍니다. 이때 추천 결과가 없는 경우에는 추천을 수행하지 않고 모든 카페를 보여줍니다.
Contributing
- 프로젝트 Fork
- 브랜치 생성 후 변경사항 작업
- 브랜치 push 후 Pull Request Open
Contact
2015104153 김대철
2016104174 최정민