============================================================
دليل تثبيت سيرفر PhoneControl POS 🚀
============================================================

مرحباً بك في دليل التثبيت لنظام PhoneControl POS.
يرجى اتباع الخطوات التالية لتشغيل وإعداد السيرفر الخاص بالنظام على مختلف أنظمة التشغيل (ويندوز، لينكس، ماك).

------------------------------------------------------------
1. المتطلبات الأساسية (لكل الأنظمة):
------------------------------------------------------------
يجب تثبيت بيئة جافا (Java JDK 17 أو أحدث) على الجهاز لكي يعمل السيرفر.
- لتحميل جافا لويندوز مباشرة:
  https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.exe
- لأنظمة لينكس وماك يمكنك تحميل النسخة المتوافقة من الموقع الرسمي: https://adoptium.net

------------------------------------------------------------
2. خطوات التثبيت حسب نظام التشغيل:
------------------------------------------------------------

--- نظام ويندوز (Windows) ---
1. قم بفك ضغط هذا المجلد كاملاً وضعه في مسار دائم على جهازك (ينصح بالمسار: C:\PhoneControl-POS-Server).
   * تنبيه: لا تقم بتشغيل الملفات وهي داخل الملف المضغوط! يجب فك الضغط أولاً.
2. اضغط بزر الفأرة الأيمن (كليك يمين) على ملف (install.bat) واختر "تشغيل كمسؤول" (Run as administrator).
3. ستفتح شاشة سوداء تقوم تلقائياً بفتح جدار الحماية (Port 8081) وتثبيت السيرفر كخدمة خلفية تعمل صامتة مع تشغيل الويندوز.
4. انتظر حتى تظهر رسالة النجاح: "Done! The server is now running in the background." ثم اضغط أي زر لإغلاق النافذة.

--- نظام لينكس (Linux - Ubuntu/Debian) ---
1. نقل المجلد بعد فك ضغطه إلى المسار المفضل (مثلاً: /opt/PhoneControl-POS-Server).
2. افتح الطرفية (Terminal) وانتقل إلى مجلد السيرفر:
   cd /opt/PhoneControl-POS-Server
3. تأكد من تثبيت الجافا عبر الأمر: `java -version`
4. لتشغيل السيرفر في الخلفية بشكل دائم حتى بعد إغلاق الطرفية، نفذ الأمر التالي:
   nohup java -jar phonecontrol-server.jar > server.log 2>&1 &
5. تأكد من فتح المنفذ 8081 في جدار الحماية الخاص بلينكس:
   sudo ufw allow 8081/tcp

--- نظام ماك (macOS) ---
1. فك ضغط المجلد وانقله إلى التطبيقات أو أي مكان دائم.
2. افتح الـ Terminal وانتقل إلى مسار المجلد:
   cd /path/to/PhoneControl-POS-Server
3. قم بتشغيل السيرفر عبر الأمر التالي:
   java -jar phonecontrol-server.jar
4. يرجى إبقاء نافذة الـ Terminal مفتوحة أثناء العمل، أو تشغيله في الخلفية باستخدام أمر `nohup` كأنظمة لينكس.

------------------------------------------------------------
3. كيفية الوصول للنظام واستخدامه:
------------------------------------------------------------
بعد تشغيل السيرفر بنجاح، افتح متصفح الإنترنت (جوجل كروم، سفاري، إيدج) وادخل للروابط التالية:

- من نفس جهاز السيرفر:
  http://localhost:8081

- من الأجهزة الأخرى أو الهواتف الذكية المتصلة بنفس الشبكة (Wi-Fi):
  استبدل `localhost` برقم الآي بي (IP) الخاص بجهاز السيرفر.
  مثال: http://192.168.1.50:8081

------------------------------------------------------------
شكراً لاستخدامك نظام PhoneControl POS!
============================================================
