Team3_BE

번개 지향 볼링 모집 커뮤니티 "번개볼링"의 백엔드 서버입니다.

카카오 테크 캠퍼스 1기 부산대 3조 프로젝트입니다.

Collaborators

Backend

조장	테크 리더	기획 리더	리액셔너
박소현	안혜준	김기해	김윤재

Frontend

리마인더	타임 키퍼
강주호	허동혁

Introduction

기존의 볼링 관련 서비스들에서는 볼링 한판을 치기 위해서 동호회, 소모임에 가입을 해야하는 번거로운 과정이 필요합니다. 소모임, 밴드 앱 또한 일회성의 가벼운 만남이 아닌 주기적으로 참여를 할 회원을 모집하는 경우가 많습니다.

저희 번개 볼링은 기존과 차별화된 번개모임, 즉, 빠른 매칭을 목표로 하고 있습니다.

기획

5Whys

1Pager 기획

Figma

둘러보기

api문서

깃헙 레포지토리

FrontEnd Repository
BackEnd Repository

System Structure

전체 구성도

백엔드 구성도

카테캠 수료 이후, 카카오 크램폴린이 더이상 지원 되지 않습니다.
현시점에서는 구성도와 다르게 단순히 AWS EC2 상에서 직접 구동 중입니다.

ERD(ER - Diagram) - ERD 협업 링크

테이블 정보 자세히 보기

참여신청 테이블(applicant_tb)

승인 상태가 false 인 경우 프론트에서 수락 / 거절 처리합니다.
거절 시 참여 신청 테이블에서 delete 됩니다.
수락 시 status가 true가 되면서 수락 / 거절 처리됩니다.
게시글이 모집완료되면 평가하기 활성화됨 status가 True인 사람들은 게시글에 달려있는 status True인 사람들을 서로 평가할 수 있습니다.

모집글 테이블(comment_tb)

마감 계산은 아래와 같습니다.
마감 = is_close || (now due_time)

댓글 테이블(comment_tb)

일반 댓글의 경우 부모 댓글id가 NULL입니다.
대댓글 일 시 부모 댓글id가 존재합니다.
게시글에 달린 댓글을 전체 조회해서 부모 id에 맞게 조합하여 계층형으로 전달 가능합니다.
댓글 데이터 삭제 시, delete하지 않고 작성자 id와 내용만 null 처리합니다.
(부모id를 참조해야하므로 row를 삭제해서는 안됩니다.)

Tech Stack

How to Start

프로젝트를 클론합니다.

$ git clone https://github.com/Step3-kakao-tech-campus/Team3_BE.git

Temp3_BE/.env.example 파일을 .env로 복사하고 내용을 자신의 환경에 맞게 설정해줍니다.

$ cd Team3_BE                        # 디렉토리 이동
$ cp .env.example .env               # 파일 복사
$ vi .env                            # .env 수정
파일 수정 및 저장 진행하기

.env 파일은 환경변수를 설정하는 파일입니다.

TOKEN_SECRET="example"                     # 로그인시 사용되는 토큰의 시크릿 키를 설정
DOMAIN="http://localhost:3000"             # 배포될 도메인을 설정
API_SERVER_URL="http://localhost:8080"     # 서버URL 설정
GMAIL_USERNAME="[email protected]"         # 메일인증 등 메일발신에 사용될 GMAIL설정
GMAIL_APPLICATION_PASSWORD="example"       # 메일인증 등 메일발신에 사용될 GMAIL설정
AWS_ACCESS_KEY="example"                   # AWS S3에 접근하기 위한 키 설정
AWS_SECRET_KEY="example+9Vkr3fRwA"         # AWS S3에 접근하기 위한 키 설정
MYSQL_USERNAME="example"                   # 데이터 베이스 연결 설정
MYSQL_PASSWORD="example"                   # 데이터 베이스 연결 설정
GOOGLE_MAP_API_KEY="example"               # 구글맵 API 키 설정
SSL_KEY_PASSWORD="example"                 # SSL 키 설정
FLASK_MAIL_SERVER="http://localhost:5000"  # 구동 시킨 Flask SMTP 서버의 주소

