프로젝트 소개

피아노플러스는 피아노 학원 프랜차이즈를 위한 통합 관리 시스템입니다. 본사 관리자, 학원(원장/강사), 학생, 그리고 브랜드 홈페이지까지 4개의 웹사이트를 운영하며, 이번에는 관리자 포털의 핵심 기능들을 구현했습니다.

---

이번에 만든 기능들

---

1. 학원/결제/정산/악보 — 실제 데이터 연동

그동안 화면에 보이던 데이터는 개발용 임시 데이터(더미)였습니다. 이번에 실제 서버와 연결하여 진짜 데이터가 오가도록 만들었습니다.

학원 관리

학원 목록 조회, 신규 학원 등록, 정보 수정, 삭제

결제 관리

결제 내역 조회, 결제 취소, 환불 처리

정산 관리

학원별 정산 요청 확인, 승인 또는 반려

악보 관리

악보 등록, 수정, 삭제, 카테고리/난이도별 검색

---

2. 공통코드 관리

"결제완료", "취소", "초급", "클래식" 같은 상태값이나 분류값을 공통코드로 한 곳에서 관리하도록 만들었습니다.

코드를 한 번만 정의하면 학원 사이트, 학생 사이트, 브랜드 사이트 등 모든 곳에서 동일하게 사용됩니다. 나중에 코드 이름이나 항목이 바뀌어도 한 곳만 수정하면 전체에 반영됩니다.

---

3. 메뉴 관리 — 사이드바를 자유롭게 편집

관리자 화면 왼쪽의 메뉴(사이드바)가 기존에는 코드에 고정되어 있어서, 메뉴를 추가하거나 순서를 바꾸려면 개발자가 직접 코드를 수정해야 했습니다.

이제는 메뉴 관리 화면에서 직접 메뉴를 추가/수정/삭제할 수 있습니다.

주요 기능

대메뉴 > 중메뉴 > 소메뉴, 최대 3단계까지 구성 가능합니다. 메뉴 이름, 경로, 아이콘, 노출 여부를 자유롭게 설정할 수 있고, 변경하면 즉시 사이드바에 반영됩니다.

현재 메뉴 구조

대시보드
회원관리 → 회원 목록
학원관리 → 학원 목록, 연습실 관리
콘텐츠   → 악보 관리, 수강프로그램, 게시판
         → 팝업 관리 → 브랜드/학원/학생 사이트
매출/정산 → 결제 관리, 정산 관리
운영관리  → 예약 관리
고객지원  → 문의 관리
시스템   → 관리자 계정, 메뉴 관리, 역할 관리, 설정

---

4. 역할별 메뉴 권한

모든 관리자가 같은 메뉴를 보는 것이 아니라, 역할에 따라 보이는 메뉴가 달라집니다.

역할별 접근 범위

역할	볼 수 있는 메뉴
최고관리자	모든 메뉴
운영/CS 담당자	시스템 설정 제외한 모든 메뉴
원장	학원, 콘텐츠, 매출/정산, 운영 관련
강사	학원, 콘텐츠, 운영 관련 (일부)

권한 설정 방법

역할 관리 화면에서 각 역할이 어떤 메뉴에 접근할 수 있는지 체크박스로 간편하게 설정할 수 있습니다. 메뉴 관리 화면에서도 각 메뉴에 허용할 역할을 콤보박스로 선택할 수 있습니다.

---

5. 팝업 관리

각 사이트(브랜드 홈페이지, 학원 사이트, 학생 사이트)에 공지 팝업을 띄울 수 있는 기능입니다.

관리자가 하는 일

어떤 사이트에 띄울지 선택합니다. (브랜드 / 학원 / 학생) 팝업 제목, 내용, 이미지, 링크, 노출 기간을 설정합니다. 활성/비활성 상태를 관리합니다.

사이트 방문자가 보는 것

사이트에 접속하면 팝업이 자동으로 뜹니다. 여러 개의 팝업이 등록되어 있으면 순서대로 표시됩니다. "오늘 하루 안 보기" 버튼을 누르면 당일에는 다시 뜨지 않습니다.

---

6. 관리자 계정 관리

관리자 계정을 별도 화면에서 관리할 수 있게 되었습니다.

주요 기능

관리자 목록 조회 (이름/이메일 검색) 신규 관리자 등록 (이름, 이메일, 비밀번호, 역할, 상태) 관리자 정보 수정 및 삭제

---

7. 로그인 기억하기

로그인 화면에서 "로그인 정보 기억하기"를 체크하면, 다음 접속 시 이메일이 자동으로 입력되어 편리하게 로그인할 수 있습니다.

---

개발 환경

구분	사용 기술
화면(프론트)	React, TypeScript, Material-UI
서버(백엔드)	Java, Spring Boot, MyBatis
데이터베이스	MySQL (AWS RDS)
서버 인프라	AWS EC2, Nginx
파일 저장소	AWS S3