← 포트폴리오 목록
캠핑장 통합 운영 관제 콘솔
MVP 예약 플랫폼 이후, 업체 정보를 CRUD로 관리하고 예약 발생 시 담당자에게 즉시 알림을 전달해 확인·업체 연락·최종 확정까지 이어지는 관리자 대시보드를 구현합니다.
예약 처리 상태 머신 설계접수-확인중-업체연락-확정 4단계 전이 규칙을 서버에서 강제하는 상태 머신 구현
실시간 알림 동기화 구조 구현SSE + Redis Pub/Sub으로 다중 담당자 세션 간 알림·처리 상태를 동기화하는 구조 설계
매출 집계 파이프라인 설계PostgreSQL Materialized View 기반 일별·주별 매출 집계 테이블 구현, 조회 구조 단순화
Overview
프로젝트 개요
MVP 예약 플랫폼 이후, 업체 정보를 CRUD로 관리하고 예약 발생 시 담당자에게 즉시 알림을 전달해 확인·업체 연락·최종 확정까지 이어지는 관리자 대시보드를 구현합니다. 예약·매출 분석까지 통합하는 운영 콘솔을 함께 설계합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
여러 담당자가 동시에 같은 예약 건을 확인·배정할 때 발생할 수 있는 경합 조건을 낙관적 잠금으로 제어할 필요가 있습니다
업체 정보 삭제 시 연결된 활성 예약과의 참조 무결성을 유지하는 제약 조건 설계가 필요합니다
실시간 알림 채널이 재접속되는 경우 놓친 알림을 유실 없이 재전달하는 복구 로직이 필요합니다
매출 집계용 Materialized View의 갱신 주기와 실시간 예약 반영 사이의 정합성을 관리할 필요가 있습니다
구현 내용
핵심 기능 상세
핵심 기능 1
예약 확정 알림 관제 대시보드
신규 예약이 발생하면 담당자 대시보드에 실시간 알림이 표시되고, 확인 전까지 처리 대기 큐에 남아 상태가 추적됩니다
핵심 기능 2
캠핑장 업체 정보 등록·관리
캠핑장·사이트·편의시설 등 업체 정보를 등록, 수정, 삭제, 목록 조회할 수 있는 관리 화면을 제공합니다. 업체 정보 CRUD API, 이미지 다중 업로드, 사이트별 요금·정원 설정 폼
핵심 기능 3
예약 확정 처리 흐름
담당자가 알림을 확인한 뒤 업체에 연락하고 최종 확정 처리하는 단계별 워크플로우 화면입니다. 단계별 상태 전이 API, 처리 담당자 배정, 확정/보류/거절 사유 기록
핵심 기능 4
예약·매출 분석 대시보드
기간별 예약 건수, 매출, 인기 캠핑장 순위를 차트로 확인할 수 있는 분석 화면입니다. Materialized View 기반 집계 테이블, 기간 필터 차트, 캠핑장별 매출 순위 테이블
구현 과정
프로젝트 진행 단계
STEP 1
업체 CRUD 및 권한 모델 설계
업체·사이트·담당자 테이블 설계, 업체 등록 폼과 이미지 업로드 API 구현
STEP 2
실시간 알림 인프라 구축
SSE 알림 채널과 Redis Pub/Sub 동기화 구조 구현, 처리 상태 머신 설계
STEP 3
예약 확정 워크플로우 개발
담당자 배정·상태 전이 API 구현, 낙관적 잠금 기반 동시 처리 충돌 방지 로직 적용
STEP 4
매출 분석 대시보드 개발
Materialized View 집계 설계, Recharts 기반 기간별 예약·매출 차트 구현
프로젝트 성과
주요 성과
예약 처리 상태 머신 설계접수-확인중-업체연락-확정 4단계 전이 규칙을 서버에서 강제하는 상태 머신 구현
실시간 알림 동기화 구조 구현SSE + Redis Pub/Sub으로 다중 담당자 세션 간 알림·처리 상태를 동기화하는 구조 설계
매출 집계 파이프라인 설계PostgreSQL Materialized View 기반 일별·주별 매출 집계 테이블 구현, 조회 구조 단순화
업체 등록 폼 검증 체계 구축Zod 스키마 기반 다단계 유효성 검증과 S3 presigned URL 이미지 업로드 결합 구현
Review
기술적 주안점
- SSE와 Redis Pub/Sub을 결합해 신규 예약 발생부터 최종 확정까지의 처리 흐름을 실시간 관제 타임라인으로 구현하고, 다중 담당자가 동시 접속해도 중복 확인이 발생하지 않는 구조를 설계합니다
- 다단계 유효성 검증과 이미지 업로드를 결합한 업체 등록 폼을 구현해, 캠핑장 단위뿐 아니라 사이트 단위 세부 정보까지 하나의 흐름에서 관리할 수 있는 구조를 설계합니다
- 상태 머신 기반 전이 규칙과 낙관적 잠금을 결합해, 여러 담당자가 동시에 업무를 처리해도 하나의 예약 건이 중복 배정되지 않는 확정 워크플로우를 구현합니다
