Actions
Feature #1129
open
지팡
지팡
[ROADMAP] AX2 Classroom Jukebox 전체 개발 계획
Feature #1129:
[ROADMAP] AX2 Classroom Jukebox 전체 개발 계획
Start date:
11/03/2026
Due date:
12/18/2026 (Due in 31 days)
% Done:
17%
Estimated time:
(Total: 0:00 h)
Description
h1. 프로젝트 목표
AX2 강의실에서 승인된 로컬 음원을 시간표에 맞춰 자동 재생하고, 학생 신청과 관리자 승인·편성·원격 제어를 지원하는 안전한 주크박스를 구축합니다.
h2. 진행 단계
- STEP 01 프로젝트 기반과 FastAPI 개발 환경
- STEP 02 관리자용 모의 플레이어 대시보드
- STEP 03 PostgreSQL 데이터베이스와 마이그레이션
- STEP 04 로그인·학생/관리자 권한
- STEP 05 학생 신청곡과 Wish List
- STEP 06 관리자 신청 승인과 음원 라이브러리
- STEP 07 Ubuntu MPD 실제 음악 재생
- STEP 08 플레이리스트 편성
- STEP 09 자동 재생 스케줄과 페이드아웃
- STEP 10 운영 대시보드·로그·비상 정지
- STEP 11 통합 테스트·보안·백업 복구
- STEP 12 Ubuntu 운영 배포와 강의실 현장 검증
h2. 개발 원칙
- 각 STEP은 작은 브랜치와 Pull Request로 진행합니다.
- 자동 테스트와 직접 확인을 통과한 뒤 다음 단계로 이동합니다.
- 비밀값, 음원 파일, DB 덤프는 Git에 커밋하지 않습니다.
- YouTube URL은 검색·식별·검토용이며 무단 다운로드를 전제로 하지 않습니다.
- 실제 앰프 연결과 운영 시간표 변경은 관리자 승인 후 진행합니다.
h2. 완료 정의
- 신청부터 승인, 등록, 편성, 예약 재생까지 전체 흐름이 동작합니다.
- STUDENT/ADMIN 권한이 분리됩니다.
- 장애와 재시작이 안전하게 처리됩니다.
- HTTPS, 백업, 로그, 롤백, 비상 정지 절차가 준비됩니다.
- 실제 강의실 현장 검증을 완료합니다.
Actions