تنصيب Hub لصيدلية جديدة

📖 نظرة عامة

Hub هو نسخة محلية من نظام sudanIPS تعمل على جهاز الصيدلية. يتيح:

• ✅ عمل أوفلاين كامل — الإنترنت قطع لأيام؟ لا مشكلة
• ✅ سرعة فائقة — كل البيانات على نفس الجهاز
• ✅ مزامنة تلقائية — كل 30 ثانية مع السحابة
• ✅ أجهزة الصيدلية الأخرى تتصل عبر LAN

🔄 آلية العمل المُختصرة

السوبر أدمن (السحابة)              الصيدلية                       جهاز الصيدلية
       |                              |                                  |
   1. ينشئ صيدلية         →         |                                  |
   2. يولّد token                    |                                  |
   3. ينشئ اشتراك                   |                                  |
   4. ينشئ حساب مدير      →    5. مدير الصيدلية يدخل                   |
                                  6. يضغط "تنزيل الحزمة"                |
                                  7. يستلم ZIP مُخصص    →           8. يفك الضغط
                                                                   9. يشغّل install.bat
                                                                   10. Hub يعمل ✓

🧰 الاستعدادات

على السحابة (سوبر أدمن)

على جهاز الصيدلية (PC)

1 الإعداد على https://sudanips.com

هذه الخطوات تُنفّذها أنت كسوبر أدمن قبل أن يتمكّن مدير الصيدلية من تنزيل الحزمة.

1.1 إنشاء بيانات الصيدلية

1. سجّل دخول كـ superadmin على https://sudanips.com/admin-panel/
2. من الشايدبار اختر "الصيدليات"
3. اضغط "➕ إضافة صيدلية"
4. عبّئ البيانات: الاسم، المدير، الهاتف، المدينة، العنوان
5. اضغط حفظ → سترى الصيدلية في القائمة بـ ID رقمي (مثل #5)

1.2 توليد Token خاص بالصيدلية

1. من الشايدبار اختر "صحة المزامنة" (أو افتح /sync/admin/)
2. ابحث عن الصيدلية الجديدة في الجدول
3. في عمود "Token" اضغط "توليد Token"
4. سيظهر Modal فيه Token طويل (64 حرف)
5. انسخ Token فوراً — لن يظهر مرة أخرى!
6. أغلق الـ Modal

1.3 إنشاء اشتراك للصيدلية

1. من الشايدبار اختر "الاشتراكات والتجديدات" (/admin-panel/subscriptions/)
2. ابحث عن الصيدلية الجديدة
3. اضغط "تجديد"
4. في النافذة المنبثقة:
   • الباقة: أساسي / قياسي / مميّز
   • المدة: 12 شهر (افتراضي)
   • المبلغ: المتفق عليه (مثلاً 500,000 ج.س)
   • مرجع الدفع: رقم الإيصال أو رمز التحويل
   • ملاحظات: اختياري
5. اضغط "تأكيد التجديد"

1.4 إنشاء حساب مدير الصيدلية

1. من الشايدبار اختر "المستخدمون"
2. اضغط "➕ إضافة مستخدم"
3. عبّئ:
   • اسم المستخدم: مختصر (مثل fairdeal_admin)
   • الاسم الكامل: للعرض
   • المستوى: admin (مدير صيدلية)
   • الصيدلية: اختر الصيدلية من القائمة
   • كلمة المرور: قوية + سهلة عليه يحفظها
4. اضغط حفظ

2 تنزيل الحزمة من dashboard

هذه الخطوات يُنفّذها مدير الصيدلية من حساب أنشأته له.

2.1 تسجيل الدخول

1. افتح المتصفح على https://sudanips.com/login/
2. أدخل اسم المستخدم + كلمة المرور التي أرسلها السوبر أدمن
3. اضغط دخول → سيتوجه لداش بورد الصيدلية

2.2 تنزيل حزمة التنصيب

في أعلى داش بورد الصيدلية ستظهر بطاقة ذهبية كبيرة:

1. اضغط زر "تنزيل حزمة التنصيب"
2. سيُنزَّل ZIP باسم sudanips-hub-{اسم_الصيدلية}-{رقم}.zip (~1 MB)
3. احفظه في مجلد مؤقت على جهازه

2.3 ملاحظة: متى يختفي الزر؟

بعد أن يعمل Hub بنجاح ويرسل أول heartbeat (خلال 30-60 ثانية من تشغيله):

• 🟢 يختفي زر التنزيل من الداش بورد
• 🟢 يظهر بدلاً منه: "✓ Hub المحلي شغّال (آخر مزامنة قبل X دقيقة)"
• 🔴 لو Hub توقف لأكثر من 10 دقائق → الزر يعود ليعيد المحاولة

3 التنصيب على PC

هذه أهم مرحلة. يُنفّذها الفنّي/مدير الصيدلية على الجهاز المخصّص لـ Hub.

3.1 المتطلبات قبل البدء

أ) Python 3.8 أو أحدث

