← 포트폴리오 목록
사진 보정 주문 관리 플랫폼
전국 사진관 가맹점을 대상으로 한 B2B 사진 보정 주문·전달 플랫폼의 구현한 프로젝트입니다.
S3 Multipart Upload + Presigned URL 기반 파일 파이프라인 설계백엔드 프록시 없이 클라이언트-S3 직접 전송 구조를 구현하여 서버 부하를 최소화하고, Presigned URL로 결과물 보안 다운로드를 제공하는 구조를 설계합니다.
토스페이먼츠 PG 결제 플로우 및 웹훅 처리 구현결제 요청·승인·취소 전 단계를 구현하고 웹훅 기반 결제 완료 처리로 주문 상태를 자동 전이하는 안전한 결제 파이프라인을 설계합니다.
카카오 알림톡 자동 발송 + Bull Queue 재시도 구조 설계주문 접수·보정 완료·전달 각 단계에서 알림톡을 자동 발송하고, 발송 실패 시 Redis 기반 큐로 재시도하는 안정적 메시지 전달 체계를 구현합니다.
Overview
프로젝트 개요
전국 사진관 가맹점을 대상으로 한 B2B 사진 보정 주문·전달 플랫폼의 구현한 프로젝트입니다. 가맹점별 회원 포털에서 사진을 업로드하고 보정 옵션을 선택한 뒤, 토스페이먼츠 PG 결제까지 완결되는 주문 플로우를 설계합니다. 관리자는 주문을 실시간으로 관리하고 결과물을 가맹점에 전달하며, 카카오 알림톡으로 각 단계별 상태를 자동 통보하는 구조를 구현할 예정입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
대용량 사진 파일(수십 MB 단위)의 안정적 업로드·다운로드를 위한 S3 Multipart Upload 분할 전략 및 재개 처리 설계
결제 웹훅 중복 수신 및 네트워크 단절 시 주문 상태 불일치를 방지하는 멱등성 보장 처리
카카오 알림톡 API 발송 한도 및 실패율을 고려한 큐 기반 비동기 발송 체계 설계
가맹점별 데이터 격리를 보장하면서도 관리자 전체 조회가 효율적으로 동작하는 쿼리 구조 설계
ZIP 묶음 다운로드 시 대용량 파일 스트리밍 처리로 서버 메모리 과부하 방지
핵심 기능 1
대시보드
가맹점 포털 메인 대시보드로, 진행 중 주문 현황·최근 결과물 다운로드·알림 요약을 한눈에 제공합니다. 주문 상태를 접수→보정중→완료→전달 단계로 구분하고, 단계별 카운트를 실시간으로 표시합니다
핵심 기능 2
주문 관리
사진 업로드·보정 옵션 선택·PG 결제까지 이어지는 신규 주문 생성 플로우와, 진행 중 주문의 상태 추적 및 결과물 다운로드를 제공합니다
핵심 기능 3
가맹점 관리
관리자가 가맹점 등록·승인·정지 및 담당자 계정을 관리하는 화면입니다. 가맹점별 주문 이력과 월별 이용 현황을 조회할 수 있습니다
핵심 기능 4
파일 관리
관리자가 접수된 원본 파일을 다운로드하고 보정 완료 파일을 업로드·전달하는 파일 관리 화면입니다. 주문별 원본·결과물 파일을 S3 버킷 구조로 체계적으로 관리하고, 대량 파일의 ZIP 묶음 다운로드를 지원합니다
구현 과정
프로젝트 진행 단계
STEP 1
도메인 모델 설계
가맹점·주문·파일·결제 엔티티 관계 정의 및 Prisma 스키마 작성
STEP 2
S3 파일 파이프라인 구축
Multipart Upload·Presigned URL·ZIP 스트리밍 다운로드 구현
STEP 3
결제·알림 연동
토스페이먼츠 결제 플로우 및 카카오 알림톡 자동 발송 구현
STEP 4
관리자·가맹점 포털 퍼블리싱
주문 관리·파일 관리·가맹점 관리 화면 구현 및 상태 연동
STEP 5
주문 상태 자동화 및 QA
상태 전이 자동화, 이벤트 훅 연결, 엣지 케이스 처리
프로젝트 성과
S3 Multipart Upload + Presigned URL 기반 파일 파이프라인 설계백엔드 프록시 없이 클라이언트-S3 직접 전송 구조를 구현하여 서버 부하를 최소화하고, Presigned URL로 결과물 보안 다운로드를 제공하는 구조를 설계합니다.
토스페이먼츠 PG 결제 플로우 및 웹훅 처리 구현결제 요청·승인·취소 전 단계를 구현하고 웹훅 기반 결제 완료 처리로 주문 상태를 자동 전이하는 안전한 결제 파이프라인을 설계합니다.
카카오 알림톡 자동 발송 + Bull Queue 재시도 구조 설계주문 접수·보정 완료·전달 각 단계에서 알림톡을 자동 발송하고, 발송 실패 시 Redis 기반 큐로 재시도하는 안정적 메시지 전달 체계를 구현합니다.
주문 상태 전이 자동화 파이프라인 구현파일 업로드 완료→주문 상태 자동 전이→가맹점 알림 발송까지 이어지는 이벤트 기반 자동화 구조를 설계하여 관리자 수작업을 최소화합니다.
가맹점 승인 플로우 및 권한 분리 구조 설계관리자·가맹점 역할을 JWT 클레임으로 분리하고, 가맹점 승인 상태 머신과 연동된 접근 제어 미들웨어를 구현합니다.
Review
기술적 주안점
- 주문 상태 전이를 이벤트 기반으로 설계하여 관리자·가맹점 양측 화면이 일관된 상태를 유지하는 구조를 구현합니다
- S3 Multipart Upload와 Presigned URL을 조합해 업로드·다운로드 전 과정을 백엔드 프록시 없이 S3 직접 전송으로 처리하는 구조를 설계합니다
- 카카오 알림톡 발송 실패 시 재시도 큐(Bull Queue)를 통해 안정적 메시지 전달을 보장하는 구조를 구현합니다
