Feature #1132
open
지팡
지팡
Feature #1129: [ROADMAP] AX2 Classroom Jukebox 전체 개발 계획
[STEP 03] PostgreSQL 데이터베이스와 마이그레이션 구축
Added by 지나 팡 22 days ago.
Updated 1 day ago.
Due date:
11/20/2026 (Due in 3 days)
Description
h2. 목표
사용자, 곡, 신청, 편성, 일정과 운영 이력을 영구 저장합니다.
h2. 작업
- PostgreSQL·SQLAlchemy 연결
- Alembic 마이그레이션
- users, tracks, requests 모델
- playlists, playlist_items, schedules 모델
- playback_events, audit_logs, settings 모델
- 테스트 데이터와 DB 통합 테스트
h2. 완료 기준
- 빈 DB에 마이그레이션을 적용할 수 있다.
- 앱 재시작 후 데이터가 유지된다.
- 적용과 롤백이 검증된다.
h2. 선행 작업
STEP 01
- Due date set to 11/10/2026
- Start date set to 11/09/2026
- 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. 작업계획
- 현재 저장 방식과 설정 파일을 확인하고 PostgreSQL 연결에 필요한 환경변수를 정리합니다.
- SQLAlchemy의 데이터베이스 연결, 세션 생성, 요청 단위 세션 종료 구조를 구성합니다.
- users, tracks, requests 모델과 관계·제약조건·인덱스를 설계합니다.
- playlists, playlist_items, schedules 모델을 추가하고 재생 순서와 일정 관계를 검증합니다.
- playback_events, audit_logs, settings 모델을 추가하여 운영 이력과 설정을 저장합니다.
- Alembic을 설정하고 빈 데이터베이스에 전체 스키마를 만드는 최초 마이그레이션을 작성합니다.
- 개발용 테스트 데이터를 넣는 방법을 준비하고, 앱 재시작 후에도 데이터가 유지되는지 확인합니다.
- 마이그레이션 적용과 한 단계 롤백을 자동 테스트로 검증합니다.
- 초보자가 따라 할 수 있도록 PostgreSQL 준비, 환경변수 설정, 마이그레이션 실행 방법을 문서화합니다.
- 전체 테스트와 GitHub Actions를 통과한 뒤 PR로 검수를 요청합니다.
h3. 완료 기준
- 빈 PostgreSQL 데이터베이스에 Alembic 마이그레이션을 적용할 수 있습니다.
- 모든 핵심 모델의 관계와 제약조건이 테스트로 확인됩니다.
- 앱을 재시작해도 저장 데이터가 유지됩니다.
- 마이그레이션 적용과 롤백이 모두 성공합니다.
- 실행 및 확인 방법이 초보자용 문서에 정리됩니다.
작업계획 확인 전에는 코드 수정을 시작하지 않겠습니다.
Also available in: PDF
Atom