Skip to content

[Fix] 정상 삭제된 문서에 MISSING_EMBEDDINGS 정합성 Issue가 남는 문제 - #519

Merged
Gimini-3 merged 3 commits into
developfrom
fix/518
Oct 16, 2026
Merged

Gimini-3 merged 3 commits into
developfrom
fix/518

Conversation

@Gimini-3

Copy link
Copy Markdown
Contributor

🔍️ 작업 내용

정상 삭제된 문서에 해소되지 않는 MISSING_EMBEDDINGS(CRITICAL) 정합성 Issue가 남던 오탐을 고쳤습니다.
같은 단위 시험으로 수정 전 실패 2건, 수정 후 통과 5건을 확인했습니다. 격리 DB의 전체 백엔드 clean build는 1,497건 중 실패·오류 0건이었습니다.

✨ 상세 설명

  • 문서를 삭제하면 DOCUMENT_DELETED Outbox가 Vector를 모두 ACTIVE → STALE로 바꿉니다. 그런데 SyncConsistencyInspector.inspectChunksAndEmbeddings는 문서 상태를 보지 않고 "현재 INDEXED 버전의 Chunk 수 > ACTIVE Vector 수"만 비교했습니다. 그 결과 삭제가 정상으로 끝난 문서도 Vector 누락으로 보고됐습니다.
  • 삭제 직후 Vector 일부만 ACTIVE로 남은 경우에는, 수정 전 코드가 삭제 문서를 repairable=true로 분류했습니다(단위 시험으로 확인).
  • 변경: Vector 완전성 조건에 document.status != DELETED 한 줄을 추가했습니다(Javadoc 한 줄 포함). 같은 분기의 MISSING_EMBEDDINGS·MODEL_MISMATCH가 삭제 문서에서 빠집니다.
  • 삭제 잔여물은 기존 DELETED_DOCUMENT_RESIDUE가 그대로 보고합니다. 다른 검사, DB 스키마, 설정, API 형식은 바꾸지 않았습니다.
  • 이미 열린 오탐 Issue는 마이그레이션 없이, 수정 배포 뒤 첫 점검에서 RESOLVED가 됩니다(실제 경로로 확인).
  • 설계

🧪 실제 검증 결과

환경: 로컬 macOS arm64·Temurin 17.0.18, 새 격리 PostgreSQL 17.8·pgvector 0.8.1·Valkey 컨테이너(사용자 로컬 DB 미사용).
실행: 2026-10-16 16:21:22–16:27:40 +09:00. 기준은 당시 develop f238caf이고, 커밋은 그 뒤 develop 8971989 위에 올렸습니다. 그 사이 병합된 #514는 RAG 파일 3개만 바꿔 이번 변경 파일과 겹치지 않습니다.

실행 실행·실패·오류·건너뜀 관측 결과
red-01 5·2·0·0 수정 전. 전부 STALE이면 MISSING_EMBEDDINGS(0/5/5, #517 실시험과 같음), 일부 ACTIVE면 MISSING_EMBEDDINGS(repairable=true)가 잔여물과 함께 보고됨
green-01 5·0·0·0 수정 후 같은 시험 통과. 바뀐 입력은 서비스 파일 하나
full-build-01 1,497·0·0·5 CI와 같은 clean build, 251개 묶음. 건너뜀 5건은 기존과 같음
live-deleted-residue-01 — 실제 HTTP 삭제·Outbox 경로. 수정 전 JAR는 오탐 재현, 이어서 수정 JAR로 점검하자 탐지 0건·기존 오탐 RESOLVED·OPEN 0건
  • red-01과 green-01의 시험 파일 SHA-256은 같습니다. red-01의 서비스 파일은 develop 원본과 해시가 같습니다.
  • 시험 컨테이너 5개와 임시 비밀값은 삭제했습니다. 증거에는 토큰을 남기지 않았습니다.
  • 실행별 로그·JUnit 요약·입력 해시·재현 스크립트
  • 일부 ACTIVE 상태의 삭제 문서는 단위 시험으로만 확인했습니다. 그 상태에서 수정 전 REPAIR가 예약했을 Event가 실패한다는 것은 코드 분석입니다.

🛠️ 추후 리팩토링 및 고도화 계획

💬 리뷰 요구사항

정상 삭제 뒤 STALE Vector만 남은 문서에 MISSING_EMBEDDINGS가 열리던 오탐을 막는다. 삭제 잔여물은 DELETED_DOCUMENT_RESIDUE가 계속 보고한다.

Refs #518
@Gimini-3 Gimini-3 self-assigned this Oct 16, 2026
@coderabbitai

coderabbitai Bot commented Oct 16, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: Repository: DocGrid/docgrid/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: f9beecd9-7f13-47fe-9b2f-d748b4f27e2c
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Fix] 정상 삭제된 문서에 MISSING_EMBEDDINGS 정합성 Issue가 남는 문제

1 participant