پیاده‌سازی سرویس اعلان Push در پروژه دانشجویی با Socket.io

پیاده‌سازی سرویس اعلان Push در پروژه دانشجویی با Socket.io

آیا تاکنون در پروژه دانشجویی خود با موقعیتی مواجه شده‌اید که کاربر منتظر بماند تا صفحه را رفرش کند تا از تغییرات جدید (مثل پیام جدید یا تکمیل سفارش) باخبر شود؟ این تجربه کاربری دیگر در پروژه‌های مدرن قابل قبول نیست. دانشجویان و توسعه‌دهندگان جوان اغلب در بخش بک‌‌اند و مدیریت دیتابیس قوی عمل می‌کنند، اما در پیاده‌سازی ارتباطات بلادرنگ (Real-time) با چالش مواجه می‌شوند. مشکل اصلی اینجاست که HTTP پروتکلی Stateles است و برای دریافت اطلاعات جدید نیاز به درخواست مکرر دارد که هم منابع سرور را می‌بلعد و هم تجربه کاربری را خراب می‌کند.

راه‌حل حرفه‌ای، استفاده از WebSockets است. در این مقاله، به صورت گام‌به‌گام و عملی بررسی می‌کنیم که چگونه می‌توانید یک سیستم نوتیفیکیشن Push واقعی را در پروژه دانشجویی خود با استفاده از Socket.io پیاده‌سازی کنید. این آموزش برای کسانی است که می‌خواهند پروژه‌شان از حالت «آفلاین» به «بلادرنگ» ارتقا یابد.

چرا Socket.io برای پروژه‌های دانشجویی بهترین انتخاب است؟

بسیاری از دانشجویان فکر می‌کنند برای ساخت سیستم نوتیفیکیشن باید از پایتون یا Go استفاده کنند، اما اگر با Node.js کار می‌کنید، Socket.io قدرتمندترین ابزار است. دلیل این محبوبیت، مدیریت خودکار «پوشش ناهمگونی» (Fallback) است. اگر مرورگر کاربر WebSocket را پشتیبانی نکند، Socket.io به صورت خودکار به Long-Polling تغییر پروتکل می‌دهد.

در پروژه‌های دانشجویی، اسکیل‌پذیری (Scalability) همیشه اولویت اول نیست، اما تمیزی کد و قابلیت توسعه بله. Socket.io با مفهوم Rooms و Namespaces این امکان را می‌دهد که شما نوتیفیکیشن‌ها را به صورت گروهی (مثلاً به تمام کاربران آنلاین یک کلاس) یا شخصی ارسال کنید. این قابلیت در پروژه‌های دانشگاهی که نیاز به مدیریت چندین کاربر همزمان دارند، بسیار ارزشمند است.

معماری کلی سیستم نوتیفیکیشن

قبل از کدنویسی، باید بدانید داده‌ها چگونه جریان پیدا می‌کنند. معماری پیشنهادی برای پروژه شما به این صورت است:

1. کلاینت (Frontend): یک اتصال WebSocket برقرار می‌کند و به رویداد connect گوش می‌دهد.
2. سرور (Backend): با استفاده از کتابخانه socket.io، اتصال را مدیریت کرده و یک ID منحصر‌به‌فرد (Socket ID) به کاربر اختصاص می‌دهد.
3. اتصال دیتابیس: این Socket ID در دیتابیس (مثلاً MongoDB یا PostgreSQL) به UserID کاربر متصل می‌شود.
4. ارسال رویداد: زمانی که رویدادی رخ می‌دهد (مثلاً ثبت سفارش)، سرور به جای بازگرداندن JSON معمولی، یک رویداد سفارشی (مثل order:new) را برای Socket ID خاص پرتاب می‌کند.

پیاده‌سازی گام‌به‌گام در Node.js

فرض کنید شما یک پروژه Express.js دارید. ابتدا کتابخانه مورد نیاز را نصب کنید:

npm install socket.io

۱. راه‌اندازی سرور

در فایل اصلی سرور (مثلاً server.js)، باید io را به سرور HTTP متصل کنید. این کار معمولاً در انتهای فایل انجام می‌شود:

const http = require('http');
const app = require('./app');
const { Server } = require("socket.io");

const server = http.createServer(app);
const io = new Server(server, {
  cors: {
    origin: "http://localhost:3000", // آدرس فرانت‌اند شما
    methods: ["GET", "POST"]
  }
});

