플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - ERP REST API가 분기마다 필드 명세가 변경되어 파이프라인 전체가 중단되는 리스크 — Zod 런타임 스키마 검증으로 변경된 필드만 오류 격리하고 나머지 엔티티는 정상 수집 지속하는 방어적 파싱 구조 설계 필요 - 무역 서류(인보이스·패킹리스트·원산지증명서)마다 국가별·거래처별 양식이 달라 단일 템플릿으로 커버 불가 — Template Strategy 패턴으로 서류
프로젝트 성과
Zod 방어적 파싱 기반 ERP 연동 안정성 구조 설계
ERP REST API 응답 27개 엔드포인트에 Zod 런타임 스키마 검증 적용, 필드 변경·추가 시 파이프라인 전체 중단 대신 해당 엔티티만 오류 격리하고 로그로 추적 가능한 방어적 파싱 아키텍처 구현
Gemini AI 구조화 프롬프트 엔지니어링으로 무역 서류 자동 생성 구현
거래 데이터를 JSON Schema 제약 조건과 함께 Gemini API에 전달하여 인보이스·패킹리스트·원산지증명서 3종 초안 자동 생성
Template Strategy 패턴 3종 무역 서류 PDF 출력 엔진 구현
서류 유형별(인보이스·패킹리스트·원산지증명서) 출력 규칙 차이를 Template Strategy 패턴으로 추상화, pdf-lib 단일 렌더러로 3종 양식을 처리하는 PDF 생성 엔진 설계 및 구현
PostgreSQL Materialized View 기반 경영 KPI 집계 구조 설계
수출입 거래·재고·미결 서류 데이터를 Materialized View 3개로 사전 집계, React Query 5분 staleTime 캐싱과 결합하여 대시보드 조회 시 실시간 집계 연산 없이 즉시 응답하는 구조 구현
Bull Queue 지수 백오프 재시도 및 DLQ 분리 구조 적용
ERP API 호출 실패 시 지수 백오프 3회 재시도 후 Dead Letter Queue로 분리 처리, 관리자 화면에서 DLQ 건 원클릭 재처리 기능과 실패 원인 로그 인라인 표시 UI 구현
핵심 기능
경영 대시보드
수출입 현황 KPI, 월별 거래량 추이, 미결 서류 현황, 환율 알림을 한 화면에서 조회하는 통합 경영 대시보드. Recharts 복합 차트 + React Query 캐싱 + WebSocket 실시간 알림
진행 단계
ERP API 연동 스펙 분석 및 PostgreSQL 웨어하우스 스키마 설계
2026.03.
ERP REST API 엔드포인트 27개 스펙 분석, 수출입·재고·품목·거래처 데이터 모델 ERD 설계 및 PostgreSQL 테이블 21개 정의, Materialized View 3개 집계 구조 확정
프로젝트 상세
1) 포트폴리오 소개 중소 무역회사의 ERP 시스템과 연동하는 데이터 파이프라인, AI 기반 수출입 서류 자동 생성, 입출고 현황 관리 앱, 경영 대시보드를 React + Node.js 기반 웹 풀스택으로 설계·구현할 예정. ERP REST API로 수집한 거래·재고 데이터를 PostgreSQL 웨어하우스에 적재하고, Gemini AI API를 활용하여 인보이스·패킹리스트·원산지증명서 등 무역 서류를 자동
