플러스프로젝트 배경
1) 문제점 - SaaS 플랫폼 API 스펙 변경 시 내부 ETL 매핑 로직에 미치는 영향을 최소화하기 위해 매핑 규칙을 코드 외부 JSON Schema로 분리하는 설계 방식 결정 - 양방향 동기화에서 A→B 전송 후 B→A 역전파로 인한 무한 루프를 방지하기 위한 동기화 방향 플래그 및 이벤트 소스 추적 구조 설계 - MSSQL 트랜잭션 격리 수준 선택에서 동기화 쓰기 경합과 읽기 일관성 사이의 균형점
프로젝트 성과
ETL 파이프라인 멱등성 설계 구현
Transform→Load 단계를 Sequelize 트랜잭션으로 묶고 UPSERT 전략을 적용하여 동일 레코드 중복 처리 시에도 데이터 일관성이 보장되는 파이프라인 구조 구축
JSON Schema 기반 외부화 매핑 규칙 설계
SaaS 필드↔MSSQL 컬럼 간 변환 규칙을 DB 저장 JSON Schema로 외부화하여 재배포 없이 매핑 규칙을 수정 가능한 구조로 설계
Socket.io 이벤트 브리지 레이어 구현
Express 미들웨어에서 발생한 동기화 완료·오류 이벤트를 Socket.io로 클라이언트에 푸시하는 이벤트 브리지를 설계하여 폴링 없이 실시간 대시보드 갱신 구조 구현
7개 테이블 MSSQL 로그·이력 스키마 설계
동기화로그·오류·매핑규칙·스케줄·API키·재처리이력·이벤트를 외래키 관계로 연결한 정규화 스키마 설계 및 Sequelize 마이그레이션 관리
Winston 구조화 로깅 미들웨어 설계
Express 파이프라인에 Winston 미들웨어를 삽입하여 요청·응답·처리시간을 구조화된 JSON으로 MSSQL에 비동기 기록하는 Cross-Cutting Concern 구조 구현
핵심 기능
동기화 모니터링 대시보드
API 연동 상태, 동기화 성공/실패 현황, 최근 오류 이벤트를 한 화면에서 실시간으로 확인하는 메인 대시보드. Socket.io로 서버 동기화 이벤트를 프론트에 실시간 푸시.
진행 단계
SaaS API 인터페이스 분석 및 Webhook 수신 구현
2024.09.
물류 SaaS 플랫폼 API 문서 분석, Webhook 수신 엔드포인트 구현, 요청 서명 검증 미들웨어 설계
프로젝트 상세
1) 포트폴리오 소개 외부 물류 SaaS 플랫폼과 사내 레거시 시스템 간의 양방향 API 연동 및 데이터 동기화 백엔드 서버를 구현하였다. Node.js + Express 기반 API 서버와 React 관리자 대시보드를 결합하여 Webhook 수신, ETL 파이프라인, API 로그 관리, 실시간 오류 모니터링 기능을 풀스택으로 설계하고 구축하였다. 2) 작업 범위 - 동기화 모니터링 대시보드: API
