🔵 F7: API 계약 자동 검증 CI (springdoc-openapi + git diff)

[ThonApple]

배경

PR #32 진행 중 FRONTEND.md와 코드 간 명세 불일치가 다수 발견됨. 향후 같은 문제를 막기 위해 옵션 A 자동화 — 코드에서 자동 생성한 OpenAPI 스펙을 리포 커밋 버전과 CI에서 diff.

해야 할 일

1. build.gradle.kts — org.springdoc.openapi-gradle-plugin 추가
2. springdoc 의존성 — org.springdoc:springdoc-openapi-starter-webmvc-ui
3. ./gradlew generateOpenApiDocs → docs/openapi.json 산출
4. GitHub Actions 워크플로 — .github/workflows/api-contract-check.yml
   • ./gradlew generateOpenApiDocs
   • git diff --exit-code docs/openapi.json 실패 시 PR fail
5. (선택) oasdiff action으로 breaking change 시 PR에 자동 댓글

검증

• PR에서 컨트롤러 응답 시그니처 바꾸면 CI가 실패
• docs/openapi.json 함께 커밋하면 통과
• FRONTEND.md 와 별도로 머신 검증 가능

의존성

독립. 인프라 작업.

영향 파일

build.gradle.kts, capstone-api/build.gradle.kts, .github/workflows/api-contract-check.yml, docs/openapi.json (신규)