DeviceShelf Server لنظام Windows (amd64) — إصدار تجريبي (BETA)
=============================================================
(English: README.txt · Deutsch: README.de.txt · Français: README.fr.txt
 Español: README.es.txt · Italiano: README.it.txt · 中文: README.zh.txt)

نسخة DeviceShelf العاملة على مدار الساعة بلا واجهة رسومية: تفحص شبكتك باستمرار،
وتنبّه عند ظهور/اختفاء الأجهزة، وتراقب المنافذ/WAN/DNS/TLS، وتوفّر لوحة تحكم
وواجهة API — دون واجهة رسومية. نفس محرّك تطبيق سطح المكتب.


<<< ابدأ بهذا أولاً (Windows 11 / Smart App Control) >>>
--------------------------------------------------------
هذا الإصدار التجريبي غير موقّع رقميًا بعد، لذا يضع Windows على الملفات علامة
"من الإنترنت"، وقد يحذّر SmartScreen/Smart App Control بشأن install.exe. يُحلّ
ذلك في 5 ثوانٍ قبل فك الضغط:

  انقر بزر الفأرة الأيمن على ملف ‎.ZIP‎ المُنزَّل  ->  الخصائص (Properties)
   ->  فعّل "إلغاء الحظر" (Unblock)  ->  موافق (OK)
  ...ثم فك ضغط الملف. الآن يعمل install.exe بشكل طبيعي.

(إذا استمر SmartScreen في التحذير: "مزيد من المعلومات" ثم "تشغيل على أي حال".
وإذا كان Smart App Control مُفعّلاً وحظره بصرامة، فاستخدم التثبيت عبر سطر
الأوامر في الأسفل. نخطّط لإصدار موقّع.)


التثبيت (موصى به) — كخدمة دائمة 24/7
------------------------------------
1. انقر نقرًا مزدوجًا على  install.exe  وأكّد طلب المسؤول (UAC).
   تُثبَّت الخدمة وتُشغَّل، ثم يُعرض عنوان لوحة التحكم ورمز الوصول، وتُفتح لوحة
   التحكم في المتصفح.
2. هذا كل شيء — تعمل الخدمة في الخلفية وتبدأ مع Windows.

لإلغاء التثبيت: انقر نقرًا مزدوجًا على  uninstall.exe  (يؤكّد طلب UAC أيضًا).


إذا حظر Windows الملف (إصدار تجريبي غير موقّع)
---------------------------------------------
هذا الإصدار التجريبي غير موقّع رقميًا بعد، لذا قد يحذّر Windows:
- SmartScreen ("قام Windows بحماية جهازك"): "مزيد من المعلومات" ثم "تشغيل على
  أي حال".
- قبل فك الضغط: انقر بزر الفأرة الأيمن على ملف ‎.zip‎ ثم الخصائص ثم فعّل "إلغاء
  الحظر" ثم موافق، ثم فك الضغط.  (في PowerShell: Unblock-File .\*.exe)
- Smart App Control (في Windows 11 إذا كان مُفعّلاً) يحظر التطبيقات غير الموقّعة
  بصرامة؛ حتى نُصدر نسخة موقّعة يلزم ضبطه على إيقاف/تقييم (Off/Evaluation).
  نخطّط لإصدار موقّع.


لوحة التحكم والرمز
------------------
- العنوان على الخادم نفسه:‏ http://localhost:8088
- العنوان من جهاز آخر:‏ http://<IP-هذا-الخادم>:8088
- يلزم رمز وصول دائمًا عندما تكون لوحة التحكم متاحة على الشبكة المحلية (وهو
  الوضع الافتراضي). لا تخترعه بنفسك — يولّده الخادم تلقائيًا عند أول تشغيل.
- اقرأ الرمز في أي وقت من نافذة أوامر داخل هذا المجلد:
    deviceshelf-server.exe -token
  (يُعرض أيضًا عند تشغيل install.exe وعلى شاشة خادم مُشغَّل يدويًا؛
   أو اقرأ الملف مباشرةً:
    type "%windir%\System32\config\systemprofile\AppData\Roaming\DeviceShelf\api-token")
- عند أول فتح للمتصفح، الصق الرمز عند طلبه.
- اسمح بالوصول إذا سأل جدار حماية Windows، كي يصل الفحص إلى شبكتك المحلية.


اختبار سريع دون تثبيت
---------------------
انقر نقرًا مزدوجًا على  deviceshelf-server.exe  — فيطبع الرمز وعنوان لوحة التحكم
على الشاشة ويفحص شبكتك المحلية. أغلق النافذة أو اضغط Ctrl+C للإيقاف.


التثبيت عبر سطر الأوامر (اختياري — إذا حُظر install.exe)
------------------------------------------------------
لا يفعل install.exe سوى تغليف هذه الأوامر؛ نفّذها بنفسك إن كنت تفضّل ذلك، أو إذا
حظر Smart App Control المُثبِّت. افتح نافذة أوامر كمسؤول: ابدأ -> اكتب "cmd" ->
انقر بزر الفأرة الأيمن -> "تشغيل كمسؤول". ثم:
    cd /d "PATH\TO\THE\EXTRACTED\FOLDER"
    deviceshelf-server.exe -service install
    deviceshelf-server.exe -service start
    deviceshelf-server.exe -token          (يعرض رمز الوصول إلى لوحة التحكم)
يفعل هذا تمامًا ما يفعله install.exe. لإلغاء التثبيت: -service stop، ثم
-service uninstall.


الإعداد (اختياري، متغيرات بيئة النظام)
-------------------------------------
كمسؤول، ثم أعد تشغيل الخدمة:
  الترخيص (وإلا تجربة 7 أيام):‏ setx /M DEVICESHELF_LICENSE "الرمز-الخاص-بك"
  رمز API خاص:‏                setx /M DEVICESHELF_API_TOKEN "قيمة-عشوائية-طويلة"
  المنفذ / الفاصل:‏             setx /M DEVICESHELF_API_PORT "8088"
                              setx /M DEVICESHELF_INTERVAL "5m"
أعد التشغيل:‏ deviceshelf-server.exe -service stop  &&  ... -service start


ملاحظات
-------
- تعمل الخدمة بحساب "النظام المحلي"؛ بياناتها ضمن ملف تعريف النظام، وليس في مجلد
  المستخدم الخاص بك (انظر مسار الرمز أعلاه).
- بصمة DHCP السلبية غير متاحة على Windows (كما في تطبيق سطح المكتب). الفحص
  والمراقبة وSNMP والتنبيهات ولوحة التحكم وAPI: كلها مشمولة.
- للأسئلة/الأعطال:‏ hello@deviceshelf.app
