PR #98 리뷰 후속 문서 및 DB 기동 절차 보완

[Gimini-3]

변경 내용

• PostgreSQL이 healthy가 될 때까지 기다린 뒤 Application을 실행하도록 README 명령을 보완했습니다.
• 상세 설계의 금지 문자열 검사가 활성 설정에서 Match를 찾으면 실패하도록 수정했습니다.
• #97이 포함된 상세 설계 Markdown 링크를 URL 인코딩했습니다.
• API 계약 변경이 없는 DB 환경 전환에서 Swagger 수동 검증이 적용되지 않는 이유와 예외 기준을 기록했습니다.

변경 이유

PR #98의 CodeRabbit 상세 리뷰가 병합 직후 완료되어 남은 네 개의 유효한 문서·실행 안내 의견을 후속 반영합니다.

금지 문자열 검사는 README의 의도적인 과거 opensql_data 볼륨 보존 경고를 오탐하지 않도록 Docker와 Application 활성 설정 경로만 검사합니다.

적용하지 않은 의견

• .local-vendor/ 경로는 실제 .gitignore의 /.local-vendor/ 규칙과 일치하므로 변경하지 않았습니다.
• 새 Java Class나 Function을 추가하지 않아 Docstring Coverage 경고는 적용 대상이 아닙니다.

검증

• git diff --check 성공
• docker compose config --quiet 성공
• 상세 설계 Link Target 존재 확인
• 금지 문자열 조건부 검사 성공
• docker compose up -d --wait --wait-timeout 60 postgres 성공
• docker compose ps postgres에서 healthy 확인

Closes #99
Related to #98

[coderabbitai]

Warning

Review limit reached

@Gimini-3, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 0bf4ce5b-be37-4067-9d8e-6e3713e7f407

📥 Commits

Reviewing files that changed from the base of the PR and between 7b954f8 and 0ef650a.

📒 Files selected for processing (4)

• README.md
• docs/design/Gimini-3-#97-postgresql17-pgvector-local-environment.md
• docs/local-db.md
• docs/test-results/Gimini-3-#97-postgresql17-pgvector-local-environment.md

---

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