← 포트폴리오 목록
패키지 투어 예약·정산 ERP
여행·관광 패키지 상품을 아임웹 홈페이지와 실시간 연동하며, 웹훅·OpenAPI 데이터 싱크, 행사별 정산 자동 계산, 매출·순수익 통계 대시보드를 갖춘 여행사 전용 ERP를 React + Node.js 기반으로 구현하는 프로젝트입니다.
아임웹 웹훅 재시도 파이프라인 구현웹훅 수신 실패 시 지수 백오프 재시도 큐를 설계하여 예약 데이터 유실 없이 ERP DB 반영 구조를 구현합니다
행사별 정산 자동 계산 엔진 설계지출 항목 12종을 집계해 총매출-총지출 순수익을 실시간 산출하는 정산 계산 엔진을 구현합니다
OpenAPI 상품·좌석 동기화 배치 구현아임웹 OpenAPI로 상품·잔여좌석 데이터를 주기 배치 동기화하는 파이프라인을 Node.js cron 기반으로 구현합니다
Overview
프로젝트 개요
여행·관광 패키지 상품을 아임웹 홈페이지와 실시간 연동하며, 웹훅·OpenAPI 데이터 싱크, 행사별 정산 자동 계산, 매출·순수익 통계 대시보드를 갖춘 여행사 전용 ERP를 React + Node.js 기반으로 구현하는 프로젝트입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
아임웹 웹훅과 OpenAPI 동기화 간 데이터 정합성을 트랜잭션 단위로 보장하는 재시도 전략 설계가 필요합니다
다중 출발일 행사와 잔여좌석 실시간 반영 사이의 동시성 제어 및 좌석 초과 예약 방지 로직 설계가 필요합니다
정산 마감 이후 지출 정정 요청을 처리하는 재정산 워크플로우 설계가 필요합니다
카카오 알림톡 템플릿 심사 대기 등 외부 승인 지연 상황에서의 SMS 폴백 발송 전략 설계가 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
매출·순수익 통계 대시보드
관리자가 기간별·행사별 매출, 지출, 순수익을 한눈에 파악할 수 있는 통합 대시보드입니다
핵심 기능 2
아임웹 웹훅 실시간 예약 동기화
아임웹 홈페이지에서 발생한 주문·결제 이벤트를 실시간으로 수신해 ERP 예약자 데이터로 자동 반영하는 기능입니다
핵심 기능 3
행사별 정산 자동 계산 및 마감 처리
관리자가 행사별 지출 내역을 입력하면 매출과 자동으로 상계해 순수익을 계산하고, 정산을 마감 처리할 수 있는 기능입니다
핵심 기능 4
출발일별 예약 캘린더 & OpenAPI 좌석 동기화
행사의 출발일별 예약 현황과 잔여좌석을 캘린더 뷰로 확인하고, 아임웹 OpenAPI로 실시간 동기화하는 기능입니다
구현 과정
프로젝트 진행 단계
STEP 1
요구사항 분석 및 ERP 데이터 모델 설계
여행 상품·행사·예약자·정산 4대 도메인 ERD 설계, PostgreSQL 테이블 22개 정의 및 아임웹 연동 스키마 매핑
STEP 2
아임웹 OpenAPI·웹훅 연동 계층 개발
Express 기반 웹훅 수신 엔드포인트와 OpenAPI 동기화 배치 작업 구현, 재시도 큐 및 실패 로그 설계
STEP 3
정산·통계 대시보드 프론트엔드 개발
React 기반 정산 자동계산 화면, Chart.js 매출·순수익 대시보드, 예약 캘린더 위젯 구현
STEP 4
통합 테스트 및 데이터 동기화 검증
웹훅-DB-아임웹 3자 데이터 정합성 테스트, API 엔드포인트 통합 검증, 좌석 동기화 부하 테스트
프로젝트 성과
주요 성과
아임웹 웹훅 재시도 파이프라인 구현웹훅 수신 실패 시 지수 백오프 재시도 큐를 설계하여 예약 데이터 유실 없이 ERP DB 반영 구조를 구현합니다
행사별 정산 자동 계산 엔진 설계지출 항목 12종을 집계해 총매출-총지출 순수익을 실시간 산출하는 정산 계산 엔진을 구현합니다
OpenAPI 상품·좌석 동기화 배치 구현아임웹 OpenAPI로 상품·잔여좌석 데이터를 주기 배치 동기화하는 파이프라인을 Node.js cron 기반으로 구현합니다
매출·순수익 대시보드 데이터 집계 설계PostgreSQL 집계 쿼리 기반 기간별·행사별 매출 통계를 Chart.js 8종 차트로 시각화하는 구조를 구현합니다
Review
기술적 주안점
- 행사별 정산 데이터를 실시간 집계해 매출·지출·순수익을 자동 산출하는 통계 대시보드 구조를 구현합니다
- 아임웹 웹훅과 ERP DB 간 데이터 싱크를 실시간 연동 구조로 구현하여 이중 입력 없이 예약 데이터를 일치시킵니다
- 행사별 지출 데이터를 기반으로 순수익을 자동 계산하고 마감 스냅샷을 남기는 정산 엔진을 구현합니다