local profile을 사용할 시, SSL과 MySQL, Flask 설정이 불필요합니다.

.env 환경변수를 등록합니다. (본 가이드에선 우분투 환경으로 진행합니다.)
```
$ set -a
$ source .env
$ set +a
```

.mysql_env.example을 복사하여 .mysql_env로 복사하고 내용을 자신의 환경에 맞게 설정해줍니다.

$ cp .mysql_env.example .mysql_env           # 파일 복사
$ vi .mysql_env                              # .mysql_env 수정

docker-compose.yml 파일을 이용해 Redis 및 MySQL 도커 컨테이너를 실행합니다.(도커가 설치되어 있다고 가정합니다.)
```
$ docker-compose up -d
```

java파일을 빌드, 실행합니다.

$ ./gradlew clean build
$ java -jar build/libs/server-0.0.1.jar

실제 배포를 위한 product 환경일 시, spring.profiles.active 설정을 추가하여 실행합니다.
```
$ ./gradlew clean build
$ java -jar -Dspring.profiles.active=product build/libs/server-0.0.1.jar
```

Flask SMTP 서버 실행

spring boot의 deploy profile을 사용하는 경우만 Flask SMTP 서버 실행이 필요합니다.

카카오 크램폴린 상의 배포에서 SMTP가 지원되지 않습니다. 따라서 별개의 네이버 클라우드 상에서 SMTP 서버를 구축하였습니다.

그 외의 profile은 spring boot 내에서 자체적으로 SMTP를 사용하여 메일을 전송합니다.

프로젝트를 클론합니다.

$ git clone https://github.com/Step3-kakao-tech-campus/Team3_BE.git

폴더를 이동합니다.
```
$ cd Team3_BE/flask
```
Flask SMTP 서버를 실행합니다.
```
$ ./start.sh
```
배포된 주소를 .env의 FLASK_MAIL_SERVER에 넣습니다.

FEATURES

개발한 API들의 핵심 특성을 서술합니다.

각 api들의 상세한 명세는 Swagger 문서를 확인 부탁드립니다.

인증

JWT를 이용하였습니다.

ACCESS TOKEN과 REFRESH TOKEN을 구현하였으며 REFRESH TOKEN은 REDIS에 저장됩니다.
RTR(refresh token rotation) 전략으로 리프레시를 일회용으로 사용하였습니다.
ACCESS 토큰은 AUTHORIZATION 헤더로 BEARER 토큰으로 전달합니다.
REFRESH 토큰은 HTTP-ONLY 쿠키로 전달하여 클라이언트의 접근을 막아 보안성을 강화하였습니다.
회원가입 시, 유저 권한을 바로 부여하지 않고 이메일인증을 필요하게 하여 보안성, 안정성을 강화하였습니다.

회원가입을 하지 않은 유저는 아래의 기능만 사용이 가능합니다.(주로 조회만 가능)

- 행정구역 관련 기능
- 모집글 조회
- 댓글 조회
- 사용자 조회 (유저 기록 조회, 참여 기록 조회, 점수 조회)

회원가입을 한 유저는 아래의 기능을 추가로 사용할 수 있습니다.

- 자신의 회원정보 조회 및 수정
- 쪽지 조회

회원 가입 후 이메일인증을 받은 유저는 아래의 기능을 포함하여 모든 기능을 사용할 수 있습니다.

- 모집글 관련 모든 기능
- 신청 관련 모든 기능
- 댓글 관련 모든 기능
- 쪽지 관련 모든 기능
- 별점 등록, 점수 등록 기능

메일 전송

현재 SMTP 서버는 분리되어, Naver Cloud 상에서 배포 중입니다.

Flask 사용 이유

크램폴린 환경에서는 카카오 정책으로 인해 HTTP 통신만 가능하다는 프로토콜 통신 제한이 있어, 외부에 SMTP 서버를 구축하여 SMTP 이메일 전송을 구현하기로 하였습니다. POST 요청에 의한 이메일 발송만 구현하면 되었기에 간결하면서도 필요한 기능을 구현할 수 있는 도구를 선택하려고 하였고, 이에 간결하게 사용할 수 있는 웹 Framework인 Flask로 메일 전송 요청에 따른 메일 전송 기능을 구현하게 되었습니다.

