← 포트폴리오 목록

스포츠 레슨 플랫폼 관리자 콘솔

MVP 이후 운영 확장을 위한 관리자 웹 콘솔 프로젝트입니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종데이터 분석
기술 스택
Next.jsTypeScriptTailwind CSSRechartsFastAPIPostgreSQLSQLAlchemyRedisAWS S3
주요 기능
  • 관리자 대시보드
  • 코치 심사·승인
  • AI 호출량·비용 관리
  • 알림 규칙 관리

프로젝트 개요

범위: 개발, 디자인, 기획

MVP 이후 운영 확장을 위한 관리자 웹 콘솔 프로젝트입니다. 코치 심사·승인, 미성년 회원 현황, 코치별 AI 호출량·비용 집계, 알림 규칙 관리를 Next.js와 FastAPI로 설계·구현합니다. P1 스택에 Redis 캐시와 AWS S3 파일 저장을 더한 구조입니다.

작업 범위

  • 관리자 대시보드: 회원·코치 현황과 미성년 회원 비중을 한눈에 보고 항목을 선택하면 상세가 우측에 펼쳐지는 화면입니다
  • 코치 심사·승인: 등록된 코치 프로필의 종목·경력·사진을 검토하고 승인 또는 보완 요청을 처리하는 화면입니다
  • AI 호출량·비용 관리: 코치별 AI 레슨노트 호출 한도를 설정하고 호출량과 비용 추정치를 집계해 보는 화면입니다
  • 알림 규칙 관리: 문의·확정·레슨 전 안내·노트 등록 알림의 발송 조건과 채널을 규칙으로 설정하는 화면입니다

주요 업무

  • 관리자 대시보드 화면: 목록과 상세를 한 화면에 두는 마스터-디테일 구조로 모달 사용을 줄입니다
  • 코치 심사·승인 화면: 심사 상태 전이와 처리 이력을 감사 테이블에 기록합니다
  • AI 호출량·비용 관리 화면: 호출 로그를 일 단위로 집계하고 한도 초과 시 요청을 대기열에서 보류합니다
  • 알림 규칙 관리 화면: 규칙 테이블과 발송 대기열을 분리하여 채널별 재시도를 관리합니다
스포츠 레슨 플랫폼 관리자 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

미성년 회원 정보를 암호화하면서 관리자 화면에서 접근 기록을 남기는 조회 구조 설계

코치별 호출량 집계와 한도 제어가 동시에 갱신될 때 카운터 정합성 확보 설계

심사 일괄 승인 시 일부 실패가 발생해도 이력이 일관되

트랜잭션 경계 설계 필요

앱 푸시·이메일 채널별 발송 실패를 규칙 단위로 추적하는 재시도 구조 설계

구현 내용

핵심 기능 상세

핵심 기능 1

관리자 대시보드

회원·코치 현황과 미성년 회원 비중을 한눈에 보고 항목을 선택하면 상세가 우측에 펼쳐지는 화면입니다. 목록과 상세를 한 화면에 두는 마스터-디테일 구조로 모달 사용을 줄입니다.

  • Materialized View로 회원·코치 집계 쿼리 구성
  • 미성년 회원 목록 필터와 보호자 동의 상태 배지 표시
  • Redis 캐시로 대시보드 집계 조회 구조 설계

집계 뷰와 캐시를 조합하여 회원 현황 조회 구조를 설계하고 목록·상세를 인라인으로 연결합니다.

관리자 대시보드
관리자 대시보드 실제 화면
핵심 기능 2

코치 심사·승인

등록된 코치 프로필의 종목·경력·사진을 검토하고 승인 또는 보완 요청을 처리하는 화면입니다. 심사 상태 전이와 처리 이력을 감사 테이블에 기록합니다.

  • 심사 상태 머신(대기·보완·승인·반려)과 이력 테이블 설계
  • AWS S3 사전 서명 URL로 증빙 사진 열람 구조 구성
  • 일괄 승인 시 트랜잭션 단위 처리

심사 상태 전이를 감사 이력과 함께 기록하고 승인된 프로필만 공개되도록 구현합니다.

코치 심사·승인
코치 심사·승인 실제 화면
핵심 기능 3

AI 호출량·비용 관리

코치별 AI 레슨노트 호출 한도를 설정하고 호출량과 비용 추정치를 집계해 보는 화면입니다. 호출 로그를 일 단위로 집계하고 한도 초과 시 요청을 대기열에서 보류합니다.

  • 호출 로그 테이블과 코치별 일 집계 뷰 설계
  • 한도 설정값을 Redis 카운터와 대조하는 호출 제한 구조
  • Recharts 막대·라인 차트로 호출량 추이 시각화

코치별 한도와 호출 집계를 연결하여 한도 도달 시 호출이 보류되는 구조를 구현합니다.

AI 호출량·비용 관리
AI 호출량·비용 관리 실제 화면
핵심 기능 4

알림 규칙 관리

문의·확정·레슨 전 안내·노트 등록 알림의 발송 조건과 채널을 규칙으로 설정하는 화면입니다. 규칙 테이블과 발송 대기열을 분리하여 채널별 재시도를 관리합니다.

  • 이벤트 유형별 알림 규칙 테이블과 채널 설정 구조 설계
  • Redis 기반 발송 대기열과 채널별 재시도 정책
  • 알림 발송 로그와 규칙 미리보기 화면 구성

이벤트 규칙과 발송 대기열을 분리하여 앱 푸시·이메일 채널을 규칙 단위로 관리하도록 설계합니다.

알림 규칙 관리
알림 규칙 관리 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

관리자 권한 모델 및 집계 스키마 설계 · 2026.10

관리자 역할 구분, 호출 로그·심사 이력 테이블과 집계 뷰 정의

STEP 2

심사·회원 관리 API 구현 · 2026.10

FastAPI 기반 코치 심사 상태 전이, 회원 정지·탈퇴 API 구현

STEP 3

호출량 집계 및 한도 제어 개발 · 2026.10

Redis 카운터 기반 한도 제어와 Recharts 호출량 차트 구현

STEP 4

알림 규칙 엔진 및 통합 점검 · 2026.10

규칙·대기열 분리 구조 구현, S3 파일 열람 구성 점검

개발 결과

마스터-디테일 관리 화면 구조 구축목록 선택 시 우측 상세가 인라인으로 펼쳐지는 구조를 4개 관리 화면에 공통 컴포넌트로 적용합니다
코치 심사 상태 머신과 감사 이력 설계대기·보완·승인·반려 전이를 제약하고 처리자·시각을 감사 테이블에 기록하는 구조를 설계합니다
코치별 AI 호출 한도 제어 구조 구현Redis 카운터와 일 집계 뷰를 연결해 한도 도달 시 호출을 보류하는 로직을 구현합니다
이벤트 기반 알림 규칙 엔진 설계이벤트·채널·시점 규칙과 발송 대기열을 분리해 채널별 재시도를 관리하는 구조를 구축합니다

기술적 주안점

  • 집계 뷰와 캐시를 조합하여 회원 현황 조회 구조를 설계하고 목록·상세를 인라인으로 연결합니다
  • 심사 상태 전이를 감사 이력과 함께 기록하고 승인된 프로필만 공개되도록 구현합니다
  • 코치별 한도와 호출 집계를 연결하여 한도 도달 시 호출이 보류되는 구조를 구현합니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의