kcg-ai-monitoring/backend
htlee f07d68b43f fix(backend): Spring 6.1 RestClient bean 모호성 기동 실패 해소
증상: rocky-211 의 kcg-ai-backend 가 `No qualifying bean of type RestClient,
but 2 were found: predictionRestClient, signalBatchRestClient` 로 기동 실패 반복.
PR #A 의 RestClientConfig 도입 이후 잠복해 있던 문제로, PredictionProxyController /
VesselAnalysisProxyController 의 필드 @Qualifier 가 Lombok `@RequiredArgsConstructor`
가 만든 constructor parameter 로 복사되지 않아 Spring 6.1 의 bean 이름 fallback 이
실패한 것.

- backend/pom.xml — default-compile / default-testCompile 의 configuration 에
  `<parameters>true</parameters>` 추가. spring-boot-starter-parent 기본값을 executions
  override 과정에서 덮어쓰지 않도록 명시.
- backend/src/main/java/lombok.config — `lombok.copyableAnnotations += org.springframework.beans.factory.annotation.Qualifier`.
  Lombok 이 필드의 @Qualifier 를 생성된 constructor parameter 로 복사해야 Spring 이
  파라미터 레벨 annotation 으로 해당 bean 을 식별할 수 있음.

검증: javap 로 PredictionProxyController 생성자의 RuntimeVisibleParameterAnnotations 에
@Qualifier("predictionRestClient") 가 실제 복사되었는지 확인, 재빌드/재배포 후 rocky-211
기동 성공("Started KcgAiApplication in 7.333 seconds") + Tomcat 18080 정상 리스닝.
2026-04-17 07:40:57 +09:00
..
.mvn/wrapper feat: Phase 2 - Spring Boot 백엔드 + DB 마이그레이션 초기화 2026-04-07 09:01:13 +09:00
src fix(backend): Spring 6.1 RestClient bean 모호성 기동 실패 해소 2026-04-17 07:40:57 +09:00
.sdkmanrc feat: Phase 2 - Spring Boot 백엔드 + DB 마이그레이션 초기화 2026-04-07 09:01:13 +09:00
mvnw feat: Phase 2 - Spring Boot 백엔드 + DB 마이그레이션 초기화 2026-04-07 09:01:13 +09:00
mvnw.cmd feat: Phase 2 - Spring Boot 백엔드 + DB 마이그레이션 초기화 2026-04-07 09:01:13 +09:00
pom.xml fix(backend): Spring 6.1 RestClient bean 모호성 기동 실패 해소 2026-04-17 07:40:57 +09:00
README.md refactor: 프로젝트 뼈대 정리 — iran 잔재 제거 + 백엔드 계층 분리 + 카탈로그 등록 2026-04-16 16:18:18 +09:00

Backend (Spring Boot)

Phase 2에서 초기화 예정.

계획된 구성

  • Spring Boot 3.x + Java 21
  • PostgreSQL + Flyway
  • Spring Security + JWT
  • Caffeine 캐시
  • 트리 기반 RBAC 권한 체계 (wing 패턴)

책임

  • 자체 인증/권한/감사로그
  • 운영자 의사결정 (모선 확정/제외/학습)
  • prediction 분석 결과 조회 API (/api/analysis/*)
  • 관리자 화면 API

상세 설계: .claude/plans/vast-tinkering-knuth.md