플러스프로젝트 배경
1) 문제점 - 포워딩사마다 다른 Daily Report 양식을 OCR로 처리하여 표준 Canonical Model로 자동 변환하는 어댑터 설계의 예외 케이스 처리 필요 - Rule 백테스트 수행 시 수천 건 과거 데이터에 Rule 소급 평가가 필요하여 동기 처리 시 응답 지연이 발생하는 장기 실행 작업 비동기 처리 구조 설계 필요 - 같은 HS코드라도 수출입 방향·협정 구분에 따라 적용 Rule이 달라
프로젝트 성과
Canonical Data Model 기반 4종 문서 대조 아키텍처 설계
이질적 양식의 B/L·패킹리스트·인보이스·Daily Report를 공통 중간 스키마로 변환하는 어댑터 패턴 구현, 26개 필드 교차 대조 결과를 Rule 평가 이벤트 입력으로 연결하는 파이프라인 설계
Rule 백테스트 비동기 처리 구조 구현
BullMQ Worker로 과거 통관 데이터 소급 평가를 비동기 처리, 진행률 WebSocket 스트리밍 구현, 발화율·오탐률 집계로 Rule 품질 지표 산출 구조 설계
NestJS AOP 기반 투명 감사 로그 삽입 구축
Interceptor로 결재 API 호출 시 비즈니스 로직 수정 없이 audit_events 불변 레코드 자동 삽입 구현, 감사 이벤트 14종 분류 체계와 INSERT-only 테이블 설계
CQRS 패턴 기반 도메인 모듈 아키텍처 구현
NestJS CQRS 모듈로 통관 처리 커맨드와 조회 쿼리를 분리, 대시보드 집계 쿼리가 트랜잭션 워크플로우와 독립적으로 동작하는 아키텍처 설계
ExcelJS 구조화 보고서 자동 생성 구현
통관 심사 결과를 요약·Rule 발화·불일치 목록·감사 이력 4개 시트로 자동 구성, 위험도 등급별 조건부 서식 및 셀 병합 레이아웃 구현
핵심 기능
통합 통관 분석 대시보드
월별 통관 건수 추이, 위험도 분포, Rule 발화 빈도, 처리 소요 단계별 현황을 통합 조회
진행 단계
통관 도메인 모델링 및 NestJS 모듈 아키텍처 설계
2025.10.
수출입 통관 도메인 바운디드 컨텍스트 분석, NestJS 모듈 분리(OCR·Rule·Workflow·Report) 및 TypeORM 엔티티 42개 설계, CQRS 패턴 적용 구조 수립
프로젝트 상세
1) 포트폴리오 소개 수출입 통관 전 과정(서류 접수→OCR→다중 문서 대조→Rule 심사→위험도 산정→직책 승인→엑셀 보고서)을 하나의 플랫폼에서 처리하고, 통관 이력 분석 대시보드와 Rule 성과 통계를 함께 제공하는 엔터프라이즈 통관 관리 시스템을 React + NestJS 기반으로 설계·구현 2) 작업 범위 - 통합 통관 분석 대시보드: 월별 통관 건수 추이, 위험도 분포, Rule 발화 빈도
