• 프로젝트 개요

  • 🏠 Run With Me Homepage

  • Run With Me는 런닝 시 GPS 추적을 통해 사용자의 런닝 기록 저장 및 사용자의 지역, 성향에 맞춰 코스를 추천 런닝 메이트들과 함께 기부하는 시스템, 친목 도모를 위한 채팅 및 커뮤니티를 활성화하여 게임같이 런닝을 즐길 수 있는 웹 / 앱 서비스입니다.

• 주요 기능

  • 러닝 기록 및 / 분석

    1. 사용자의 러닝을 실시간으로 추적하고 속도, 거리와 같은 기록이 화면에 표시가 된다.

    2. 러닝 종료 시 기록이 저장되고, 개인 러닝 기록을 실시간으로 분석한다.

    ​ - 이전 기록과 최근 기록, 평균 러너 기록을 분석하여 비교해 얼마나 성장했는지 알 수 있다.

  • 챌린지 서비스

    1. 매일 똑같이 러닝만 하는 데 지루함을 느끼는 사용자들에게 새로운 시도를 제공한다.

    2. 사용자는 카카오페이를 통해 마일리지를 충전하고 기부할 금액을 정해 원하는 카테고리의 챌린지에 참여한다.

    3. 챌린지 각각의 목표와 기부 금액을 달성하면 기부가 되는 형식으로, 기부를 하지 않아도 참여가 가능하다.

    4. 비대면 레이스의 형태로 여러 사용자들과 함께 각자의 장소에서 목표를 이루는 것을 통해 색다른 이벤트를 제공한다.

  • 커뮤니티 서비스

    1. 혼자가 아닌 러닝메이트를 만들고 싶을 때, 사용자의 기록과 활동 지역 분석을 통해 다른 러너를 매칭해준다.

    2. 일대일 채팅을 통해 팔로우한 친구와 대화를 하거나 다른 러너 매칭을 원활하게 돕기위해 활용한다.

    3. 지역별 채팅을 통해 사용자의 지역에 속한 지역의 그룹 채팅을 통해 다양한 러너들과 소통하는 서비스를 제공한다.

    4. 랭킹 시스템을 도입하여 러닝에 대한 성취감을 높이고, 유저들의 러닝 동기부여를 한다.

• 향후 계획

  • 알림 기능 : 친구 추가 및 채팅 관련한 알림 기능을 통해 사용자들에게 편리성을 제공.
  • 코칭 서비스 : 러너들에게 효과적인 러닝을 할 수 있도록 코칭할 수 있는 유저를 매칭하는 서비스를 제공.
  • 다양한 챌린지 컨텐츠 : 기부 뿐만 아니라 다양한 카테고리의 챌린지를 만들어 다양하게 챌린지를 할 수 있도록 제공.
  • 기부 단체 협약 : 기부 챌린지를 통해 얻은 기부금 전달을 위해 기부 단체를 찾아 협약을 맺을 계획.

Run With Me ? 🏃

• 시작하기

  • 시작하기에 앞서
  • 설치하기
  • 실행하기
  • 배포하기

• 지원하는 브라우저

• 사용된 도구

• 사용된 기술

• 시스템 아키텍쳐

• 서비스 소개

• 일정

• 저자

• 라이센스

아래 방법을 따르시면 프로젝트를 실행시킬 수 있습니다.

• Windows 10
• JDK 1.8
• Node.js 12.8.1
• MySQL 8.0

1. 깃헙의 레포지토리를 클론합니다.

   $ git clone https://github.com/soohyun0907/RunWithMe.git
   

2. npm을 설치합니다.

   $ npm install
   

Run With Me 서비스를 사용하기 위해서는 다음과 같은 방법으로 실행합니다:

1. 데이터베이스를 설정합니다.

   • RunWithMe_SQL.sql을 참고해서 데이터베이스를 생성합니다. (여기를 눌러 erd를 확인하세요.)

   • application.yml에 데이터베이스 설정을 추가합니다.

     spring:
       datasource:
         driver-class-name: com.mysql.cj.jdbc.Driver
         url : jdbc:mysql://localhost:3306/rwm?characterEncoding=UTF-8&serverTimezone=Asia/Seoul
         username : {데이터베이스 계정 아이디}
         password : {데이터베이스 계정 비밀번호}
     

