Project

General

Profile

Feature #1568

open
충장 충장

[T08] PostgreSQL Migration 체계 구축

Feature #1568: [T08] PostgreSQL Migration 체계 구축

Added by 충만 장 11 days ago. Updated 11 days ago.

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
11/06/2026
Due date:
11/12/2026 (5 days late)
% Done:

90%

Estimated time:

Description

목표
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)
CI 4개 모두 통과 (T08 migration runner test 포함, PostgreSQL 18.1). 로컬 PostgreSQL 16.15 테스트 23개 통과.
T05 ERD는 main 반영 완료(#17). SQLAlchemy·Pydantic 도입(#44)에 맞춰 README §7 역할 분리 규칙 추가.
남은 확인: 리뷰 승인 1건(GilbertMoon, Crasnec), 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


Add

Subtasks


Add

Related issues

Also available in: PDF Atom