Χρήση του Μοτίβο Εργοστάσιο για τη διαχείριση διαφορετικών Κανάλια ειδοποιήσεων σε ένα προϊόν SaaS

Εισαγωγή: Η πρόκληση γνωστοποίησης στο SaaS

Τα σύγχρονα προϊόντα SaaS βασίζονται σε έγκαιρες, εξατομικευμένες ειδοποιήσεις για να συμμετάσχουν χρήστες, να ενεργοποιήσουν τη διατήρηση κίνησης και να επικοινωνήσουν κρίσιμα γεγονότα συστήματος. Οι χρήστες αναμένουν να λάβουν ειδοποιήσεις μέσω των προτιμούμενων καναλιών τους ⁇ email, SMS, ειδοποιήσεις ώθησης, μηνύματα εν εφαρμογή, ή ακόμα και webhooks σε υπηρεσίες τρίτων. Καθώς το προϊόν εξελίσσεται, ο αριθμός των καναλιών αυξάνεται, και η διαχείριση τους μέσω διάσπαρτης λογικής υπό όρους γίνεται εφιάλτης συντήρησης.

Directus, ένα ακέφαλο CMS και πλατφόρμα υποστήριξης ανοικτού κώδικα, παρέχει ένα ευέλικτο θεμέλιο για την οικοδόμηση εφαρμογών SaaS. Το μοντέλο δεδομένων, κινητήρα ροής, και εκτεταμένα άγκιστρα καθιστούν ένα ιδανικό περιβάλλον για την εφαρμογή ενός ισχυρού συστήματος κοινοποίησης. Με την εφαρμογή ενός κλασικού μοτίβου δημιουργίας ⁇ το Factory Pattern ⁇ μπορείτε να ενσωματώσετε τη λογική δημιουργίας-ειδική κανάλι, αποσυνδέστε τον βασικό κωδικό επιχείρησής σας από λεπτομέρειες παράδοσης, και χωρίς κόπο προσθέστε νέα κανάλια καθώς το προϊόν σας ωριμάζει.

Κατανόηση του Μοτίβου Εργοστάσιου

Το Factory Pattern είναι ένα μοτίβο δημιουργίας που παρέχει μια διεπαφή για τη δημιουργία αντικειμένων σε μια σούπερ-κατηγορία, αλλά επιτρέπει σε υποκλάσεις να αλλάξει τον τύπο των αντικειμένων που θα δημιουργηθούν. Προωθεί χαλαρή σύζευξη και προσκολλάται στην [[LFT:0]]] Open/Closed Principle[[LFT:1]]: οι οντότητες λογισμικού θα πρέπει να είναι ανοικτές για επέκταση αλλά κλειστές για τροποποίηση. Αντί να απορριφθεί η εφαρμογή σας με [[LFT:0]] ή [[LFT:1]] δηλώσεις για να αποφασίσει ποιο αντικείμενο κοινοποίησης να ακαριασθεί, μεταβιβάζετε την ευθύνη αυτή σε ένα ειδικό εργοστάσιο.

Αυτό το μοτίβο λάμπει όταν έχετε μια οικογένεια των σχετικών αντικειμένων και ο ακριβής τύπος για να instantiate καθορίζεται κατά το χρόνο εκτέλεσης με βάση τη δυναμική εισαγωγή ⁇ όπως οι προτιμήσεις ειδοποίησης ενός χρήστη ή το γεγονός που ενεργοποιείται. Σε ένα πλαίσιο κοινοποίησης, κάθε κανάλι είναι ένα διαφορετικό «προϊόν», ωστόσο όλα μοιράζονται μια κοινή διεπαφή (π.χ., μια μέθοδος).

Κανάλια κοινοποίησης σε ένα προϊόν SaaS

Οι κοινοί διαύλων κοινοποίησης περιλαμβάνουν:

• Email ⁇ μηνύματα ηλεκτρονικού ταχυδρομείου συναλλαγών και μάρκετινγκ μέσω υπηρεσιών όπως SendGrid ή Mailgun.
• SMS ⁇ σύντομα μηνύματα μέσω του Τουίλιο ή του Φονάζ.
• Πιέζουν ειδοποιήσεις ⁇ web push, mobile push μέσω Firebase Cloud Messaging ή OneSignal.
• In ⁇ App Notifications ⁇ UI pasts ή indam alerts.
• Webhooks ⁇ HTTP POST αιτείται εξωτερικά τελικά σημεία για ενσωμάτωση.
• Λακκ/Εμπιστοσύνη ⁇ ομάδα ⁇ εστημένο μήνυμα.

Χωρίς μοτίβο, ο κωδικός σας μπορεί να μοιάζει με αυτόν:

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');
 }
}

Αυτή η προσέγγιση λειτουργεί για μερικά κανάλια, αλλά κάθε νέο κανάλι σας αναγκάζει να τροποποιήσετε τη λειτουργία αποστολής σας και να επανεξετάσετε όλη την υπάρχουσα λογική.

Εφαρμογή του μοτίβου Εργοστάσιο για τις κοινοποιήσεις

Παρακάτω περπατάμε μέσα από μια εφαρμογή TypeScript που μπορεί να προσαρμοστεί για μια Directus ⁇ based SaaS. TypeScript είναι φυσικό για Directus, επειδή η ίδια η πλατφόρμα είναι χτισμένη με αυτό και παρέχει ένα πλούσιο σύστημα τύπου.

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);
}

Ο κώδικας πελατών δεν χρειάζεται ποτέ να γνωρίζει τον τύπο του σκυροδέματος. Εξαρτάται μόνο από τη διασύνδεση [[LFT:8]]. Αυτή η αποσύνδεση καθιστά τη δοκιμή μονάδας απλή ⁇ μπορείτε να χλευάσετε το αντικείμενο ειδοποίησης χωρίς να αγγίξετε το εργοστάσιο ή τις κατηγορίες σκυροδέματος.

Ενσωματώνοντας το πρότυπο Εργοστάσιο με Directus

Η Directus προσφέρει πολλαπλά σημεία εισόδου για την ενεργοποίηση των κοινοποιήσεων:

• ⁇ Οπτικός αυτοματισμός που μπορεί να αποκαλεί τις προσαρμοσμένες λειτουργίες ή webhooks.
• Hoks ⁇ ] ή αγκίστρια που τρέχουν σε γεγονότα CRUD.
• Τελωνεία Τελικά σημεία ⁇ Διαδρομές Express που εισπράττονται στον εξυπηρετητή Directus.
• Webhooks ⁇ Εξερχόμενη αποστολή webhook.

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);
 }
}