Scheduly

수강생들의 스케쥴을 효율적으로 관리할 수 있는 관리자용 백오피스 시스템입니다.
Google Calendar 스타일의 달력 UI를 기반으로 수강생 개별 스케쥴을 관리할 수 있습니다.

📌 프로젝트 개요

이 프로젝트는 학원 관리자들이 수강생들의 스케쥴을 손쉽게 등록, 수정, 조회할 수 있도록 돕는 웹 애플리케이션입니다.
주요 기능은 다음과 같습니다:

• 수강생 정보 등록 및 관리
• 수강생 주간/월간 수업 스케쥴 등록 및 캘린더 조회
• 수강생 상태(졸업, 탈퇴 등) 기반 스케쥴 제어

---

🧱 기술 스택

계층	기술 스택
프론트엔드	Next.js, Tailwind CSS, shadcn/ui, FullCalendar
백엔드	NestJS + TypeScript, Prisma, MySQL
인증	JWT
캘린더 반복 처리	rrule.js

🔒 정책

수강생 상태 (state)

• NORMAL : 정상 수강 중인 수강생
• GRADUATE : 졸업 처리된 수강생
• DELETED : 탈퇴 처리된 수강생 (관리자 전용 목록에서만 확인 가능)

GRADUATE, DELETED 상태의 수강생은 스케쥴 등록 시 선택 불가

수강생 유형 (type)

• EXAMINEE : 입시생
• DROPPER : 재수생
• ADULT : 성인 수강생

---

🖥️ 관리자 백오피스 기능

1. 로그인

• 관리자 로그인 (아이디 / 패스워드 기반)

---

2. 수강생 관리

📄 수강생 목록

• 목록 정보: ID, 상태, 유형, 이름, 지역, 총 수강시간
• 기본 페이지 사이즈: 20
• 정렬: ID 내림차순(desc), 상태는 NORMAL 우선 노출

➕ 수강생 등록

• 필수 항목: ID, 이름, 상태, 지역, 나이, 설명, 수업 시작일, 수업 종료일, 유형, 학부모 정보, 전화번호

🛠️ 수강생 수정

• 수정 가능 항목: 이름, 상태, 지역, 나이, 설명, 수업 시작/종료일, 유형, 학부모 정보, 전화번호

🔍 수강생 조회

• 상세 정보: ID, 이름, 상태, 유형, 지역, 나이, 설명, 수업 시작/종료일, 학부모 정보, 전화번호
• 주간 스케쥴 정보 포함

🎓 수강생 졸업

• 상태를 GRADUATE로 변경
• 스케쥴 등록 시 노출되지 않음

❌ 수강생 탈퇴

• 상태를 DELETED로 변경
• 스케쥴 등록 시 노출되지 않음

---

3. 스케쥴 관리

📅 스케쥴 목록

• 월별 보기 제공
• Google Calendar 유사한 UI 제공

🔎 스케쥴 조회

• 항목: 수강생 이름, 날짜 및 시간, 반복 옵션
• 수강생 이름 클릭 시 수강생 상세 조회로 이동

➕ 스케쥴 등록

• 수강생: 등록 시 검색/선택
• 날짜 및 시간: 30분 단위 등록 가능 (예: 13:30 ~ 15:00)
• 반복 옵션:
  • 해당 일정만
  • 매주 반복 등록

🛠️ 스케쥴 수정

• 과거 날짜의 스케쥴은 수정 불가
• 수정 가능 항목: 시간, 수강생, 반복 옵션
• 반복 수정 옵션:
  • 선택한 일정만 수정
  • 이후 일정 일괄 수정

❌ 스케쥴 삭제

• 과거 날짜의 스케쥴은 삭제 불가
• 삭제 옵션:
  • 선택한 일정만 삭제
  • 이후 일정 일괄 삭제

---

🚀 향후 개선 예정

• 수강생 알림 기능 연동
• 수업료 기능 추가
• 수업 후 피드백 기능 추가
• 수강생 UI 기능 추가

---

📂 프로젝트 설정 및 실행

(이 섹션은 사용한 기술스택에 따라 추후 추가 작성)