feat: 저장 실패 시 SAVE_FAILED 알림 발송

[sudosubin]

📌 Related Issue

• 없음

🚀 Description

장소 저장에 실패하면 장소를 저장하지 못했어요. 알림을 남깁니다. (PRD [SYS-002] Flow B)

이동할 대상이 없는 앱 내 안내 화면으로 가는 유형이라 payload는 null입니다. 실패 사유도 구분하지 않습니다. 알림함은 어느 건을 누르든 같은 안내 화면으로 보냅니다. (EC-013)

발송 시점은 세 가지입니다.

상황	발송	이유
영구 실패 (재시도 대상 아님)	O	재시도가 없으니 지금이 유일한 기회
인식된 장소 0건	O	저장할 것도 재시도할 것도 없음
마지막 배달	O	아래 참고
재시도가 남음	X	재시도가 성공할 수 있어 거짓 알림이 됨

재시도 소진은 Cloud Tasks가 조용히 버려서 워커가 알 수 없습니다. 큐는 최대 10회 재시도하는데 소진되면 아무 신호도 오지 않아 저장했는데 아무 소식도 없는 사용자가 생깁니다. x-cloudtasks-taskretrycount 헤더로 마지막 배달을 판별해 그때 알립니다.

📢 Notes

• CLOUD_TASKS_MAX_ATTEMPTS를 추가했습니다. 기본값이 인프라 설정과 같은 10이라 배포 시 별도 설정 없이 동작합니다. 큐 설정을 바꾸면 이 값도 함께 바꿔야 합니다.
• key가 저장 시도당 하나라 여러 실패 경로를 거쳐도, 재배달돼도 한 건으로 접힙니다.
• PRD의 "공유된 텍스트에 URL이 없을 때"는 이 PR 범위 밖입니다. URL 추출은 클라이언트가 하고 POST /rooms/pins는 유효한 Instagram URL을 요구해서 애초에 호출되지 않거나 동기 400을 받습니다. 알림함 행을 남기려면 클라이언트가 실패를 알려주는 경로가 따로 필요합니다.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 1a4bb945-de49-4449-a3ed-14a41ffcadde

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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