الإخطارات
البريد الإلكتروني SMTP، والرسائل النصية القصيرة، والدفع عبر الهاتف المحمول، وخطافات الويب الصادرة. قوالب i18n، حد المعدل لكل قناة، إدارة الارتداد، توقيعات HMAC. كل شيء من حافة العمل.
أربع قنوات، وSDK واحد موحد#
تعرض خدمة aura-notifications سطحًا واحدًا aura.notify.* يدير البريد الإلكتروني والرسائل النصية القصيرة والدفع وخطافات الويب. تمر المكالمات عبر قائمة انتظار NATS مع إعادة المحاولة، والتراجع، وDLQ - أنت ترسل، ونحن نضمن التسليم (أو استرداد الرصيد).
القوالب والسجلات والحصص موجودة في project_{uuid}_platform.notifications_*. الاحتفاظ بسجلات التسليم لمدة 30 يومًا (سنتان على مستوى المؤسسة).
ما تضمنه كل قناة#
- البريد الإلكتروني (SMTP). قوالب MJML/HTML مع Liquid وDKIM/SPF/DMARC وحد المعدل حسب المجال، تتم إدارتها تلقائيًا.
- الرسائل القصيرة. مقدمو خدمات متعددون (Twilio، Vonage، OVH)، التوجيه حسب البلد، الرجوع التلقائي.
- ادفع. APNs (iOS)، FCM (Android)، دفع الويب (VAPID). الرموز المميزة للجهاز التي تم التحقق منها ذاتيًا، وتطهير الرموز غير الصالحة.
- خطافات الويب الصادرة. HMAC- توقيع SHA256، إعادة المحاولة الأسية (5 محاولات)، DLQ، التوقيعات الدوارة.
MJML + سائل، i18n الأصلي#
قم بإنشاء قوالب من الاستوديو أو عبر واجهة سطر الأوامر (CLI). بناء جملة MJML للبريد الإلكتروني (سريع الاستجابة خارج الصندوق)، سائل للقوالب. اللغات المُدارة بواسطة الملف welcome.fr.mjml, welcome.en.mjml.
- نماذج البريد الإلكتروني: ~ 12 لكل مشروع (في المتوسط)
- المحلية المدعومة: 38 (سائل + احتياطي تلقائي)
- التسليم ص99: < 8s (قائمة الانتظار → المتلقي)
- معدل البريد الوارد: 97.8% (DKIM + عنوان IP مخصص)
أربع قنوات في الكود#
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
استمر باستخدام edge.job() للفصل: يدفع جهاز الإرسال إلى قائمة الانتظار notifications، ويرسل العامل بشكل غير متزامن مع إعادة المحاولة التلقائية.
خطاف الويب المُوقع: قم بتكوين سر في الإشعارات → الإعدادات → خطاف الويب (أو WEBHOOK_SIGNING_SECRET على جانب الخدمة). يحمل كل إرسال بعد ذلك رأس X-Aurabase-Signature: t={timestamp},v1={hmac-sha256} - التحقق على جانب المتلقي الموثق في الملف التمهيدي لحزمة @aurabase/notifications.