플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 파트너사마다 배송 상태 코드 체계가 달라 내부 표준 상태로 정규화하는 매핑 테이블 및 변환 레이어 설계 - FastAPI WebSocket 연결이 끊어진 파트너사 헬스체크 구독자를 안전하게 정리하는 연결 관리 로직 구현 - 정산 승인 후 재처리 요청 시 이미 승인된 정산 데이터 불변성을 보장하는 상태 전환 잠금 설계 - CSV 스트리밍 중 DB 연결 오류 발생 시 클
프로젝트 성과
FastAPI 기반 복수 파트너사 배송 API 집계 파이프라인 설계
파트너사별로 상이한 배송 API를 FastAPI BackgroundTask로 주기 수집하고 PostgreSQL에 정규화 저장하는 집계 구조를 설계하고 구현.
PostgreSQL 집계 뷰 기반 정산 금액 자동 산출 구조 구현
배송 완료 건수와 파트너사 단가 테이블을 조인하는 집계 뷰를 설계하여 정산 금액 산출 쿼리를 단일화하고 정산 승인 워크플로우에 연결.
FastAPI WebSocket 파트너사 API 헬스체크 실시간 모니터링 구현
파트너사 API 연결 상태를 WebSocket으로 프론트에 실시간 전달하여 장애 발생 즉시 대시보드에 반영되는 모니터링 구조를 구현.
TanStack Table 가상 스크롤 기반 대용량 정산 명세 테이블 구현
수천 건의 정산 명세 데이터를 DOM 렌더링 부하 없이 표시하는 가상 스크롤 테이블을 TanStack Table로 구현.
FastAPI StreamingResponse CSV 스트리밍 다운로드 구현
대용량 배송·정산 데이터를 메모리 적재 없이 청크 단위로 전송하는 CSV 스트리밍 다운로드 엔드포인트를 FastAPI StreamingResponse로 구현.
핵심 기능
파트너 대시보드
전체 파트너사 배송·정산 현황을 집계하는 메인 대시보드
진행 단계
도메인 분석 및 데이터 모델 설계
2026.03.
물류 정산 도메인 분석, PostgreSQL 스키마 및 집계 뷰 설계
프로젝트 상세
1) 포트폴리오 소개 물류사가 여러 파트너 배송업체를 일원화하여 관리하는 B2B SaaS 어드민 플랫폼. 파트너사별 실시간 배송 현황 모니터링, 정산 내역 관리, 성과 리포트 자동 생성 기능을 FastAPI 백엔드와 React 프론트엔드로 구현. 2) 작업 범위 - 파트너 대시보드: 전체 파트너사 배송·정산 현황을 집계하는 메인 대시보드 - 파트너사 현황: 파트너사별 배송 현황 상세 조회 및 SLA
