지자체별 행사 / 축제 정보 및 날씨 제공 서비스

순서

About the Project
Getting Started
- Prerequisites
- Installation
프로젝트 구조 / 동작 방식
Usage
Roadmap
Contribution
License
Contact

About the Project

기존에 축제나 행사를 검색하기 위해서는 행사가 언제 어디서 열리는지 파악하고, 그 날짜에 맞춰서 날씨를 또 검색해 보아야 하는 번거로움이 있었다. 이러한 일련의 번거로운 과정들을 한 데 묶어 몇 번의 클릭으로 사용자가 원하는 행사 및 축제 정보를 디스플레이 함으로써 사용자의 편의 증대라는 효과를 가져올 수 있을 것으로 예상된다. 또한 시민들의 활발한 행사 참여로 인해 지역 경제 활성화에 이바지할 수 있을 것으로 예상된다.

본 서비스는 지자체에서 개최하는 행사 정보와 날씨 데이터를 API를 통하여 받아온 후 그를 조합하여 사용자에게 친숙한 인터페이스(svelte 활용)를 통해 지역 / 행사별로 날씨 정보를 한눈에 볼 수 있는 서비스를 제공한다.

Built With

WEB
- Node.js
- Svelte
- Express
Database
- MongoDB
API Handler

Getting Started

Prerequisites

Docker 다운로드 페이지에 접속하여 docker 및 docker-compose 설치
API 키를 획득하기 위해, Free API Key를 기상청 API에서 단기예보 서비스에 대한 API Key를, 관광공사 API에서 국문 관광정보 서비스에 대한 API Key를, 카카오 지도 API Key를 획득

Installation

Windows의 경우 설치하고자 하는 폴더에 들어가서 우클릭한 후 git bash 를 클릭하여 터미널 창을 연다
MacOs의 경우 터미널창을 연 후 Command Line Interface를 통하여 설치하고자 하는 폴더로 이동한다

git clone 명령으로 프로젝트 폴더 clone

git clone http://khuhub.khu.ac.kr/2018102190/TFT.git

API 키 적용 방법 -> ServiceKey 폴더 안의 festival.txt, weather.txt 파일에 국문 관광정보 서비스 API키와 기상청 단기예보 서비스 API를 각각 입력하고, TFT/TFT_WEB/public/index.html 안의 dapi.kakao.com/v2/maps/sdk.js?appkey=########의 # 부분에 카카오 지도 API를 입력한다

프로젝트 구조 / 동작 방식

Service 1 - Web
1. Frontend
  1. Svelte를 사용하여 관광지 정보 / 날씨 정보를 한눈에 볼 수 있게 알려주는 반응형 유저 인터페이스로 사용
  2. 카카오 지도 API를 호출하여 지도 위에 핀 및 마커 설정
2. Backend Server
  1. MongoDB Database와 Node.js 연결
  2. DB에서 데이터를 불러 온 후 Frontend에서 유저에 의한 요청 발생 시 Frontend로 전송
Service 2 - DB
1. API로부터 받아온 정보를 관리하고 Server에 제공

DB 설정 방법 : docker-compose 실행에 따라서 자동으로 database가 설정된다.
DB Schema

title : 축제명

addr : 축제 개최주소

tel : 축제 문의 전화번호

mapx : 축제 지역 경도값

mapy : 축제 지역 위도값

overview : 축제에 관한 간략한 설명

firstimage : 축제 관련 사진 정보

homepage : 축제 홈페이지

eventstartdate : 축제 시작일

evemtenddate : 축제 종료일

weather : 축제 시작일 기준 3일분의 온도와 날씨 정보를 json 형태로 저장