플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - FastAPI 앱과 Celery 워커가 별도 프로세스로 실행되어 DB 세션과 Redis 연결을 공유하는 구성이 복잡할 리스크가 있으며, SQLAlchemy 비동기 세션 팩토리를 각 워커 초기화 시 독립 생성하는 방식으로 대응할 계획입니다. - 1,000건 중 일부 자동이체 요청이 실패할 경우 전체 롤백 vs 부분 커밋 정책 결정이 까다로울 리스크가 있으며, 건별 독립 트
프로젝트 성과
APScheduler + Celery 이중 비동기 처리 구조 구현
APScheduler로 월별 자동이체 배치를 등록하고, Celery + Redis로 미납자 SMS 발송을 비동기 큐로 처리하는 이중 비동기 아키텍처를 FastAPI와 통합하여 설계합니다.
PostgreSQL CTE 계층 쿼리 구조 설계
강좌→반→수강생 3단계 계층 데이터를 CTE 재귀 쿼리로 단일 DB 호출로 조회하고, Pydantic v2 중첩 모델로 직렬화하는 고효율 API 구조를 구현합니다.
WebSocket 실시간 배치 진행률 브로드캐스트 구현
FastAPI WebSocket으로 배치 처리 진행 상황을 실시간 브로드캐스트하고, 커스텀 useWebSocket 훅으로 연결 끊김 자동 재연결과 진행률 프로그레스바 동기화를 구현합니다.
openpyxl 엑셀 배치 등록 및 오류 반환 설계
수강생 엑셀 업로드 시 행 단위 유효성 검증 후 성공·실패 결과를 오류 사유 열이 추가된 결과 엑셀로 반환하는 배치 등록 API를 Python openpyxl로 구현합니다.
핵심 기능
수강생 현황
전체 수강생 수, 이번 달 결제 완료율, 미납 현황, 강좌별 등록 현황을 한눈에 파악하는 운영 대시보드. 월별 수강료 납부 추이와 강좌별 수강생 분포를 차트로 시각화합니다
진행 단계
학원 도메인 ERD 설계 및 환경 구성
2026.04.
강좌·반·수강생·강사 계층 구조 ERD 설계, FastAPI + PostgreSQL + Redis 개발 환경 구성, Alembic 마이그레이션 초기화
프로젝트 상세
1) 포트폴리오 소개 학원 수강료 정기결제 자동이체와 수강생 통합 CRM 관리를 구현한 기술 데모입니다. 효성CMS 유사 정기결제 배치 처리, FastAPI 기반 고성능 API, 수강생·반·강사 계층 관리, 미납자 SMS 알림 자동화까지 어린이집 CRM 프로젝트의 핵심 기술을 학원 도메인에 적용하여 구현 역량을 증명합니다. 2) 작업 범위 - 수강생 현황: 전체 수강생 수, 이번 달 결제 완료율, 미
