fix: format prices in notifications, change partial payment label, and add session holding notify API

components/payments/paymentService.js

@@ -28,7 +28,8 @@ const {
   isPaidTransaction,
   isCancelledTransaction,
   isActiveTransaction,
-  sumPaidTransactions
+  sumPaidTransactions,
+  formatPrice
 } = require('../../utils/paymentAmount');
 const logger = require('../../utils/logger');
 
@@ -36,7 +37,7 @@ const PAYMENT_METHODS = new Set(['online', 'card', 'cash']);
 
 const PAYMENT_STATUS_LABELS = {
   pending: 'در انتظار پرداخت',
-  partial: 'پرداخت جزئی',
+  partial: 'پیش پرداخت',
   paid: 'پرداخت‌شده',
   overdue: 'معوق'
 };
@@ -112,7 +113,7 @@ const notifyTransactionRecorded = async (payment, transaction, source = {}) => {
       phoneNumber: user.phoneNumber,
       email: user.email,
       subject: 'ثبت تراکنش',
-      body: `تراکنش ${transaction.uniqueCode || ''} به مبلغ ${transaction.amount} تومان ثبت شد.`,
+      body: `تراکنش ${transaction.uniqueCode || ''} به مبلغ ${formatPrice(transaction.amount)} تومان ثبت شد.`,
       smsHandler: () => sendTransactionRecordedSms(user.phoneNumber, {
         fullName: user.name || '',
         amount: transaction.amount,
@@ -333,7 +334,7 @@ const createPayment = async (body, actorId = null) => {
           phoneNumber: user.phoneNumber,
           email: user.email,
           subject: 'ایجاد صورتحساب',
-          body: `صورتحساب ${invoiceCode} به مبلغ ${getPayableAmount(payment)} تومان بابت «${courseName}» ایجاد شد.`,
+          body: `صورتحساب ${invoiceCode} به مبلغ ${formatPrice(getPayableAmount(payment))} تومان بابت «${courseName}» ایجاد شد.`,
           smsHandler: () => sendInvoiceCreatedSms(user.phoneNumber, {
             fullName: user.name || '',
             amount: getPayableAmount(payment),

components/sessions/sessionController.js

@@ -57,6 +57,12 @@ exports.updateAttendance = catchAsync(async (req, res, next) => {
   return successResponse(res, 200, 'Session attendance updated successfully', session);
 });
 
+exports.notifyHolding = catchAsync(async (req, res, next) => {
+  const actorId = req.user?._id;
+  const result = await sessionService.notifySessionHolding(req.params.id, actorId);
+  return successResponse(res, 200, 'اطلاع‌رسانی برگزاری جلسه با موفقیت انجام شد', result);
+});
+
 exports.getMySessions = catchAsync(async (req, res, next) => {
   const { data, meta } = await sessionService.getMySessions(req.user._id, req.query);
   return listResponse(res, 200, data, meta);

components/sessions/sessionRoutes.js

@@ -28,5 +28,6 @@ router.delete('/admin/delete/:id', perm.requires(PERMISSIONS.SESSIONS_DELETE), s
 router.post('/admin/bulk-delete', perm.requires(PERMISSIONS.SESSIONS_DELETE), sessionController.bulkDelete);
 router.post('/admin/bulk-status', perm.requires(PERMISSIONS.SESSIONS_UPDATE), sessionController.bulkUpdateStatus);
 router.put('/admin/:id/attendance', perm.requires(PERMISSIONS.SESSIONS_ATTENDANCE), validateUpdateAttendanceList, sessionController.updateAttendance);
+router.post('/admin/:id/notify-holding', perm.requires(PERMISSIONS.SESSIONS_READ), sessionController.notifyHolding);
 
 module.exports = router;

components/sessions/sessionService.js

@@ -9,6 +9,9 @@ const AppError = require('../../utils/AppError');
 const eventEmitter = require('../../events/eventEmitter');
 const EVENT_NAMES = require('../../constants/eventNames');
 const { parsePaginationAndSort, buildFilterQuery, calculateMeta } = require('../../utils/pagination');
+const { notifyAction } = require('../../utils/actionNotify');
+const { sendSessionHoldingSms } = require('../../utils/senders/smsMessages');
+const logger = require('../../utils/logger');
 
 const STATUS_MAP = {
   scheduled: 'scheduled',
@@ -430,6 +433,77 @@ const getMySessions = async (userId, queryParams) => {
   return { data: sessions, meta };
 };
 
+const notifySessionHolding = async (sessionId, actorId = null) => {
+  const session = await Session.findById(sessionId)
+    .populate({
+      path: 'class',
+      select: 'name uniqueCode students startTime place'
+    })
+    .populate('course', 'title');
+
+  if (!session) {
+    throw new AppError('SESSION_NOT_FOUND');
+  }
+
+  const classDoc = session.class;
+  let studentIds = classDoc?.students?.length
+    ? classDoc.students
+    : (await User.find({ courses: session.course?._id || session.course }).select('_id')).map((u) => u._id);
+
+  if (!studentIds.length) {
+    throw new AppError('NOT_FOUND', null, 'هیچ دانشجویی در این کلاس ثبت‌نام نشده است.');
+  }
+
+  const sessionDate = session.day
+    ? new Date(session.day).toLocaleDateString('fa-IR')
+    : '';
+  const className = classDoc?.name || session.course?.title || 'کلاس';
+  const classCode = classDoc?.uniqueCode || '';
+  const timeLabel = session.startTime || '';
+  const topicLabel = session.topic || className;
+
+  const users = await User.find({ _id: { $in: studentIds } }).select('name phoneNumber email').lean();
+  const validUsers = users.filter((u) => u.phoneNumber);
+
+  if (!validUsers.length) {
+    throw new AppError('NOT_FOUND', null, 'هیچ دانشجویی با شماره همراه معتبر در این کلاس یافت نشد.');
+  }
+
+  let sentCount = 0;
+  for (const student of validUsers) {
+    try {
+      await notifyAction({
+        actionKey: 'sessionHolding',
+        userId: student._id,
+        phoneNumber: student.phoneNumber,
+        email: student.email,
+        subject: 'برگزاری جلسه طبق برنامه',
+        body: `جلسه «${topicLabel}» کلاس ${className} در تاریخ ${sessionDate} و ساعت ${timeLabel} طبق برنامه برگزار خواهد شد.`,
+        smsHandler: () => sendSessionHoldingSms(student.phoneNumber, {
+          fullName: student.name || '',
+          className,
+          topic: topicLabel,
+          sessionDate,
+          classTime: timeLabel,
+          courseName: session.course?.title || className,
+          classCode,
+          place: session.place || '-'
+        }, student._id),
+        requestSource: { notifySms: true, notifyEmail: true, notifyBot: true }
+      });
+      sentCount += 1;
+    } catch (err) {
+      logger.error(`[notifySessionHolding] Failed for user ${student._id}: ${err.message}`);
+    }
+  }
+
+  return {
+    success: true,
+    sentCount,
+    totalStudents: validUsers.length
+  };
+};
+
 module.exports = {
   createSession,
   getSessionById,
@@ -441,6 +515,7 @@ module.exports = {
   searchSessions,
   updateSessionAttendance,
   getMySessions,
+  notifySessionHolding,
   isSessionDue,
   hasCompleteAttendance,
   isAttendancePending

components/settings/smsTemplates.js

@@ -382,13 +382,33 @@ const resolveVariablesList = (def, storedVariables) => {
     .filter(Boolean);
 };
 
+const isPriceSlot = (slot = '', name = '') => {
+  const s = String(slot).toLowerCase();
+  const n = String(name).toLowerCase();
+  return s.includes('amount') || s.includes('price') || s.includes('tuition') || s.includes('fee')
+    || n.includes('amount') || n.includes('price') || n.includes('tuition') || n.includes('fee') || n.includes('cost');
+};
+
+const formatPriceValue = (val) => {
+  if (val === null || val === undefined || val === '') return '';
+  const str = String(val).trim();
+  const rawNum = Number(str.replace(/,/g, ''));
+  if (!Number.isNaN(rawNum) && Number.isFinite(rawNum)) {
+    return rawNum.toLocaleString('en-US');
+  }
+  return str;
+};
+
 const buildSmsParameters = (variables, valuesBySlot = {}) => {
   return normalizeVariablesInput(variables, null)
     .map((item) => {
       const name = sanitizeVariableName(item?.name);
       if (!name) return null;
       const slot = item?.slot;
-      const value = slot ? valuesBySlot?.[slot] : '';
+      let value = slot ? valuesBySlot?.[slot] : '';
+      if (isPriceSlot(slot, name) && value != null && value !== '') {
+        value = formatPriceValue(value);
+      }
       return {
         name,
         value: String(value ?? '')