플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 지도 드래그마다 API가 호출되어 요청이 폭주하는 문제를 React Query staleTime + 300ms 디바운싱 조합으로 해결 필요 - 주간·격주·월간 반복 예약이 특정 날짜에 겹치는지 판단하는 로직을 PostgreSQL 재귀 CTE로 DB 레이어에서 처리 필요 - pdfkit으로 계약서 PDF 생성 시 응답 지연 문제를 Celery 비동기 태스크 분리와 웹훅
프로젝트 성과
React Query 뷰포트 연동 검색 구조 설계
지도 이동 시 현재 뷰포트 좌표를 React Query 쿼리 키로 사용하여 자동 리페치되는 구조를 설계하고 300ms 디바운싱으로 API 호출을 최적화할 예정
FullCalendar + PostgreSQL 재귀 CTE 연동 구현
반복 예약 규칙(주간·월간)을 PostgreSQL 재귀 CTE로 날짜 시퀀스로 전개하고 FullCalendar 이벤트 포맷으로 변환하는 API를 구현할 예정
Celery 비동기 계약서 생성 파이프라인 구축
예약 확정 시 Celery 태스크로 pdfkit 계약서 생성 → S3 업로드 → 이메일 발송을 순차 처리하는 비동기 파이프라인을 구축할 예정
SQLAlchemy 낙관적 락 기반 동시 예약 방지 설계
동일 시간대 공간에 복수 예약 요청이 동시 도달하는 상황을 낙관적 락 버전 컬럼과 재시도 로직으로 처리하는 트랜잭션 구조를 설계할 예정
FastAPI OpenAPI 기반 계약 우선 개발 적용
FastAPI 자동 생성 OpenAPI 스펙을 기반으로 프론트엔드 mock 서버를 선행 구성하여 병렬 개발이 가능한 계약 우선 개발 구조를 적용할 예정
핵심 기능
공간 탐색 메인
지도와 리스트를 동시에 보여주는 스플릿 뷰 메인 화면 — 용도·면적·가격 필터로 공간 탐색
진행 단계
공간 임대 도메인 모델링 및 FastAPI 설계
2026.03.
공간·예약·계약·정산 도메인 ERD 설계, FastAPI OpenAPI 스펙 기반 계약 우선 API 28개 설계
프로젝트 상세
1) 포트폴리오 소개 네이버 지도 API 기반 위치 검색과 다중 조건 필터를 결합한 상업 공간 임대 중개 플랫폼을 React + Python FastAPI + PostgreSQL로 설계·구현할 예정. 공간 탐색부터 예약 문의, 호스트 관리 시스템, 자동 계약서 생성까지 임대 중개 전 과정을 커버하는 통합 시스템을 구축할 예정. 2) 작업 범위 - 공간 탐색 메인: 지도와 리스트를 동시에 보여주는 스플