2. 백엔드 서버를 실행합니다.

   • IDE에 import 후 실행합니다.

     : IntelliJ, STS와 같은 IDE를 사용하는 경우, backend - RunWithMe를 import하여 실행합니다.

   • war파일을 생성 후 실행합니다.

     $ gradlew -DskipTests=true build
     

     $ java -jar [filename].war
     

   • 프론트엔드를 실행합니다.

     $ npm run serve
     

해당 서비스는 AWS EC2를 이용하여 배포하였습니다. 사전에 여기를 참고해서 AWS EC2계정을 생성하세요.

배포를 하기위해서는 다음과 같은 방법으로 실행합니다:

1. AWS EC2 인스턴스 생성

2. Ubuntu 환경에 Git Clone

3. Nginx 환경 설정

   server {
   
           listen 80;
           listen [::]:80;
           server_name k3a303.p.ssafy.io;
           return 301 https://$host$request_uri;
           
   }
   
   server {
   
           listen 443 ssl default_server;
           listen [::]:443 ssl default_server;
          
           root /home/ubuntu/deploy/s03p31a303/frontend/RunWithMe/dist;
   
           # Add index.php to the list if you are using PHP
           index index.html index.htm index.nginx-debian.html;
   
           server_name k3a303.p.ssafy.io;
   
           location / {
                   # First attempt to serve request as file, then
                   # as directory, then fall back to displaying a 404.
                   try_files $uri $uri/ /index.html;
           }
   
           ssl_certificate /etc/letsencrypt/live/k3a303.p.ssafy.io/fullchain.pem;
           ssl_certificate_key /etc/letsencrypt/live/k3a303.p.ssafy.io/privkey.pem;
   
           access_log /var/log/nginx/proxy/access.log;
           error_log /var/log/nginx/proxy/error.log;
           
   }
   

4. JDK 설치 (환경변수 설정)

5. DB 설치 (해당 프로젝트에서 MySQL 사용)

6. gradle wrapper을 위한 버전 설정 (6.0.0 이상)

7. gradle clean build 실행 (war 파일 생성)

8. yarn build (dist 폴더 생성)

• Vue.js 2.6.11
• vue/cli 4.4.6
• yarn 1.22.4
• Spring boot 2.3.1
• Gradle 6.4.1
• IDE: Visual Studio Code 1.48, Spring Tool Suite 3
• GitLab
• Jira
• SonarQube

[ BACK END ]

• Spring Boot : Run WIth Me Project의 전반적인 Rest Controller 구현.
• Spring Security : WebSecurityConfigurerAdapter를 상속받아 Filter를 적용, 사용자 권한에 맞는 기능을 수행하도록 구현.
• JWT : JSON Web Token을 활용하여 회원 인증 및 안정성있는 정보 교환을 할 수 있도록 활용.
• JPA (Hibernate) : ORM인 Hibernate를 활용하여 객체 중심의 개발을 할 수 있도록 하였고, SQL을 직접 작성하지 않고 Entity 필드가 되는 객체를 통해 DB를 동작시켜 유지보수에 용이하게 활용.
  • 동일한 쿼리에 대한 캐시 기능을 사용하기 때문에 높은 효율성 기대
• SSL 프로토콜 : SSL을 적용하여 전송되는 패킷값을 암호화하여 외부의 공격자로부터 데이터를 보안하기 위해 사용.
  • Let’s Encrypt 무료 인증서를 발급받아 웹서버에 SSL 인증서를 적용.
  • Google Map API 활용 시, SSL 적용 필수.
• MySql : RDBMS로 Run With Me Project의 사용자, 러닝 기록, 챌린지, 게시판 등 필요한 데이터를 저장.
• Redis : 비관계형 데이터베이스로 'Key-Value' 구조 데이터 관리 시스템이며, 데이터를 메모리에 저장하여 빠른 처리속도가 필요한 기능에 적용.
  • 채팅 서버의 채팅방, 메세지 처리를 위해 사용. (Subscribe / Publish)
  • 만료일을 저장하면 만료 시 자동으로 데이터가 사라지는 특성을 활용하여 로그아웃된 토큰을 저장하여 블랙리스트로 활용.
