Project

General

Profile

Feature #1568

Updated by 충만 장 11 days ago

목표 
 PostgreSQL Migration 체계(도구·파일 규칙·적용 이력·실패/복구 전략·CI 격리 테스트)를 구축해 T09 이후 스키마 변경을 승인된 순서로 안전하게 적용할 수 있게 합니다. 

 작업 계획 

 선행 일감 T05(ERD)·T07(DB 권한) 상태와 기존 DRAFT_0001·DRAFT_00, d1-postgres-sql-test CI를 확인합니다. 
 도구 결정: 순수 SQL 파일 + database/migrate.py(Python 표준 라이브러리, psql 사용), Forward-only 방식을 제안합니다. 
 파일 규칙 NNNN_snake_case.sql, 필수 헤더(Purpose/Recovery), 금지 SQL lint를 적용합니다. 
 적용 이력 career_migration.schema_migrations(앱 계정 접근 불가), 체크섬 drift·순서 위반 차단, migration 1개 = 트랜잭션 1개로 실패 시 롤백합니다. 
 Staging은 승인번호·DB 이름 확인 필수, CI·자동 배포에서 실행 금지합니다. 
 일회용 PostgreSQL 18.1(CI)에서 신규 설치·중복 방지·실패 처리를 검증합니다. 

 산출물 

 database/migrate.py, database/security/DRAFT_01_migration_history.sql, database/migrations/README.md(사용법·복구 전략·Staging 절차), database/tests/test_migration_runner.py, .github/workflows/db-migration-runner-test.yml, PR URL 

 현재 상태 

 T08_STATUS=PARTIAL (리뷰·Merge 대기). PR #39 https://github.com/ai-career-platform/ai-career-platform/pull/39 (커밋 a7735df, d233cac) T08_STATUS=PARTIAL. 브랜치 task/t08-migration-system 커밋 010fe07. 
 CI 4개 모두 통과 (T08 migration runner test 포함, PostgreSQL 18.1). 로컬 PostgreSQL 16.15 일회용 DB에서 테스트 23개 통과. 통과(신규 설치·재실행·실패 롤백·drift·순서 위반·Staging 안전장치·이력 권한). 
 T05 ERD는 main 반영 완료(#17). SQLAlchemy·Pydantic 도입(#44)에 맞춰 README §7 역할 분리 규칙 추가. PostgreSQL 18.1 검증은 PR CI에서 확인 예정. PR 생성 후 링크를 추가합니다. 
 남은 확인: 리뷰 승인 1건(GilbertMoon, Crasnec), T05 ERD 승인, T07 결과에 따른 LOGIN 계정·career_migrator 부여 방식, Staging DB 접근 방식(포트/SSH 터널). 방식. 
 공유 Staging DB 변경 없음, down -v 사용 안 함. 

 작업지시서 
 https://github.com/ai-career-platform/ai-career-platform/blob/docs/initial-30-work-orders-20261106/docs/work-orders/initial-30/T08.md

Back