Project

General

Profile

Actions

Feature #1132

open
지팡 지팡

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

[STEP 03] PostgreSQL 데이터베이스와 마이그레이션 구축

Feature #1132: [STEP 03] PostgreSQL 데이터베이스와 마이그레이션 구축

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

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
11/16/2026
Due date:
11/20/2026 (Due in 3 days)
% Done:

10%

Estimated time:

Description

h2. 목표

사용자, 곡, 신청, 편성, 일정과 운영 이력을 영구 저장합니다.

h2. 작업

  • PostgreSQL·SQLAlchemy 연결
  • Alembic 마이그레이션
  • users, tracks, requests 모델
  • playlists, playlist_items, schedules 모델
  • playback_events, audit_logs, settings 모델
  • 테스트 데이터와 DB 통합 테스트

h2. 완료 기준

  • 빈 DB에 마이그레이션을 적용할 수 있다.
  • 앱 재시작 후 데이터가 유지된다.
  • 적용과 롤백이 검증된다.

h2. 선행 작업

STEP 01

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

  • Due date set to 11/10/2026
  • Start date set to 11/09/2026

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

  • Due date changed from 11/10/2026 to 11/20/2026
  • Status changed from New to In Progress
  • Start date changed from 11/09/2026 to 11/16/2026
  • % Done changed from 0 to 10

h3. 작업계획

  1. 현재 저장 방식과 설정 파일을 확인하고 PostgreSQL 연결에 필요한 환경변수를 정리합니다.
  2. SQLAlchemy의 데이터베이스 연결, 세션 생성, 요청 단위 세션 종료 구조를 구성합니다.
  3. users, tracks, requests 모델과 관계·제약조건·인덱스를 설계합니다.
  4. playlists, playlist_items, schedules 모델을 추가하고 재생 순서와 일정 관계를 검증합니다.
  5. playback_events, audit_logs, settings 모델을 추가하여 운영 이력과 설정을 저장합니다.
  6. Alembic을 설정하고 빈 데이터베이스에 전체 스키마를 만드는 최초 마이그레이션을 작성합니다.
  7. 개발용 테스트 데이터를 넣는 방법을 준비하고, 앱 재시작 후에도 데이터가 유지되는지 확인합니다.
  8. 마이그레이션 적용과 한 단계 롤백을 자동 테스트로 검증합니다.
  9. 초보자가 따라 할 수 있도록 PostgreSQL 준비, 환경변수 설정, 마이그레이션 실행 방법을 문서화합니다.
  10. 전체 테스트와 GitHub Actions를 통과한 뒤 PR로 검수를 요청합니다.

h3. 완료 기준

  • 빈 PostgreSQL 데이터베이스에 Alembic 마이그레이션을 적용할 수 있습니다.
  • 모든 핵심 모델의 관계와 제약조건이 테스트로 확인됩니다.
  • 앱을 재시작해도 저장 데이터가 유지됩니다.
  • 마이그레이션 적용과 롤백이 모두 성공합니다.
  • 실행 및 확인 방법이 초보자용 문서에 정리됩니다.

작업계획 확인 전에는 코드 수정을 시작하지 않겠습니다.

Actions

Also available in: PDF Atom