Vector Projection 검색 시각화 API PROJECTION_SEARCH_FAILED 오류

[donghyuck]

Issue

Type

• Feature
• Bug
• Refactor
• Docs
• Chore

Size

• Small (1): 단순 수정 / 단일 파일
• Medium (2): 기능 단위 변경 / 다중 파일
• Large (3): 구조 변경 / 복수 모듈

Summary

• 최신 Vector Projection에서 POST /api/mgmt/ai/vectors/search-visualization 호출 시 PROJECTION_SEARCH_FAILED가 반환됩니다.
• points 조회와 산점도 렌더링은 정상이며, 검색 시각화 API 내부 SQL/파라미터 처리 문제로 보입니다.

Background

• 화면: /services/ai/vector-visualization
• Projection: proj-20260430064126-16fa3e4a
• Projection 상태: COMPLETED, 122건
• 검색어: 퇴직금 규정은
• 클라이언트는 객체유형을 명시 선택하지 않은 경우 targetTypes를 전송하지 않도록 수정했습니다.
• 그래도 검색 시각화 API가 실패하고 화면에는 PROJECTION_SEARCH_FAILED alert가 표시됩니다.

Scope

• POST /api/mgmt/ai/vectors/search-visualization 실패 원인 확인
• projectionId만 전달되는 검색 요청 처리 확인
• SQL 파라미터 타입 추론 오류 수정
• Projection 자체의 targetTypes/scope를 사용하는 검색 흐름 검증

Acceptance Criteria

• projectionId=proj-20260430064126-16fa3e4a, query=퇴직금 규정은, topK=10 요청이 200으로 응답한다.
• 객체유형 필터를 생략한 경우 Projection scope 기준으로 검색된다.
• 응답에 query point와 Top-K results가 포함된다.
• Vector Map 화면에서 Top-K 결과가 표시된다.
• 서버 로그에 could not determine data type of parameter $4가 발생하지 않는다.

Validation Plan

• build
• test
• smoke / manual check
• analysis only (no code change)

AI-Assisted

• Yes
• No

AI Usage

• Usage type: 브라우저 재현, 서버 로그 확인, 이슈 작성
• Subagent used: No
• Delegated scope: N/A
• Main author validation: /services/ai/vector-visualization에서 최신 Projection 선택 후 퇴직금 규정은으로 검색 시각화를 실행합니다.

Notes

• 브라우저 증상:

검색어 기반 Top-K 결과
PROJECTION_SEARCH_FAILED

• 서버 로그 핵심:

POST /api/mgmt/ai/vectors/search-visualization
org.postgresql.util.PSQLException: ERROR: could not determine data type of parameter $4

• points 조회 및 산점도 렌더링은 정상입니다.

[donghyuck]

처리 PR을 등록했습니다: #389

주요 조치:

• searchByObject, hybridSearchByObject의 nullable objectType/objectId predicate에 PostgreSQL 타입 추론용 CAST(... AS varchar) 적용
• objectId=null인 objectType-only 검색 경로를 실제 PostgreSQL + pgvector Testcontainers 테스트로 검증
• Vector Projection search visualization의 targetTypes 호출 계약 테스트 추가

검증:

• ./gradlew :starter:studio-platform-starter-ai:test :starter:studio-platform-starter-ai-web:test :studio-platform-ai:test PASS
• ./gradlew test PASS
• git diff --check PASS

서브에이전트 리뷰 결과: 보완 전 테스트 부족 지적 반영 후 재리뷰에서 blocking finding 없음.

[donghyuck]

PR #389 병합 확인했습니다. 이슈를 닫습니다.