인덱싱·Vector 검색 최종 통합 성능 리포트 및 그래프 지원 추가 구현

[Gimini-3]

배경

Claim, 실제 BGE-M3 배치, Vector 검색, Worker 수평 확장, Queue Backpressure, PDF·DOCX E2E 부하 결과가 개별 문서에 분산되어 있습니다. 현재 상태만으로는 전체 병목의 이동, 권장 운영값, 서로 비교하면 안 되는 실험 조건을 한눈에 설명하기 어렵습니다.

목표

기존 실측 결과를 정규화된 원본 데이터와 재생성 가능한 그래프로 통합하고, 비교 가능한 범위와 한계를 명시한 최종 성능 리포트를 제공합니다.

구현 범위

• 기존 실측 문서의 핵심 수치와 출처를 하나의 정규화 데이터 파일로 관리
• 정규화 데이터의 스키마·필수 필드·유한값·원본 문서 존재 여부 검증
• 외부 시각화 라이브러리 없이 GitHub에서 바로 렌더링되는 SVG 그래프 생성
• 다음 영역별 비교표와 그래프 제공
  • OpenSQL Job Claim 처리량과 Tail Latency
  • 실제 BGE-M3 Batch Size별 처리량과 지연
  • Exact Search 대비 HNSW 속도와 Recall@K
  • Worker 수·실행 슬롯별 수평 확장
  • Queue 적체·DB Pool Backpressure
  • 실제 PDF·DOCX 50·100문서 전체 E2E
• 실험 조건이 다른 결과를 하나의 순위표로 오해하지 않도록 비교 경계 명시
• 병목, 권장 기본값, 운영 전 추가 검증 항목을 최종 결론으로 정리
• 생성 결과가 정규화 데이터와 일치하는지 확인하는 재현성 검사 명령 제공

산출물

• 설계 문서: docs/design/
• 정규화 원본 데이터: docs/test-results/
• 최종 통합 성능 리포트: docs/test-results/
• GitHub 렌더링용 SVG: docs/test-results/assets/
• 재현 가능한 그래프 생성기: scripts/performance/

제외 범위

• 기존 Benchmark 재실행
• 제품 코드 또는 운영 기본값 변경
• 서로 다른 문서 크기·환경의 결과를 직접 우열 비교
• 현재 실측값을 운영 SLO로 확정
• 공급사 지원 Rocky Linux 원격 환경의 최종 승인 판정

완료 조건

• 정규화 데이터의 모든 출처가 실제 문서와 연결된다.
• 생성기가 모든 그래프를 결정적으로 재생성한다.
• 검사 모드에서 데이터 오류와 생성 결과 불일치를 탐지한다.
• 최종 리포트에 비교표, 그래프, 병목 분석, 권장값, 한계가 포함된다.
• 관련 자동 검증과 전체 프로젝트 테스트가 통과한다.