Repository navigation
Conversation
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configuration
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. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔍️ 작업 내용
이미 구현된 정합성 점검기(Reconciler)를 로컬 격리 환경에서 시험하고, 결과와 설계를 문서로 정리했습니다. 운영 코드 변경은 없습니다.
복구 증명 2건은 탐지부터 재점검 종결까지 통과했습니다. 보고 사례 2건은 자동 복구 없이 보고만 했습니다. 시험 중 발견한 삭제 문서 오탐은 #518에서 고쳤습니다.
✨ 상세 설명
docs/test-results/reconciler-repair-20261016/— 실행 ID별 주입 SQL, 주입 전후 상태, API 응답, Issue·Event·Job 상태, 정리 내역DRY_RUN·REPAIR두 모드(DRY_RUN도 DB에 쓴다), API 명세와 오류, Issue 생명주기, 주기 점검이 기본으로 꺼진 이유, A/B 중복 실행 한계(분석)🧪 실제 검증 결과
환경: 로컬 macOS arm64, develop
f238cafJAR, 새 격리 PostgreSQL 17.8·pgvector 0.8.1·Valkey·BGE-M3 컨테이너, 시험 문서 4건(Chunk 20개), 수동 API, Backend 1대. 공개 서비스·GCP·기존 사용자 데이터는 쓰지 않았습니다.실행: 2026-10-16 15:57–16:06 KST.
INDEXED→RESOLVED. 기존 Vector 4행 ID·해시 보존, 누락 1행만 같은 해시로 추가, 검색 1위가 복구 VectorPENDINGJob 삭제INDEXED, 검색 반환DELETED_DOCUMENT_RESIDUE보고,REPAIR0건, 단건 복구 409. 잔여 중 검색 0건. 삭제 Event 처리 뒤RESOLVEDupdated_at20분 과거, 이어서 Job 삭제STALLED_VERSIONWARNING →MISSING_JOB과 동시 탐지·ERROR.REPAIR는MISSING_JOB만 예약MISSING_EMBEDDINGS(CRITICAL)가 열려 남았습니다. 시험 지시에 따라 이 PR에서는 고치지 않았고, [Fix] 정상 삭제된 문서에 MISSING_EMBEDDINGS 정합성 Issue가 남는 문제 #518(PR [Fix] 정상 삭제된 문서에 MISSING_EMBEDDINGS 정합성 Issue가 남는 문제 #519)에서 수정·재시험해 develop에 머지했습니다.🛠️ 추후 리팩토링 및 고도화 계획
MISSING_CHUNKS·MODEL_MISMATCH·INVALID_CURRENT_VERSION·ORPHANED_DATA는 이번에 주입하지 않았고, 유형 이름으로 찾히는 자동 시험도 없습니다.REPAIR모드로 첫 배치(100개)만 실행합니다(설계 문서 6절).💬 리뷰 요구사항