SMTP 서버 구조 설명

크램폴린 환경에서만 Naver Cloud 환경에서의 flask 서버를 활용합니다.

HTTP POST 요청 생성하기

SpringBoot 상에서 Flask로 보내게 될 HTTP 요청에 대한 request를 생성하기 위해 MultiValueMap을 이용하여 request body를 생성합니다.
HTTP Header와 requestURL을 설정하고, Proxy 설정이 된 RestTemplate을 이용하여 HTTP 통신을 통해 Flask 서버로 POST 요청을 전송합니다.

SMTP 요청 생성하기

HTTP POST 요청이 들어오면, Flask 서버는 SMTP 서버로 보내게 될 SMTP 요청을 생성합니다.
request body에서 필요한 정보를 추출하고, SMTP 요청을 생성합니다. 이때, SMTP의 text 부분에 들어갈 내용이 html이므로, MIME Type을 text/html으로 설정해야 요청이 정상적으로 보내집니다.
SMTP 권한 설정한 후, 발신자와 수신자 그리고 text를 설정하여 SMTP 서버로 요청을 보냅니다.
요청이 성공적으로 전송되면 200을 반환합니다.

행정 구역

정부의 행정구역 데이터를 db에 미리 작성해두어 행정구역 데이터를 직접 관리하도록 구현하였습니다.

행정표준코드관리 시스템 - 법정동코드 목록 조회 데이터 파일을 이용하여 sql 데이터를 생성하였습니다.

모집글

볼링 번개 모임을 모집하려는 사람이 작성하는 포스팅입니다.

모집글을 등록하면, 타 유저들이 해당 모집글에 신청을 할 수 있고, 모임을 결성할 수 있습니다.
참가희망자들은 참가신청 기능을 이용하여 참가신청을 할 수 있고, 모집글 게시자가 참가수락 여부를 결정할 수 있습니다.
댓글 기능이 있어 정보 교환 및 소통이 가능합니다.
이후 모집글을 베이스로 참여기록, 별점, 점수등록 등이 이루어 지기 때문에모임 확정 이후에는 모집글 내용을 수정하거나 삭제할 수 없습니다.

JPA Specification

모집글 데이터가 필요한 API를 구현하는 도중, 복잡한 조건처리가 필요한 로직이 있어 동적 쿼리가 필요했습니다. queryDSL을 학습하여 도입하기에는 프로젝트 기간이 한정적이라 비교적 사용이 쉬운 JPA Specification을 사용하였습니다.

참여기록 데이터에 적용된 JPA Specification의 일부 로직입니다.

private List<Post> loadPosts(CursorRequest cursorRequest, Long userId, String condition, String status, Long cityId, String start, String end) {
    int size = cursorRequest.hasSize() ? cursorRequest.size() : DEFAULT_SIZE;
    Pageable pageable = PageRequest.of(0, size, Sort.by(Sort.Order.desc("id")));

    Specification<Post> spec = Specification.where(conditionEqual(condition, userId))
            .and(statusEqual(status))
            .and(cityIdEqual(cityId))
            .and(createdAtBetween(start, end));

    if (cursorRequest.hasKey()) {
        spec = spec.and(postIdLessThan(cursorRequest.key()));
    }
    return postRepository.findAll(spec, pageable).getContent();
}

해당 부분에서 동적쿼리를 사용하지 않으면 30개가 넘는 조건을 처리해야 했기 때문에 JPA Specification을 도입하게 되었습니다.

조회는 비회원도 가능하지만 작성은 회원만 가능합니다.
커서 기반 페이징을 하였습니다.
삭제된 댓글에 대댓글이 있는 경우 대댓글 표시를 위해 전달이 됩니다.
- 삭제된 댓글이 표시될 경우 아래와 같이 표시됩니다.
  - content: "삭제된 댓글입니다"
  - userId: null
그외, 대댓글이 없는 삭제된 댓글과 대댓글이 삭제된 경우의 댓글은 responseBody에 포함되지 않습니다.

