sodalive-backend-spring-boot/docs/20260313_크리에이터커뮤니티댓글알림딥링크적용.md

• 요구사항/기존 패턴 확정: 크리에이터 커뮤니티 댓글 등록 시점에 푸시 발송 + 알림 리스트 저장 경로를 기존 FCM 이벤트 파이프라인으로 연결한다.
  • QA: CreatorCommunityService#createCommunityPostComment, FcmEvent, FcmSendListener, PushNotificationService 흐름을 코드로 확인한다.
• 딥링크 규칙 확정: 댓글 알림의 딥링크를 voiceon://community/{creatorId}?postId={postId}(테스트 환경은 voiceon-test://community/{creatorId}?postId={postId})로 생성되도록 이벤트 메타를 설정한다.
  • QA: FcmService.buildDeepLink(serverEnv, deepLinkValue, deepLinkId, deepLinkCommentPostId) 규칙과 creatorId/postId 매핑을 확인한다.
• 댓글 등록 시 알림 이벤트 구현: 댓글 작성자가 크리에이터 본인이 아닌 경우에만 크리에이터 대상 INDIVIDUAL 이벤트를 발행한다.
  • QA: 이벤트에 category=COMMUNITY, deepLinkValue=COMMUNITY, deepLinkId=creatorId, deepLinkCommentPostId=postId, recipients=[creatorId]가 포함되는지 확인한다.
• 알림 문구 메시지 키 추가: 크리에이터 커뮤니티 댓글 알림용 다국어 키를 SodaMessageSource에 추가한다.
  • QA: KO/EN/JA 값이 모두 존재하고 messageKey로 조회 가능해야 한다.
• 검증 실행: 수정 파일 LSP 진단, 관련 테스트, 전체 빌드 실행 후 결과를 기록한다.
  • QA: ./gradlew test, ./gradlew build 성공.

완료 기준 (Acceptance Criteria)

• 댓글 등록 API 호출 후(작성자 != 크리에이터) FcmEvent가 발행되어 크리에이터에게 푸시 전송 대상이 생성된다.
• 동일 이벤트로 저장되는 알림 리스트의 deepLink 값이 푸시 payload deep_link와 동일 규칙으로 생성된다.
• 댓글 알림 딥링크는 커뮤니티 전체보기 진입 경로(community/{creatorId})를 유지하면서 대상 게시글 식별자(postId)를 포함한다.
• 기존 커뮤니티 새 글 알림 및 다른 도메인 푸시 딥링크 동작에 회귀 영향이 없다.

검증 기록

1차 구현

• 무엇을: CreatorCommunityService#createCommunityPostComment에 댓글 등록 직후 크리에이터 대상 FcmEventType.INDIVIDUAL 이벤트 발행 로직을 추가했다. 이벤트에는 category=COMMUNITY, messageKey=creator.community.fcm.new_comment, deepLinkValue=COMMUNITY, deepLinkId=creatorId, recipients=[creatorId]를 설정했고, 크리에이터 본인 댓글은 알림을 발행하지 않도록 제외했다. 또한 SodaMessageSource에 creator.community.fcm.new_comment 다국어 메시지를 추가했다.
• 왜: 댓글 알림 수신자가 푸시 터치/알림 리스트 터치 시 동일 딥링크(community/{creatorId})로 이동하도록, 기존 FCM 이벤트-알림 저장 공통 경로를 그대로 재사용하기 위해서다.
• 어떻게:
  • lsp_diagnostics 실행 시도: Kotlin LSP 미구성으로 실행 불가(환경 한계)
  • ./gradlew test --tests "*CreatorCommunityServiceTest" 실행(성공)
  • ./gradlew test 실행(성공)
  • ./gradlew build 실행(성공)

2차 수정

• 무엇을: 커뮤니티 댓글 알림 딥링크에 postId를 함께 전달하도록 FcmEvent에 deepLinkCommentPostId를 추가하고, FcmService.buildDeepLink에서 커뮤니티 딥링크일 때 ?postId={postId}를 붙이도록 수정했다. 이에 맞춰 CreatorCommunityService에서 댓글 등록 이벤트 발행 시 deepLinkCommentPostId = postId를 설정했고, PushNotificationService도 동일 딥링크 문자열을 알림 리스트에 저장하도록 반영했다. 테스트는 CreatorCommunityServiceTest, PushNotificationServiceTest를 보강했다.
• 왜: 기존 community/{creatorId}만으로는 어떤 게시글의 댓글 리스트를 열어야 하는지 식별할 수 없어, 커뮤니티 전체보기 진입은 유지하면서 대상 게시글 식별자를 함께 전달하기 위해서다.
• 어떻게:
  • lsp_diagnostics 실행 시도: Kotlin LSP 미구성으로 실행 불가(환경 한계)
  • ./gradlew test --tests "*CreatorCommunityServiceTest" --tests "*PushNotificationServiceTest" 실행(성공)
  • ./gradlew test 실행(성공)
  • ./gradlew build 실행(성공)