• AWS
  • EC2 서비스를 이용하여 Ubuntu 서버를 구축 (호스팅).
  • S3 서비스를 이용하여 프로필 및 러닝 기록 (Polyline)을 저장하기 위해 사용.
• Nginx : 웹 서버를 구축
• WebSocket : 웹 상에서 쉽게 소켓 통신을 하게 해주는 라이브러리를 활용하여 러닝 메이트 매칭, 지역별 그룹 채팅 기능을 구현.
• STOMP : Http에 모델링된 frame 기반의 메세징 프로토콜을 통해 메세지 전송을 좀 더 효율적으로 하기 위해 활용.
  • STOMP Handler를 구현하여 Subscribe를 통해 통신하고자 하는 주체(Topic)를 판단하여 실시간, 지속적으로 감시하고 해당 요청이 들어오면 처리하도록 구현. (Broker 역할 수행)

[ FRONT END ]

• Vue
  • Swal (Sweet Alert) - 다양한 기능과 디자인을 가진 Alert창을 구현.
  • SplideSlide - Page를 Swap할때마다 변경되는 페이지.
  • carousal - Main Page에서 다양한 이벤트를 보기 편하게 하기 위해 3D Slide형식으로 넘어가는 컴포넌트 구현.
  • apexChart - 런닝 데이터 분석을 위해 사용하는 분석차트.
  • decode-google-map-polyline - String으로 인코딩했던 polyline을 맵에 다시 표시하기 위해 사용.
  • vue-good-table - 친구 목록이나 다양한 목록을 표현할때 사용되는 검색과 정렬기능, 페이지 기능을 사용.
  • vue-moment - 시간을 DB에 저장하기위해 포맷 형식을 변경 및 DB에서 가져올 때 출력 형식 변경.
  • web-stomp - 채팅기능을 위한 웹 소켓 프로그래밍, 실시간으로 채팅을 할때 사용.
• Google Static Map : 실시간 위치정보를 맵에 Polyline화해서 지도이미지를 DB에 저장.
• Google Map : 지도에 지속적으로 위치를 기록 및 추적하기 위해 사용.
• Kakao Pay : Kakao에서 제공하는 KakaoPay기능을 이용해 모바일로 결제가 가능. 기부 챌린지 참가를 위해 원하는 금액만큼 미리 충전하여 사용.
• Vuex : 여러 페이지에서 공용으로 사용하는 데이터와 함수들을 저장해서 한번에 관리, 추가적으로 JWT토큰을 스토어에 저장하여 Backend와 통신시마다 주고받으며, 2시간이 지나면 토큰이 만료되어 서비스 이용 불가.
• vue apaxcharts : 러닝 데이터를 효과적으로 시각화할 수 있도록 활용.
  • axios 통신.
  • 시각화 자료 이미지 파일로 변환 및 저장.
  • 활용 사례
    • running plant
      • 월별 사용자 러닝 거리 기록.
      • 거리 기록에 따라 상대적인 색 표현.
      • 업데이트를 통한 실시간 기록 분석 가능.
    • running analysis
      • 지난 측정 기록 vuex 저장 및 시각화.
      • 업데이트 기록과 비교.
      • 사용자와 같은 티어의 사용자와 비교 분석.

[ TEAM Cooperation ]

• GitLab : GitLab을 활용하여 프로젝트를 관리.
  • Git Flow 에 따른 브랜치 전략 수립.
  • MR 시 코드 리뷰 진행.
• Jira : 이슈 관리 도구로 활용.
  • 주요 기능들을 이슈로 등록하고 Story Point를 산정한 후, 담당자를 지정하여 프로젝트를 진행.
  • 1~2 주 정도 상황에 맞게 스프린트를 설정.
• Google Drive : 협업을 위한 공용 문서 및 산출물들을 공유할 수 있도록 활용.
  • 동시 문서 작성 (Google Docs).
  • 대용량 파일 첨부

• [메인 화면] : 상단에는 현재 진행중인 챌린지, 중앙에는 랭킹, 하단에는 팔로우한 유저의 최신 러닝 기록을 보여준다.

• [메인 화면에서 랭커 클릭 시] : 선택한 유저의 간단한 프로필, 팔로우 여부, 러닝 기록을 보여준다.
• [랭커 프로필에서 러닝 피드 클릭 시] : 유저의 해당 러닝 상세 기록을 보여준다.

