[Feat] 문서 버전 이력과 제출 검증 증빙 보완

[Gimini-3]

🔍️ 작업 내용

• Closes 문서 버전 이력과 제출 검증 증빙 보완 #308

• 읽기 가능한 문서의 전체 버전과 버전별 최신 인덱싱 Job Snapshot을 조회하는 API와 UI를 추가했습니다.
• 소유자뿐 아니라 계산된 WRITE 권한 사용자도 새 버전을 업로드할 수 있게 하고 실제 저장 Transaction에서 권한을 다시 확인합니다.
• MCP 도구 실행 결과·소요 시간을 민감정보 없이 기록하고 발급 Token 원문을 화면에 렌더링하지 않도록 변경했습니다.
• OpenSQL Single 중단·재연결·Lease 복구 Runbook과 기존 실행 결과를 공개했습니다.
• 로컬 .demo, 촬영 스토리보드와 루트 FETCH_HEAD를 Git 대상에서 제외했습니다.

✨ 상세 설명

문서 상세 화면에서 정상인 현재 버전과 실패한 새 버전을 함께 확인할 수 있습니다. 버전 응답에는 파일 Snapshot과 최신 Job 상태만 포함하고 저장소 위치, Claim Token과 내부 오류 상세문은 노출하지 않습니다.

기존 OpenSQL 복구 결과는 8aeedc9에서 실행한 과거 증빙임을 명시했습니다. 최종 제출 Commit에서 같은 실장애를 다시 실행한 결과로 주장하지 않습니다.

시연 녹화 시나리오, 데모 문서·계정·DB Snapshot과 scripts/demo/**는 이 PR에 포함하지 않았습니다.

✅ 검증

• Backend 전체 테스트: 1,120 / 1,120 PASS
• Frontend Build·테스트: 39 / 39 PASS
• 변경 관련 Backend 단위·Controller 테스트: PASS
• bash -n scripts/opensql/verify-single-recovery.sh: PASS
• git diff --check: PASS
• 변경 대상 절대경로·Token·Private Key 패턴 검사: 이상 없음

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

• 최종 제출 Commit에서 OpenSQL Single 중단·재연결 시나리오를 다시 실행할 경우 별도 결과 문서로 기록합니다.
• 다중 Node HA, Primary/Standby 승격과 무중단 Failover는 이 PR 범위에 포함하지 않습니다.

📸 스크린샷 (선택)

• 시연 녹화 자료는 로컬 전용이므로 첨부하지 않았습니다.

💬 리뷰 요구사항

• WRITE 권한 준비·실제 저장의 이중 검증 경계
• 버전 이력 응답에서 운영 내부 값이 제외됐는지
• MCP Log와 Token UI에 원문·Query·본문이 노출되지 않는지
• OpenSQL 결과 문서가 실행 Commit과 최종 제출 Commit을 혼동하지 않는지

[coderabbitai]

Important

• 🔍 Trigger review

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

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 53656959-dd52-489f-a363-d2aa7cda4aa6

---

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