📖 Summary

photique 프로젝트의 서버입니다. Java + SpringBoot 기반으로 작성되었으며, REST API 부터 실시간 양방향 통신, 캐싱 등 다양한 기술이 적용되었습니다.

🛠️ Tech Stack

Backend

Database

Monitoring

CI/CD

Etc.

📑 API

각 도메인 별로 REST API 가 있으며, 웹소켓과 SSE 연결 엔드포인트를 포함하여 총 52개의 API가 존재합니다. 아래 노션 링크를 통해서 API 상세 스펙을 확인할 수 있습니다.

인증

API 기능	METHOD	URL
로그인	POST	/api/v1/auth/login
로그아웃	POST	/api/v1/auth/logout
인증 메일 발송 - 회원가입	POST	/api/v1/auth/mail/join
인증 메일 발송 - 비번찾기	POST	/api/v1/auth/mail/password
인증 메일 요청	POST	/api/v1/auth/code
내 아이디 조회	GET	/api/v1/auth/me

유저

API 기능	METHOD	URL
닉네임 중복검사	GET	/api/v1/users/nickname
비밀번호 찾기	PATCH	/api/v1/users/password
회원가입	POST	/api/v1/users
회원정보 조회	GET	/api/v1/users/{userId}
회원정보 수정	PATCH	/api/v1/users/{userId}
회원탈퇴	DELETE	/api/v1/users/{userId}
유저 검색	GET	/api/v1/users
팔로우 요청	POST	/api/v1/users/{userId}/follows
언팔 요청	DELETE	/api/v1/users/{userId}/follows
팔로워 리스트 조회	GET	/api/v1/users/{userId}/follower
팔로잉 리스트 조회	GET	/api/v1/users/{userId}/following

단일작품

API 기능	METHOD	URL
단일작품 생성	POST	/api/v1/singleworks
단일작품 조회	GET	/api/v1/singleworks/{singleworkId}
단일작품 수정	PATCH	/api/v1/singleworks/{singleworkId}
단일작품 삭제	DELETE	/api/v1/singleworks/{singleworkId}
단일작품 검색	GET	/api/v1/singleworks
단일작품 좋아요 추가	POST	/api/v1/singleworks/{singleworkId}/like
단일작품 좋아요 삭제	DELETE	/api/v1/singleworks/{singleworkId}/like
단일작품 댓글 생성	POST	/api/v1/singleworks/{singleworkId}/comments
단일작품 댓글 리스트 조회	GET	/api/v1/singleworks/{singleworkId}/comments
단일작품 댓글 수정	PATCH	/api/v1/singleworks/{singleworkId}/comments/{commentId}
단일작품 댓글 삭제	DELETE	/api/v1/singleworks/{singleworkId}/comments/{commentId}
좋아요한 단일작품 조회	GET	/api/v1/singleworks/like
내 단일작품 조회	GET	/api/v1/singleworks/me

전시회

API 기능	METHOD	URL
전시회 생성	POST	/api/v1/exhibitions
전시회 조회	GET	/api/v1/exhibitions/{exhibitionId}
전시회 삭제	DELETE	/api/v1/exhibitions/{exhibitionId}
전시회 검색	GET	/api/v1/exhibitions
전시회 좋아요 추가	POST	/api/v1/exhibitions/{exhibitionId}/like
전시회 좋아요 삭제	DELETE	/api/v1/exhibitions/{exhibitionId}/like
전시회 북마크 추가	POST	/api/v1/exhibitions/{exhibitionId}/bookmark
전시회 북마크 삭제	DELETE	/api/v1/exhibitions/{exhibitionId}/bookmark
전시회 감상평 생성	POST	/api/v1/exhibitions/{exhibitionId}/comments
전시회 감상평 리스트 조회	GET	/api/v1/exhibitions/{exhibitionId}/comments
전시회 감상평 수정	PATCH	/api/v1/exhibitions/{exhibitionId}/comments/{commentId}
전시회 감상평 삭제	DELETE	/api/v1/exhibitions/{exhibitionId}/comments/{commentId}
북마크한 전시회 조회	GET	/api/v1/exhibitions/bookmark
좋아요한 전시회 조회	GET	/api/v1/exhibitions/like
내 전시회 조회	GET	/api/v1/exhibitions/me

