Initial V2 commit 4

app/Services/SocketService.php

@@ -5,10 +5,15 @@ namespace App\Services;
 use Illuminate\Support\Facades\Log;
 
 /**
- * Socket Communication Service
+ * خدمة التواصل اللحظي (Socket Communication Service)
  * 
- * Communicates with Node.js socket servers for real-time events.
- * Replaces hardcoded IPs in V1 with .env configuration.
+ * الغرض من الملف:
+ * التنسيق بين الخادم (PHP) وخوادم الـ Sockets (التي تعمل بـ Node.js) لتحديث التطبيقات فوراً عند وقوع حدث معين.
+ * 
+ * كيفية العمل:
+ * 1. عندما يتم قبول رحلة أو تحديث موقع، يرسل هذا الملف طلباً سريعاً (Async) لخادم السوكت.
+ * 2. يقوم خادم السوكت بدوره بتوصيل هذه المعلومة لتطبيق الراكب أو السائق في نفس اللحظة بدون تأخير.
+ * 3. يستخدم مفاتيح أمان داخلية (Internal Key) لضمان أن الطلبات قادمة من الخادم الموثوق فقط.
  */
 class SocketService
 {