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