docs: 팀원 모집 Java Swagger와 공개 API 계약 동기화

[taejinn]

🔍 개요

• 팀원 모집 Java OpenAPI가 실제 JSON의 required, nullable, 날짜, query 계약을 정확히 표현하도록 정렬합니다.

• Part of [공통] 팀원 모집 Java Swagger와 공개 API 명세 불일치 #2378

---

🚀 주요 변경 내용

• Campus 문서의 팀원 모집 operation 23개를 exact path/method로 고정합니다.
• 채팅·알림 응답 필드와 메시지 요청 필드의 required 계약을 명시합니다.
• TEAM counterpart, GENERAL role, apply_block_reason, 내 지원 정보의 required key와 nullable value를 OpenAPI 3.0 inline schema로 표현합니다.
• nullable $ref schema를 복제해 inline하고 공유 component 값을 보존합니다.
• 알림·메시지의 T 날짜 형식과 지원·모집의 공백 날짜 형식을 runtime pattern으로 명시합니다.
• apply_block_reason 우선순위와 enum 값을 고정합니다.
• 메시지 조회 query 이름을 afterMessageId, beforeMessageId, limit으로 명시합니다.
• 팀원 모집 customizer를 Campus group에 등록합니다.

---

💬 참고 사항

• 영향
  • 심각도는 P1 문서·SDK 계약 오류이며 클라이언트가 nullable·required·날짜 형식을 반영한 타입과 SDK를 생성할 수 있습니다.
  • controller/service 처리와 실제 JSON 값을 유지하며 Java OpenAPI 표현을 정렬합니다.
• 검증
  • TeamRecruitmentOpenApiContractTest 3개와 TeamRecruitmentOpenApiCustomizerTest 1개가 통과했습니다.
  • fix: OpenAPI dialect와 component schema 참조 정합성 수정 #2404 위 최종 branch에서 팀원 모집 228개와 전역 OpenAPI 3개, 총 231개가 통과했습니다.
  • 직렬화 값 2026-08-26T11:20:30.123456과 2026-08-26 11:20:30을 확인했습니다.
• 반영 순서
  • 현재 base는 fix: OpenAPI dialect와 component schema 참조 정합성 수정 #2404 branch이며 #2404와 fix: OpenAPI 응답 코드를 표준 status와 204 no-content로 정규화 #2390 반영 후 최신 develop에 rebase해 최종 OpenAPI 조합을 확인합니다.

---

✅ Checklist (완료 조건)

• 코드 스타일 가이드 준수
• 테스트 코드 포함됨
• Reviewers / Assignees / Labels 지정 완료
• 보안 및 민감 정보 검증 (API 키, 환경 변수, 개인정보 등)

[coderabbitai]

Warning

Review limit reached

Next included review available in 6 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

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

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: 758d60d1-ea57-4079-8ded-391a2f3adbac

📥 Commits

Reviewing files that changed from the base of the PR and between e77f271 and c87fe9c.

📒 Files selected for processing (14)

• src/main/java/in/koreatech/koin/domain/team/recruitment/dto/ApplicationRole.java
• src/main/java/in/koreatech/koin/domain/team/recruitment/dto/RecruitmentDetail.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/controller/TeamRecruitmentChatApi.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/controller/TeamRecruitmentChatController.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/ChatMessageResponse.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/ChatRoomResponse.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/CreateChatMessageRequest.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/DirectChatRoomResponse.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/TeamRecruitmentNotificationResponse.java
• src/main/java/in/koreatech/koin/domain/teamrecruitment/dto/TeamRecruitmentNotificationsResponse.java
• src/main/java/in/koreatech/koin/global/config/SwaggerGroupConfig.java
• src/main/java/in/koreatech/koin/global/config/TeamRecruitmentOpenApiCustomizer.java
• src/test/java/in/koreatech/koin/acceptance/domain/TeamRecruitmentOpenApiContractTest.java
• src/test/java/in/koreatech/koin/unit/global/config/TeamRecruitmentOpenApiCustomizerTest.java

---

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

[github-actions]

Unit Test Results

1 134 tests   1 131 ✔️  2m 40s ⏱️
   255 suites         3 💤
   255 files           0 ❌

Results for commit c87fe9c.

♻️ This comment has been updated with latest results.