1. افتح https://www.python.org/downloads/
2. نزّل Python 3.8+ (Windows 64-bit)
3. شغّل المُنصِّب
4. ⚠ مهم جداً: ضع علامة على ✓ Add Python to PATH في أول شاشة
5. اضغط Install Now
6. للتحقق: افتح Command Prompt واكتب: python --version → يظهر الإصدار

3.2 فك ضغط حزمة الصيدلية

1. اختر مكان دائم — مفضّل D:\SudanIPSHub\ لأن:
   • D: ينجو من إعادة تثبيت Windows
   • بعيد عن OneDrive (التداخل مع المزامنة)
2. إذا D: غير متاح، استخدم C:\SudanIPSHub\
3. افتح ZIP المُنزَّل (sudanips-hub-...zip)
4. فك الضغط في المسار المختار

3.3 تنزيل nssm.exe

NSSM أداة Windows تحوّل أي برنامج لخدمة. مطلوبة لتشغيل Hub تلقائياً:

1. افتح https://nssm.cc/download
2. نزّل "nssm 2.24" (الأحدث)
3. فك ضغط ZIP الذي نُزِّل
4. من المجلد win64/ انسخ nssm.exe
5. الصقه في: D:\SudanIPSHub\hub_windows\ (بجانب install.bat)

3.4 تشغيل install.bat

1. افتح المجلد D:\SudanIPSHub\hub_windows\
2. انقر بالزر الأيمن على install.bat
3. اختر "Run as administrator"
4. سيظهر مربع UAC → اضغط نعم
5. سيُفتح Console يطبع 20 خطوة:

   ====== Step 1 ======   التحقق من Administrator
   ====== Step 2 ======   اكتشاف ملفات المشروع
   ====== Step 3 ======   التحقق من Python
   ====== Step 4 ======   التحقق من NSSM
   ====== Step 5 ======   تحديد مسار التنصيب
   ...
   ====== Step 20 ======  عرض ملخص

6. اتبع الأسئلة:
   • Install path: اضغط Enter للمسار الافتراضي
   • Pharmacy code: مُعبَّأ تلقائياً من .env
   • Sync token: مُعبَّأ تلقائياً من .env
7. انتظر 5-10 دقائق (الأطول: pip install + sync_bootstrap)
8. عند الانتهاء سيظهر:

   =============================================
                 INSTALLATION COMPLETED SUCCESSFULLY
   =============================================
     Install path:   D:\SudanIPSHub
     Pharmacy code:  5
     Local URL:      http://localhost:8000
     Network URL:    http://192.168.1.10:8000
   
     Services running:
       * SudanIPSHub
       * SudanIPSHubSync
       * SudanIPSHubWatcher
       * SudanIPS_Hourly_Backup

4 التحقق من النجاح

على جهاز الصيدلية

1. افتح المتصفح على http://localhost:8000/ — يظهر الموقع
2. افتح http://localhost:8000/sync/health/ — يجب أن ترى:

   {"ok": true, "checks": {"db_local": {"ok": true}, "cloud": {"ok": true, ...}, "pending_total": 0}}

