[Fix] V12 vision_summary_5s 재생성 마이그레이션이 신규 환경에서 실패하지 않도록 수정

[LeeJeongHeon02]

요약

• V12__recreate_vision_summary_5s.sql은 운영 DB에서 vision_summary_5s 테이블이 실수로 DROP된 사고를 복구하기 위해 작성된 마이그레이션으로, 조건 없이 CREATE TABLE을 실행한다.
• V1부터 전체 이력을 처음부터 적용하는 환경(신규 스테이징, MySQL 기반 로컬 셋업, 마이그레이션만으로 하는 DR 복구 등)에서는 V1이 이미 이 테이블을 만들어두는데 그 환경에서는 아무도 지운 적이 없어서, V12에서 ERROR 1050 (42S01): Table 'vision_summary_5s' already exists로 실패한다.
• 실제 mysql:8.0.46 컨테이너로 확인한 결과 V12의 컬럼/제약조건/인덱스 목록이 V1 + V4가 이미 만들어내는 스키마와 완전히 동일함을 확인했다. 그래서 V12가 vision_summary_5s가 실제로 없을 때만 DDL을 실행하도록 가드를 추가했다(information_schema로 존재 여부 확인 + PREPARE/EXECUTE로 조건부 실행 — MySQL은 CREATE INDEX에 IF NOT EXISTS를 지원하지 않아 CREATE TABLE IF NOT EXISTS만으로는 부족함).
• 두 시나리오 모두 동일한 최종 스키마로 수렴함을 확인했다: 신규 부트스트랩(V1→V13을 빈 DB에 적용)과 원래 사고 복구 경로(V1~V11 적용 후 수동 DROP, 이후 V12 적용).

⚠️ 배포 시 주의

이 변경은 운영에 이미 적용된 마이그레이션의 파일 내용을 바꾸기 때문에 Flyway checksum도 함께 바뀐다. 배포 전에 운영 DB에 flyway repair(또는 flyway_schema_history의 version = 12 행 checksum 수동 갱신)를 먼저 실행해야 한다 — 안 하면 다음 앱 기동 시 Flyway checksum 검증에서 실패해 앱이 뜨지 않는다. README의 DB 마이그레이션 섹션과 마이그레이션 파일 헤더에 이 내용을 문서화해뒀다.

이 PR과 관련된 운영 repair는 이미 완료됨 — 운영 DB의 V12 checksum을 67901973 → 1057297317로 직접 갱신하고 확인까지 마쳤다.

테스트

• 원본 버그 재현: 수정 전 V1~V12를 빈 mysql:8.0.46 컨테이너에 순서대로 적용 → ERROR 1050 (42S01) at line 12: Table 'vision_summary_5s' already exists로 실패 확인.
• V1 + V4가 만드는 최종 스키마가 V12의 CREATE TABLE 정의와 컬럼/제약조건/인덱스까지 동일함을 SHOW CREATE TABLE로 대조 확인.
• 신규 부트스트랩: 수정된 V12를 포함해 V1→V13을 빈 DB에 적용 → 성공, 가드가 스킵되고 스키마 그대로 유지.
• 사고 복구: V1~V11 적용 후 수동으로 DROP TABLE vision_summary_5s 실행, 이후 수정된 V12 적용 → 테이블 정상 재생성.
• 두 시나리오의 최종 스키마(SHOW CREATE TABLE)를 diff → 완전히 동일.
• 실제 Flyway 11 CLI로 V1~V13 전체 마이그레이션을 처음부터 실행 → 성공, checksum 값 확인.
• ./gradlew test → BUILD SUCCESSFUL.

🤖 Generated with Claude Code

[coderabbitai]

📝 Walkthrough

Walkthrough

V12 마이그레이션이 기존 vision_summary_5s 테이블과 인덱스를 조건부로 처리하도록 변경됐다. README에는 Flyway 버전 범위, 실제 MySQL 검증 절차, 운영 마이그레이션 파일의 체크섬 관리 규칙이 추가됐다.

Changes

Flyway 마이그레이션 업데이트

Layer / File(s)	Summary
V12 조건부 DDL 실행 src/main/resources/db/migration/V12__recreate_vision_summary_5s.sql	information_schema.tables로 테이블 존재 여부를 확인하고, 테이블과 두 인덱스의 생성을 PREPARE/EXECUTE 기반으로 조건부 실행한다.
Flyway 운영 검증 절차 README.md	운영 스키마 범위를 V1~V13으로 갱신하고, 실제 MySQL에서 전체 마이그레이션을 검증하는 절차와 체크섬 변경 시 flyway repair를 수행하는 규칙을 문서화했다.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

• Shinhan-KLLJS/backend#53: 동일한 V12 마이그레이션의 vision_summary_5s 테이블 재생성 동작을 수정한다.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	제목이 V12 vision_summary_5s 재생성 마이그레이션이 신규 환경에서 실패하지 않도록 한 핵심 변경을 명확히 요약합니다.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/vision-summary-5s-fresh-bootstrap

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}