[설계의사결정] 시리즈 목록

ARCHITECTURE

[설계 의사결정] 시리즈 목록

단순히 기능을 구현하는 것보다 더 중요했던 건 “왜 이 방식을 선택했는가?”에 대한 고민이었다.

목차

• 1. 이미지 업로드 정책 결정 과정
• 2. 페이지네이션 방식 선택 과정
• 3. 독서 리마인더 알림 구현 방식 선택 과정
• 4. 국내 도서 검색 API 선택 과정
• 5. JWT + Redis 인증 설계

이 시리즈는 Booktine 개발 과정에서 실제로 고민했던 설계 선택 과정들을 정리한 글이다. 단순 구현 방법보다는 “왜 이 구조를 선택했는가”를 중심으로 기록했다.

01

이미지 업로드 정책 결정 과정

Booktine에는 책 표지 이미지와 프로필 이미지 두 가지 이미지가 존재한다. 이미지를 저장하는 방식으로 외부 URL 직접 저장, 서버에서 S3 재업로드, Presigned URL을 통한 클라이언트 직접 업로드 세 가지를 비교했다.

이미지 종류별로 특성이 달라 각각 다른 방식을 선택하게 된 과정을 정리했다.

→ 자세히 보기

02

페이지네이션 방식 선택 과정

게시물, 메모, 추천 도서 목록 등 목록 조회가 많은 서비스 특성상 페이지네이션 도입이 필요했다.

오프셋 기반과 커서 기반을 비교했고, Spring Data의 Page<T>와 Slice<T> 중 어떤 방식이 Booktine에 적합한지 선택한 과정을 정리했다.

→ 자세히 보기

03

독서 리마인더 알림 구현 방식 선택 과정

사용자가 설정한 시간에 맞춰 서버가 알림을 전달하는 리마인더 기능을 구현하면서 @Scheduled + SSE, 이메일, WebSocket, FCM 등 여러 방식을 비교했다.

단방향 알림 전달이라는 요구사항에 맞는 방식을 선택한 과정을 정리했다.

→ 자세히 보기

04

국내 도서 검색 API 선택 과정

도서 검색 기능 구현을 위해 알라딘, 카카오, 네이버, 국립중앙도서관, 도서관 정보나루 API를 비교했다.

표지 이미지 제공 여부, 신간/베스트셀러 데이터, JSON 응답 지원 등을 기준으로 검토하고 최종 API를 선택한 과정을 정리했다.

→ 자세히 보기

05

JWT + Redis 인증 설계

Booktine의 대부분의 기능이 인증을 전제로 하기 때문에 인증 방식 선택이 중요한 설계 결정이었다.

세션 방식과 JWT를 비교하고, Refresh Token 강제 무효화 문제를 해결하기 위해 Redis를 도입한 과정을 정리했다.

→ 자세히 보기