← 포트폴리오 목록
급여전표 자동연동 관제 시스템
더존 아마란스10 급여전표 API 연동부터 SAP·이카운트 전표 자동 생성, 업로드 실패 시 예외 파일 자동 변환까지 이어지는 회계 연동 파이프라인을 React와 Node.js 기반으로 설계·구현합니다.
더존 아마란스 API 연동 모듈 구현REST API 클라이언트로 급여전표 데이터 조회·파싱 로직 구현, 응답 스키마 검증 계층 설계
전표 매핑 규칙 엔진 설계급여 데이터→SAP/이카운트 컬럼 매핑을 규칙 테이블로 관리하는 동적 변환 엔진 구현
업로드 어댑터 패턴 구축Strategy 패턴으로 SAP API 전송과 이카운트 파일 업로드를 단일 인터페이스로 추상화
Overview
프로젝트 개요
더존 아마란스10 급여전표 API 연동부터 SAP·이카운트 전표 자동 생성, 업로드 실패 시 예외 파일 자동 변환까지 이어지는 회계 연동 파이프라인을 React와 Node.js 기반으로 설계·구현합니다. 급여 마감 이벤트를 트리거로 배치 처리가 자동 실행되어 수동 개입 없이 전표가 생성되는 구조를 구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
더존 아마란스10 급여전표 API 응답 스키마와 SAP·이카운트 업로드 양식 간 컬럼 매핑 규칙 설계
급여 마감 트리거 시점의 배치 처리 실패에 대비한 재시도 및 원자적 트랜잭션 처리
SAP·이카운트 두 타겟 시스템의 상이한 연동 방식(API vs 파일 업로드)을 흡수하는 어댑터 계층 설계
타겟 시스템 전송 실패 시 데이터 유실 없이 예외 파일로 자동 폴백하는 안전장치 설계
구현 내용
핵심 기능 상세
핵심 기능 1
더존 아마란스10 급여전표 연동 대시보드
관리자가 더존 아마란스10 API로 수신한 급여전표 데이터와 연동 상태를 대시보드에서 한눈에 확인할 수 있는 화면을 제공합니다
핵심 기능 2
급여 마감 자동 트리거 & 배치 처리
급여 마감 이벤트 발생 시 배치 처리가 자동으로 트리거되어 전표 생성 파이프라인이 수동 개입 없이 실행됩니다. Bull Queue 기반 스케줄러, 배치 실행 로그 테이블, 실패 시 재시도 정책을 구현합니다
핵심 기능 3
SAP·이카운트 전표 자동 생성
수신된 급여 데이터를 SAP 및 이카운트 업로드 양식에 맞춰 컬럼 매핑 규칙에 따라 자동으로 전표를 생성합니다. 매핑 규칙 테이블 기반 동적 변환 엔진과 생성 결과 미리보기 화면을 구현합니다
핵심 기능 4
업로드 상태 추적 & 예외처리 파일 다운로드
생성된 전표를 SAP·이카운트로 전송하고, 전송 실패 건은 예외 처리용 파일로 자동 변환해 다운로드할 수 있도록 제공합니다
구현 과정
프로젝트 진행 단계
STEP 1
더존 아마란스10 API 명세 분석 및 DB 스키마 설계
급여전표 API 응답 구조 분석, PostgreSQL 연동 로그·매핑 규칙 테이블 설계
STEP 2
API 연동 & 배치 트리거 모듈 개발
Axios 클라이언트, Bull Queue 기반 배치 스케줄러 및 재시도 정책 구현
STEP 3
전표 변환 엔진 & 업로드 어댑터 개발
매핑 규칙 기반 전표 생성 엔진, SAP·이카운트 업로드 어댑터 Strategy 패턴 구현
STEP 4
예외처리 및 통합 테스트
실패 건 예외 파일 자동 생성, 전체 파이프라인 통합 테스트 및 오류 시나리오 검증
프로젝트 성과
주요 성과
더존 아마란스 API 연동 모듈 구현REST API 클라이언트로 급여전표 데이터 조회·파싱 로직 구현, 응답 스키마 검증 계층 설계
전표 매핑 규칙 엔진 설계급여 데이터→SAP/이카운트 컬럼 매핑을 규칙 테이블로 관리하는 동적 변환 엔진 구현
업로드 어댑터 패턴 구축Strategy 패턴으로 SAP API 전송과 이카운트 파일 업로드를 단일 인터페이스로 추상화
배치 재시도 큐 아키텍처 구현Bull Queue 기반 배치 작업 재시도·백오프 정책 설계, 실패 건 예외 파일 자동 생성 연동
Review
기술적 주안점
- 더존 아마란스10 API 응답을 주기적으로 폴링하며 연동 상태를 sparkline 카드로 시각화하는 대시보드 구조를 설계합니다
- 급여 마감 이벤트를 트리거로 배치 파이프라인이 자동 실행되며, 각 단계의 진행 상태를 실시간 로그로 추적하는 구조를 구현합니다
- 급여 데이터를 SAP·이카운트 각각의 전표 양식으로 자동 변환하는 규칙 기반 엔진을 구현하며, 차대변 합계 검증으로 데이터 정확성을 확보합니다
