feat: Flyway 버전 형상 백엔드 (조회/충돌·순서역전 분석/작업중 이슈)

[Ryan-Dia]

📌 What

어드민에서 Flyway 버전 형상을 조회하고, out-of-order 적용 시 발생할 수 있는 충돌(같은 번호 / 순서 역전)을 감지하며, 작업중인 마이그레이션을 flyway-wip 이슈로 예약하는 백엔드 API를 추가합니다. (GET /admin/api/v1/flyway/overview, GET /flyway/script, POST /flyway/wip)

❓ Why

곧 Flyway out-of-order를 도입할 예정인데, 그로 인해 두 종류의 사고가 날 수 있습니다.

• 같은 번호 충돌: 두 작업이 같은 버전 번호를 쓰면 적용 시 실패
• 순서 역전: 내 낮은 번호(미적용)가 먼저 적용된 높은 번호 뒤에 out-of-order로 끼어들며 같은 테이블/컬럼을 건드리면 스키마가 깨질 수 있음

이를 머지 전에 사람이 한눈에 보고 예방할 수단이 필요해, 형상을 읽어 분석/노출하는 백엔드를 만들었습니다.

🔧 How

• 도메인(순수 로직): MigrationVersion(시맨틱 정렬), MigrationFile(파일명 파싱), MigrationScript(SQL 정적분석 → 영향 테이블/컬럼), OutOfOrderAnalyzer(같은번호 충돌 + 순서역전: 같은 컬럼=강 / 같은 테이블=약)
• GitHub 연동: GitHubClient(WebClient) — 트리/raw/PR+파일/이슈 조회 + 이슈 생성 (기존 LambdaPlaywrightService 패턴 재사용)
• 서비스: 4단계 상태판정(DB반영=main / 배포대기=통합−배포 차집합 / 열린PR=리뷰중 / flyway-wip 이슈=로컬작업중) + 버전 디듑 + 적용본 SQL 보강 후 분석
  • 이 레포는 마이그레이션이 main 에 있어 적용 기준=main(server 브랜치엔 마이그레이션 파일이 없음). 별도 마이그레이션-반영 deploy 브랜치가 생기면 flyway.source.deploy-branch로 바꾸면 '배포 대기' 단계가 활성화됨
  • 조회 대상 브랜치에 디렉터리가 없으면(404) 에러 대신 빈 목록으로 처리
• 소스/대상 분리: 읽기는 public woowacourse-teams/2025-bom-bom, 이슈 생성은 Bombom-Team/admin(토큰 스코프 일치). 설정은 yml 없이 기본값 + GITHUB_ISSUE_TOKEN
• 이슈 폼 템플릿 .github/ISSUE_TEMPLATE/flyway-wip.yml

👀 Review Point

• 도메인 단위테스트 18 + 서비스 테스트 3 = 21개 (GitHubClient mock 기반 순서역전 end-to-end 포함)
• 상태 판정/디듑 로직(FlywayService)의 경계 케이스 검토
• 셋업: 시크릿 GITHUB_ISSUE_TOKEN(설정됨) + Bombom-Team/admin에 라벨 flyway-wip 1회 생성 필요
• 범위 밖(Phase 2): AI 충돌 판정 / CI 중복번호 가드 / 실DB(flyway_schema_history) 드리프트 / 충돌 알림