플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 이벤트마다 접수 폼 항목 구조가 달라 단일 테이블에 모든 이벤트 응답을 저장하기 어려운 스키마 설계 문제 — 폼 항목 정의를 JSONB로 직렬화하고 응답 값도 JSONB 컬럼에 저장하는 유연한 스키마 구조 설계 - 로그인 없는 공개 토큰 URL 환경에서 동일 참가자의 중복 접수를 방지하면서 이벤트 정원 초과도 동시에 제어해야 하는 동시성 과제 — PostgreSQL SE
프로젝트 성과
token_urlsafe 기반 이벤트 단축 URL 자동 발급 구현
이벤트 등록 시 Python secrets.token_urlsafe로 고유 토큰 생성·단축 URL 발급, 서버사이드 QR코드 SVG 생성 후 PNG 변환 다운로드 지원
Celery + Redis 알림톡→SMS 폴백 발송 큐 구축
Celery 비동기 태스크로 알림톡 발송 시도 → 실패 시 SMS 자동 폴백 처리 구현, 태스크 ID를 클라이언트에 반환하여 폴링 기반 진행 상태 추적
FastAPI WebSocket 체크인 이벤트 실시간 브로드캐스트 구조 설계
FastAPI WebSocket ConnectionManager로 다중 운영자 클라이언트에 체크인 이벤트 브로드캐스트 구현, 연결 해제 시 자동 정리 및 재연결 로직으로 안정적인 실시간 현황 표시 구조 설계
동적 폼 항목 기반 CSV 컬럼 생성 로직 구현
이벤트별 JSONB 폼 정의를 읽어 응답 데이터의 커스텀 항목을 동적 CSV 컬럼으로 변환하는 Python 내보내기 로직 구현, 어떤 이벤트 형식에도 대응하는 범용 내보내기 파이프라인 설계
Pydantic v2 스키마 기반 비즈니스 검증 레이어 구축
날짜 범위·정원 초과·필수 항목 누락 등 이벤트 도메인 비즈니스 검증 규칙을 Pydantic v2 field_validator로 선언적 정의, 26개 API 엔드포인트 전체에 통일된 검증 레이어 적용
핵심 기능
이벤트 운영 현황
히어로 배너에 오늘 이벤트 체크인 현황 KPI를 표시하고, 이벤트별 접수율·응답 건수를 카드 그리드로 시각화하는 운영 메인 화면. 히어로 KPI + 이벤트 카드 그리드 + 실시간 체크인 피드 + 최근 응답 타임라인
진행 단계
이벤트-참가자-접수 도메인 모델링 및 FastAPI 프로젝트 구조 설계
2026.03.
이벤트·참가자·폼 항목·접수·발송 5개 도메인 SQLAlchemy 모델 설계, FastAPI 라우터 분리·Pydantic v2 스키마·의존성 주입 레이어 구조 확정
프로젝트 상세
1) 포트폴리오 소개 전시·컨퍼런스·팝업스토어 등 이벤트 현장의 참가자 사전 접수, QR 체크인, 현장 설문 수집을 URL 기반으로 처리하는 운영 플랫폼을 Python + FastAPI + PostgreSQL 기반으로 설계·구현할 예정. 이벤트별 단축 URL·QR 자동 생성, 로그인 없는 모바일 접수 폼, 알림톡 초대 발송, 실시간 체크인 현황 집계, CSV 내보내기를 포함한 풀스택 B2B SaaS 구조를
