🏋️♀️ 서비스 개요
슈퍼핏은 피트니스 센터 운영에 필요한 모든 기능을 통합한 웹 애플리케이션입니다. 회원 관리, 수업 스케줄링, 수강권 관리, 직원 관리 등 피트니스 센터 운영의 모든 측면을 디지털화하여 효율적인 센터 운영을 지원합니다.
모노레포 구조로 설계되어 프론트엔드(Next.js), 백엔드(NestJS), 그리고 공통 컴포넌트들이 체계적으로 관리되며, 확장 가능하고 유지보수가 용이한 아키텍처를 제공합니다.
🎯 핵심 기능
👥 회원 관리
- 회원 등록 및 프로필 관리
- 회원 리스트 및 필터링
- 회원별 수업 이력 관리
- 회원 노트 및 상세 정보
- 센터 입장 신청 관리
📅 수업 관리
- 날짜별 수업 생성 및 관리
- 수업 스케줄 조회
- 수강 신청 및 확정 처리
- 출석 체크 및 관리
- 수업 일지 작성
🎫 수강권 관리
- 수강권 등록 및 수정
- 수강권 태그 관리
- 수강권 사용 내역 추적
- 수강권 유효성 검증
- 수강권 상세 정보 조회
👨💼 직원 관리
- 직원 등록 및 권한 관리
- 센터별 직원 배정
- 직원 정보 수정
- 마스터/일반 직원 구분
- 직원별 업무 관리
🏢 센터 관리
- 센터 등록 및 설정
- 센터 초대 코드 관리
- 센터 입장 신청 처리
- 센터 연동 관리
- 사업자 등록 관리
💳 구독 관리
- 구독 플랜 관리
- 7일 체험 서비스
- 구독 연장 및 갱신
- 구독 상태 추적
- 결제 관리
🔧 기술 스택
Frontend
Next.js
React
TypeScript
SCSS
Backend
NestJS
Node.js
TypeScript
MySQL
인증 & 보안
JWT
OAuth
카카오 로그인
실시간 통신
Socket.IO
WebSocket
개발 도구
Turbo
Yarn
ESLint
Prettier
🏗️ 시스템 아키텍처
프레젠테이션 계층
Next.js 기반 웹 애플리케이션 (mweb), 관리자 대시보드 (admin)
API 계층
NestJS 기반 RESTful API 서버, JWT 인증, Socket.IO 실시간 통신
비즈니스 로직 계층
회원관리, 수업관리, 수강권관리, 센터관리, 구독관리 서비스
데이터 계층
MySQL 데이터베이스, 데이터 백업 및 복구 시스템
👥 사용자 유형
🏢 센터 마스터
- 전체 센터 관리 권한
- 직원 관리 및 권한 설정
- 센터 설정 및 구독 관리
- 매출 및 통계 조회
👨💼 센터 직원
- 수업 생성 및 관리
- 회원 관리
- 수강권 발급 및 관리
- 출석 체크 및 일지 작성
🏃♀️ 센터 회원
- 수업 조회 및 신청
- 나의 수업 및 수강권 확인
- 수업 일지 조회
- 센터 직원 정보 확인
📱 주요 페이지
홈 & 대시보드
- 직원 전용 홈 (/home/partner)
- 회원 전용 홈 (/home/user)
- 프로필 페이지 (/profile)
수업 관리
- 수업 생성 (/class/create)
- 수업 리스트 (/class/list)
- 수업 일지 (/class/journal)
- 스케줄 페이지 (/schedule)
회원 & 직원
- 회원 리스트 (/user/list)
- 회원 상세 (/user/[id])
- 직원 리스트 (/staff/list)
- 직원 관리 폼
수강권 & 센터
- 수강권 등록 (/ticket/register)
- 수강권 상세 (/ticket/view)
- 센터 관리 (/manage)
- 공지사항 (/notice)
🚀 특장점
📦 모노레포 구조
Turbo를 활용한 모노레포 구조로 프론트엔드, 백엔드, 공통 패키지들을 효율적으로 관리하며, 코드 재사용성과 개발 생산성을 극대화했습니다.
🔄 실시간 업데이트
Socket.IO를 통한 실시간 통신으로 수업 신청, 확정, 취소 등의 상태 변화를 즉시 반영하여 사용자 경험을 향상시켰습니다.
🔐 강력한 보안
JWT 기반 인증과 OAuth 소셜 로그인을 지원하며, 역할 기반 접근 제어로 데이터 보안을 보장합니다.
📊 체계적인 데이터 관리
정규화된 데이터베이스 설계와 정기적인 백업 시스템으로 안정적인 데이터 관리를 제공합니다.