Showing
1 changed file
with
95 additions
and
11 deletions
| 1 | -## 2021 - 2학기 오픈소스SW개발 프로젝트 | 1 | +# 2021 - 2학기 오픈소스SW개발 프로젝트 |
| 2 | 2 | ||
| 3 | -#### 지자체별 행사 / 축제 정보 및 날씨 제공 서비스 | 3 | +## 지자체별 행사 / 축제 정보 및 날씨 제공 서비스 |
| 4 | 4 | ||
| 5 | ---- | 5 | +* 지자체에서 개최하는 행사 정보와 날씨 데이터를 조합하고, 사용자에게 친숙한 인터페이스를 활용하여 지역/행사별로 날씨 정보를 한눈에 볼 수 있는 서비스를 제공한다. |
| 6 | -*** | ||
| 7 | ---- | ||
| 8 | 6 | ||
| 9 | -1. Service 1 - web | 7 | +Built With |
| 8 | + | ||
| 9 | +- Frontend | ||
| 10 | + * [Svelte](https://svelte.dev/) | ||
| 11 | +- Backend & DB | ||
| 12 | + * [Node.js](https://nodejs.org/ko/download/) | ||
| 13 | + * [MongoDB](https://www.mongodb.com/) | ||
| 14 | + | ||
| 15 | +## Getting Started | ||
| 16 | + | ||
| 17 | +### Prerequisites 사전 설치 파일 | ||
| 18 | + | ||
| 19 | +1. Docker를 사용하는 경우 (**권장**) | ||
| 20 | + * [도커 공식 홈페이지](https://www.docker.com/)에 접속하여 docker 및 docker-compose 설치 | ||
| 21 | +1. Docker를 사용하지 않는 경우 | ||
| 22 | + * [Node.js 공식 홈페이지](https://nodejs.org/ko/download/)에 접속하여 Node.js 설치 | ||
| 23 | + * [MongoDB 공식 홈페이지](https://www.mongodb.com/)에 접속하여 MongoDB 설치 | ||
| 24 | + * [Mongoexport 사용을 위한 tool](https://www.mongodb.com/try/download/database-tools?tck=docs_databasetools)에 접속하여 mongoexport 추가 가능 설치 | ||
| 25 | + * `Program files/mongodb/bin` 경로 안에 설치된 파일들 추가하여 확장 기능을 위한 설치 완료 | ||
| 26 | + | ||
| 27 | + | ||
| 28 | +### Installation 설치 | ||
| 29 | + | ||
| 30 | +* Windows의 경우 설치하고자 하는 폴더에 들어가서 우클릭한 후 `git bash` 를 클릭하여 터미널 창을 연다. | ||
| 31 | + | ||
| 32 | +* MacOs의 경우 터미널창을 연 후 Command Line Interface를 통하여 설치하고자 하는 폴더로 이동한다 | ||
| 33 | + | ||
| 34 | +* `git clone` 명령으로 프로젝트 폴더 clone | ||
| 35 | + ``` | ||
| 36 | + git clone http://khuhub.khu.ac.kr/2018102190/TFT.git | ||
| 37 | + ``` | ||
| 38 | + | ||
| 39 | +* `npm install` 명령으로 npm 패키지 설치 | ||
| 40 | + ``` | ||
| 41 | + npm install | ||
| 42 | + ``` | ||
| 43 | + | ||
| 44 | + | ||
| 45 | +## 프로젝트 구조 | ||
| 46 | + | ||
| 47 | +1. Service 1 - Web | ||
| 48 | + 1. Frontend | ||
| 49 | + 1. Svelte를 사용하여 관광지 정보 / 날씨 정보를 한눈에 볼 수 있게 알려주는 유저 인터페이스로 사용 | ||
| 50 | + 1. [카카오 지도 API](https://apis.map.kakao.com/)를 호출하여 지도 위에 핀 및 마커 설정 | ||
| 10 | 1. Backend Server | 51 | 1. Backend Server |
| 11 | 1. MongoDB Atlas와 서버를 연동하여 Database와 Node.js 연결 | 52 | 1. MongoDB Atlas와 서버를 연동하여 Database와 Node.js 연결 |
| 12 | 1. DB에서 json 형태의 데이터를 불러 온 후 Frontend에서 유저에 의한 요청 발생 시 Frontend로 전송 | 53 | 1. DB에서 json 형태의 데이터를 불러 온 후 Frontend에서 유저에 의한 요청 발생 시 Frontend로 전송 |
| 13 | - 1. Frontend | ||
| 14 | - 1. Svelte를 사용하여 관광지 정보 / 날씨 정보를 알려주는 유저 인터페이스로 사용 | ||
| 15 | - | ||
| 16 | 1. Service 2 - DB | 54 | 1. Service 2 - DB |
| 17 | 1. API로부터 받아온 정보를 관리하고 MongoDB Atlas를 활용하여 Server에 제공 | 55 | 1. API로부터 받아온 정보를 관리하고 MongoDB Atlas를 활용하여 Server에 제공 |
| 18 | - | ||
| 19 | 1. Service 3 - API Handler | 56 | 1. Service 3 - API Handler |
| 20 | 1. [관광공사 API](https://api.visitkorea.or.kr/main.do)를 호출하여 Database에 Write함 | 57 | 1. [관광공사 API](https://api.visitkorea.or.kr/main.do)를 호출하여 Database에 Write함 |
| 21 | - 1. [카카오 지도 API](https://apis.map.kakao.com/)를 호출하여 지도 위에 핀 및 마커 설정 | 58 | + 1. [기상청 API](https://data.kma.go.kr/api/selectApiList.do?pgmNo=42)를 호출하여 날씨 및 기상 관련 정보 가져옴 |
| 59 | + | ||
| 60 | +## Usage 사용법 | ||
| 61 | + | ||
| 62 | +빌드 설치 설정 예시 / 방법 | ||
| 63 | + | ||
| 64 | +1. Docker에서 사용하는 경우 | ||
| 65 | + 1. Docker-compose를 이용하여 | ||
| 66 | +1. 직접 소스코드를 수정하는 경우 | ||
| 67 | + | ||
| 68 | + | ||
| 69 | +## Roadmap | ||
| 70 | + | ||
| 71 | +* 무슨 기능들 구현했는지 시간에 따라 | ||
| 72 | + | ||
| 73 | + | ||
| 74 | +- [v] 처음 구현한 기능 | ||
| 75 | +- [v] 그다음 구현한 기능 | ||
| 76 | +- [v] 세번째 구현한 기능 | ||
| 77 | +- [ ] 네번째 구현한 기능 | ||
| 78 | +- [ ] 다섯번째 구현한 기능 | ||
| 79 | + - [ ] 세부기능1 | ||
| 80 | + - [ ] 세부기능2 | ||
| 81 | + | ||
| 82 | +## Contribution | ||
| 83 | + | ||
| 84 | +프로젝트에 대한 어떠한 참여나 추가 개발도 **환영합니다**. | ||
| 85 | + | ||
| 86 | +만약 프로젝트 발전을 위한 더 좋은 방법이 있으시다면 저희의 repo를 fork하신 후 pull request를 부탁드립니다. | ||
| 87 | + | ||
| 88 | +1. 프로젝트 fork 해오기 (` git clone http://khuhub.khu.ac.kr/2018102190/TFT.git `) | ||
| 89 | +2. 새로운 기능을 위한 branch 생성 (` git checkout -b feature/newFeature `) | ||
| 90 | +3. 바뀐 파일들 commit하기 (` git commit -m 'Add some newFeature' ` ) | ||
| 91 | +4. Fork된 Branch에 바뀐 파일들 push하기 (` git push origin feature/newFeature `) | ||
| 92 | +5. Pull Request 보내기 | ||
| 93 | + | ||
| 94 | +## License | ||
| 95 | + | ||
| 96 | + | ||
| 97 | + | ||
| 98 | +## Contact | ||
| 99 | + | ||
| 100 | +2018102198 서준혁 junhyuk0801@khu.ac.kr | ||
| 101 | + | ||
| 102 | +2018102194 배형석 qogudtjr7@khu.ac.kr | ||
| 103 | + | ||
| 104 | +2018102190 박정민 jungmin59@khu.ac.kr | ||
| 22 | 105 | ||
| 106 | +프로젝트 주소 : [http://khuhub.khu.ac.kr/2018102190/TFT.git](http://khuhub.khu.ac.kr/2018102190/TFT.git) | ... | ... |
-
Please register or login to post a comment