stable · overview · 0.1.0

Notifications

從業務意圖到傳送

Project Backend 建立 Notification Intent，說明要使用的 template、locale、Delivery Endpoint 與 variables。MiniCenter 驗證 client-scoped Sender Profile、template、endpoint 與 consent，再建立 Notification Delivery 交給 durable worker。

Notification Intent 是 Project Backend 已決定要通知的業務事實；MiniCenter 不替 Project Backend 決定何時通知、收件人的偏好或 marketing purpose。

Channels 與可靠性

目前平台的 delivery channels 包含 email、FCM、APNs、LINE 與 Web Push。每個 Delivery Endpoint、Sender Profile、template 與 consent 都限制在同一 Project Client。

Delivery 以 PostgreSQL durable operation 保存，provider 的暫時失敗會 exponential backoff retry；超過嘗試上限後進入 dead-letter。建立 Intent 成功只代表請求已持久化，不代表 provider 已送達。

從送出 Notification Intent開始，再閱讀channels、delivery outcome 與 retry。

Guides

• 送出 Notification Intent — 在 sandbox 以已核准的 Sender Profile、template 與 Delivery Endpoint 建立通知。
• Channels、delivery outcome 與 retry — 理解 email、FCM、APNs、LINE、Web Push 的 endpoint、outcome 與 durable retry。

API Reference

• Create a Notification Intent — POST /api/v1/notification-intents
• Create an FCM, APNs, LINE, or Web Push Notification Intent — POST /api/v1/channel-notification-intents
• Get a Notification Delivery outcome — GET /api/v1/notification-deliveries/{deliveryId}

Event Reference

• In-app notification signal — An ephemeral in-app signal is available for a Project Client target.