[Docs] 담당 이슈별 작업 문서 정리

[Gimini-3]

변경 사항

• 기민 담당 작업을 GitHub 이슈 번호 기준으로 docs/에 정리했습니다.
• 누락됐던 이슈 [Feat] 1단계 MVP 도메인 Entity 및 Enum 생성 #5, [FEAT] 기본 임베딩 모델 등록 및 조회 #10, [Feat] 문서 업로드 접수 API 구현 #15 설계·구현 문서를 추가했습니다.
• 로컬 DB 문서의 번호를 PR 번호 #4에서 실제 이슈 번호 #3으로 수정했습니다.
• 기본 임베딩 모델 동시성 검증 문서의 번호를 기능 이슈 #10에서 테스트 이슈 #12로 수정했습니다.
• 이슈 [Feature] 문서 새 버전 업로드 #25·[Test] 실제 MinIO 업로드 동시성 검증 #27 문서에서 내부 작업 구분 표현을 제거하고 공개 문서 용어와 링크를 정리했습니다.

문서 구성

• [Feat] DB 관련 로컬 개발 환경 설정 #3 로컬 DB 개발 환경
• [Feat] 1단계 MVP 도메인 Entity 및 Enum 생성 #5 MVP 도메인 모델과 Flyway 스키마
• [FEAT] 기본 임베딩 모델 등록 및 조회 #10 기본 임베딩 모델 등록·조회
• [Test] 기본 임베딩 모델 단일성 및 동시성 검증 #12 기본 임베딩 모델 단일성·동시성 검증
• [Feat] 문서 업로드 접수 API 구현 #15 문서 업로드 접수 API
• [Feature] 문서 새 버전 업로드 #25 문서 새 버전 업로드 및 테스트 결과
• [Test] 실제 MinIO 업로드 동시성 검증 #27 실제 MinIO 업로드 동시성 테스트 결과

영향

애플리케이션 코드와 DB 스키마는 변경하지 않습니다. 문서 이름과 내용만 실제 GitHub 이슈 기준으로 정리합니다.

검증

• 로컬 Markdown 링크 존재 여부 확인
• 코드 블록 fence 균형 확인
• trailing whitespace 및 git diff --check 확인
• 공개 문서의 내부 작업명과 잘못된 이슈 번호 제거 확인

Summary by CodeRabbit

• 문서화
  • 기본 임베딩 모델의 등록·조회 기준과 동시성 검증 방법을 문서화했습니다.
  • 문서 업로드 API의 파일 검증, 중복 처리, 버전 및 임베딩 작업 생성 규칙을 정의했습니다.
  • MVP 도메인 모델과 로컬 DB 구성 문서를 정리했습니다.
  • 문서 버전 업로드 및 MinIO 동시성 테스트 문서를 기능 중심으로 갱신했습니다.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: f265a1b6-e708-4231-9ab6-59bd2b6d19d0

📥 Commits

Reviewing files that changed from the base of the PR and between 1ea8b70 and 9ed45d3.

📒 Files selected for processing (8)

• docs/gimin-#10-embedding-model-basic.md
• docs/gimin-#15-document-upload-api.md
• docs/gimin-#25-document-version-upload.md
• docs/gimin-#3-local-db.md
• docs/gimin-#5-mvp-domain-model.md
• docs/test-results/gimin-#12-embedding-model-concurrency-verification.md
• docs/test-results/gimin-#25-document-version-upload.md
• docs/test-results/gimin-#27-minio-concurrency-integration-test.md

---

📝 Walkthrough

Walkthrough

임베딩 모델, 문서 업로드, 문서 버전 업로드 및 MVP 도메인 모델 관련 설계 문서를 추가·정리했다. PR 중심 표현을 기능·이슈 중심으로 변경하고, 동시성·상태·검증 범위를 구체화했다.

Changes

문서 기능 계약

Layer / File(s)	Summary
MVP 도메인 및 로컬 DB 문서 docs/gimin-#3-local-db.md, docs/gimin-#5-mvp-domain-model.md	로컬 DB 제목을 갱신하고 MVP 도메인 모델, Flyway 순서, 연관관계와 DB 불변식을 정리했다.
기본 임베딩 모델 계약 docs/gimin-#10-embedding-model-basic.md, docs/test-results/gimin-#12-embedding-model-concurrency-verification.md	활성·검색 가능 모델 규칙, Partial Unique Index, Seed, 조회 계약, 작업별 모델 ID 저장 및 동시성 검증 기준을 정의했다.
문서 업로드 접수 계약 docs/gimin-#15-document-upload-api.md, docs/test-results/gimin-#27-minio-concurrency-integration-test.md	업로드 검증, SHA-256 기반 파일 재사용, 동시 업로드 처리, MinIO 보상 삭제와 실제 저장소 검증 기준을 문서화했다.
문서 버전 계약 및 테스트 문서 docs/gimin-#25-document-version-upload.md, docs/test-results/gimin-#25-document-version-upload.md	PR 명칭 중심 표현을 기능·이슈 중심으로 바꾸고 버전 상태, 인덱싱 완료, 실패·재처리 및 상태 조회 계약을 갱신했다.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

• DocGrid/backend#6: 임베딩 모델과 문서·버전·파일·작업 엔티티의 실제 구현이 관련 계약과 연결된다.
• DocGrid/backend#22: 문서 업로드 API와 파일 검증, Object 재사용 및 EmbeddingJob 생성 흐름이 직접 연관된다.
• DocGrid/backend#26: 문서 새 버전 업로드 계약과 구현 흐름이 같은 기능 영역을 다룬다.

Suggested labels: ✨ Feature

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/docs-gimin-issue-summary

---

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