Actions
Feature #1131
closed
지팡
지팡
Feature #1129: [ROADMAP] AX2 Classroom Jukebox 전체 개발 계획
[STEP 02] 관리자용 모의 플레이어 대시보드 구현
Feature #1131:
[STEP 02] 관리자용 모의 플레이어 대시보드 구현
Start date:
11/05/2026
Due date:
11/06/2026
% Done:
100%
Estimated time:
Description
h2. 목표
실제 장비 없이 재생 제어 흐름과 관리자 화면을 검증합니다.
h2. 작업
- Jinja2 + Bootstrap 관리자 화면
- FakePlayer 서비스
- 재생·일시정지·정지·다음 곡
- 볼륨·음소거와 상태 조회
- 모바일 화면 및 테스트
h2. 완료 기준
- 화면에서 모든 모의 제어가 동작한다.
- 새로고침 후 상태를 확인할 수 있다.
- 잘못된 명령과 볼륨은 거부된다.
h2. 선행 작업
STEP 01
지팡 Updated by 지나 팡 14 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 10
h3. 작업계획
- 기존 관리자 모의 플레이어 화면과 STEP 02 요구사항을 비교합니다.
- 현재 곡, 재생 상태, 재생 위치, 볼륨 표시가 올바른지 확인합니다.
- 재생, 일시정지, 정지, 다음 곡, 볼륨 조절 기능을 점검합니다.
- FakePlayer 상태와 API 응답이 화면에 정확히 반영되는지 확인합니다.
- 관리자 권한과 CSRF 보호가 제어 요청에 적용되는지 확인합니다.
- 자동 테스트에서 누락된 사용자 동작이 있으면 보완합니다.
- 로컬 테스트와 GitHub Actions를 통과한 뒤 PR로 전체 검수를 요청합니다.
h3. 산출물 및 완료 기준
- 관리자 대시보드에서 모의 재생 상태를 확인할 수 있습니다.
- 재생 제어와 볼륨 조절이 정상 작동합니다.
- 잘못된 값과 권한 없는 요청이 안전하게 거부됩니다.
- pytest와 GitHub Actions가 통과합니다.
- 초보자가 실행·확인할 수 있는 방법이 문서에 정리됩니다.
기존 구현은 보존하고 요구사항과 비교하여 누락된 부분만 보완하겠습니다. 작업계획 컨펌 전에는 추가 코드 수정을 진행하지 않습니다.
지팡 Updated by 지나 팡 14 days ago · Edited
h3. 작업 범위 조정
STEP 02 범위를 플레이어 자체 개발이 아니라 관리자 페이지 구현 및 기존 재생 API 연동으로 명확히 조정합니다.
- FakePlayer는 관리자 화면을 검증하기 위한 기존 테스트 수단으로만 사용
- 플레이어 엔진을 새로 만들거나 불필요하게 확장하지 않음
- 관리자 화면의 상태 표시, 재생 제어, 볼륨 조절, 오류 안내, 모바일 사용성에 집중
- 기존 계획의 플레이어 관련 표현은 위 기준으로 해석하여 진행
진척도는 작업계획 단계인 10%로 유지하며, 위 범위로 개발을 시작합니다.
지팡 Updated by 지나 팡 14 days ago · Edited
- % Done changed from 10 to 90
h3. 개발 완료 및 전체 검수 요청
조정된 작업 범위에 따라 플레이어 엔진을 새로 만드는 대신, 기존 재생 API와 연결되는 관리자 운영 페이지를 보완했습니다.
- 관리자 화면 목적이 드러나도록 제목과 안내 문구 수정
- 재생 현황, 신청곡 승인, 플레이리스트, 자동 스케줄 메뉴 구성
- 상태 수동 새로고침 기능 추가
- 오류 안내 개선
- 모바일 조작성과 필수 화면 테스트 보강
- 초보자용 STEP 02 검증 문서 작성
검증 결과: pytest 42개 통과, JavaScript 문법 검사 통과, Python 컴파일 검사 통과, Git 공백 오류 검사 통과
전체 검수 PR: https://github.com/GilbertMoon/jina-classroom-jukebox/pull/15
현재 개발 완료 단계이므로 진척도를 90%로 조정합니다. 검토 및 승인 후에만 병합하고, 병합 완료 뒤 100%/Closed로 변경하겠습니다.
Actions