[donghyuck]

Why

• Spring Boot 4.1.0, Spring AI 2.0.0, Jackson 3 기준으로 3.x runtime과 AI/RAG 계약을 전환합니다.
• 2.x 호환 기준선을 보존하면서 3.0.0-rc.1을 검증 가능한 release candidate로 제공합니다.

What

• Gradle 8.14.5, Spring Boot 4.1.0, Spring AI 2.0.0, MyBatis Spring Boot Starter 4.0.1을 적용했습니다.
• Jackson 3 application boundary와 provider별 Spring AI 2 adapter를 반영했습니다.
• Redis 기반 RAG exact-answer cache, revision/evidence 기반 key, fail-open 동작을 추가했습니다.
• Boot 4 자동구성, JDBC/Flyway, MySQL/MariaDB schema 호환 변경과 회귀 테스트를 반영했습니다.
• README, CHANGELOG, 3.x 업그레이드 기준선, Redis rollout 문서를 현행화했습니다.

Related Issues

• Supersedes: [3.x] Spring Boot 4 및 Spring AI 2 런타임 전환 #524
• 별도 Issue 없음: 사용자가 3.x major upgrade의 계획, 구현, 검증 및 PR 생성을 직접 요청했습니다.

Validation

• Command: ./gradlew compileJava compileTestJava --continue --no-daemon
  • Result: 성공, 150 tasks
• Command: ./gradlew test --continue --no-daemon
  • Result: 성공, 239 tasks
• Command: ./gradlew test -PrunDbTests=true --continue --no-daemon
  • Result: 성공, 239 tasks
• Command: ./gradlew dependencyCheckAnalyze --no-daemon
  • Result: 성공, 분석 대상 취약점 0건
• Command: ./gradlew check --no-daemon
  • Result: 성공, verify3xRuntimeClasspath 포함
• Command: ./gradlew publishToMavenLocal --no-daemon
  • Result: 성공, 386 tasks
• Runtime: cache none/redis, revision invalidation, Redis 장애 fail-open, sync/SSE 및 인증/API smoke test 성공
• Rollback: v2.1.0-rc.1 platform 전체 test와 2.x server composite/runtime smoke test 성공
• Documentation: git diff --check 성공

Risk / Rollback

• Risk: Boot 4, Spring AI 2, Jackson 3의 major boundary로 인해 소비 애플리케이션이 2.x와 3.x artifact를 혼합하면 runtime linkage 오류가 발생할 수 있습니다.
• Rollback: RAG cache를 none으로 전환하고 v2.1.0-rc.1 platform 및 2.1 property set을 함께 복원합니다. DB content migration과 embedding identity는 변경하지 않았습니다.

AI / Subagent Usage

• AI-assisted: Yes
• Subagent used: Yes
• Delegated scope: 기준선, Jackson 3, Spring AI 2, 계획 architecture/critic, 최종 upgrade verification 검토
• Main author validation: 모든 변경을 통합한 뒤 전체 compile/test/DB test/dependency check/publish/runtime/rollback 검증을 직접 수행했습니다.

Checklist

• commit message follows policy
• issue template used or exception recorded
• AI-Assisted value is correct
• validation recorded
• subagent usage recorded when used
• CI / repository verification passed locally
• human review completed before merge
• no unrelated changes included