PROJECT DETAIL / 업무 프로젝트
배송 메시지 발송 이력과 통계·정산을 관리하는 백엔드
배송 앱의 문자 발송 이력과 통계·정산 API를 개발했습니다. 원본 이력에 발송 일시 기준 RANGE 파티셔닝을 적용해 조회 범위를 줄이고 보관 기간이 지난 데이터를 파티션 단위로 삭제하도록 설계했습니다.
배송 앱과 연계되는 메시지 이력·정산 모듈의 백엔드 설계와 API 개발을 담당했습니다. 원본 이력의 파티셔닝과 조회·보관 정책, 일별·월별 집계, S3 이미지 업로드·조회를 구현하고 AWS 환경에서 배포·운영했습니다.
01 / ARCHITECTURE
02 / IMPLEMENTATION
기능별 처리 흐름과 문제 해결 과정, 설계 이유와 구현 결과를 소개합니다.
FEATURE 01 구현 완료
LMS·MMS 발송 결과를 저장하고 운송장 기준으로 조회합니다.
배송 앱에서 발생하는 문자 발송 결과를 추적하고 기사별 발송량을 정산에 활용할 수 있는 관리 기능이 필요했습니다.
발송 라이브러리의 결과를 수신하는 API와 운송장 번호 기준의 이력 조회 기능을 구현했습니다.
발송 이력은 개별 결과를 추적하는 근거로 보관하고 정산은 집계 데이터로 조회합니다. 조회 목적에 맞는 데이터 구조를 사용할 수 있지만 원본과 집계의 갱신 시점은 달라집니다.
운송장 기준 발송 이력 조회와 기사별 발송량 집계를 제공해 이력 추적과 정산 업무를 지원했습니다.
FEATURE 02 구현 완료
발송 일시 기준으로 원본 이력을 분할해 조회와 보관 만료 데이터의 삭제를 함께 설계했습니다.
발송 이력이 계속 쌓이면 기간별 조회의 탐색 범위가 커지고 오래된 원본을 행 단위로 대량 삭제하는 작업도 DB에 부담을 줍니다.
발송 일시를 기준으로 RANGE 파티셔닝을 적용했습니다. 기간 조회 조건으로 관련 파티션만 탐색하도록 구성하고, 1년이 지난 데이터는 보관 만료 파티션을 DROP해 정리하도록 설계했습니다.
기간별 이력 조회와 1년 보관 정책에 같은 시간 기준을 사용했습니다. 데이터가 늘어도 조회할 파티션 범위를 제한할 수 있지만, 파티션 기준과 맞는 기간 조건을 쿼리에 포함해야 합니다.
만료된 데이터를 한 행씩 삭제하는 대신 파티션 단위로 제거해 대량 삭제와 이후 정리 작업의 부담을 줄였습니다. 파티션 경계와 보관 기간을 맞춰야 하며, 생성·삭제 시점과 DDL 잠금은 운영 과정에서 고려해야 합니다.
기간 조건 조회에 파티션 프루닝을 적용해 조회 범위를 줄였습니다. 1년이 지난 원본 데이터를 파티션 DROP으로 정리할 수 있는 보관 정책을 설계했습니다.
FEATURE 03 구현 완료
Pre-signed URL로 이미지 전송과 API 처리를 분리했습니다.
이미지 전송을 API 서버가 중계하면 파일 크기와 요청량에 따라 서버의 네트워크·처리 부담이 커집니다.
API에서 S3 Pre-signed URL을 발급하고 클라이언트가 S3에 직접 업로드·조회하도록 구현했습니다.
API 서버는 파일 접근에 필요한 URL을 발급하고 이미지 데이터는 S3로 전송합니다. 서버의 파일 중계를 줄이는 대신 URL 만료 시간과 객체 접근 정책을 관리해야 합니다.
이미지 업로드·조회 경로를 S3 직접 통신으로 전환해 API 서버가 이미지 바이너리를 중계하는 구조를 개선했습니다.
FEATURE 04 구현 완료
대량 발송 이력을 일별·월별로 집계해 통계와 정산에 활용합니다.
통계·정산 요청마다 대량의 발송 원본을 집계하면 조회 비용과 운영 DB의 부담이 커집니다.
원본 이력과 조회용 집계 데이터를 분리하고 EventBridge 기반의 일별·월별 집계 흐름을 구성했습니다.
배치에서 집계한 결과를 조회하면 요청마다 원본 전체를 계산하지 않아도 됩니다. 대신 배치 완료 시점까지 최신 원본이 집계 결과에 반영되지 않는 지연을 고려해야 합니다.
일별·월별 집계 데이터를 기반으로 통계·정산 API를 제공하고 원본 적재와 집계 조회의 역할을 분리했습니다.
03 / RESULTS & TESTING
| 항목 | 결과 |
|---|---|
| 처리 규모 | 일 50만~200만 건 규모의 메시지 발송 이력 관리 |
| 이력 관리 | 운송장 기준 추적 및 기사별 발송량 집계 |
| 원본 관리 | 발송 일시 RANGE 파티셔닝, 기간 조회 프루닝, 1년 경과 파티션 DROP |
| 이미지 처리 | S3 Pre-signed URL을 통한 직접 업로드·조회 |
| 통계 · 정산 | EventBridge 기반 일별·월별 집계와 조회 API |
04 / REFLECTION
발송 이력은 저장과 조회뿐 아니라 보관 기간이 끝난 뒤의 정리 방식까지 고려해야 했습니다. 원본 파티셔닝으로 기간 조회와 만료 데이터 삭제를 설계하고, 통계·정산은 별도 집계 데이터로 제공했습니다. 파일 전송도 S3로 분리하면서 각 처리 목적에 맞는 구조를 구성했습니다.
다시 설계한다면 파티션 경계와 보관 기간, 파티션 생성·삭제 작업의 관찰 지표를 더 명확하게 정리하겠습니다. 집계 지연과 재처리 기준, 원본과 집계 결과를 대조하는 절차도 함께 고려하겠습니다.