استخدام نمط المصنع لإدارة قنوات الإخطار المختلفة في منتج من طراز SaaS

مقدمة: تحدي الإخطار في ساسا

وتعتمد منتجات " ساسا " الحديثة على الإخطارات الشخصية في الوقت المناسب لإشراك المستخدمين، والاحتفاظ بالخدمة، وإبلاغ الأحداث الحرجة في النظام، ويتوقع المستعملون تلقي تنبيهات عبر القنوات المفضلة لديهم، أي البريد الإلكتروني، أو نظام الرصد، أو الإخطارات بالدفع، أو حتى رسائل الالتقاء إلى خدمات طرف ثالث، ومع تطور المنتج، ينمو عدد القنوات ويديرونها من خلال المنطق المشروط المتناثر يصبح كابوساً للنفقة.

ويوفر نظام إدارة المعلومات والاتصالات الذي لا يُستهان به من مصادر مفتوحة ومنصة الدعم، أساساً مرناً لبناء تطبيقات نظام سايس، ويُعد نموذج بياناته ومحرك التدفقات والخطوط الهاتفية المكثفة بيئة مثالية لتنفيذ نظام إخطار قوي، وبتطبيق نمط تصميمي كلاسيكي - نمط مصنع - يمكن أن ترسم منطقاً محدداً للإبداع، وتُبطل مُنتجك الأساسي من تفاصيل التنفيذ، وتضيف بلا جهد قنوات جديدة.

فهم نمط المصنع

The Factory Pattern is a creational design pattern that provides an interface for creating objects in a superclass, but allows subclasses to alter the type of objects that will be created. It promotes loose coupling and adheres to the Open/Closed Principle: software entities should be open for extension immediately but closed for modification. instead of littering your application with

ويشع هذا النمط عندما تكون لديك أسرة من الأشياء ذات الصلة، ويحدَّد النوع الدقيق الذي يُحدَّد في وقت التشغيل على أساس مدخلات دينامية - مثل أفضليات إخطار المستخدم أو الحدث الذي يجري إطلاقه، وفي سياق الإخطار، تكون كل قناة " منتج " مختلف، ومع ذلك فهي جميعاً تتقاسم واجهة مشتركة (مثلاً طريقة ).

قناة الإخطار في منتج من طراز SaaS

وتشمل قنوات الإخطار المشتركة ما يلي:

• Email] - transactional and marketing emails via services like SendGrid or Mailgun.
• SMS] - رسائل قصيرة عبر Twilio أو Vonage.
• Push Notifications] – web push, mobile push via Firebase Cloud Messaging or OneSignal.
• In — App Notifications] – UI bass or dashboard alerts.
• Webhooks – HTTP POST requests to external endpoints for integrations.
• Slack / Discord] - الرسائل التي تركز على الفريق.

بدون نمط، رمزك قد يبدو هكذا

function sendNotification(channel, message, recipient) {
 if (channel === 'email') {
 // Email logic here
 } else if (channel === 'sms') {
 // SMS logic here
 } else if (channel === 'push') {
 // Push logic here
 } else {
 throw new Error('Unknown channel');
 }
}

هذا النهج يعمل لبضع قنوات لكن كل قناة جديدة تدفعك إلى تعديل مهمتك في إرسالها وإعادة اختبار كل المنطق القائم نمط المصنع يزيل هذا الهشاشة

تنفيذ خطة المصانع للإبلاغ

ويلي ذلك، نسير من خلال تنفيذ من نوع سريبيت يمكن تكييفه من أجل نظام ساسا إس الذي يرتكز على مباشرة، والنوع من المكبس طبيعي بالنسبة إلى شركة مباشرة لأن المنبر نفسه مبني به ويوفر نظاماً من النوع الثري.

1- تحديد ما بين أوجه الإخطار

interface Notification {
 send(message: string, recipient: string): Promise<void>
}

2 - رتب الإخطار المكفول

class EmailNotification implements Notification {
 async send(message: string, recipient: string): Promise<void> {
 // Use Directus’s internal mailer or an external SDK
 console.log(`Sending email to ${recipient}: ${message}`);
 }
}

class SMSNotification implements Notification {
 async send(message: string, recipient: string): Promise<void> {
 // Call Twilio API
 console.log(`Sending SMS to ${recipient}: ${message}`);
 }
}

class PushNotification implements Notification {
 async send(message: string, recipient: string): Promise<void> {
 // Use Firebase or OneSignal SDK
 console.log(`Sending push to ${recipient}: ${message}`);
 }
}

3- مصنع الإخطار

type ChannelType = 'email' | 'sms' | 'push';

class NotificationFactory {
 static createNotification(channel: ChannelType): Notification {
 switch (channel) {
 case 'email':
 return new EmailNotification();
 case 'sms':
 return new SMSNotification();
 case 'push':
 return new PushNotification();
 default:
 throw new Error(`Unknown notification channel: ${channel}`);
 }
 }
}

4- استخدام المفاعل في تطبيقك

async function notifyUser(event: string, userId: string, channel: ChannelType) {
 const notification = NotificationFactory.createNotification(channel);
 await notification.send(event, userId);
}

ولا يحتاج قانون العملاء إلى معرفة النوع الملموس، بل يعتمد فقط على واجهة ، وهذا التزييف يجعل اختبار الوحدة على نحو مباشر - يمكنك أن تسخر من موضوع الإخطار دون لمس المصنع أو الفصول المحددة.

إدماج دورية المصانع مع شركة Directus

ويقدم التوجيه نقاط دخول متعددة للإخطارات الموجهة:

• Flows ] — Visual auto that can call custom operations or webhooks.
• Hooks] — or hooks that run on CRUD events.
• Custom Endpoints] — Express routes injected into the Directus server.
• Webhooks] - مرسلو الشبكة المنتهية ولايتهم.

وفي مشروع مباشر، يمكن أن تُثبت مصنع الإخطارات الخاص بك كخدمة داخل وحدة قياسية أو امتداد، مثلاً داخل Flow] يمكن أن تُطلق نقطة نهاية داخلية للجهاز تُصدر القناة الصحيحة استناداً إلى أفضليات مخزنة للمستعملين، ويمكنك بدلاً من ذلك أن تلف المصنع في

import { NotificationFactory } from './services/NotificationFactory';

async function onTaskCreate(payload, { accountability }) {
 const { assigneeId } = payload;
 const userPreferences = await getUserNotificationPreferences(assigneeId);
 for (const channel of userPreferences.channels) {
 const notifier = NotificationFactory.createNotification(channel);
 await notifier.send(`You have a new task!`, assigneeId);
 }
}