데브코스 커뮤니티 플랫폼 'Devnity' 백엔드

🔗 프로젝트 관련 링크

배포 사이트 링크 (서버중단) : https://devnity.xyz

• 개발서버 API 문서 (RestDocs)
• 배포서버 API 문서 (RestDocs)
• 프로젝트 Wiki
• 프로젝트 노션
• 프론트엔드 Repo

🙉 팀 소개

Jerry	Hanjo	Mark	Dave
알고리즘맨	데브옵스맨	객체지향맨	리뷰어

백엔드는 이렇게 협업해요!

---

브랜치 전략

• Git Flow 전략을 사용합니다.
• 기존 Git Flow 전략을 간소화해 4가지 브랜치를 사용합니다.
• main : 최종 배포 서버 브랜치
• develop : 개발 서버 브랜치
• feature : 기능 구현 브랜치
• hotfix : 핫픽스 브랜치
• 1Task == 1Issue == 1PR 규칙을 따랐습니다.

즉각 코드리뷰 및 피드백 반영

• 저희는 코드 품질과 컨벤션 통일을 위해 지속적인 코드리뷰를 지향하였습니다.
• PR이 생성되면 누군가 한명이 코드리뷰를 작성해야만 merge가 승인됩니다.

초단기 스프린트

• 2주간 총 4번의 초단기 스프린트를 진행했습니다. (3~4일 간격)
• 스프린트 시작 전 작업할 태스크를 모두 Issue로 등록한 후, Milestone을 설정하여 진행 목표를 정했습니다. (참고)
• 스프린트 기간엔 Github의 Project 칸반보드를 활용하여 개인 태스크 진행현황을 공유하였습니다. (참고)
• 스프린트가 종료되면 간단 회고록을 작성하였습니다. (참고)

---

💻 프로젝트 소개

Devnity는 프로그래머스 데브코스 수강생을 위한 커뮤니티 플랫폼입니다.

데브코스 1기 백엔드와 프론트엔드 수강생들간 소통의 불편함을 해소하고자 만들어졌습니다.

데브코스 과정 초반에 활용될 자기소개를 적는 기능과, 각 수강생의 위치를 파악할 수 있는 기능을 제공합니다.

또한 맵 API를 활용한 모각코 모집, 스터디나 동아리, 토이프로젝트를 모집할 수 있는 기능을 제공합니다.

🔎 기능 소개

항목을 클릭하여 자세히 볼 수 있습니다.

관리자

초대 링크 생성

• 데브코스 수강생만이 회원가입이 가능해야 하므로, 관리자는 초대링크를 생성합니다.
• 각 초대링크는 유일하며 만료 기간을 설정할 수 있습니다.
• 만료된 초대링크는 스케줄러를 통해 DB에서 자동 삭제됩니다.

회원가입 & 로그인

회원가입

• 전달받은 초대링크를 통해 유효성 검증 후 회원가입을 진행합니다.
• 초대링크에 따라 코스, 기수, 역할은 미리 정해져 있습니다.

로그인

• 이메일과 비밀번호를 입력해 로그인합니다.
• 인증방식은 JWT 방식을 사용합니다.

메인페이지 & 마이페이지

메인페이지

• 메인페이지에서는 각 서비스의 요약 정보를 확인할 수 있습니다.

마이페이지 - 프로필 설정

• 자신에 대한 정보와 자기소개를 작성합니다.
• 마크다운을 지원하며, 이미지 파일을 업로드할 수 있습니다.
• 자신의 위치 정보를 저장할 수 있습니다.

마이페이지 - 내 모임 관리

• 내가 신청한 모임과 등록한 모임을 모아볼 수 있습니다.

데둥이 소개

검색 및 필터링

• 사용자의 이름을 검색할 수 있습니다.
• 코스, 기수, 역할별 필터링이 가능합니다.
• 무한스크롤을 지원하며, 커서 페이징이 사용됩니다.

조회

• 특정 사용자에게 좋아요를 누를 수 있습니다.
• 댓글 및 대댓글을 작성, 수정, 삭제할 수 있습니다.

데둥여지도

조회 및 필터링

• 다른 사용자가 등록한 위치를 확인할 수 있습니다.
• 코스, 기수별 필터링이 가능합니다.

모집 게시판

검색 및 필터링

• 게시글 제목으로 검색이 가능합니다.
• 총 세가지(스터디, 동아리, 프로젝트) 카테고리가 존재하며, 각 카테고리별로 게시글을 조회할 수 있습니다.
• 모집중인 게시글이 최상단에 위치합니다.
• 무한스크롤을 지원하며, 커서 페이징이 사용됩니다.

모집 등록

• 카테고리를 선택하여 모집 게시글을 등록할 수 있습니다.
• 등록시 Slack으로 모집 홍보 알람이 전송됩니다.
• 마감날짜가 지난 모집은 자동으로 마감처리됩니다.

상세조회 및 신청

• 모집중인 상태의 게시글에 신청,취소할 수 있습니다.
• 인원이 가득 차거나, 등록자가 마감하는 경우 신청할 수 없습니다.
• 댓글 및 대댓글을 작성, 수정, 삭제할 수 있습니다.

맵각코

검색 및 필터링

• 특정 주소를 검색할 수 있습니다.
• 우측 상단 버튼을 눌러 나의 위치로 화면을 전환할 수 있습니다.
• 다른 사용자의 위치 노출을 선택할 수 있습니다.
• 진행중인 맵각코 노출을 선택할 수 있습니다.
• 직접 구현한 좌표 알고리즘을 통해 사용자의 화면 범위에 포함된 데이터만 요청됩니다.

등록

• 위치를 선정하고 맵각코를 등록합니다.
• 마감날짜가 지난 맵각코은 자동으로 마감처리됩니다.

상세조회 및 신청

• 해당 맵각코 정보를 확인할 수 있습니다.
• 해당 맵각코에 신청,취소가 가능합니다.
• 인원이 가득차거나, 등록자가 마감한 경우 신청할 수 없습니다.

📜 기술스택

Spring

• Java 11
• Gradle 7.2
• Spring Boot 2.6.0
• Spring Data JPA, QueryDSL
• Spring Security, jwt
• JUnti5, RestDocs, JACOCO

Database

• H2
• MySQL 5.7

DevOps

• AWS - EC2 / RDS / S3 / CloudFront
• Github Actions
• Nginx
• Docker, docker-compose
• Slack, Codecov

⚙ 아키텍처

• JACOCO + Codecov를 사용해 PR을 생성할 때마다 테스트 커버리지를 측정합니다.
• 개발서버와 배포서버를 분리하여 최종 배포 전 기능 검증과 locust를 통해 부하테스트를 진행합니다.
• 협업시 개발서버에서는 반드시 RestDocs를 작성하여 프론트엔드에게 검증된 API 명세를 제공합니다.
• nginx와 docker-compose를 사용한 blue-green 방식으로 무중단 배포를 지원합니다.
• CloudFront를 사용해 정적 리소스 제공시 캐싱과 HTTP/2를 지원합니다.

📁 ERD