← 포트폴리오 목록
ERP 데이터 연동 자동화 콘솔
ERP·업무자동화 영역에서, 기간계 ERP의 MS-SQL 데이터를 추출·정제해 외부 API로 자동 전송하는 스케줄러와 전송 현황을 실시간으로 확인하는 웹 어드민 콘솔을 FastAPI + React 기반 풀스택으로 설계·구현합니다.
MS-SQL 청크 페이징 추출 엔진 구현대용량 테이블을 청크 단위로 분할 조회하는 페이징 로직 설계, DB 부하를 제어하는 커넥션 풀 관리 구현
14개 엔드포인트 전송 재시도 로직 설계지수 백오프 기반 재시도 정책 3단계 구현, 응답코드별 성공/실패 분기 처리와 전송 로그 테이블 설계
항목별 독립 스케줄러 구조 구축APScheduler 기반 14개 잡 독립 등록, DB 락으로 중복 실행 방지 로직과 KST 타임존 동기화 구현
Overview
프로젝트 개요
ERP·업무자동화 영역에서, 기간계 ERP의 MS-SQL 데이터를 추출·정제해 외부 API로 자동 전송하는 스케줄러와 전송 현황을 실시간으로 확인하는 웹 어드민 콘솔을 FastAPI + React 기반 풀스택으로 설계·구현합니다. 항목별 독립 스케줄, 재시도 로직, 수동 재전송까지 하나의 콘솔에서 운영할 수 있는 구조를 구축합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
MS-SQL 14개 메뉴별 스키마 편차를 흡수하는 공통 클렌징 규칙 엔진 설계
외부 API 엔드포인트별 상이한 인증 방식과 페이로드 규격을 통합 처리하는 어댑터 구조 설계
항목별 독립 스케줄 간 중복 실행과 타임존 불일치를 방지하는 락·동기화 전략
대용량 데이터 추출 시 ERP DB 부하를 제어하는 청크 크기·페이징 전략 설계
구현 내용
핵심 기능 상세
핵심 기능 1
실시간 전송 모니터링 대시보드
관리자가 로그인 직후 오늘의 API 전송 성공·실패·대기 현황과 스케줄 상태를 한 화면에서 확인합니다
핵심 기능 2
데이터 추출 및 클렌징 규칙 관리
관리자가 14개 주요 메뉴별 MS-SQL 추출 쿼리와 외부 API 규격에 맞춘 필드 매핑·클렌징 규칙을 화면에서 설정하고 미리봅니다
핵심 기능 3
외부 API 전송 로그 및 재시도
관리자가 14개 엔드포인트별 전송 이력을 조회하고, 실패 건을 선택해 즉시 수동으로 재전송합니다
핵심 기능 4
항목별 독립 스케줄러 관리
관리자가 항목별로 독립된 전송 주기를 설정하고, 중복 실행 방지와 타임존 동기화 상태를 확인합니다
구현 과정
프로젝트 진행 단계
STEP 1
ERP 연동 요구사항 분석 및 DB 스키마 설계
14개 메뉴별 MS-SQL 테이블 구조 분석, SQLAlchemy 모델 설계 및 외부 API 규격 매핑 정의
STEP 2
데이터 추출·클렌징 파이프라인 개발
FastAPI 기반 커넥션 풀 구성, 청크 페이징 추출 로직과 필드 매핑 클렌징 엔진 구현
STEP 3
API 전송 및 스케줄러 엔진 개발
14개 엔드포인트 인증·전송·재시도 로직 구현, APScheduler 기반 항목별 독립 주기 스케줄러 구축
STEP 4
웹 어드민 UI 개발 및 통합 테스트
React 기반 로그인·로그조회·수동재전송 화면 구현, 전송 시나리오 통합 테스트 진행
프로젝트 성과
주요 성과
MS-SQL 청크 페이징 추출 엔진 구현대용량 테이블을 청크 단위로 분할 조회하는 페이징 로직 설계, DB 부하를 제어하는 커넥션 풀 관리 구현
14개 엔드포인트 전송 재시도 로직 설계지수 백오프 기반 재시도 정책 3단계 구현, 응답코드별 성공/실패 분기 처리와 전송 로그 테이블 설계
항목별 독립 스케줄러 구조 구축APScheduler 기반 14개 잡 독립 등록, DB 락으로 중복 실행 방지 로직과 KST 타임존 동기화 구현
환경변수 기반 보안 관리 체계 설계DB 접속정보·API 키를 환경변수로 분리하고 암호화 저장, 접근 권한 계층 2단계 설계
Review
기술적 주안점
- 전송 로그 집계 API와 주기 갱신 기반 대시보드를 결합해, 관리자가 전송 상태를 즉시 파악할 수 있는 모니터링 구조를 구현합니다
- 메뉴별 추출 쿼리와 클렌징 규칙을 데이터로 관리해, 신규 메뉴 추가 시 코드 수정 없이 규칙만 등록하는 구조를 설계합니다
- 어댑터 패턴 기반 API 연동과 재시도 큐를 결합해, 엔드포인트 추가·변경에 유연하게 대응하는 전송 구조를 구현합니다
