[Fix] 업로드 접수와 인덱싱 완료를 문서 화면에 반영

[Gimini-3]

📌 배경

프론트에서 문서를 업로드하거나 새 버전을 올려도 화면이 갱신되지 않아 사용자가 직접 새로고침해야 했습니다. UploadModal의 onSuccess가 Toast 알림에만 연결돼 있어 갱신 신호가 화면까지 도달하지 않았습니다.

수정 전 네트워크 로그 — PATCH/DELETE는 재조회가 따라오는데 업로드 경로만 누락돼 있었습니다.

POST /api/documents             → 201   (이후 목록 재조회 없음)
POST /api/documents/14/versions → 201   (이후 상세 재조회 없음)
PATCH /api/documents/14         → 204 → 재조회 ✅
DELETE /api/documents/14        → 204 → 리다이렉트 + 재조회 ✅

여기에 더해 진행 상태 카드에 "실시간 조회" 배지가 있었지만 실제 폴링이 없었습니다. 20초 관찰 동안 /status 호출이 0건이었고, 인덱싱이 비동기라 사용자는 완료 시점을 볼 수 없었습니다.

🔧 변경 내용

1. 갱신 신호 — DocGridRouter가 접수 성공 횟수를 refreshKey로 들고 목록·상세에 전달합니다. 각 화면은 직전 처리값을 useRef로 기억해 신호가 실제로 바뀐 경우에만 다시 읽습니다. 의존성 배열에만 넣으면 조회 조건이 바뀔 때도 중복 요청이 나가고 exhaustive-deps가 경고합니다.

2. 조건부 폴링 — 처리 중 버전이 남아 있는 동안에만 2초 간격으로 /status를 읽고, 끝나면 현재 버전과 추출 본문까지 맞춥니다.

3. 판단 기준 — 진행 여부를 documentStatus가 아니라 processingVersion 으로 판단합니다. 재인덱싱 중에는 검색 가용성을 위해 문서가 INDEXED를 유지하므로(#230) 문서 상태만으로는 완료와 구분되지 않습니다. 백엔드가 UPLOADED·PARSING·CHUNKED·EMBEDDING Version만 processingVersion으로 반환하므로 INDEXED로 끝나든 FAILED로 끝나든 값이 사라지면서 폴링이 멈춥니다 — 실패해도 무한 폴링이 생기지 않습니다.

완료 시 재조회는 silent로 처리해 이미 떠 있는 화면에 Loading 표시가 끼어들지 않게 했고, 언마운트·documentId 변경 시 Interval을 정리하며 늦게 도착한 응답은 active 플래그로 막습니다.

✅ 검증

브라우저에서 실제로 조작해 확인했습니다.

• 목록 자동 갱신 — 업로드 직후 새로고침 없이 총 8개 → 9개, 새 문서 즉시 표시
• 상세 자동 갱신 — 새 버전 업로드 후 이동·새로고침 없이 v1 · INDEXED → v2 · INDEXED, 원본 파일명과 추출 본문까지 교체(V2 sentinel 등장, V1 sentinel 사라짐)

네트워크 트레이스가 전후 차이를 그대로 보여줍니다.

POST .../versions                 → 201
GET  detail/status/perm/content   ← 접수 직후 즉시 재조회 (기존에 없던 동작)
GET  status ×3                    ← 처리 중에만 폴링
GET  detail/perm/content          ← 완료 시 silent 갱신
(이후 15초 추가 대기 — /status 요청 0건)

폴링이 정확히 멈췄고 콘솔 에러도 없습니다.

빌드 성공, 테스트 17/17(기존 12 + 신규 5), lint에서 이 변경으로 인한 경고는 0건입니다. 남은 lint 에러 1건(useRagAnswerSocket.ts)과 tsc 에러는 기존 문제로 이 PR 범위 밖입니다.

closes #231

[coderabbitai]

Important

Review available on request

• 🔍 Trigger review

Reviews should be triggered manually for repositories with fewer than 10 stars. Select Trigger review above or comment @coderabbitai review to review the latest changes. For a full review, comment @coderabbitai full review.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 9270d7a3-e9ed-4f84-ac5f-59f1608114fa

---

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.}