GM 오락실
work · 커머스 플랫폼

다중 배송지 · 선물하기

한 번의 주문을 여러 배송지로 나눠 보내는 기능(V2). 엑셀로 배송지를 한꺼번에 올리고, 결제 전에 배송 가능 여부를 검사합니다.

2026.08프론트 · 백엔드
다중 배송지 주문 흐름
다중 배송지 주문 흐름
N:M
주문 상품 ↔ 배송지
엑셀
배송지 일괄 등록
2단계
등록 때 · 결제 전 검증
3층
React · Java · MyBatis

01개요

레거시 Spring MVC 모놀리스와 Next.js 프론트에 걸친 기능입니다. 배송지마다 상품 · 수량 · 배송 지정일이 다른 주문을 하나의 결제로 묶어야 했습니다.

선물하기도 같은 구조(여러 상품 ↔ 여러 받는 사람)로 확장해, 주문 행을 그룹키로 구분하도록 정리했습니다.

02기술 스택

프론트
React · TypeScript배송지 등록 · 검증 모달엑셀 업로드 파싱 훅
백엔드
Java · Spring MVCMyBatis 매퍼Apache POI 엑셀 파싱

03주문 흐름

배송지 등록
직접 · 엑셀 일괄
등록 검증
배송 가능 지역 · 지정일
주문 행 구성
그룹키로 구분
결제 전 검사
배송 불가 상품 모아 안내

04만든 것들

한 일
  • 엑셀 업로드 기반 배송지 일괄 등록과 배송 가능 지역 · 지정일 검증 모달
  • 그룹키 기반 주문 행 구분, 엑셀 파싱 · 매퍼 정비
  • 선물하기를 여러 받는 사람 구조로 확장
  • 결제 직전 배송 불가 상품 검증 · 안내

05문제와 해결

같은 받는 사람이 안내에 여러 번

문제
배송 불가 안내 메시지에 같은 받는 사람이 중복으로 찍혔다.
원인
배송 불가 상품을 모으는 과정에서 같은 받는 사람 번호가 중복으로 쌓였다.
해결
받는 사람 기준으로 중복을 걷어 낸 뒤 안내 메시지를 만들도록 고쳤다.

검증이 가끔 옛 값으로 돌던 것

문제
배송지를 고친 직후 검증을 누르면 고치기 전 값으로 검사될 때가 있었다.
원인
검증 핸들러가 처음 만들어질 때의 state를 붙잡고 있는 stale closure였다.
해결
핸들러가 항상 최신 값을 읽도록 훅의 의존성과 참조 방식을 정리했다.

검증 조건이 뜻과 다르게 묶이던 것

문제
일부 조합에서 배송 가능한 상품이 불가로 걸렸다.
원인
&& 와 || 가 섞인 조건식에서 연산자 우선순위가 의도와 달랐다.
해결
조건을 의도대로 묶어 고치고, 검증 API마다 다르던 응답 모양 차이도 프론트에서 한 모양으로 맞춰 다뤘다.

06관련 회고

  • 이벤트 핸들러가 옛날 state를 보는 이유: stale closure
프로젝트 회고 보기 →
Gunmo Lee
since 2021.07