Next.js 기반 쇼핑몰 커머스 플랫폼 파이프라인 아키텍처 설계 사례

프로젝트 개요

SampleShip 관리자 상품 관리 화면에 이미지별 alt 텍스트 편집 기능과 업로드 파일 삭제 정책을 추가하는 작업입니다. 업로드 이미지와 정적 이미지를 구분해 삭제 범위를 제한하는 것이 핵심입니다.

갤러리 alt 텍스트 데이터 구조

관리자 상품 API에 gallery_alt_texts 필드를 추가하고, 관리자 화면의 이미지 카드마다 alt 입력란을 구성했습니다.

Product Image Alt Editor

업로드 이미지 삭제 정책

업로드 파일 삭제 API를 별도로 구성해, 업로드된 이미지 URL만 물리 삭제 대상으로 제한했습니다. 정적으로 제공되는 상품 이미지는 갤러리 목록에서만 제거되고 실제 파일은 삭제되지 않도록 구분했습니다.

검증 결과와 향후 과제

검증 결과
[PASS] 프론트엔드/Rust 빌드 및 포맷 검사 성공
[PASS] GET /healthz 정상 응답 확인
[PASS] alt 텍스트 수정(PATCH) 저장 확인
[PASS] 업로드 파일 삭제 후 디스크 파일 제거 확인
[PASS] 관리자 화면 업로드/삭제 흐름 렌더링 확인

상품 고시정보 템플릿 선택 UI/API, 실제 메일 수신 서버 설치와 DNS 연결, 리뷰/상품문의, 쿠폰/적립금, 결제(PG) 연동은 다음 단계 과제로 남아 있습니다.