3. سجّل دخول بحساب مدير الصيدلية
4. افتح صفحة المخزون — يجب أن ترى الأصناف (مستوردة من السحابة)

على السحابة (سوبر أدمن)

1. افتح https://sudanips.com/sync/admin/
2. ابحث عن الصيدلية في الجدول
3. الحالة يجب تكون 🟢 healthy
4. عمود "آخر heartbeat": أقل من 5 دقائق

على dashboard الصيدلية

عُد لـ dashboard الصيدلية على السحابة. زر التنزيل اختفى وظهر بدلاً منه:

✓ Hub المحلي شغّال
(آخر مزامنة قبل X دقيقة)

5 ربط أجهزة الصيدلية الأخرى

إذا كان للصيدلية أجهزة أخرى (كاونتر إضافي، تابلت، جوال) — كلهم على نفس WiFi — يمكنهم استخدام Hub:

1. على جهاز Hub: افتح Command Prompt واكتب ipconfig
2. ابحث عن "IPv4 Address" — مثلاً 192.168.1.10
3. على الجهاز الآخر: افتح المتصفح على http://192.168.1.10:8000/
4. سجّل دخول بحساب موظف
5. اذهب لصفحة /sync/status/
6. في قسم "اتصال المتصفح بـ Hub محلي": أدخل http://192.168.1.10:8000
7. اضغط حفظ

الآن المتصفح يعتمد على Hub المحلي. حتى لو الإنترنت قطع، سيستمر العمل.

netsh advfirewall firewall add rule name="SudanIPS Hub" dir=in action=allow protocol=TCP localport=8000

🛠️ استكشاف الأخطاء

سجلات للمراجعة

• D:\SudanIPSHub\logs\hub.log — السيرفر
• D:\SudanIPSHub\logs\hub-err.log — أخطاء السيرفر
• D:\SudanIPSHub\logs\sync.log — المزامنة
• D:\SudanIPSHub\logs\sync-err.log — أخطاء المزامنة
• D:\SudanIPSHub\logs\watcher.log — التحديث التلقائي
• D:\SudanIPSHub\logs\update_watcher.log — تفاصيل التحديث

🔧 الصيانة الدورية

عند تجديد اشتراك صيدلية

1. افتح /admin-panel/subscriptions/
2. ابحث عن الصيدلية
3. اضغط "تجديد"
4. عبّئ المبلغ + المرجع
5. اضغط حفظ → JWT جديد يصل Hub خلال 30 ثانية

عند سرقة/تسريب Token

1. افتح /sync/admin/
2. اضغط "إبطال" على Token الصيدلية المتأثرة
3. اضغط "توليد Token" — يُولَّد جديد فوراً
4. أبلِغ مدير الصيدلية: ادخل dashboard وأعد تنزيل الحزمة
5. الفنّي يفك ضغط الـ ZIP الجديد على نفس مكان Hub القديم → استبدال .env
6. أعد تشغيل الخدمات: net stop SudanIPSHubSync & net start SudanIPSHubSync

عند ترقية النظام (تحديث الإصدار)

Hub يفحص update.flag كل 10 دقائق. عندما تضع ZIP جديد في releases/ على السحابة وتُنشئ update.flag، الـ SudanIPSHubWatcher سيقوم تلقائياً بـ:

1. إيقاف الخدمات
2. أخذ snapshot من DB (للأمان)
3. تنزيل وفك الضغط
4. تشغيل migrate + collectstatic
5. إعادة تشغيل الخدمات
6. فحص health — لو فشل، استرجاع snapshot تلقائياً

الجدولة اليومية

• تنبيهات الاشتراكات: subscription_alerts (cron 9 صباحاً يومياً)
• تنبيهات Hub الميتة: sync_alerts (cron يومياً)
• نسخ احتياطية: كل ساعة على Hub (Task Scheduler)

عند مغادرة المُختبَر

قبل أن تُسلِّم الصيدلية للموظفين:

التنصيب اكتمل

احفظ هذا الدليل (طباعة → PDF) في ملفات الصيدلية. لأي مساعدة: +201555257895 | info@sudanips.com