Project

General

Profile

Actions

Feature #1131

closed
지팡 지팡

Feature #1129: [ROADMAP] AX2 Classroom Jukebox 전체 개발 계획

[STEP 02] 관리자용 모의 플레이어 대시보드 구현

Feature #1131: [STEP 02] 관리자용 모의 플레이어 대시보드 구현

Added by 지나 팡 22 days ago. Updated 1 day ago.

Status:
Closed
Priority:
Normal
Assignee:
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 Actions #1

  • Due date set to 11/06/2026
  • Start date set to 11/05/2026

지팡 Updated by 지나 팡 14 days ago Actions #2

  • Status changed from New to In Progress
  • % Done changed from 0 to 10

h3. 작업계획

  1. 기존 관리자 모의 플레이어 화면과 STEP 02 요구사항을 비교합니다.
  2. 현재 곡, 재생 상태, 재생 위치, 볼륨 표시가 올바른지 확인합니다.
  3. 재생, 일시정지, 정지, 다음 곡, 볼륨 조절 기능을 점검합니다.
  4. FakePlayer 상태와 API 응답이 화면에 정확히 반영되는지 확인합니다.
  5. 관리자 권한과 CSRF 보호가 제어 요청에 적용되는지 확인합니다.
  6. 자동 테스트에서 누락된 사용자 동작이 있으면 보완합니다.
  7. 로컬 테스트와 GitHub Actions를 통과한 뒤 PR로 전체 검수를 요청합니다.

h3. 산출물 및 완료 기준

  • 관리자 대시보드에서 모의 재생 상태를 확인할 수 있습니다.
  • 재생 제어와 볼륨 조절이 정상 작동합니다.
  • 잘못된 값과 권한 없는 요청이 안전하게 거부됩니다.
  • pytest와 GitHub Actions가 통과합니다.
  • 초보자가 실행·확인할 수 있는 방법이 문서에 정리됩니다.

기존 구현은 보존하고 요구사항과 비교하여 누락된 부분만 보완하겠습니다. 작업계획 컨펌 전에는 추가 코드 수정을 진행하지 않습니다.

지팡 Updated by 지나 팡 14 days ago · Edited Actions #3

h3. 작업 범위 조정

STEP 02 범위를 플레이어 자체 개발이 아니라 관리자 페이지 구현 및 기존 재생 API 연동으로 명확히 조정합니다.

  • FakePlayer는 관리자 화면을 검증하기 위한 기존 테스트 수단으로만 사용
  • 플레이어 엔진을 새로 만들거나 불필요하게 확장하지 않음
  • 관리자 화면의 상태 표시, 재생 제어, 볼륨 조절, 오류 안내, 모바일 사용성에 집중
  • 기존 계획의 플레이어 관련 표현은 위 기준으로 해석하여 진행

진척도는 작업계획 단계인 10%로 유지하며, 위 범위로 개발을 시작합니다.

지팡 Updated by 지나 팡 14 days ago · Edited Actions #4

  • % 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로 변경하겠습니다.

지팡 Updated by 지나 팡 14 days ago Actions #5

h3. 화면 검수 반영

  • 상단의 Demo Player Online 표시 제거
  • 재생 현황, 신청곡 승인, 플레이리스트, 자동 스케줄 메뉴를 상단 메뉴바 형태로 변경
  • 현재 선택된 메뉴를 밑줄로 구분
  • Playwright 스크린샷 교체 및 PR #15 갱신
  • 전체 자동 테스트 42개 통과

검수 대기 단계이므로 진척도는 90%로 유지합니다.

지팡 Updated by 지나 팡 1 day ago Actions #6

  • Status changed from In Progress to Closed
  • % Done changed from 90 to 100

PR #16과 #17의 리뷰 승인 및 병합 완료를 확인했습니다. STEP 02 개발과 검수가 완료되어 일감을 100% / Closed로 처리합니다.

Actions

Also available in: PDF Atom