Dispatch·Embedding 장애 지점 복구 검증

[Gimini-3]

변경 사항

• Claim 세대별 시작·성공·Handler 실패·Lease 만료를 보존하는 sync_event_delivery_attempts 이력을 추가했습니다.
• Event Claim 직후, Handler 시작 직후, Job 생성 직후, Embedding 저장 도중, Event 완료 직전 장애를 실제 PostgreSQL Trigger와 강제 예외로 주입했습니다.
• Sync/Worker Lease Recovery, Retry, 새 Attempt, 인덱싱 완료 후 Event·Job·Attempt·Chunk·Vector·currentVersion의 최종 정합성을 검증했습니다.
• 과거 부분 Commit 형태의 누락 Job을 Reconciler가 탐지하고 Repair Event로 복구한 뒤 Issue를 RESOLVED로 종결하는 흐름을 검증했습니다.
• 실제 Reconciliation에서 발견한 Chunk 고아 검사 조인 오류를 Version 원장 경유로 수정했습니다.
• 실행 환경·중간 상태·최종 결과를 docs/test-results/gimin-#168-sync-failure-recovery.md에 기록했습니다.

검증

• 필수 장애·복구 통합 및 단위 테스트: BUILD SUCCESSFUL in 8s
• 전체 백엔드 회귀: BUILD SUCCESSFUL in 34s
• 전달 Attempt 입력 불변식 보강 후 관련 재검증: BUILD SUCCESSFUL in 6s

Closes #168

[coderabbitai]

Warning

Review limit reached

@Gimini-3, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 99 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 1a43f0a5-9111-4e69-ab16-d6c895f4a4bd

📥 Commits

Reviewing files that changed from the base of the PR and between 643f85d and 9c88b87.

📒 Files selected for processing (16)

• backend/src/main/java/com/opensource/docgrid/domain/document/repository/DocumentChunkRepository.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/entity/SyncEventDeliveryAttempt.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/enums/SyncEventDeliveryAttemptStatus.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/repository/SyncEventDeliveryAttemptRepository.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/service/command/SyncEventClaimService.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/service/command/SyncEventDeliveryAttemptService.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/service/command/SyncEventDispatchService.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/service/command/SyncEventFailureService.java
• backend/src/main/java/com/opensource/docgrid/domain/sync/service/command/SyncEventLeaseRecoveryService.java
• backend/src/main/resources/db/migration/V39__create_sync_event_delivery_attempts.sql
• backend/src/test/java/com/opensource/docgrid/domain/sync/entity/SyncEventDeliveryAttemptTest.java
• backend/src/test/java/com/opensource/docgrid/domain/sync/integration/EmbeddingFailureRecoveryIntegrationTest.java
• backend/src/test/java/com/opensource/docgrid/domain/sync/integration/SyncDispatchFailureRecoveryIntegrationTest.java
• backend/src/test/java/com/opensource/docgrid/domain/sync/service/command/SyncEventClaimServiceTest.java
• backend/src/test/java/com/opensource/docgrid/domain/sync/service/command/SyncEventDispatchServiceTest.java
• docs/test-results/gimin-#168-sync-failure-recovery.md

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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