[Docs] 테스트 결과 문서 위치와 개념 설명 수정

[Gimini-3]

배경

병합된 #53의 테스트 결과 문서에 내부 작업 순번 별칭이 포함돼 있었고, 실행 결과 문서의 저장 기준도 명확히 분리되지 않았습니다.

내부 작업 순번은 사용자와 Codex 사이의 계획용 표현으로만 유지하고, GitHub와 저장소에는 실제 기능명과 이슈 번호만 사용하도록 정리합니다.

Related to #52 and #53

변경 내용

• AGENTS.md에 문서 작성 규칙 추가
  • 내부 작업 순번 별칭을 GitHub 이슈·PR·문서·코드·주석에 노출하지 않음
  • 외부 문서에는 실제 이슈 번호나 기능·테스트 이름 사용
  • 설계 문서는 docs/design/에 저장
  • 실행한 테스트 계획·재현 가이드·측정값·결과는 docs/test-results/에 저장
• Claim 동시성 테스트 결과 문서를 docs/test-results/gimin-#52-embedding-job-claim-concurrency.md로 정리
• 결과 문서의 내부 작업 순번 표현 제거
• 초보자를 위한 동시성 테스트 기본 개념 추가
  • Task
  • Executor와 Thread Pool
  • readyLatch
  • startLatch
  • Claim
• 모든 Task가 준비된 뒤 거의 동시에 Claim을 시작하는 전체 흐름 추가
• Task와 DB Job의 차이, Executor Thread 수가 부족할 때 발생하는 Gate 교착 가능성 설명

GitHub 본문 동기화

• 이슈 #52의 내부 작업 순번 표현 제거 및 기본 개념 추가
• 병합된 PR [Test] 다중 Worker Job Claim 정합성 검증 #53 본문의 내부 작업 순번 표현 제거
• PR #53의 실행 가이드 경로를 docs/test-results/로 수정
• 기존 CodeRabbit 요약은 보존

검증

• 저장소 변경 파일에서 내부 작업 순번 표현이 남지 않았는지 검색
• GitHub 이슈 #52와 PR [Test] 다중 Worker Job Claim 정합성 검증 #53 본문에서 같은 표현과 잘못된 결과 문서 경로가 남지 않았는지 검색
• git diff --check 통과
• 문서 이동이 Git Rename으로 인식되는지 확인

Java·Gradle·Production 동작 코드는 변경하지 않았으므로 테스트는 재실행하지 않았습니다.

Summary by CodeRabbit

• 문서화
  • 외부 문서에서 내부 전용 식별자를 노출하지 않도록 문서 작성 규칙을 추가했습니다.
  • 문서 유형에 따른 저장 위치와 외부 아티팩트 작성 기준을 명확히 했습니다.
  • Embedding Job 동시성 테스트 문서를 기능과 검증 불변식 중심으로 개선했습니다.
  • 테스트 개념, 실행 흐름, 경쟁 제어 방식에 대한 설명과 다이어그램을 보강했습니다.
  • 성능 및 락 경합 측정 관련 안내를 별도 테스트 환경 기준으로 정리했습니다.

[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: a97af668-1c5f-4146-840c-401b72decd83

📥 Commits

Reviewing files that changed from the base of the PR and between ceae0b9 and 22b3e65.

📒 Files selected for processing (2)

• AGENTS.md
• docs/test-results/gimin-#52-embedding-job-claim-concurrency.md

---

📝 Walkthrough

Walkthrough

문서 외부에 내부 PR 라벨을 노출하지 않는 규칙이 추가되었습니다. Embedding Job Claim 동시성 테스트 문서는 PR 중심 표현을 기능 중심으로 변경하고, 핵심 개념과 실행 흐름 설명을 보강했습니다.

Changes

문서 표기 및 테스트 설명 정비

Layer / File(s)	Summary
문서화 규칙 추가 AGENTS.md	내부 PR 라벨 비노출, 외부 아티팩트 표기, 디자인 문서와 테스트 결과 문서의 저장 경로 규칙을 추가했습니다.
Claim 동시성 테스트 문서 개편 docs/test-results/gimin-#52-embedding-job-claim-concurrency.md	PR 번호 중심 표현을 PENDING Job Claim과 Lease Lock 중심으로 변경하고, Task, Executor, latch, Claim, FOR UPDATE SKIP LOCKED 및 테스트 실행 흐름을 설명했습니다.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• DocGrid/backend#53: 동일한 Embedding Job Claim 동시성 테스트를 대상으로 관련 통합 테스트와 안내를 추가합니다.

Suggested labels: 📃 Docs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/53-test-result-convention

---

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