프로젝트 개요
MVP 이후 운영 확장을 위한 관리자 웹 콘솔 프로젝트입니다. 코치 심사·승인, 미성년 회원 현황, 코치별 AI 호출량·비용 집계, 알림 규칙 관리를 Next.js와 FastAPI로 설계·구현합니다. P1 스택에 Redis 캐시와 AWS S3 파일 저장을 더한 구조입니다.
작업 범위
- 관리자 대시보드: 회원·코치 현황과 미성년 회원 비중을 한눈에 보고 항목을 선택하면 상세가 우측에 펼쳐지는 화면입니다
- 코치 심사·승인: 등록된 코치 프로필의 종목·경력·사진을 검토하고 승인 또는 보완 요청을 처리하는 화면입니다
- AI 호출량·비용 관리: 코치별 AI 레슨노트 호출 한도를 설정하고 호출량과 비용 추정치를 집계해 보는 화면입니다
- 알림 규칙 관리: 문의·확정·레슨 전 안내·노트 등록 알림의 발송 조건과 채널을 규칙으로 설정하는 화면입니다
주요 업무
- 관리자 대시보드 화면: 목록과 상세를 한 화면에 두는 마스터-디테일 구조로 모달 사용을 줄입니다
- 코치 심사·승인 화면: 심사 상태 전이와 처리 이력을 감사 테이블에 기록합니다
- AI 호출량·비용 관리 화면: 호출 로그를 일 단위로 집계하고 한도 초과 시 요청을 대기열에서 보류합니다
- 알림 규칙 관리 화면: 규칙 테이블과 발송 대기열을 분리하여 채널별 재시도를 관리합니다



프로젝트 핵심 과제
미성년 회원 정보를 암호화하면서 관리자 화면에서 접근 기록을 남기는 조회 구조 설계
코치별 호출량 집계와 한도 제어가 동시에 갱신될 때 카운터 정합성 확보 설계
심사 일괄 승인 시 일부 실패가 발생해도 이력이 일관되
트랜잭션 경계 설계 필요
앱 푸시·이메일 채널별 발송 실패를 규칙 단위로 추적하는 재시도 구조 설계
핵심 기능 상세
관리자 대시보드
회원·코치 현황과 미성년 회원 비중을 한눈에 보고 항목을 선택하면 상세가 우측에 펼쳐지는 화면입니다. 목록과 상세를 한 화면에 두는 마스터-디테일 구조로 모달 사용을 줄입니다.
- Materialized View로 회원·코치 집계 쿼리 구성
- 미성년 회원 목록 필터와 보호자 동의 상태 배지 표시
- Redis 캐시로 대시보드 집계 조회 구조 설계
집계 뷰와 캐시를 조합하여 회원 현황 조회 구조를 설계하고 목록·상세를 인라인으로 연결합니다.


코치 심사·승인
등록된 코치 프로필의 종목·경력·사진을 검토하고 승인 또는 보완 요청을 처리하는 화면입니다. 심사 상태 전이와 처리 이력을 감사 테이블에 기록합니다.
- 심사 상태 머신(대기·보완·승인·반려)과 이력 테이블 설계
- AWS S3 사전 서명 URL로 증빙 사진 열람 구조 구성
- 일괄 승인 시 트랜잭션 단위 처리
심사 상태 전이를 감사 이력과 함께 기록하고 승인된 프로필만 공개되도록 구현합니다.


AI 호출량·비용 관리
코치별 AI 레슨노트 호출 한도를 설정하고 호출량과 비용 추정치를 집계해 보는 화면입니다. 호출 로그를 일 단위로 집계하고 한도 초과 시 요청을 대기열에서 보류합니다.
- 호출 로그 테이블과 코치별 일 집계 뷰 설계
- 한도 설정값을 Redis 카운터와 대조하는 호출 제한 구조
- Recharts 막대·라인 차트로 호출량 추이 시각화
코치별 한도와 호출 집계를 연결하여 한도 도달 시 호출이 보류되는 구조를 구현합니다.


알림 규칙 관리
문의·확정·레슨 전 안내·노트 등록 알림의 발송 조건과 채널을 규칙으로 설정하는 화면입니다. 규칙 테이블과 발송 대기열을 분리하여 채널별 재시도를 관리합니다.
- 이벤트 유형별 알림 규칙 테이블과 채널 설정 구조 설계
- Redis 기반 발송 대기열과 채널별 재시도 정책
- 알림 발송 로그와 규칙 미리보기 화면 구성
이벤트 규칙과 발송 대기열을 분리하여 앱 푸시·이메일 채널을 규칙 단위로 관리하도록 설계합니다.


프로젝트 진행 단계
관리자 권한 모델 및 집계 스키마 설계 · 2026.10
관리자 역할 구분, 호출 로그·심사 이력 테이블과 집계 뷰 정의
심사·회원 관리 API 구현 · 2026.10
FastAPI 기반 코치 심사 상태 전이, 회원 정지·탈퇴 API 구현
호출량 집계 및 한도 제어 개발 · 2026.10
Redis 카운터 기반 한도 제어와 Recharts 호출량 차트 구현
알림 규칙 엔진 및 통합 점검 · 2026.10
규칙·대기열 분리 구조 구현, S3 파일 열람 구성 점검
개발 결과
기술적 주안점
- 집계 뷰와 캐시를 조합하여 회원 현황 조회 구조를 설계하고 목록·상세를 인라인으로 연결합니다
- 심사 상태 전이를 감사 이력과 함께 기록하고 승인된 프로필만 공개되도록 구현합니다
- 코치별 한도와 호출 집계를 연결하여 한도 도달 시 호출이 보류되는 구조를 구현합니다