[#734] 앱별 언어 설정에 맞춰 푸시 알림 문구를 현지화한다

[opficdev]

🔗 연관된 이슈

• closed 앱별 언어 설정에 맞춰 푸시 알림 문구를 현지화한다 #734
• 서버 발송 전환: DevLog_Firebase #46

🎯 의도

• 앱별 언어 설정을 기준으로 Todo 마감 알림 문구를 구성하기 위한 iOS 수신·표시 계약 마련
• 기존 title/body 알림 문서와 공존하는 단계적 전환 기반 확보

📝 작업 내용

📌 요약

• todoDueTomorrow 의미 기반 알림 모델과 해석·변환 경로 추가
• NotificationTab의 한국어·영어 알림 문구 현지화
• 기존 알림과 알 수 없는 contentType의 title/body 대체 표시 유지
• FCM token 문서에 pushLocalizationVersion: 1 기록
• MARKETING_VERSION 1.5 반영

🔍 상세

의미 기반 알림 계약

• PushNotificationContent와 PushNotificationResponse.Content에 todoDueTomorrow(todoTitle:) 추가
• contentType: "todoDueTomorrow"와 contentArguments.todoTitle 해석
• 빈 contentArguments 또는 빈 Todo 제목을 제목 없는 Todo로 처리
• 의미 기반 내용을 Infra → Data → Domain → Presentation 계층으로 전달
• contentType 누락 또는 알 수 없는 값 해석 시 기존 title/body 사용
• 전환 기간 동안 의미 기반 필드와 기존 title/body가 함께 존재하는 문서 계약 유지

알림 문구 현지화

• push_notification_todo_due_title 추가
• push_notification_todo_due_tomorrow_format 추가
• push_notification_todo_due_tomorrow_without_title 추가
• String(localized:)를 통한 현재 앱 언어 기준 NotificationTab 문구 구성
• Todo 제목이 없거나 빈 문자열인 경우 전용 문구 적용

서버 연계

• 사용자 upsert와 FCM token 갱신 시 pushLocalizationVersion: 1 기록
• 새 token 필드 구성에서 languageCode 미추가
• 기존 languageCode 제거 마이그레이션 미포함
• APNs 현지화 키와 의미 기반 문서 발송 전환은 DevLog_Firebase #46 범위
• 시스템 푸시 배너의 종단 현지화 완료는 서버 구현·배포 이후 범위

테스트 및 검증

• 의미 기반 알림 해석과 기존·알 수 없는 알림 처리 테스트 추가
• Data 변환 및 repository 전달 보존 테스트 추가
• NotificationTab의 제목 있음·제목 없음·기존 문구 처리 테스트 추가

부가 변경

• MARKETING_VERSION 1.4 → 1.5 변경
• .gitignore에 .superpowers/ 제외 규칙 추가

📸 영상 / 이미지 (Optional)

• 별도 첨부 없음

[gemini-code-assist]

Code Review

이번 PR은 내일 마감되는 할 일(Todo)에 대한 로컬라이징된 푸시 알림 기능을 추가합니다. 이를 위해 푸시 알림 응답 및 도메인 엔티티에 의미 기반 내용(content)을 추가하고, 이를 파싱 및 매핑하는 로직과 테스트 코드를 작성했습니다. 리뷰어 피드백으로는 PushNotificationItem에서 할 일 제목(todoTitle)의 공백 문자열을 검사할 때, 공백만 포함된 경우를 대비해 trimmingCharacters(in: .whitespacesAndNewlines)를 사용하여 처리하도록 개선할 것을 제안했습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.