← 포트폴리오 목록
부동산 공부서류 자동 발급 관리 시스템
부동산 등기부등본·건축물대장 등 공부서류를 코드에프·틸코 B2B 브로커 API와 연동해 자동화하는 발급 백엔드를 FastAPI와 Celery 기반으로 구현합니다.
브로커 API 발급 엔진 설계코드에프·틸코 REST API를 표준화한 어댑터 계층을 구현하여 브로커 교체·장애 시에도 발급 로직 영향을 최소화하도록 설계합니다.
배치 큐 재시도 아키텍처 구현Celery + Redis 기반 비동기 큐에 지수 백오프 재시도 정책을 적용하여 다건 발급 처리의 안정성을 높이는 구조를 구축합니다.
PDF 문서 파싱 파이프라인 설계pdfplumber 텍스트 추출과 규칙 기반 파서를 결합해 소유자·근저당권 등 핵심 항목을 JSON으로 구조화하는 파이프라인을 구현합니다.
Overview
프로젝트 개요
부동산 등기부등본·건축물대장 등 공부서류를 코드에프·틸코 B2B 브로커 API와 연동해 자동화하는 발급 백엔드를 FastAPI와 Celery 기반으로 구현합니다. 대량 발급 시에도 안정성을 유지하는 배치 큐 구조와 발급 문서 파싱, 통계 대시보드까지 포함한 풀스택 프로젝트입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
코드에프·틸코 브로커 API의 응답 지연이나 일시 장애 시 발급 요청이 지연될 리스크
재시도 큐와 대체 브로커 전환 로직으로 대응합니다
다건 주소 배치 처리 중 일부 건의 부분 실패가 전체 배치에 영향을 줄 리스크
건별 트랜잭션 격리와 실패 큐 분리로 대응합니다
지자체별로 상이한 PDF 서식에서 파싱 정확도가 떨어질 리스크
서식별 파서 룰과 OCR 폴백 경로로 대응합니다
대량 발급 시 브로커 API 호출 한도 초과로 요청이 거부될 리스크
큐 기반 속도 제한과 대기열 스로틀링으로 대응합니다
핵심 기능 1
발급 현황 통합 대시보드
관리자가 등기부등본·건축물대장 발급 건수와 처리 상태를 실시간으로 확인할 수 있는 통합 대시보드입니다
핵심 기능 2
브로커 API 자동 발급 엔진
주소·소유자 정보를 입력하면 코드에프·틸코 B2B API를 호출해 등기부등본·건축물대장을 자동 발급받는 화면입니다
핵심 기능 3
대량 발급 배치 큐 관리
다건 주소를 CSV로 업로드하면 순차·병렬로 자동 발급을 처리하고 진행 상황을 큐 단위로 확인할 수 있는 화면입니다
핵심 기능 4
발급 문서 파싱 및 구조화
발급된 PDF에서 소유자·근저당권·위반건축물 등 핵심 항목을 추출해 구조화된 데이터로 확인할 수 있는 화면입니다. pdfplumber 텍스트 추출과 규칙 기반 파서를 결합하고, 실패 시 OCR 폴백 경로를 거칩니다
구현 과정
프로젝트 진행 단계
STEP 1
요구사항 분석 및 브로커 API 연동 설계
코드에프·틸코 API 스펙 분석, 발급 도메인 ERD 설계 및 어댑터 인터페이스 정의
STEP 2
발급 엔진 및 배치 큐 개발
FastAPI 발급 엔드포인트 구현, Celery+Redis 기반 비동기 배치 큐 20여개 작업 정의
STEP 3
문서 파싱 및 대시보드 UI 개발
pdfplumber 파싱 파이프라인 구현, React 기반 발급 현황·배치 관리 화면 개발
STEP 4
통합 테스트 및 안정화
브로커 API 장애 시나리오 테스트, 재시도·타임아웃 정책 검증 및 성능 점검
프로젝트 성과
브로커 API 발급 엔진 설계코드에프·틸코 REST API를 표준화한 어댑터 계층을 구현하여 브로커 교체·장애 시에도 발급 로직 영향을 최소화하도록 설계합니다.
배치 큐 재시도 아키텍처 구현Celery + Redis 기반 비동기 큐에 지수 백오프 재시도 정책을 적용하여 다건 발급 처리의 안정성을 높이는 구조를 구축합니다.
PDF 문서 파싱 파이프라인 설계pdfplumber 텍스트 추출과 규칙 기반 파서를 결합해 소유자·근저당권 등 핵심 항목을 JSON으로 구조화하는 파이프라인을 구현합니다.
발급 통계 집계 대시보드 구현PostgreSQL 집계 쿼리와 Recharts로 일별·월별 발급 현황을 시각화하는 대시보드를 설계합니다.
Review
기술적 주안점
- PostgreSQL 집계와 Recharts 시각화를 결합해 발급 현황을 한 화면에서 파악할 수 있는 대시보드 구조를 설계합니다
- 브로커 API 어댑터 계층을 구현하여 브로커 교체나 장애 시에도 발급 로직 변경 없이 대응 가능한 구조를 설계합니다
- Celery 워커 풀과 Redis 브로커로 다건 발급을 병렬 처리하고, 실패 건만 별도 큐로 격리하는 구조를 구축합니다
