Utilizzando il modello di fabbrica per gestire diversi canali di notifica in un prodotto SaaS

Questo modello risplende quando si dispone di una famiglia di oggetti correlati e il tipo esatto di istantaneo è determinato a runtime basato su input dinamici, come le preferenze di notifica dell'utente o l'evento in fase di attivazione. In un contesto di notifica, ogni canale è un "prodotto", ma tutti condividono un'interfaccia comune (ad esempio, un metodo ).

Canali di notifica in un prodotto SaaS

I canali comuni di notifica includono:

• Email[] – email transazionali e di marketing tramite servizi come SendGrid o Mailgun.
• SMS[] – messaggi brevi tramite Twilio o Vonage.
• Push Notifiche[[] – web push, mobile push via Firebase Cloud Messaging o OneSignal.
• Notifiche di In‐App[] – brindisi o avvisi di cruscotto dell'interfaccia utente.
• Webhooks[ – HTTP POST chiede agli endpoint esterni per le integrazioni.
• Slack / Discord[[] – messaggistica messa a fuoco di squadra.

Senza uno schema, il tuo codice potrebbe assomigliare a questo:

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

Questo approccio funziona per alcuni canali, ma ogni nuovo canale ti costringe a modificare la tua funzione di invio e a riattivare tutta la logica esistente.

Implementazione del modello di fabbrica per le notifiche

Qui di seguito passiamo attraverso un'implementazione di TypeScript che può essere adattata per un SaaS basato su Directus. TypeScript è naturale per Directus perché la piattaforma stessa è costruita con esso e fornisce un sistema di tipo ricco.

1. Definire l'interfaccia di notifica

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

2. Classi di notifica concrete

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. La fabbrica di notifica

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. Utilizzo della fabbrica nella vostra applicazione

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

Il codice client non ha mai bisogno di conoscere il tipo di calcestruzzo. Dipende solo dall'interfaccia []. Questo decoupling rende semplice il test di unità—può mock l'oggetto di notifica senza toccare la fabbrica o le classi di cemento.

Integrazione del modello di fabbrica con Directus

Directus offre più punti di ingresso per attivare le notifiche:

• Flows[] – Automazione visiva che può chiamare operazioni personalizzate o webhooks.
• Hooks[] – ] o []] ganci che si corrono su eventi CRUD.
• Custom Endpoints[[] – Le rotte Express iniettate nel server Directus.
• Webhooks[] – In uscita webhook dispacciatori.

In un progetto Directus, è possibile installare la vostra fabbrica di notifica come servizio all'interno di un modulo personalizzato o di un'estensione. Ad esempio, all'interno di un Flow[] si potrebbe chiamare un endpoint API interno che istanzia il canale corretto basato sulle preferenze memorizzate di un utente.

Poiché la fabbrica vive in un unico luogo, è possibile aggiornare le sue mappature senza toccare ogni gancio o flusso. E poiché Directus Flows può passare i dati JSON arbitrari, è possibile alimentare facilmente la fabbrica con gli identificatori di canale dal database.

Vantaggi dell'approccio del modello di fabbrica

Scalabilità

Aggiungendo un nuovo canale significa scrivere una nuova classe che implementa [] e aggiungere una linea all'indicazione dell'interruttore della fabbrica. Non sono necessari cambi di codice client. Ciò è particolarmente prezioso nei prodotti SaaS multi-tenant in cui diversi inquilini possono abilitare diversi set di canali.

Mantenere

La logica di consegna della notifica è isolata dalla logica aziendale. Ogni classe concreta può essere mantenuta indipendentemente. Se il provider SMS cambia la sua API, si modifica solo . La fabbrica e tutti i consumatori rimangono invariati.

Testabilità

È possibile testare ogni classe di notifica in isolamento, e si può mock l'interfaccia [ quando si verificano le funzioni di livello superiore. La fabbrica stessa può essere verificata con un semplice test che verifica che restituisce le istanze del tipo corretto per ogni canale.

Flessibilità

La fabbrica può essere estesa per costruire oggetti complessi. Ad esempio, si potrebbe desiderare di passare la configurazione (chiavi API, politiche di riprova) al momento della creazione. È possibile sovraccaricare il metodo di fabbrica o utilizzare un []Strumento]]] all'interno della fabbrica per assemblare oggetti di notifica completamente configurati.

Potenziali svantaggi e considerazioni

Mentre il modello di fabbrica è un potente strumento, non è un proiettile d'argento:

• Over-engineering:[] Se hai solo due canali e non hai intenzione di aggiungere altro, un semplice condizionale potrebbe essere bene. Il modello introduce file aggiuntivi e astrazioni.
• La logica di precisione esiste ancora:[ La fabbrica stessa utilizza un'affermazione di commutazione. Se si dispone di decine di canali, si consideri un [ pattern di registrazione[] dove i canali auto-registranti, o utilizzare un schema di strategia che scambia l'algoritmo può integrare entrambi gli oggetti.
• Iniezione di dipendenza:[] Se le classi di notifica dipendono da servizi esterni (ad esempio, un client HTTP o un logger), è necessario iniettare tali dipendenze. La fabbrica deve accettare un contenitore DI o ricevere le dipendenze come parametri, qualcosa da pianificare in anticipo.

In un'estensione Directus, è possibile sfruttare l'iniezione integrata della piattaforma (la funzione e i servizi ) per passare istanze condivise come il logger o l'accesso al database alla fabbrica.

Esempio di Real‐World: Notifiche Multi-Channel in un SaaS B2B

Considerare uno strumento di gestione del progetto costruito su Directus. Quando viene assegnato un compito, il sistema deve notificare:

• l'assegnatore via e-mail (se lo preferiscono)
• l'aggiudicazione tramite brindisi in-app
• il canale di progetto su Slack

Utilizzando la fabbrica, il codice sotto un Directus gancio diventa:

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

Ogni classe di notifica gestisce la propria consegna idiomatica. La fabbrica rimane la sola fonte di verità per la mappatura dei canali.

Per vedere una completa implementazione di tale sistema, fare riferimento alla documentazione ufficiale di Directus] sulla creazione di ganci e servizi personalizzati. Per una comprensione più profonda del modello di fabbrica stesso, il Rifacente pagina Guru su Metodo di fabbrica[]]] è una risorsa eccellente.

Conclusioni

Il modello di fabbrica fornisce un modo pulito e manutenbile per gestire più canali di notifica in un prodotto SaaS. Incapsulando la creazione di oggetti, si decouple la logica dell'applicazione core dalle specifiche di consegna, rendendo facile da aggiungere, rimuovere, o modificare i canali senza effetti di increspatura attraverso la base di codice.

Che si stia costruendo un semplice notificante per e-mail o un complesso motore multi-canale, a partire dal modello di fabbrica presto si paga come il vostro set di funzionalità si espande. L'investimento in una piccola quantità di astrazione oggi salva giorni di rifattore domani.