AWESOMEDEV db54b9bc19
All checks were successful
CI / backend-test (push) Successful in 1m1s
CI / frontend-build (push) Successful in 23s
CI / backend-dep-scan (push) Successful in 29s
feat(db): Flyway 마이그레이션 도입 (ddl-auto update → validate)
스키마를 '앱이 자동 변경'에서 '버전 관리되는 마이그레이션'으로 전환:
- flyway-core + flyway-database-postgresql 추가
- V1__baseline.sql: 현재 운영 스키마(테이블 13·제약 31·인덱스 1)를 그대로 박제
- ddl-auto: update → validate (Hibernate는 이제 검증만, 스키마는 Flyway 소유)
- baseline-on-migrate: 기존 운영 DB는 V1 미실행·baseline 표시, 신규 DB는 V1 실행

안전 절차로 진행:
- 도입 전 운영 DB 백업(pg_dump -Fc)
- 신규 DB 경로 검증(빈 DB→V1 실행→validate 통과→기동) 후 운영 배포
- 운영: 기존 스키마 baseline(무실행)→validate 통과→기동, 데이터 무손실(users=4·profile=3) 확인
- 테스트 잔재 pgcrypto 확장 제거

향후 스키마 변경은 V2, V3...로 의도를 남긴다. 엔티티만 바꾸고 마이그레이션을
안 쓰면 validate가 기동 시 실패해 알려 준다.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 07:59:20 +09:00

142 lines
5.7 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!-- 미림 수습 학습 플랫폼 백엔드 (Spring Boot)
학습 포인트: Maven이 라이브러리(의존성)를 관리하는 방법을 이 파일에서 봅니다. -->
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<!-- 3.4.2 → 3.5.16: 현재 활발히 유지되는 GA 라인의 최신 패치로 올려, OSV 스캔이 찾은
누적 CVE(tomcat-embed-core·spring-security·spring-web 등)를 관리 의존성 버전 상향으로
해결한다. 마이너 상향이지만 표준 스타터(web/jpa/security/validation)만 쓰고 전체 테스트
47개로 회귀를 검증했다. 3.4.x보다 지원 수명이 길어 인턴십 이후 운영에도 유리. -->
<version>3.5.16</version>
<relativePath/>
</parent>
<groupId>dev.awesomedev</groupId>
<artifactId>mirim-backend</artifactId>
<version>0.1.0</version>
<name>mirim-backend</name>
<description>어썸데브 수습 학습 플랫폼 API 서버</description>
<properties>
<java.version>21</java.version>
</properties>
<dependencies>
<!-- 웹 API (컨트롤러) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- DB 접근 (JPA) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- DB 마이그레이션 (Flyway) — 스키마 변경을 버전 관리한다.
학습 포인트: flyway-core는 엔진, flyway-database-postgresql은 Postgres 방언 지원.
(Flyway 10부터 DB별 지원이 별도 모듈로 분리됐다.) 버전은 Spring Boot BOM이 관리. -->
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-database-postgresql</artifactId>
</dependency>
<!-- 로그인/권한 (세션 기반) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
<!-- 요청 값 검증 (@Valid) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<!-- PostgreSQL 드라이버 -->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<scope>runtime</scope>
</dependency>
<!-- 테스트 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!-- 코드 포맷·위생 검사 (Spotless)
학습 포인트: 사람마다 다른 "안 쓰는 import·줄끝 공백·파일 끝 개행" 같은 잡티를
기계가 통일한다. 과도한 재정렬은 하지 않고(코드 의미·주석 정렬 보존) 위생만 맞춘다.
mvn spotless:apply → 자동 교정, mvn spotless:check → 어긋나면 실패(CI가 이걸 검사). -->
<plugin>
<groupId>com.diffplug.spotless</groupId>
<artifactId>spotless-maven-plugin</artifactId>
<version>2.44.0</version>
<configuration>
<java>
<removeUnusedImports/>
<trimTrailingWhitespace/>
<endWithNewline/>
</java>
</configuration>
</plugin>
<!-- 테스트 커버리지 측정 (JaCoCo)
학습 포인트: "테스트가 코드의 몇 %를 실제로 실행해 봤나"를 숫자로 보여준다.
숫자가 낮은 곳 = 아직 안전망이 없는 곳. mvn test 후 target/site/jacoco/index.html 에 리포트.
check 규칙: 라인 커버리지가 기준선 아래로 "떨어지면" 빌드 실패 → 테스트를 지우며 후퇴하는 걸 막는다. -->
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.12</version>
<executions>
<execution>
<id>prepare-agent</id>
<goals><goal>prepare-agent</goal></goals>
</execution>
<execution>
<id>report</id>
<phase>test</phase>
<goals><goal>report</goal></goals>
</execution>
<execution>
<id>check</id>
<phase>test</phase>
<goals><goal>check</goal></goals>
<configuration>
<rules>
<rule>
<element>BUNDLE</element>
<limits>
<!-- 현재 기준선 라인 36.7%. 바닥을 30%로 걸어 "후퇴"만 막는다(전진은 자유).
학생이 테스트를 늘리면 이 숫자를 함께 올려 바닥을 끌어올리는 게 건강한 패턴. -->
<limit>
<counter>LINE</counter>
<value>COVEREDRATIO</value>
<minimum>0.30</minimum>
</limit>
</limits>
</rule>
</rules>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>