전시회 채팅

API 기능	METHOD	URL
채팅 서버 연결	GET	/api/v1/chats/connection

알림

API 기능	METHOD	URL
알림 서비스 연결	GET	/api/v1/users/{userId}/notifications/subscribe
알림 리스트 조회	GET	/api/v1/users/{userId}/notifications
알림 읽음 처리	PATCH	/api/v1/users/{userId}/notifications/{notificationId}
알림 전체 읽음 처리	PATCH	/api/v1/users/{userId}/notifications
알림 삭제	DELETE	/api/v1/users/{userId}/notifications/{notificationId}
읽지 않은 알림 카운팅	GET	/api/v1/users/{userId}/notifications/unread

🚀 CI/CD Pipeline

개발 서버 배포 파이프라인 - AWS EC2 free tier

1. 로컬에서 변경사항 commit
2. main 브랜치로 push
3. main -> develop 브랜치로 pr 보냄으로써 개발 서버 배포 워크 플로우 실행
4. 정상 배포되면 merge

프로덕트 서버 배포 파이프라인 - GCP VM

1. 로컬에서 변경사항 commit
2. main 브랜치로 push
3. main -> release 브랜치로 pr 보냄으로써 개발 서버 배포 워크 플로우 실행
4. 정상 배포되면 merge

💥 Tech Selection & Trouble Shooting

타이틀	주요 내용	문서 링크
🔐 스프링 인증인가 도입기	인증-인가 적용 방식 결정	자세히 보기
🚀 개발 서버 배포 파이프라인 구축기	개발 서버 초기 세팅 및 무중단 배포 적용	자세히 보기
👁️ 모니터링 시스템 구축기	그라파나를 활용한 로그, 시스템 메트릭 시각화	자세히 보기
🍽️ 설정파일 관리 전환기	깃허브 서브모듈 기반의 설정파일 관리	자세히 보기
🔍 검색 기능 도입기	Elasticsearch 도입	자세히 보기
👥 Request Body 두 번 읽기?!	HttpServletRequestWrapper 상속받은 커스텀 클래스를 통해서 요청 바디스트림 여러 번 소모	자세히 보기
↩️ S3 이미지는 누가 롤백함?	ThreadedLocal을 활용하여 @Transactional의 결과를 감지하는 리스너 추가	자세히 보기
↪️️ 그럼, Elasticsearch 데이터는 누가 롤백함???	S3 롤백과 같은 동작을 하는 es 데이터 담당 리스너 추가	자세히 보기
🔔 알림 기능 도입기	SSE 도입을 통한 알림 기능 추가	자세히 보기
💬 채팅방 구현기	WebSocket with STOMP 도입을 통한 채팅 기능 추가	자세히 보기
💀 DB connection 고갈	JPA의 open-in-view: false 설정	자세히 보기
📣 알림 서비스 비동기 처리	SSE 알림을 @Async 처리	자세히 보기
💨 캐싱 적용하기	Redis 기반 캐싱 적용	자세히 보기
🚛 Nginx 최대로 활용하기	Nginx 커넥션 설정 및 rate limiting 추가	자세히 보기
🐳 도커 볼륨 마운트 이해하기	도커의 볼륨 마운트 기준 이해	자세히 보기
👀 조회수 업데이트 레이스 컨디션	RDBMS 게시글 조회수 업데이트 방치 및 검색 데이터 조회수 스케줄러 처리	자세히 보기
🧪 API 처리 스레드 수 조절하기	jmeter 부하테스트를 통한 톰캣 스레드, hikari pool 커넥션 사이즈 최적화	자세히 보기
🫢 단일쿼리가 30번씩 나간다고?!	JPQL을 통한 join 처리	자세히 보기
🛫 쿼리 최적화 경험하기	Lazy Loading 문제 개선하기	자세히 보기
🚀 프로덕트 서버 배포 파이프라인 구축기	기존에 구축해놨던 파이프라인을 활용하여 GCP에 프로덕트 서버 배포	자세히 보기