Project

General

Profile

Overview

Jina Classroom Jukebox

1. 프로젝트 개요

Jina Classroom Jukebox는 AX2 강의실에 음악과 자동화를 결합한 학생 참여형 스마트 주크박스 시스템을 구축하는 프로젝트입니다.

학생들이 YouTube URL로 원하는 음악을 신청하고, 관리자가 선곡을 승인하면 준비된 음원을 강의실 Ubuntu 서버에 저장하여 지정된 시간에 자동으로 재생합니다.

웹을 통해 음악 신청, 플레이리스트 관리, 재생 스케줄 설정, 실시간 모니터링 및 원격 제어가 가능한 시스템을 개발합니다.

기존 Ubuntu 서버와 강의실 앰프를 활용하며, 무료 오픈소스 기술을 중심으로 추가 운영 비용을 최소화합니다.

본 프로젝트는 AX2 교육생이 실제 서비스를 설계·개발·검증·운영하는 실전 협업형 학습 프로젝트입니다.

2. 주요 기능

학생 기능

  • YouTube URL 기반 음악 신청
  • 개인 Wish List 관리
  • 신청곡 승인·반려 현황 확인
  • 승인된 플레이리스트 및 재생 대기열 조회
  • 일별·주간 음악 재생 스케줄 조회
  • 현재 재생곡 및 재생 상태 확인

관리자 기능

  • 신청곡 검토 및 승인·반려
  • 음원 파일 등록·검증 및 로컬 저장 관리
  • 플레이리스트 생성 및 재생 순서 관리
  • 시간대별 자동 재생 설정(0809시, 1314시, 18~19시 등)
  • 재생·일시정지·정지·다음 곡 원격 제어
  • 볼륨 조절 및 재생 현황 모니터링
  • 재생 이력 및 시스템 장애 확인

시스템 기능

  • Ubuntu 서버와 강의실 앰프 연동
  • MPD 기반 로컬 음악 재생
  • APScheduler 기반 자동 재생
  • PostgreSQL 기반 사용자·음악·스케줄 관리
  • 서버 재시작 시 스케줄 자동 복구
  • GitHub Actions 기반 자동 테스트

3. 기술 스택

영역 기술
Backend Python, FastAPI
Frontend HTML, CSS, JavaScript, Jinja2
Database PostgreSQL, SQLAlchemy, Alembic
Server Ubuntu Linux
Music Player MPD, python-mpd2
Scheduler APScheduler
Audio MP3, OGG, FLAC, FFmpeg
Testing pytest, GitHub Actions
Collaboration GitHub, Redmine

4. 개발 단계

  • STEP 01 — 기반 구축: 프로젝트 구조, API, DB 및 테스트 환경
  • STEP 02 — 음악 재생: 플레이어 제어, 볼륨 및 상태 확인
  • STEP 03 — 학생 참여: 로그인, 신청곡 접수, 관리자 승인
  • STEP 04 — 음원 관리: 파일 검증, 저장 및 플레이리스트 편성
  • STEP 05 — 자동화: 시간대별 재생 스케줄 및 이력 관리
  • STEP 06 — 장비 연동: Ubuntu MPD 및 실제 강의실 앰프 연결
  • STEP 07 — 운영 안정화: 모니터링, 장애 대응 및 통합 QA

5. 기대 효과

  • 실제 강의실에서 활용할 수 있는 음악 자동 재생 시스템 확보
  • 학생 참여를 통한 강의실 환경 개선
  • 웹·DB·Linux·오디오 장비 통합 개발 경험
  • GitHub PR 및 Redmine 기반 협업 경험
  • 요구사항 분석부터 테스트·운영까지 실전 개발 경험 축적

6. 프로젝트 운영 원칙

  • 소규모 스터디형 협업 개발
  • GitHub PR 기반 코드 검토 및 병합
  • Redmine 기반 일감·담당자·진행 현황 관리
  • 단계별 자동 테스트와 기능 검증
  • 기존 Ubuntu 서버 및 무료 오픈소스 우선 활용
  • 이용 권한이 확인된 음원 중심의 로컬 재생 운영

7. 관련 저장소

GitHub: https://github.com/GilbertMoon/jina-classroom-jukebox

프로젝트 목표: 학생이 신청하고, 관리자가 선곡하며, 강의실에서 자동으로 음악이 흐르는 스마트 주크박스 구현

Issue tracking  Details

open closed Total
Bug 0 0 0
Feature 11 2 13
Support 0 0 0

View all issues | Summary | Calendar | Gantt

Time tracking

  • Estimated time: 0:00 hour
  • Spent time: 0:00 hour

Details | Report