Skip to content

[Test] 정합성 점검기 복구·보고 격리 시험과 문서화 - #521

Merged
Gimini-3 merged 3 commits into
developfrom
test/517
Oct 16, 2026
Merged

Gimini-3 merged 3 commits into
developfrom
test/517

Conversation

@Gimini-3

Copy link
Copy Markdown
Contributor

🔍️ 작업 내용

이미 구현된 정합성 점검기(Reconciler)를 로컬 격리 환경에서 시험하고, 결과와 설계를 문서로 정리했습니다. 운영 코드 변경은 없습니다.
복구 증명 2건은 탐지부터 재점검 종결까지 통과했습니다. 보고 사례 2건은 자동 복구 없이 보고만 했습니다. 시험 중 발견한 삭제 문서 오탐은 #518에서 고쳤습니다.

✨ 상세 설명

  • 시험 기록: docs/test-results/reconciler-repair-20261016/ — 실행 ID별 주입 SQL, 주입 전후 상태, API 응답, Issue·Event·Job 상태, 정리 내역
  • 설계 문서: 8가지 검사, 보고만 하는 이유, DRY_RUN·REPAIR 두 모드(DRY_RUN도 DB에 쓴다), API 명세와 오류, Issue 생명주기, 주기 점검이 기본으로 꺼진 이유, A/B 중복 실행 한계(분석)
  • README: 「주요 기능」 1줄, 「검증된 범위」 표 1행(시험 조건과 한계 포함, 점수 표현 없음)
  • 시험 기록 · 설계

🧪 실제 검증 결과

환경: 로컬 macOS arm64, develop f238caf JAR, 새 격리 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.

실행 주입 관측 판정
run-baseline-01 없음 버전 2개, Issue 0건 통과
run-missing-embeddings-01 ACTIVE Vector 1행 삭제 탐지 → Event 1 → 새 Job 1 → INDEXED → RESOLVED. 기존 Vector 4행 ID·해시 보존, 누락 1행만 같은 해시로 추가, 검색 1위가 복구 Vector 통과
run-missing-job-01 attempt 없는 PENDING Job 삭제 Dispatcher가 다시 만들지 않음 → 탐지 → Event 1 → 새 Job → Worker 켠 뒤 INDEXED, 검색 반환 통과
run-deleted-residue-01 Dispatcher 끈 채 정상 삭제 DELETED_DOCUMENT_RESIDUE 보고, REPAIR 0건, 단건 복구 409. 잔여 중 검색 0건. 삭제 Event 처리 뒤 RESOLVED 부분 통과(아래 오탐)
run-stalled-version-01 updated_at 20분 과거, 이어서 Job 삭제 STALLED_VERSION WARNING → MISSING_JOB과 동시 탐지·ERROR. REPAIR는 MISSING_JOB만 예약 통과
run-final-check-01 없음 Vector·live Job 중복 0, 미처리 Outbox 0. OPEN 1건(아래 오탐) 기록

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

  • MISSING_CHUNKS·MODEL_MISMATCH·INVALID_CURRENT_VERSION·ORPHANED_DATA는 이번에 주입하지 않았고, 유형 이름으로 찾히는 자동 시험도 없습니다.
  • 주기 점검을 A/B 양쪽에서 켜면 같은 범위를 중복 점검합니다. 새 Issue 동시 생성 시 배치 실패 가능성은 코드 분석이며 시험하지 않았습니다.
  • 관리 화면 "상태 검사 실행" 버튼은 REPAIR 모드로 첫 배치(100개)만 실행합니다(설계 문서 6절).

💬 리뷰 요구사항

  • 문서만 바뀝니다(시험 기록 127개 파일, 설계 1개, README 3줄).
  • README 「검증된 범위」 행의 측정 조건·한계 표현이 과장되지 않았는지 확인해 주세요.

@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: f011fb7b-4f56-4e4c-baa0-279071c50dbb
  • 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.

@Gimini-3
Gimini-3 merged commit 0e685ca into develop Oct 16, 2026
3 checks passed
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.

[Test] 정합성 점검기 복구·보고 경로 격리 시험과 문서화

1 participant