[donghyuck]

Why

• Studio platform 3.0.0-rc.1과 Spring Boot 4 runtime 계약을 실제 실행 서버에 동일하게 적용합니다.
• Redis RAG cache를 선택적으로 승격하면서 기존 domain cache와 rollback 경계를 보존합니다.

What

• Gradle 8.14.5, Spring Boot 4.1.0, Studio 3.0.0-rc.1 의존성을 적용했습니다.
• Boot 4 MVC, AspectJ, Flyway PostgreSQL starter 구성을 반영했습니다.
• 기존 @Cacheable domain cache는 Caffeine으로 고정하고 RAG answer cache만 Redis를 직접 사용하도록 구성했습니다.
• PostgreSQL 초기화와 datasource schema 설정을 보완했습니다.
• README에 3.x 실행 기준선, cache 승격, fail-open 및 rollback 절차를 현행화했습니다.

Related Issues

• Platform PR: [3.x] Spring Boot 4 및 Spring AI 2 런타임 전환 studio-api#525
• 별도 Issue 없음: 사용자가 3.x 실행 서버 전환과 PR 생성을 직접 요청했습니다.

Validation

• Command: ./gradlew test --no-daemon
  • Result: 성공, 147 tasks
• Runtime: ApplicationContext, root, actuator mappings, 보호 AI endpoint, login, AI info smoke test 성공
• RAG cache: none, redis MISS/HIT, revision invalidation, Redis 장애 fail-open, sync/SSE 검증 성공
• Rollback: origin/2.x server의 v2.1.0-rc.1 platform composite test와 runtime smoke test 성공
• Documentation: git diff --check 성공

Risk / Rollback

• Risk: Platform PR보다 먼저 배포하거나 2.x와 3.x Studio artifact를 혼합하면 runtime classpath 오류가 발생할 수 있습니다.
• Rollback: RAG_ANSWER_CACHE_TYPE을 none으로 전환하고 2.x server와 v2.1.0-rc.1 platform 및 2.1 property set을 함께 복원합니다. 별도 schema 사용 시 DEFAULT_SCHEMA와 JDBC currentSchema를 동일하게 유지합니다.

AI / Subagent Usage

• AI-assisted: Yes
• Subagent used: Yes
• Delegated scope: 플랫폼 기준선, Jackson 3, Spring AI 2, 계획 architecture/critic, 최종 upgrade verification 검토
• Main author validation: 서버 설정을 플랫폼 변경과 통합한 뒤 test, runtime, cache 및 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