[공통] 팀원 모집 알림 단건 명령의 204·404 정책 불일치

[taejinn]

🔍 개요

• 상위 기능 이슈: [공통] 팀원 모집 기능 구현 #2335
• 기준: origin/develop@2bbb2a23ca04fc7ece8a2986f12e88f12a4ab92e
• 심각도: P2
• 분류: 클라이언트 재시도 계약 + 서버 정보 노출 정책
• 상태: Callvan 기준으로 정책 확정, Draft PR fix: 팀원 모집 알림 단건 명령을 recipient 범위의 멱등 처리로 통일 #2387 구현 완료

확정 정책

팀원 모집 알림 단건 읽음·삭제는 Callvan과 동일한 recipient 범위 멱등 204로 처리합니다.

• 본인 unread 알림 읽음: 204
• 이미 읽은 본인 알림 재읽음: 204, 최초 readAt 유지
• 본인 알림 삭제 및 재삭제: 204
• soft-deleted 본인 알림 읽음: 204 no-op
• 존재하지 않는 ID: 204 no-op
• 타 사용자 ID: 204 no-op, 타 사용자 데이터는 변경하지 않음

📱 클라이언트 영향

클라이언트는 stale 상태나 네트워크 실패 후 읽음·삭제 요청을 안전하게 재시도할 수 있습니다. 404 분기나 리소스 존재 여부 추론이 필요하지 않습니다.

✅ 완료 조건

• recipient ID, notification ID, 미삭제 조건으로 원자적으로 갱신합니다.
• 반복 호출과 타 사용자 격리를 실제 MySQL HTTP 테스트로 검증합니다.
• Java Swagger에서 단건 404를 제거하고 멱등 204를 명시합니다.

🚫 범위 밖

• 알림 목록·전체 읽음·전체 삭제 인수 테스트: [공통] 팀원 모집 알림 목록 및 일괄 처리 HTTP 인수 테스트 보강 #2401/test: 팀원 모집 알림 목록과 일괄 처리 HTTP 인수 테스트 추가 #2405
• 실제 Firebase FCM 발송

[taejinn]

2026-09-01 정책 확정 및 PR #2387 구현 반영

• Callvan과 동일한 recipient-scoped 멱등 204
• 이미 읽음·이미 삭제·없는 ID·타 사용자 ID는 no-op 204
• 타 사용자 알림은 변경하지 않으며 최초 read_at은 보존
• 공개 정적 OpenAPI 동기화는 [공통] 팀원 모집 Java Swagger와 공개 API 명세 불일치 #2378/#2391에서 별도 처리