프로젝트 배경
1) 예상 리스크 및 대응 계획 - HRM과 ERP 간 근태 코드 체계 불일치를 버전 관리 가능한 매핑 규칙으로 추상화하는 설계 - 급여 마감일 대량 요청 집중 시 FastAPI 비동기 처리와 Celery 분산 큐의 조합 구성 - pandas 데이터 변환 파이프라인에서 누락 필드·타입 오류를 행 단위로 격리하는 오류 처리 구조 구현 - Celery 워커 작업 상태를 WebSocket으로 브라우저에 실시
프로젝트 성과
FastAPI 비동기 급여 데이터 변환 파이프라인 구현
pandas와 FastAPI 비동기 처리를 조합하여 대용량 급여 파일을 응답 블로킹 없이 백그라운드 처리하는 파이프라인 구조를 설계 및 구현.
Celery + Redis 기반 분산 배치 큐 구성
급여 마감 시점 대량 작업을 Celery 워커로 분산 처리하고, beat 스케줄러로 주기적 자동 실행을 설정하는 배치 인프라를 구축.
매핑 규칙 버전 스냅샷 관리 구조 설계
MySQL 스냅샷 테이블로 매핑 규칙 버전을 보존하여 이전 버전으로 재처리가 가능한 이력 관리 구조를 설계 및 구현.
WebSocket 기반 실시간 작업 진행률 가시화 구현
FastAPI WebSocket으로 Celery 작업 진행 상태를 브라우저에 실시간 푸시하여 처리 현황을 즉시 확인할 수 있는 모니터링 인터페이스를 구현.
오류 유형별 집계 및 선택적 재처리 인터페이스 설계
SQLAlchemy 집계 쿼리와 Chart.js 시각화를 조합하여 연동 오류 원인을 빠르게 파악하고 선택적 재처리가 가능한 리포트 화면을 구현.
핵심 기능
진행 단계
HRM/ERP 데이터 구조 분석 및 스키마 설계
2026.03.
급여·근태 데이터 포맷 분석, MySQL 테이블 14개 정의, SQLAlchemy 모델 설계
프로젝트 상세
1) 포트폴리오 소개 인사 관리 시스템(HRM)의 급여·근태 데이터를 이카운트 ERP 표준 형식으로 자동 변환하고 일괄 연동하는 통합 플랫폼을 설계 및 구현. 반복적인 수작업 데이터 이관 프로세스를 자동화 파이프라인으로 대체하는 어드민 웹 시스템을 구축. 2) 작업 범위 - 급여 데이터 ERP 변환: HRM 시스템에서 추출한 급여·공제 데이터를 이카운트 ERP 회계 전표 형식으로 자동 변환하여 일괄