io.on('connection', (socket) => {
  console.log('کاربر متصل شد:', socket.id);

  // وقتی کاربر نام کاربری خود را ارسال کرد، او را شناسایی کن
  socket.on('register_user', (userId) => {
    socket.join(userId);
    console.log(کاربر ${userId} در اتاق خود عضو شد.);
  });

  socket.on('disconnect', () => {
    console.log('کاربر قطع شد:', socket.id);
  });
});

const PORT = process.env.PORT || 3001;
server.listen(PORT, () => {
  console.log(سرور نوتیفیکیشن روی پورت ${PORT} در حال اجراست);
});

۲. ارسال نوتیفیکیشن از روت‌های API

این بخش کلیدی است. شما در روت‌های عادی Express (مثلاً هنگام POST کردن داده)، به جای ارسال پاسخ JSON، از io استفاده می‌کنید:

// فرض کنید io را در این فایل ایمپورت کرده‌اید
router.post('/create-task', async (req, res) => {
  const newTask = await Task.create(req.body);

  // ارسال نوتیفیکیشن به مدیر پروژه
  io.to(req.body.managerId).emit('task:new', {
    message: 'یک تسک جدید اضافه شد',
    taskId: newTask._id
  });

  res.status(201).json(newTask);
});

مدیریت رویدادها در فرانت‌اند (React/Vue)

در سمت کلاینت، شما باید یک شنونده (Listener) داشته باشید که منتظر رویدادهای ارسالی سرور باشد. در React می‌توانید از useEffect استفاده کنید:

useEffect(() => {
  const socket = io('http://localhost:3001');

  socket.on('connect', () => {
    socket.emit('register_user', currentUser.id);
  });

  socket.on('task:new', (data) => {
    // نمایش پاپ‌آپ یا تغییر وضعیت در UI
    showNotification(data.message);
  });

  return () => socket.disconnect();
}, []);

چالش‌های رایج در پروژه‌های دانشجویی

در حین پیاده‌سازی، دانشجویان اغلب با خطاهای CORS مواجه می‌شوند. مطمئن شوید که در تنظیمات cors در سرور Socket.io، آدرس دقیق فرانت‌اند (شامل پورت) را وارد کرده‌اید. همچنین، اگر پروژه را روی هاست واقعی (مثل Heroku یا Vercel) دیپلوی می‌کنید، باید از Socket.IO Adapter برای ارتباط بین چندین اینستنس سرور استفاده کنید، زیرا Socket به صورت پیش‌فرض حافظه محلی دارد.

استفاده از این الگو نه تنها نمره پروژه شما را به شدت افزایش می‌دهد، بلکه مهارتی است که در بازار کار به عنوان «توسعه‌دهنده Full-stack بلادرنگ» از شما طلب می‌شود. اگر مایل هستید ساختار کامل پروژه را بدون دردسر پیاده‌سازی ببینید، می‌توانید به سورس‌کست source-cast.ir مراجعه کنید تا نمونه‌های کد استاندارد و ماژولار را مشاهده کنید.

جمع‌بندی

پیاده‌سازی نوتیفیکیشن Push با Socket.io یک سرمایه‌گذاری هوشمندانه برای پروژه‌های دانشجویی است. این قابلیت نشان‌دهنده درک عمیق شما از معماری سرور-کلاینت است. با رعایت نکات امنیتی (مثل اعتبارسنجی توکن در لحظه اتصال) و مدیریت صحیح Rooms، می‌توانید پروژه‌ای بسازید که با پروژه‌های تجاری رقابت کند. فراموش نکنید که کد تمیز و مستندسازی صحیح، نیمی از موفقیت پروژه دانشگاهی است.

برای دیدن معماری‌های پیچیده‌تر و پروژه‌های آماده‌ای که از این تکنولوژی استفاده کرده‌اند، مطالعه در سورس‌کست source-cast.ir می‌تواند دیدگاه تازه‌ای به شما بدهد.

سؤالات پرتکرار

آیا Socket.io برای پروژه‌های بزرگ مقیاس‌پذیر است؟

بله، اما برای مقیاس‌پذیری بالا (چندین سرور) نیاز به استفاده از Adapterهایی مانند Redis دارید تا ارتباط بین سرورها برقرار شود.

تفاوت Socket.io با WebSocket چیست؟

WebSocket یک پروتکل است، اما Socket.io یک کتابخانه روی آن است که قابلیت‌های اضافی مثل اتصال مجدد خودکار و پشتیبانی از مرورگرهای قدیمی را فراهم می‌کند.

آیا می‌توانم از Socket.io در پروژه‌های PHP یا Python استفاده کنم؟

بله، اما باید یک سرور Node.js جداگانه برای مدیریت Socket.io داشته باشید و آن را از طریق API یا Queue با بک‌اند اصلی خود هماهنگ کنید.