← 포트폴리오 목록
다중 고객사 서류 발급 관제 플랫폼
코드에프·틸코 등 복수 브로커 API를 통합해 여러 고객사의 등기부등본·건축물대장 발급 현황을 실시간으로 관제하는 확장 플랫폼을 FastAPI와 Celery 기반으로 설계합니다.
우선순위 재처리 큐 알고리즘 설계실패 사유·마감 임박도를 가중치로 환산한 우선순위 큐를 구현하여 재처리 순서를 자동 산정하는 로직을 설계합니다.
멀티 테넌트 API 키 체계 구축고객사별 API Key 발급, IP 화이트리스트, 브로커 예치금 잔액 추적을 통합한 접근 관리 모듈을 구현합니다.
PDF 리포트 자동 생성 파이프라인 구현jsPDF 기반 리포트 템플릿 엔진과 AWS S3 저장소를 연동해 발급 통계 리포트를 자동 발행하는 구조를 구축합니다.
Overview
프로젝트 개요
코드에프·틸코 등 복수 브로커 API를 통합해 여러 고객사의 등기부등본·건축물대장 발급 현황을 실시간으로 관제하는 확장 플랫폼을 FastAPI와 Celery 기반으로 설계합니다. 실패 건 우선순위 재처리, 고객사별 API 접근 관리, 발급 통계 리포트 자동 생성까지 포함한 운영 확장 프로젝트입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
다수 고객사의 API 호출이 동시에 몰릴 경우 브로커 API 레이트리밋을 초과할 리스크
고객사별 큐 우선순위와 스로틀링 정책으로 대응합니다
고객사별 예치금 잔액이 예고 없이 소진되어 발급이 중단될 리스크
잔액 임계치 알림과 자동 발급 일시 중지 로직으로 대응합니다
재처리 큐에서 동일 건이 중복 처리되는 리스크
멱등키 기반 중복 방지 로직으로 대응합니다
PDF 리포트 생성 중 대용량 데이터 집계로 처리 지연이 발생할 리스크
사전 집계 테이블과 비동기 리포트 생성 큐로 대응합니다
핵심 기능 1
실시간 발급 관제 현황판
전체 발급 요청의 처리 상태를 상태바로 확인하고 지연·실패 건을 즉시 식별할 수 있는 관제 화면입니다. 상태 스트립에 실시간 처리량을 인라인 지표로 표시하고, 핵심 타임라인에 배치별 진행 상황을 시각화합니다
핵심 기능 2
우선순위 재처리 큐
실패 사유별로 자동 분류된 발급 건을 마감 임박순으로 정렬해 일괄 재처리할 수 있는 화면입니다. Celery 우선순위 큐로 마감 임박 건을 먼저 처리하고, 멱등키로 중복 재처리를 방지합니다
핵심 기능 3
다중 고객사 API 접근 관리
고객사별 API Key 발급과 접근 IP 제한, 브로커 예치금 잔액 알림을 통합 관리하는 화면입니다. JWT 기반 API Key 발급·회수와 IP 화이트리스트 미들웨어로 접근을 제어합니다
핵심 기능 4
발급 리포트 자동 생성
일별·월별 발급 통계를 요약한 PDF 리포트를 자동 생성해 다운로드할 수 있는 화면입니다. jsPDF 기반 리포트 템플릿 엔진과 AWS S3 저장소를 연동해 리포트를 자동 발행합니다
구현 과정
프로젝트 진행 단계
STEP 1
멀티 테넌트 아키텍처 및 API 설계
고객사별 API Key 스키마 설계, 브로커 예치금 추적 테이블 및 권한 모델 정의
STEP 2
우선순위 재처리 엔진 개발
Celery 기반 우선순위 큐 구현, 실패 사유 분류 로직과 재처리 API 15여개 개발
STEP 3
관제 대시보드 및 리포트 기능 개발
React 기반 실시간 관제 화면 개발, jsPDF 리포트 자동 생성 모듈 구현
STEP 4
통합 테스트 및 성능 검증
다중 고객사 동시 처리 부하 테스트, 레이트리밋 대응 로직 검증
프로젝트 성과
우선순위 재처리 큐 알고리즘 설계실패 사유·마감 임박도를 가중치로 환산한 우선순위 큐를 구현하여 재처리 순서를 자동 산정하는 로직을 설계합니다.
멀티 테넌트 API 키 체계 구축고객사별 API Key 발급, IP 화이트리스트, 브로커 예치금 잔액 추적을 통합한 접근 관리 모듈을 구현합니다.
PDF 리포트 자동 생성 파이프라인 구현jsPDF 기반 리포트 템플릿 엔진과 AWS S3 저장소를 연동해 발급 통계 리포트를 자동 발행하는 구조를 구축합니다.
실시간 상태 스트립 집계 설계Redis Pub/Sub 기반 실시간 처리량 집계로 상태 스트립 인라인 지표를 초 단위로 갱신하는 구조를 설계합니다.
Review
기술적 주안점
- Redis Pub/Sub과 WebSocket을 결합한 실시간 관제 구조로 전체 발급 현황을 지연 없이 반영합니다
- 실패 사유와 마감 임박도를 가중치로 환산한 우선순위 큐를 구현하여 재처리 순서를 자동으로 산정합니다
- 고객사별 API 접근 권한과 브로커 예치금 잔액을 통합 관리하는 멀티 테넌트 보안 모듈을 설계합니다
