플러스프로젝트 배경
1) 문제점 - 객실·시설·다이닝 3종 시설의 공통 필드와 유형별 특수 필드(객실: 요금/시즌, 다이닝: 메뉴/운영시간)를 단일 테이블 상속으로 설계하며 Pydantic 검증을 유형별로 분리하는 구조 설계 필요 - 예약 문의 5단계 상태 변경 시 역전 방지와 동시 관리자 수정 충돌 감지를 FastAPI 미들웨어 레이어에서 처리하는 동시성 제어 및 낙관적 잠금 설계 필요 - 시즌별 요금 가중치가 객실 유형
프로젝트 성과
Pydantic v2 discriminated union 시설 유형 통합 스키마 설계
객실·시설·다이닝 3종 시설 유형을 단일 Pydantic 스키마에서 discriminated union으로 분기하여 유형별 필수 필드(객실: 수용인원/요금, 다이닝: 운영시간/메뉴)를 자동 검증하는 구조 설계
예약 문의 5단계 상태 머신 + 처리 타임라인 구현
접수→확인→상담→예약확정→완료 5단계 전환을 FastAPI 의존성 주입으로 검증하고, SQLAlchemy 이벤트 리스너로 변경 이력을 자동 기록하여 수직 타임라인 UI로 시각화하는 구조 설계
SQLAlchemy Hybrid Property 시즌별 요금 자동 산출 구현
객실 기본 요금 × 시즌 가중치(비수기 0.8/준성수기 1.0/성수기 1.5/극성수기 2.0) 계산을 SQLAlchemy Hybrid Property로 모델 레벨에서 구현
글래스모피즘 히어로 배너 + KPI 오버레이 대시보드 구현
CSS backdrop-filter:blur + linear-gradient 히어로 배너 위에 반투명 KPI 카드를 오버레이하고
FastAPI BackgroundTask 게시 기간 자동화 스케줄 설계
프로모션·이벤트 게시물의 시작일/종료일 기준 자동 활성화·만료를 BackgroundTask로 구현하고, PostgreSQL 부분 인덱스로 게시 중 콘텐츠 조회를 최적화하는 스케줄 아키텍처 설계
핵심 기능
홈 대시보드
히어로 배너 인라인 KPI + 예약 문의 현황 차트 + 시설 콘텐츠 카드 그리드 대시보드
진행 단계
리조트 시설 도메인 모델링 및 SQLAlchemy 스키마 설계
2025.08.
객실·시설·다이닝 3종 시설 유형과 예약 문의·프로모션 데이터 구조를 SQLAlchemy 모델로 정의, Alembic 마이그레이션 전략 수립 및 PostgreSQL 9개 테이블 설계
프로젝트 상세
1) 포트폴리오 소개 프리미엄 리조트의 홍보 웹사이트와 예약 문의 관리 시스템을 설계·구현한 프로젝트입니다. 풀스크린 히어로 비주얼 + 스크롤 애니메이션 랜딩, 객실/시설/다이닝 소개 섹션, 예약 문의 접수 폼 및 관리자 CMS, 시설 갤러리 관리와 프로모션 게시판을 Python + FastAPI + PostgreSQL + SQLAlchemy 기반으로 구축했습니다. 2) 작업 범위 - 홈 대시보드:
