Add sessionHolding template, unique 8-digit codes, reason slot for sessionCancelled, and disable unused notifications

2026-08-21 10:44:51 +03:30
parent 5328f36f06
commit 091e519280
28 changed files with 2180 additions and 280 deletions
@@ -13,22 +13,26 @@ const resolveUserIdByPhone = async (phoneNumber) => {
  return user?._id || null;
 };

-const sendAccountCredentialsSms = async ({
+const resolveUserName = async (userId, fallback = '') => {
+  if (!userId) return fallback;
+  const user = await User.findById(userId).select('name uniqueCode').lean();
+  return {
+    fullName: user?.name || fallback,
+    userCode: user?.uniqueCode || ''
+  };
+};
+
+const sendTemplateSms = async ({
+  templateKey,
  receiver,
-  username,
-  password,
  userId = null,
  subject,
  body,
-  relatedEvent
+  relatedEvent,
+  slotValues = {}
 }) => {
  const resolvedUserId = userId || await resolveUserIdByPhone(receiver);
-  let fullName = '';
-  if (resolvedUserId) {
-    const user = await User.findById(resolvedUserId).select('name').lean();
-    if (user?.name) fullName = user.name;
-  }
-  const { templateId, variables } = await getSmsTemplate('accountCreated');
+  const { templateId, variables } = await getSmsTemplate(templateKey);
  return recordAndSend({
    userId: resolvedUserId,
    channel: 'sms',
@@ -36,37 +40,74 @@ const sendAccountCredentialsSms = async ({
    body,
    relatedEvent,
    sendFn: () => sendSingleSms(receiver, templateId, buildSmsParameters(variables, {
-      username,
-      password,
-      fullName: fullName || username,
-      name: fullName || username,
      phoneNumber: receiver,
-      mobile: receiver
+      mobile: receiver,
+      ...slotValues
    }))
  });
 };

-const sendAccountCreatedSms = async (receiver, username, password, userId = null) => {
-  return sendAccountCredentialsSms({
+const sendAccountCredentialsSms = async ({
+  receiver,
+  username,
+  password,
+  userId = null,
+  subject,
+  body,
+  relatedEvent,
+  templateKey = 'accountCreated',
+  userCode = ''
+}) => {
+  const resolvedUserId = userId || await resolveUserIdByPhone(receiver);
+  let fullName = '';
+  let code = userCode;
+  if (resolvedUserId) {
+    const profile = await resolveUserName(resolvedUserId, username);
+    fullName = profile.fullName;
+    code = code || profile.userCode;
+  }
+  return sendTemplateSms({
+    templateKey,
    receiver,
-    username,
-    password,
-    userId,
-    subject: 'ایجاد حساب کاربری',
-    body: `حساب کاربری شما ایجاد شد. نام کاربری: ${username}`,
-    relatedEvent: 'user.created'
+    userId: resolvedUserId,
+    subject,
+    body,
+    relatedEvent,
+    slotValues: {
+      username,
+      password,
+      fullName: fullName || username,
+      name: fullName || username,
+      userCode: code
+    }
  });
 };

-const sendPasswordResetSms = async (receiver, username, password, userId = null) => {
+const sendAccountCreatedSms = async (receiver, username, password, userId = null, userCode = '') => {
  return sendAccountCredentialsSms({
    receiver,
    username,
    password,
    userId,
+    userCode,
+    subject: 'ایجاد حساب کاربری',
+    body: `حساب کاربری شما ایجاد شد. نام کاربری: ${username}`,
+    relatedEvent: 'user.created',
+    templateKey: 'accountCreated'
+  });
+};
+
+const sendPasswordResetSms = async (receiver, username, password, userId = null, userCode = '') => {
+  return sendAccountCredentialsSms({
+    receiver,
+    username,
+    password,
+    userId,
+    userCode,
    subject: 'بازنشانی رمز عبور',
    body: `رمز عبور شما بازنشانی شد. نام کاربری: ${username}`,
-    relatedEvent: 'user.password_reset'
+    relatedEvent: 'user.password_reset',
+    templateKey: 'passwordReset'
  });
 };

@@ -74,27 +115,26 @@ const sendClassRegisteredSms = async (receiver, className, userId = null, extraC
  const resolvedUserId = userId || await resolveUserIdByPhone(receiver);
  let fullName = extraContext.fullName || '';
  if (!fullName && resolvedUserId) {
-    const user = await User.findById(resolvedUserId).select('name').lean();
-    if (user?.name) fullName = user.name;
+    const profile = await resolveUserName(resolvedUserId);
+    fullName = profile.fullName;
  }
-  const { templateId, variables } = await getSmsTemplate('classRegistered');
-  return recordAndSend({
+  return sendTemplateSms({
+    templateKey: 'classRegistered',
+    receiver,
    userId: resolvedUserId,
-    channel: 'sms',
    subject: 'ثبت‌نام در کلاس',
    body: `ثبت‌نام شما در کلاس «${className}» انجام شد.`,
    relatedEvent: 'user.enrolled',
-    sendFn: () => sendSingleSms(receiver, templateId, buildSmsParameters(variables, {
+    slotValues: {
      className,
      courseName: extraContext.courseName || className,
      fullName: fullName || 'کارآموز',
-      phoneNumber: receiver,
-      mobile: receiver,
      classStartDate: extraContext.classStartDate || '',
      classDays: extraContext.classDays || '',
      courseTime: extraContext.courseTime || '',
+      classCode: extraContext.classCode || '',
      ...extraContext
-    }))
+    }
  });
 };

@@ -102,74 +142,226 @@ const sendClassReminderSms = async (receiver, className, time, place = '', userI
  const resolvedUserId = userId || await resolveUserIdByPhone(receiver);
  let fullName = extraContext.fullName || '';
  if (!fullName && resolvedUserId) {
-    const user = await User.findById(resolvedUserId).select('name').lean();
-    if (user?.name) fullName = user.name;
+    const profile = await resolveUserName(resolvedUserId);
+    fullName = profile.fullName;
  }
-  const { templateId, variables } = await getSmsTemplate('classReminder');
-  return recordAndSend({
+  return sendTemplateSms({
+    templateKey: 'classReminder',
+    receiver,
    userId: resolvedUserId,
-    channel: 'sms',
    subject: 'یادآوری کلاس',
    body: `یادآوری کلاس «${className}» ساعت ${time} — مکان: ${place || '-'}`,
    relatedEvent: 'session.reminder',
-    sendFn: () => sendSingleSms(receiver, templateId, buildSmsParameters(variables, {
+    slotValues: {
      className,
+      topic: extraContext.topic || className,
      courseName: extraContext.courseName || className,
      time,
+      classTime: extraContext.classTime || extraContext.courseTime || extraContext.time || time || '',
+      sessionDate: extraContext.sessionDate || '',
      place: place || '-',
      fullName: fullName || 'کارآموز',
-      phoneNumber: receiver,
-      mobile: receiver,
      classStartDate: extraContext.classStartDate || '',
      classDays: extraContext.classDays || '',
-      courseTime: extraContext.courseTime || extraContext.time || time || '',
+      courseTime: extraContext.courseTime || extraContext.classTime || extraContext.time || time || '',
+      classCode: extraContext.classCode || '',
      ...extraContext
-    }))
+    }
  });
 };

 const sendInvoiceCreatedSms = async (receiver, payload, userId = null) => {
  const resolvedUserId = userId || await resolveUserIdByPhone(receiver);
-  const { templateId, variables } = await getSmsTemplate('invoiceCreated');
+  const data = typeof payload === 'object' && payload !== null ? payload : { amount: payload };
+  const fullNameLabel = data.fullName || 'کارآموز';
+  const amountLabel = data.amount != null ? String(data.amount) : '';
+  const courseLabel = data.course || '-';

-  let fullName = '';
-  let amount = '';
-  let course = '';
-  let classStartDate = '';
-  let classDays = '';
-  let courseTime = '';
-
-  if (typeof payload === 'object' && payload !== null) {
-    fullName = payload.fullName || '';
-    amount = payload.amount != null ? String(payload.amount) : '';
-    course = payload.course || '';
-    classStartDate = payload.classStartDate || '';
-    classDays = payload.classDays || '';
-    courseTime = payload.courseTime || '';
-  } else {
-    amount = String(payload || '');
-  }
-
-  const amountLabel = String(amount);
-  const courseLabel = course || '-';
-  const fullNameLabel = fullName || 'کارآموز';
-
-  return recordAndSend({
+  return sendTemplateSms({
+    templateKey: 'invoiceCreated',
+    receiver,
    userId: resolvedUserId,
-    channel: 'sms',
    subject: 'ایجاد صورتحساب',
    body: `کارآموز عزیز، ${fullNameLabel}، یک صورتحساب به مبلغ ${amountLabel} تومان بابت دوره «${courseLabel}» برای شما ایجاد شد.`,
    relatedEvent: 'payment.created',
-    sendFn: () => sendSingleSms(receiver, templateId, buildSmsParameters(variables, {
+    slotValues: {
      fullName: fullNameLabel,
      amount: amountLabel,
      course: courseLabel,
-      phoneNumber: receiver,
-      mobile: receiver,
-      classStartDate,
-      classDays,
-      courseTime
-    }))
+      classStartDate: data.classStartDate || '',
+      classDays: data.classDays || '',
+      courseTime: data.courseTime || '',
+      invoiceCode: data.invoiceCode || ''
+    }
+  });
+};
+
+const sendPaymentStatusChangedSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'paymentStatusChanged',
+    receiver,
+    userId,
+    subject: 'تغییر وضعیت پرداخت',
+    body: `وضعیت صورتحساب شما به «${data.statusLabel || data.status || '-'}» تغییر کرد.`,
+    relatedEvent: 'payment.status_changed',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      status: data.statusLabel || data.status || '-',
+      amount: data.amount != null ? String(data.amount) : '',
+      invoiceCode: data.invoiceCode || '',
+      course: data.course || '-'
+    }
+  });
+};
+
+const sendPaymentReminderSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'paymentReminder',
+    receiver,
+    userId,
+    subject: 'یادآوری سررسید پرداخت',
+    body: `یادآوری: مبلغ ${data.amount || '-'} تومان تا ${data.dueDate || '-'} سررسید دارد.`,
+    relatedEvent: 'payment.reminder_due',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      amount: data.amount != null ? String(data.amount) : '',
+      dueDate: data.dueDate || '',
+      invoiceCode: data.invoiceCode || '',
+      course: data.course || '-'
+    }
+  });
+};
+
+const sendTransactionRecordedSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'transactionRecorded',
+    receiver,
+    userId,
+    subject: 'ثبت تراکنش',
+    body: `تراکنش به مبلغ ${data.amount || '-'} تومان ثبت شد.`,
+    relatedEvent: 'payment.transaction_added',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      amount: data.amount != null ? String(data.amount) : '',
+      invoiceCode: data.invoiceCode || '',
+      transactionCode: data.transactionCode || '',
+      receiptNumber: data.receiptNumber || ''
+    }
+  });
+};
+
+const sendSessionCancelledSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'sessionCancelled',
+    receiver,
+    userId,
+    subject: 'لغو جلسه',
+    body: `جلسه «${data.topic || data.className || 'کلاس'}» لغو شد.`,
+    relatedEvent: 'session.cancelled',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      className: data.className || '-',
+      topic: data.topic || '-',
+      sessionDate: data.sessionDate || '',
+      reason: data.reason || '-',
+      classCode: data.classCode || ''
+    }
+  });
+};
+
+const sendSessionHoldingSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'sessionHolding',
+    receiver,
+    userId,
+    subject: 'برگزاری جلسه طبق برنامه',
+    body: `جلسه «${data.topic || data.className || 'کلاس'}» کلاس ${data.className || ''} در تاریخ ${data.sessionDate || '-'} و ساعت ${data.classTime || data.time || '-'} طبق برنامه برگزار خواهد شد.`,
+    relatedEvent: 'session.holding',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      topic: data.topic || '-',
+      className: data.className || '-',
+      sessionDate: data.sessionDate || '',
+      classTime: data.classTime || data.time || '',
+      courseName: data.courseName || data.className || '-',
+      classCode: data.classCode || '',
+      place: data.place || '-'
+    }
+  });
+};
+
+const sendClassRequestApprovedSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'classRequestApproved',
+    receiver,
+    userId,
+    subject: 'تأیید درخواست تشکیل کلاس',
+    body: `درخواست تشکیل کلاس «${data.courseName || '-'}» تأیید شد.`,
+    relatedEvent: 'class_request.approved',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      courseName: data.courseName || '-',
+      classCode: data.classCode || ''
+    }
+  });
+};
+
+const sendClassRequestRejectedSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'classRequestRejected',
+    receiver,
+    userId,
+    subject: 'رد درخواست ثبت‌نام',
+    body: `درخواست شما برای «${data.courseName || '-'}» رد شد.`,
+    relatedEvent: 'class_request.rejected',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      courseName: data.courseName || '-',
+      reason: data.reason || '-',
+      registrationCode: data.registrationCode || ''
+    }
+  });
+};
+
+const sendPendingRegistrationSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'pendingRegistration',
+    receiver,
+    userId,
+    subject: 'دریافت درخواست ثبت‌نام',
+    body: `درخواست ثبت‌نام شما در «${data.className || '-'}» دریافت شد.`,
+    relatedEvent: 'pending.registration_received',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      className: data.className || '-',
+      registrationCode: data.registrationCode || ''
+    }
+  });
+};
+
+const sendCertificateIssuedSms = async (receiver, payload, userId = null) => {
+  const data = payload || {};
+  return sendTemplateSms({
+    templateKey: 'certificateIssued',
+    receiver,
+    userId,
+    subject: 'صدور گواهینامه',
+    body: `گواهینامه «${data.certificateTitle || '-'}» برای شما صادر شد.`,
+    relatedEvent: 'certificate.issued',
+    slotValues: {
+      fullName: data.fullName || 'کارآموز',
+      certificateTitle: data.certificateTitle || '-',
+      certificateCode: data.certificateCode || '',
+      courseName: data.courseName || '-'
+    }
  });
 };

@@ -178,5 +370,14 @@ module.exports = {
  sendPasswordResetSms,
  sendClassRegisteredSms,
  sendClassReminderSms,
-  sendInvoiceCreatedSms
+  sendInvoiceCreatedSms,
+  sendPaymentStatusChangedSms,
+  sendPaymentReminderSms,
+  sendTransactionRecordedSms,
+  sendSessionCancelledSms,
+  sendSessionHoldingSms,
+  sendClassRequestApprovedSms,
+  sendClassRequestRejectedSms,
+  sendPendingRegistrationSms,
+  sendCertificateIssuedSms
 };