개발 이야기

배송은 끝났는데 사진이 없을 때, 안내를 어디까지 보낼까요

배송완료와 사진 도착 시점을 분리하고, 먼저 보낸 안내 이력을 보존하면서 후속 사진을 한 번만 보내도록 설계했어요.

사이트 공개일
기록 수정일
기술과 주제
Node.js · PostgreSQL · 상태 전이 · 비동기 처리
이 글의 목차

수집 실패가 아니라 사진 대기였어요

배송완료가 됐는데 자동화 시스템에서 처리되지 않는다는 문의가 있었어요. 확인해 보니 완료 상태와 주문은 이미 연결돼 있었어요. 배송업체 원본에 사진이 없어 문자 발송이 기다리고 있던 상황이었죠.

처음에는 배송완료 안내와 사진을 한 번에 보내도록 만들었어요. 그런데 현장에서는 사진이 늦게 등록되거나 인수증만 올라오는 일이 있었어요. 의뢰인은 사진을 다시 받기 전이라도 완료 안내를 먼저 보내고 싶어 했어요.

요구를 ‘사진이 없으면 문자만 보낸다’로 줄이면 위험했어요. 사진이 실제로 없는 경우와 사진을 확인하지 못한 경우를 먼저 나눠야 했어요.

빈 목록도 확인된 결과여야 했어요

확인한 상태처리
정상적으로 사용할 사진이 있음안내문과 대표 사진 한 장을 함께 발송
사진 조회 성공, 등록 사진은 0장안내문자 먼저 발송
수집·분석 완료, 모두 인수증 전용 사진안내문자 먼저 발송
조회·다운로드 실패 또는 분석 진행 중확인·처리 대기
분류 불명확 또는 상품과 문서가 섞인 사진기존 사진 검토 흐름 유지

사진 배열이 비어 있다는 사실만으로는 충분하지 않았어요. 원본 조회가 성공했는지를 별도로 남겼어요. 다운로드 실패나 잘못된 응답을 빈 배열로 치환하면 확인하지 못한 주문을 정상 무사진 주문처럼 처리할 수 있기 때문이에요.

사진에 문서가 포함됐다는 판정과 인수증만 있다는 판정도 달랐어요. 상품과 인수증이 함께 찍힌 사진까지 ‘문서니까 사진 없음’으로 취급하지 않도록 인수증 전용 판별 근거를 구분했어요.

꽃·인수증 구분과 혼합 사진의 추가 판별 과정에서는 일반 사진 우선, 가장자리 재검사, 다섯 영역 분할을 더 자세히 설명해요.

첫 안내와 후속 사진에 각각 이력을 남겼어요

한 주문의 화면은 그대로 유지하면서 발송 단계를 notice와 photo_followup으로 나눴어요. 첫 안내는 사진이 있으면 MMS, 확인된 무사진 상태라면 LMS를 사용해요. 전송 형식이 달라도 같은 첫 안내 단계이므로 둘 다 접수되지 않도록 했어요.

업무 흐름

  1. 01완료·무사진 확인
  2. 02안내문자 전달 성공
  3. 03시트 체크 기록
  4. 04사진 추가 수집·검토
  5. 05후속 사진 한 번 발송
업무 흐름 개념도

후속 단계는 첫 LMS의 전달 성공과 시트 체크 반영을 확인한 뒤 시작해요. 먼저 보낸 시도 ID·수신번호·문구·주문 정보·완료 시각은 별도 기록에 보존하고, 현재 진행 단계만 사진 대기로 바꿔요. 앞선 발송을 지우고 새 작업처럼 재사용하지 않는 것이 핵심이에요.

후속 사진은 ‘배송완료 사진입니다.’라는 짧은 문구와 대표 사진 한 장으로 보내요. 후속까지 끝난 뒤 사진이 더 올라와도 자동으로 추가 발송하지 않아요. 이 배송완료 흐름은 안내와 후속을 합쳐 최대 두 번이며, 제작사진 안내는 별도예요.

사진이 도착하는 순간에 따라 행동이 달라져요

첫 안내를 접수하기 전에 정상 사진이 준비됐다면 안내와 사진을 한 번에 보내면 돼요. 이미 접수가 시작됐다면 그 문자 내용은 고정해야 해요. 이후 사진이 들어왔다고 과거 발송의 본문이나 첨부 정보를 바꾸면 실제로 보낸 내용과 기록이 달라져요.

그래서 접수 중에도 사진 수집은 계속하되, 이미 접수한 발송 기록은 수정하지 않아요. 첫 안내의 전달 성공을 확인한 다음 후속 여부를 판단해요. 첫 안내가 실패하거나 결과 불명 상태라면 자동으로 후속 사진을 보내지 않아요.

시트에 완료 체크가 있다는 이유만으로 후속을 모두 허용하지도 않아요. 시스템이 먼저 보낸 LMS의 성공 기록과 동일 주문이라는 근거가 있는 경우에만 후속 단계를 열어요. 사람이 체크한 주문이나 이전에 사진문자까지 완료한 주문은 새 후속 대상으로 만들지 않아요.

사진을 기다리는 기간과 재확인 조건

첫 안내 후 사진을 기다리는 기간은 7일로 정했어요. 최근 배송 조회 범위에서 벗어나더라도 대기 주문의 외부 식별값으로 다시 조회해요. 추가 조회량을 제한하고 순환 처리해, 오래 기다리는 건이나 조회 오류가 현재 주문 수집을 막지 않도록 했어요.

기간이 끝나면 관리자에게 확인이 필요한 건으로 남겨요. 고객에게 사진을 재촉하는 문자를 자동 발송하지는 않아요.

후속을 보내기 직전에는 주문·연락처·발송 제외·자동발송 설정·운영시간을 다시 확인해요. 첫 안내 후 번호가 바뀌었다면 새 번호로 조용히 이어 보내지 않고 확인 대기로 전환해요. 두 단계와 제작사진은 번호별 발송 제한에도 함께 집계돼요.

기존 주문을 새 정책으로 다시 보내지 않도록

정책을 추가하는 순간 과거 사진 대기 건이 모두 발송되면 의도하지 않은 안내가 나갈 수 있어요. 적용 시작 시각을 데이터베이스에 한 번 저장하고, 그 이후 완료된 배송에 새 흐름을 적용했어요. 재시작해도 이 기준은 바뀌지 않아요.

가상 발송사와 독립 데이터베이스를 사용해 무사진→안내→사진 추가→후속 한 번의 흐름을 검증했어요. 이후 재수집과 동시 요청에도 추가 접수가 생기지 않는지, 접수 중 사진 추가가 기존 기록을 바꾸지 않는지 확인했어요. 시트 쓰기 재시도, 오래된 결과 응답, 연락처 변경과 추적 기간 만료도 검사했어요.

배송완료, 안내 완료, 사진 확보는 서로 다른 사실이었어요. 각각의 근거와 완료 시점을 분리하니, 고객에게 먼저 알려도 되는 내용과 아직 기다려야 하는 내용을 구분할 수 있었어요.