Pusher — البثّ اللحظي للإشعارات

ماذا يُبثّ؟

إشعاران فقط: تذكيرات الاستحقاق وإشعارات إجراءات الشيك — على قناة خاصة لكل مستخدم private-App.Models.User.{id} بحدث الفريمورك BroadcastNotificationCreated وحمولة {cheque_log_id, type, id}. لا قنوات عامة ولا حضور. والمتصفح عند الاستقبال يزيد رقم شارة الجرس بواحد فقط؛ التفاصيل تُقرأ من صفحة الإشعارات كالمعتاد.

الإعداد

الإعدادات ← اعدادات عامة ← تبويب Pusher (عرض بصلاحية إدارة التكامل):

جدول الإعدادات هو المصدر (لا .env)، ويُقرأ عند الإقلاع. حارس مزدوج: التفعيل مطفأ أو البيانات ناقصة ⟹ الاتصال log. وسطر حالة القنوات في تبويب الإشعارات يقولها: «الجرس داخل البرنامج: مفعَّل دائمًا · البثّ اللحظي: معطّل (لا خادم بثّ مضبوط) · البريد: …».

ما يلزم على الخادم

البثّ يُدفع إلى الطابور. التنصيبة القياسية تشغّل المجدوِل وحده ولا عامل طابور؛ فـبلا queue:work الأحداث تتراكم صفوفًا ولا تُبثّ والشاشة تقول «مفعَّل». عند تفعيل Pusher على تنصيبة إنتاج: شغّل عامل طابور كخدمة (أو اجعل اتصال الطابور sync) — ينسّقه فريق التركيب.

المتصفح يحمّل pusher.min.js من CDN ويشترك بقناة المستخدم — ويشترط Cluster مضبوطًا (خادم ذاتي بمضيف بلا cluster يبثّ ولا يستمع أحد).

أثر الغياب

لا شيء يتعطّل: الإشعارات في القاعدة والجرس والبريد كلها تعمل — البثّ يُضاف فقط حين يكون المحرّك حقيقيًا. الخسارة الوحيدة: الشارة لا تزيد لحظيًا في تبويب مفتوح.

مشاكل شائعة

• الحفظ يرفض بلا تغيير السرّ — في الإصدارات قبل 1.8.0: أعد كتابة App Secret مع كل حفظ؛ من 1.8.0 الفارغ يبقي المحفوظ.
• مفعَّل ولا يصل شيء — لا عامل طابور، أو Cluster فارغ، أو مفاتيح خاطئة (راجع لوحة Pusher).
• يعمل على جهاز ولا يعمل على آخر — القناة لكل مستخدم؛ المستخدم الآخر ليس مستهدفًا بالإشعار (نطاق الرؤية).

صفحات ذات صلة

• الإشعارات والبريد
• نطاقات الرؤية