삭제된 댓글들로 인한 통일되지 않은 응답 개수 문제가 존재합니다.

이는 프론트의 구현이 무한 스크롤로 이루어 지기 때문에 적은 개수가 응답되어도 자동으로 다음 key로 요청이 일어나 사용자 경험에 큰 영향을 주지 않을 것으로 판단되어 이렇게 구현하였습니다.

신청, 별점

모집글 작성자 이외의 유저들은 모집글에 참여 신청을 할 수 있습니다.

작성자는 신청을 수락하거나 거부할 수 있습니다.
작성자는 신청자 목록, 신청수락완료 유저을 확인할 수 있습니다.
모임 시간 이후 사용자들은 별점 등록 API를 통해 참여자들에게 별점을 줄 수 있습니다.
별점은 사용자의 평점에 영향을 줍니다.

볼링 점수(스코어)

모임 이후, 해당 모임에 대해 점수를 등록할 수 있습니다.

점수와 함께 이미지를 등록 할 수 있어 점수에 대한 증명이 가능합니다.
모임 별 점수 등록은 여러개가 가능합니다.

이미지 등록

외부 저장소 - AWS S3를 사용하였습니다.

white listing 방식으로 확장자 검사가 이루어 집니다.
업로드 가능한 확장자는 png, jpg, jpeg, gif 4가지입니다.
이미지의 사이즈는 10MB로 제한하였습니다.

프로필, 정보

닉네임, 이메일, 지역 정보, 매너 점수, 볼링 Avergae 점수 등을 사용자 정보로 관리합니다.

타인의 프로필 조회 시 얻을 수 있는 정보
- 닉네임
- 매칭기록에 기반한 볼링 Average점수
- 매너 점수
- 지역
- 프로필 사진
자신의 프로필 조회 시 추가로 얻을 수 있는 정보
- id(PK)
- 이메일
- 메일인증여부

쪽지

다른 사용자와 1대1 대화를 할 수 있습니다.

카카오톡과 같은 채팅 서비스와 비슷한 사용자경험을 주기 위해 채팅 서비스와 유사하게 구현하였습니다.
웹소켓을 이용한 채팅 기능으로의 변경을 염두에 두고 구현하였습니다.

Name		Name	Last commit message	Last commit date
Latest commit History 592 Commits
.github		.github
docs		docs
flask		flask
gradle/wrapper		gradle/wrapper
k8s		k8s
src		src
.env.example		.env.example
.gitignore		.gitignore
.mysql_env.example		.mysql_env.example
Dockerfile		Dockerfile
README.md		README.md
build.gradle		build.gradle
docker-compose-redis.yml		docker-compose-redis.yml
docker-compose.yml		docker-compose.yml
gradlew		gradlew
gradlew.bat		gradlew.bat
nohup.sh		nohup.sh
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Team3_BE

Collaborators

Backend

Frontend

Introduction

기획

5Whys

1Pager 기획

Figma

둘러보기

깃헙 레포지토리

System Structure

전체 구성도

백엔드 구성도

ERD(ER - Diagram) - ERD 협업 링크

Tech Stack

How to Start

Flask SMTP 서버 실행

FEATURES

인증

메일 전송

Flask 사용 이유

SMTP 서버 구조 설명

행정 구역

모집글

JPA Specification

댓글

신청, 별점

볼링 점수(스코어)

이미지 등록

프로필, 정보

쪽지

About

Releases

Contributors 6

Languages

Step3-kakao-tech-campus/Team3_BE

Folders and files

Latest commit

History

Repository files navigation

Team3_BE

Collaborators

Backend

Frontend

Introduction

기획

5Whys

1Pager 기획

Figma

둘러보기

깃헙 레포지토리

System Structure

전체 구성도

백엔드 구성도

ERD(ER - Diagram) - ERD 협업 링크

Tech Stack

How to Start

Flask SMTP 서버 실행

FEATURES

인증

메일 전송

Flask 사용 이유

SMTP 서버 구조 설명

행정 구역

모집글

JPA Specification

댓글

신청, 별점

볼링 점수(스코어)

이미지 등록

프로필, 정보

쪽지

About

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors 6

Languages