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

충장 Updated by 충만 장 11 days ago Actions #1

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

작업 착수 (10%). 로컬 구현·테스트 완료(커밋 010fe07, 23 tests OK on PG16). GitHub push 후 PR 링크와 함께 90%로 갱신 예정.

충장 Updated by 충만 장 11 days ago Actions #2

  • % Done changed from 10 to 90

PR 생성, 리뷰 요청 (90%)
PR: https://github.com/ai-career-platform/ai-career-platform/pull/39
커밋: a7735df
CI: 3개 모두 통과. DB migration runner test (T08) - PostgreSQL 18.1 일회용 DB에서 lint + 통합 테스트 Success (https://github.com/ai-career-platform/ai-career-platform/actions/runs/42181653379)
리뷰어: GilbertMoon, Crasnec (승인 대기)
T09(희주) 질문 답변 완료: 0001_initial_schema.sql은 빈 DB 기준 첫 migration, 적용 순서 DRAFT_00 → DRAFT_01 → migrate.py apply
후속: SQLAlchemy(#44) 도입에 맞춰 README에 "스키마 변경은 SQL migration만, 모델은 매핑용" 규칙 추가 예정

충장 Updated by 충만 장 11 days ago Actions #3

리뷰 대응 업데이트

  • 커밋 d233cac: database/migrations/README.md §7 "SQLAlchemy·Pydantic과의 역할 분리" 추가 (#44 SQLAlchemy 2.0.57 + Pydantic 2.14.3 도입 반영)
    • 테이블 생성·변경은 SQL migration이 단일 기준, SQLAlchemy 모델은 기존 테이블 매핑용, 공용 DB에서 create_all() 금지
  • 재실행 CI 4개 모두 통과 (PostgreSQL 18.1)
  • PR #39 리뷰 대기 (GilbertMoon, Crasnec), 승인 1건 필요
    참고: Staging DB(10.2.10.104:15432) DBeaver 접속 시간 초과 이슈 공유. 웹(18080)은 접속되나 compose.yaml에 DB 외부 포트 공개 설정 없음 → 포트 개방/SSH 터널 여부 PM 확인 필요 (T08 Staging 적용 절차와 관련)

충장 Updated by 충만 장 11 days ago Actions #4

  • Description updated (diff)

Also available in: PDF Atom