Paggamit ng Disenyo sa Pabrika Upang Mamahala sa Iba't Ibang mga Titasyon sa Isang Mabungang SaAS

Ang huwarang ito ay sumisikat kapag may pamilya ng mga kaugnay na bagay at ang eksaktong uri ng instantia ay itinatakda sa runtime batay sa dynamic input na ⁇ tulad ng isang user na mga ⁇ i ⁇ ang mga kagustuhang pang-estadistika o ang pangyayari ay nagudyok. sa isang notipikasyong konteksto, ang bawat channel ay isang iba't ibang ⁇ product, ang Eksperimento ay lahat ng mga ito ay nagbabahagi ng isang karaniwang interface (e.g., isang paraang ).

Mga Titang Pang - araw - araw sa Isang Mabungang SaAS

Kabilang sa karaniwang mga notasyon ang:

• Email – transaksyonal at marketing emails sa pamamagitan ng mga serbisyo tulad ng SendGrid o Mailgun.
• SMS – mga maiikling mensahe sa pamamagitan ng Twitio o Vyonage.
• Push Notifications[ – web push, mobile push sa pamamagitan ng Firebase Cloud Messing o OneSignal.
• Sa ⁇ App Notifications – UI toasts o dashboard slatters.
• – HTTP POST[kailangan ng sanggunian] Sa mga panlabas na endpoints para sa mga pagsasanib.
• Slack / Discord – koponang ⁇ focused messaging.

Kung walang parisan, baka ganito ang hitsura ng iyong kodigo:

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

Ang pamamaraang ito ay mabisa para sa ilang channel, subalit ang bawat bagong channel ay pumipilit sa iyo na baguhin ang iyong gawain sa pagpapadala at muling subukin ang lahat ng umiiral na lohika.

Pag - uugnay sa Disenyo ng Pabrika Para sa mga Papansin

Sa ibaba ay naglalakad tayo sa isang TypeScript pagpapatupad na maaaring iangkop para sa isang Directus ⁇ based SaaS. TypeScript ay natural para sa Directus dahil ang plataporma mismo ay itinayo na kasama nito at nagbibigay ng isang mayamang sistema ng tipo ng titik.

1. Pakahuluganan ang Interface ng Notification

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

2. Ibagay ang mga Hindi Pag - uulat

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. Ang Pabrikang Pag - iinternasyon

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. Paggamit ng Factory sa Iyong Pagkakapit

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

Ang client code ay hindi na kailangang malaman ang kongkretong uri. Ito ay umaasa lamang sa interface. Ang decoupling na ito ay gumagawa sa unit na pagsubok sa rightific you na manguya sa bagay na notasyon nang hindi hinihipo ang pabrika o ang mga klaseng kongkreto.

Pag - aawtuhan ang Disenyo ng Pabrika sa Pamamagitan ng Directus

Ang Directus ay nag - aalok ng maraming entidad para sa mga notasyong pang - umpisa:

• Flows – Visual automation na maaaring tumawag sa mga operasyon ng kaugalian o webhooks.
• Mga kawit – o na tumatakbo sa mga kaganapang CRUD.
• Custom Endpoints[ – Mga ruta ng Express na itinuturok sa Patimog na server.
• – Mga webhook na tagahatid ng webhook.

Sa isang proyektong Directus, maaari mong i-install ang iyong pagawaan ng notasyon bilang isang serbisyo sa loob ng isang custom module o isang extension. Halimbawa, sa loob ng isang Flow Maaari mong tawagin ang isang panloob na API endpoint na nagreresulta sa tamang channel batay sa isang user na imbakan ng mga kagustuhan. alternatibo, maaari mong balutin ang pabrika sa isang na nag-eresultang apoy pagkatapos ng isang bagong tagagamit na nag-sign at nagpadala ng isang ST.

Dahil sa ang pabrika ay nakatira sa isang lugar, maaari mong i - update ang mga mapa nito nang hindi hinihipo ang bawat kawit o daloy.

Mga Pakinabang ng Paraan ng Pabrika

Madaling Ilabas

Ang pagdaragdag ng bagong channel ay nangangahulugan ng pagsulat ng bagong klase na ang mga kasangkapan at pagdaragdag ng isang linya sa worker recurrations switch statement. walang mga pagbabago sa code ng kliyente ang kinakailangan. Ito ay lalo nang mahalaga sa mga produktong multi-propetent SaaS kung saan ang iba't ibang mga nangungupahan ay maaaring magdulot ng iba't ibang set ng mga channel.

Pananatiling Matatag

Ang notification delivery logic ay naihihiwalay sa lohikang pangnegosyo.Ang bawat kongkretong klase ay maaaring mapanatili nang independiyente. kung babaguhin ng provider ng SMS ang API nito, binabago mo lamang .Ang pabrika at lahat ng mamimili ay nananatiling hindi nagbabago.

Pagiging Mapapatunayan

Maaari mong pag - isahin ang bawat klase sa pag - aaral ng nota sa pamamagitan ng pagbubukod, at maaari mong tuyain ang na interface kapag sinusubok ang mas mataas na mga gawain sa calclevel.

Pagiging Madaling makibagay

Halimbawa, baka gusto mong ipasa ang mga susi (API keys, retry policy) sa panahon ng paglalang. Maaari mong hulugan ng labis - labis ang paraan ng paggawa ng pabrika o gamitin ang isang refinder Ang isang plano sa loob ng pabrika para sa mga bagay na may kinalaman sa pagsasaayos.

Potensiyal na mga Balakid at Pagpapakundangan

Bagaman ang disenyo ng pabrika ay isang malakas na kasangkapan, hindi ito isang balag na pilak:

• Over calcernineering: Kung mayroon ka lamang dalawang channel at walang planong magdagdag, maaaring maging mainam ang isang simpleng kondisyonal. Ang padron ay nagpapakilala ng karagdagang mga file at abstraksyon.
• Ang lohikang pang-Decision ay umiiral pa rin: Ang pabrika mismo ay gumagamit ng isang witch na pangungusap. kung mayroon kang dose-dosenang mga lagusan, isaalang-alang ang isang [registry pattern kung saan ang mga lagusan mismo ang g surgrampor kaysa sa kapwa mga bagay.
• Dependensiya: Kung ang iyong mga klase sa notasyon ay nakasalalay sa mga panlabas na serbisyo (hal.g., isang kliyenteng HTTP o isang logager), kailangan mong i-iniksiyon ang mga dependensiya na iyon. Ang pabrika ay dapat na tumanggap ng isang lalagyan ng DI o tumanggap ng dependensiya bilang parameter composable upang magplano ng maaga.

Sa isang ekstensiyon ng Directus, maaari mong padaluyin ang mga platform adminitor na gumagawa ng calculus dependency injection (ang na tungkulin at serbisyo) upang maipasa ang mga kabahaging pagkakataon tulad ng logger o database access sa pabrika.

Tunay na HalimbawangWorld: MultiMChannel Notifications in a B2B SaaS

Isaalang - alang ang isang kasangkapan sa pangangasiwa ng proyekto na itinayo sa Directus.

• ang inatasan sa pamamagitan ng email (kung gusto nila iyon)
• ang inatasan sa pamamagitan ng pag - i - anke sa phystapp toast
• ang channel ng proyekto sa Itim

Sa paggamit ng pabrika, ang kodigo sa ilalim ng isang Paktor ay nagiging:

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

Ang bawat klase sa pag - iintification ay humahawak ng sarili nitong idyomatikong paghahatid, at ang pabrika pa rin ang nag - iisang pinagmumulan ng katotohanan para sa paggawa ng channel.

Upang makita ang isang kumpletong pagpapatupad ng gayong sistema, tumutukoy sa Directus ⁇ s official document sa paglikha ng mga pamahayan at serbisyong pang-industriya. Para sa mas malalim na pagkaunawa sa mismong disenyo ng pabrika, ang [[FLT:[T] Ang Panibagong-buhay na Tatak ay isang mahusay na mapagkukunan. Maaari ka ring maging interesado sa kung paano hindi gumagamit ang ibang plataporma ng ⁇ [TL4:[TLif] [[T] Ang isang katulad na konsepto[T][T][T] ay isang mahusay na batayan[T][T][T][T][T][T][T][T][T].