← 포트폴리오 목록
장비 서비스콜 이메일 자동 접수 관제 시스템
고객 서비스콜 접수 이메일을 자동 파싱해 구조화된 데이터로 저장하고, 외부 ServiceNow 포털과의 REST API 연동으로 처리 상태 동기화를 자동화하는 B2B 내부 운영 관제 시스템을 React + Node.js 기반으로 설계·구현합니다.
방어적 이메일 파싱 규칙 엔진 설계정규식·키워드 기반 파싱 규칙을 모듈화하고 신뢰도 점수 산출 로직 구현, 포맷 변경에 유연하게 대응하는 구조 설계
외부 REST 연동 재시도 아키텍처 구현지수 백오프 재시도와 토큰 자동 재발급 모듈 분리, 실패 원인 원문 로깅으로 추적 가능한 연동 계층 설계
시리얼 기반 콜-장비 정합성 검증 구조 구축API 미들웨어 단에서 시리얼 대조를 강제해 계약 외 장비 콜 등록을 원천 차단하는 검증 계층 설계
Overview
프로젝트 개요
고객 서비스콜 접수 이메일을 자동 파싱해 구조화된 데이터로 저장하고, 외부 ServiceNow 포털과의 REST API 연동으로 처리 상태 동기화를 자동화하는 B2B 내부 운영 관제 시스템을 React + Node.js 기반으로 설계·구현합니다. 계약 장비 시리얼 대조와 실시간 콜 상태 모니터링, 연동 에러 로그 확인을 하나의 워크벤치 화면에서 처리할 수 있도록 구성합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
메일 본문 포맷이 발신처마다 상이해 파싱 규칙이 특정 포맷에 과적합되지 않
신뢰도 기반 분기 구조 설계 필요
외부 ITSM 플랫폼 API 스펙 변경/장애 시에도 콜 데이터 유실 없이 재전송 큐에 안전하게 적재하는 구조 설계
시리얼 넘버 오탈자·형식 불일치로 인한 오매칭을 방지하는 정규화·유사도 대조 로직 설계
핵심 기능 1
실시간 콜 접수 관제 대시보드
당일 접수된 서비스콜의 파싱 상태, 연동 전송 상태, 처리 대기 건수를 한 화면에서 실시간으로 파악합니다
핵심 기능 2
이메일 자동 파싱 및 장비 매핑
IMAP으로 수신한 서비스콜 접수 이메일에서 장비명, 시리얼 넘버, 담당자, 접수/종료 일시를 자동 추출해 구조화된 레코드로 저장합니다
핵심 기능 3
ServiceNow 연동 상태 및 재전송 관리
파싱 완료된 콜 데이터를 외부 ITSM 플랫폼의 REST API 규격(Table API 패턴)으로 변환해 전송하고, 처리 상태값 수신 결과를 목록에서 확인·재전송할 수 있습니다
핵심 기능 4
계약 장비 및 시리얼 검증 관리
계약 장비를 등록·수정·삭제하고, 접수된 콜의 시리얼 넘버가 유효 계약 장비인지 자동 대조 검증합니다
구현 과정
프로젝트 진행 단계
STEP 1
콜 처리 프로세스 분석 및 DB 스키마 설계
서비스콜 접수·파싱·전송 프로세스 분석, PostgreSQL 콜/장비/로그 테이블 18개 정의
STEP 2
이메일 파싱 엔진 및 REST 연동 API 개발
Nodemailer IMAP 워커, 정규식 파싱 규칙 엔진, Axios 기반 외부 REST 연동 모듈 구현
STEP 3
관제 대시보드 및 장비 관리 UI 개발
React 기반 콜 관제 대시보드, 장비 CRUD, 시리얼 대조 검증 화면 16개 구현
STEP 4
재전송 워크플로우 및 통합 테스트
재전송 큐 로직, 파싱 신뢰도 임계값 튜닝, API 통합 테스트 40개 케이스 작성
프로젝트 성과
방어적 이메일 파싱 규칙 엔진 설계정규식·키워드 기반 파싱 규칙을 모듈화하고 신뢰도 점수 산출 로직 구현, 포맷 변경에 유연하게 대응하는 구조 설계
외부 REST 연동 재시도 아키텍처 구현지수 백오프 재시도와 토큰 자동 재발급 모듈 분리, 실패 원인 원문 로깅으로 추적 가능한 연동 계층 설계
시리얼 기반 콜-장비 정합성 검증 구조 구축API 미들웨어 단에서 시리얼 대조를 강제해 계약 외 장비 콜 등록을 원천 차단하는 검증 계층 설계
Review
기술적 주안점
- 콜 처리 파이프라인의 각 단계(접수/파싱/전송/완료)를 상태 머신으로 모델링하여 대시보드 시각화와 백엔드 상태 전이 로직을 일치시키는 구조를 설계합니다
- 메일 본문 구조가 일정하지 않은 상황을 고려해, 파싱 실패를 예외로 던지지 않고 신뢰도 점수와 함께 저장하는 방어적 파싱 구조를 설계합니다
- 실제 외부 인스턴스 접근 없이도 검증 가능하도록 Table API 스펙을 준수한 mock 응답 서버를 함께 구성하여 요청/응답 계약을 데모로 재현합니다
