docs: Java 구현 주석과 흐름 설명 보강

[Gimini-3]

변경 내용

• Git 작성 이력과 최근 작업을 기준으로 핵심 Java 구현 140개 파일의 주석을 보완했습니다.
• 클래스와 메서드의 역할·책임·경계를 설명하고, 순차 실행 흐름은 번호 주석으로 정리했습니다.
• 이미 충분한 주석은 유지하고 현재 구현과 달라진 설명만 갱신했습니다.
• PDF·DOCX 파싱, 설정형 파일 저장소, 권한 CHECK 제약, Ollama 비동기 RAG, pgvector 저장 구조를 현재 코드에 맞게 반영했습니다.
• 비즈니스 로직은 변경하지 않았습니다.

커밋 구성

1. 문서 업로드·파싱 흐름
2. 임베딩·Worker 수명주기
3. Sync Event·Reconciliation 흐름
4. 검색·RAG·MCP·권한 흐름

검증

• git diff --check 통과
• ./backend/gradlew -p backend compileJava 통과
• ./backend/gradlew -p backend test 실행: 1,064개 중 86개 실패
  • 실패 원인은 테스트 PostgreSQL localhost:55432 연결 거부이며, 소스 컴파일 오류는 없습니다.

[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: Team

Run ID: 9188ea1d-e6c9-4269-abfc-7ae72dec8b46

---

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

[Gimini-3]

동일한 Java 주석 변경을 도메인과 실행 흐름 기준의 16개 커밋으로 세분화해 #311로 다시 올렸습니다.