• [메인 화면에서 팔로워 피드 클릭 시] : 팔로우한 유저의 러닝 상세 기록을 보여준다.

• [러닝 페이지에서 시작 버튼 클릭 시] : 러닝 기록을 시작한다.
• [러닝 페이지에서 정지 버튼 클릭 시] : 러닝을 끝내고 기록을 저장한다.
• [러닝 페이지에서 페이지 스왑 시] : 현재 러닝의 중간 기록을 1km 단위로 확인한다.

• [러닝 결과] : 현재 러닝의 부분 기록 및 전체 기록을 확인한다.

• [러닝 기록] : Github의 contributions을 표현하는 잔디 포멧을 가져와 개발자 감성을 살려 한달 단위로 하루에 뛴 거리를 보여주며, 이미지로 저장할 수 있다.
• [러닝 분석 그래프] : 이전 기록, 최근 기록과 유저들의 평균 기록을 보여주며, 이미지로 저장할 수 있다.

• [주변 러너 추천] : 같은 동네의 주변 러너들을 추천해주고, 클릭 시 유저의 프로필과 기록을 보여준다.

• [일대일 채팅] : 팔로우한 유저의 온라인 접속 상태가 보이며 온라인인 유저와 실시간으로 채팅한다.

• [일대일 채팅 밑 매칭 클릭 시] : 일대일 채팅의 온라인 및 오프라인 유저의 목록 하단 매칭 버튼 클릭 시 경험치에 따른 유저를 매칭해준다.
• [매칭 시스템] : 성별을 선택 후 원하는 러너를 선택해 팔로우한 다음 일대일 채팅을 시작한다.

• [지역 채팅] : 원하는 지역을 선택 시 해당 지역에서 여러 유저와 실시간으로 채팅한다.

• [챌린지 페이지] : 상단의 보유 마일리지가 표시되고, 현재 진행중, 진행 예정, 종료된 챌린지를 확인한다.

• [챌린지 클릭 시] : 챌린지 클릭 시 해당 챌린지의 상세 정보를 확인하고, 신청 버튼을 통해 챌린지에 참여한다.
• [챌린지 신청 버튼 클릭 시] : 챌린지 신청 버튼 클릭 시 챌린지 참여 페이지로 넘어가며, 기부 금액을 설정해 참여한다. 이 때, 기부 금액은 0원을 설정해도 참여가 가능하며, 해당 금액은 미리 충전된 마일리지에서 차감된다.
• [충전하기 버튼 클릭 시] : 충전하기 버튼을 클릭 시, [마이페이지]-[마일리지 충전] 탭으로 전환되며 카카오페이를 통해 충전이 가능하다.

• [챌린지 제안] : 유저가 관리자에게 챌린지를 제안한다.

• [챌린지 관리 페이지] : 챌린지 관리 페이지는 관리자 등급만 확인 가능하며, 챌린지 생성, 삭제, 수정이 가능하다.

• [러닝 기록 조회] : 본인의 모든 러닝 기록을 조회한다. 하단에서 러닝 기록을 클릭 시, 지도에 러닝 경로가 표시된다.
• [활동 지역 러닝 기록 조회] : 본인이 설정한 활동 지역 러닝 기록을 조회한다. 하단에서 러닝 기록을 클릭 시, 지도에 러닝 경로가 표시된다.
• [러닝 기록 클릭 시] : 러닝 상세 페이지로 이동한다.

• [팔로우 목록 조회] : 팔로워의 간단한 정보와, 말풍선 아이콘을 클릭 시 일대일 채팅으로 이동하며, 엑스 아이콘을 클릭 시 팔로우를 취소한다.

• [유저 정보 수정] : 유저 정보를 수정하거나 탈퇴한다.
• [유저 프로필 수정] : 유저 프로필을 수정한다.

• 김대용 - Daeyong Kim - [email protected] - @imdaeyong [Front]
• 김순빈 - Soonbeen Kim - [email protected] - @soo-ni [Back / PM]
• 김형택 - Hyungtaik Kim - [email protected] - @hyungtaik [Back]
• 이선수 - Sunsoo Lee - [email protected] - @LEESUNSOO [Back]
• 전수현 - Soohyun Jeon - [email protected] - @soohyun0907 [Front]

Copyright (c) 2015 Juns Alen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.