플러스프로젝트 배경
1) 문제점 - 관광지·패키지·객실 3종 콘텐츠의 공통 필드와 유형별 특수 필드를 단일 테이블 상속(STI) 전략으로 설계하며 Pydantic 검증 스키마를 유형별로 분리 구성하는 구조 설계 필요 - 예약 문의 처리 상태 변경 시 역전 방지와 동시 관리자 수정 시 충돌 감지를 FastAPI 미들웨어 레이어에서 처리하는 동시성 제어 설계 필요 - 한국어 관광 콘텐츠 전문 검색에서 PostgreSQL tsv
프로젝트 성과
Pydantic v2 discriminated union 콘텐츠 스키마 설계
관광지·패키지·객실 3종 콘텐츠를 단일 Pydantic 기본 스키마에서 discriminated union으로 분기하여 FastAPI 라우터 중복을 최소화하고 타입별 필드 검증을 자동화하는 구조 설계
예약 문의 4단계 상태 머신 워크플로우 구현
접수→확인→답변→완료 4단계 전환을 FastAPI 의존성 주입 기반으로 구현하여 잘못된 상태 변경을 방지하고, SQLAlchemy 이벤트 리스너로 변경 이력을 자동 기록하는 구조 설계
PostgreSQL tsvector 한국어 전문 검색 인덱스 구현
tsvector + GIN 인덱스를 simple 토크나이저로 적용하여 관광지·패키지 콘텐츠의 한국어 키워드 검색을 SQLAlchemy 커스텀 타입으로 구현, 검색 결과 랭킹 정렬 적용
게시 기간 자동화 BackgroundTask 스케줄 설계
이벤트·프로모션 게시물의 시작일/종료일을 기준으로 자동 활성화·만료를 FastAPI BackgroundTask로 구현하고, PostgreSQL 부분 인덱스로 게시 중 콘텐츠 조회 최적화
React DnD 이미지 갤러리 낙관적 업데이트 구현
이미지 순서 드래그 변경 시 React Query 낙관적 업데이트로 UI를 즉시 반영하고, 서버 오류 시 자동 롤백하는 패턴을 DnD 이벤트와 연동하여 구현
핵심 기능
홈 대시보드
히어로 배너 인라인 KPI + 관광 콘텐츠 카드 그리드 현황을 확인하는 CMS 대시보드.
진행 단계
관광 콘텐츠 도메인 모델링 및 SQLAlchemy 스키마 설계
2025.03.
관광지·패키지·객실 3종 콘텐츠 유형과 예약 문의 데이터 구조를 SQLAlchemy 모델로 정의, Alembic 마이그레이션 전략 수립 및 PostgreSQL 10개 테이블 설계
프로젝트 상세
1) 포트폴리오 소개 관광지·리조트·패키지 상품을 소개하는 관광 포털 공식 웹사이트와 관리자 CMS를 설계·구현한 프로젝트입니다. 관광 콘텐츠 카탈로그 CMS, 예약 문의 4단계 처리 워크플로우, 뉴스/이벤트/프로모션 홍보 게시판, 한/영 다국어 지원을 포함한 풀스택 시스템을 Python + FastAPI + PostgreSQL + SQLAlchemy 기반으로 구축했습니다. 2) 작업 범위 - 홈 대
