Notification Strategy & Delivery Architecture

🔔 NOTIFICATION_STRATEGY.md - Notification Strategy & Delivery Architecture (ยุทธศาสตร์การยิงแจ้งเตือนและระบบจัดส่ง)

This document outlines the notification priorities, channels, retry strategies, and failover architectures for the SplitDee platform.
เอกสารฉบับนี้สรุปลำดับความสำคัญของข้อความการแจ้งเตือน ช่องทางการส่ง แผนการส่งซ้ำเมื่อล้มเหลว และแนวทางกู้คืนระบบแจ้งเตือนสำหรับ SplitDee

---

🇹🇭 ภาษาไทย (สำหรับผู้ใช้งาน)

1. ลำดับความสำคัญและช่องทางการแจ้งเตือน

• ตั้งหารบิลใหม่ (New Bill Published): ระดับปานกลาง ส่งผ่าน Push Notification (FCM) ในหน้าจอมือถือ และแจ้งเตือนหน้าข่าวในแอป ผู้ใช้กดเปิดปิดได้
• ตรวจสลิปโอนผ่านสำเร็จ (Slip Verified): ระดับสูง ส่งผ่านหน้าจอมือถือด่วน (FCM) และแจ้งเตือนระบบเข้าห้องแชทกลุ่ม ห้ามปิด
• ตรวจสลิปโอนไม่ผ่าน/ปฏิเสธ (Payment Rejected): ระดับสูง ส่งด่วน (FCM) และแสดงผลในแอป พร้อมส่งบันทึกสำรองเข้าเมล/SMS ห้ามปิด
• สะกิดทวงเงิน AI (AI Reminder): ระดับปานกลาง ยิงหน้าจอ (FCM) หรือแชทบอร์ดทักไลน์เพื่อนบุคคล (LINE) ผู้ใช้เลือกเปิดปิดสไตล์ภาษาได้
• สัตว์เลี้ยงโมจิป่วย HP หมด (Pet Status): ระดับต่ำ แจ้งเฉพาะกล่องในแอปกลุ่มเท่านั้น ปิดเสียงเตือนได้
• แชทพิมพ์มาใหม่ (Chat Message): ระดับปานกลาง ยิงเตือนหน้าจอ (FCM) ปิดเสียงได้

2. โครงสร้างผู้ให้บริการจัดส่ง (Delivery Providers)

1. Firebase Cloud Messaging (FCM): ยิงข้อความด่วนเข้าจอมือถือทั้ง iOS และ Android มีการฝังไอดีการ์ดบิลเงียบๆ เพื่อเมื่อคนกดจะสลับหน้าจอเข้าบิลทันที
2. LINE Messaging API: ทวงเงินอัตโนมัติเป็นรูปมีมน้องโมจิส่งตรงเข้าห้องแชทส่วนบุคคลของเพื่อน ได้รับความนิยมสูงและผ่อนคลายที่สุดสำหรับคนไทย
3. Email (Amazon SES / SendGrid): สำหรับรายงานยอดบัญชีและสรุปประวัติหนี้รายเดือน จดหมายเปลี่ยนรหัสผ่าน และประเด็นฟ้องข้อโต้แย้งสลิปผิด

3. แผนกู้คืนการจัดส่งและส่งซ้ำเมื่อล้มเหลว (Retry & Fallback)

• การพยายามส่งซ้ำ (Retry): รันหลังบ้านด้วย Celery/Redis คิวงาน หากเซิร์ฟเวอร์ตอบรับช้า ระบบจะขยับเวลารอรันรอบถัดไปแบบทวีคูณ (Exponential Backoff with Jitter) เพื่อลดแรงกดดันระบบ ยิงสูงสุด 5 ครั้ง หากยังล้มเหลวโยนเข้าเก็บค้างรันแก้บั๊ก (DLQ)
• กลไกสำรองกู้คืน (Fallback): หากมือถือยิง FCM สลับไม่ได้ผล ให้ส่งเข้ากระดิ่งแจ้งเตือนภายในแอปทันที หากระบบสลับไอดีไลน์เกิดขัดข้องออฟไลน์ ให้เปลี่ยนไปใช้ Push ข้อความเตือนธรรมดาทางเบอร์มือถือแทน

---

🇬🇧 English (For AI Agents)

1. Notification Priorities & Channels

Event Type	Priority	Core Channel	Fallback Channel	User Configurable?
New Bill Published	Medium	Push Notification (FCM)	In-app notification	Yes
Slip Verified (Paid)	High	Push Notification (FCM)	Group Chat alert	No
Payment Rejected	High	Push (FCM) + In-app Alert	Email / SMS	No
AI Reminder (Overdue)	Medium	Push (FCM) / LINE	In-app	Yes
Pet Status Alert (Sick)	Low	Push (FCM)	In-app only	Yes
Chat Message Recieved	Medium	Push Notification (FCM)	None	Yes

2. Delivery Providers Architecture

• Firebase Cloud Messaging (FCM): Native push alerts for iOS/Android. Payloads embed navigation ids (bill_id, group_id).
• LINE Messaging API: Dynamic AI reminders and spend summaries using Mochi memes sent directly to user LINE accounts.
• Email (Amazon SES): Monthly spending stats, security emails, and payment dispute updates.

3. Retry & Fallback Strategy

• Retry Mechanics: Async workers process events with Exponential Backoff with Jitter retry intervals. Retries up to 5 times before moving to the Dead Letter Queue (DLQ).
• Fallback Rules: If FCM registration token expires, fallback to In-app notification feed. If LINE is offline, fallback to standard FCM notifications.