التوثيق والتعليمات

كل ما يحتاجه صاحب الشبكة لتشغيل GazaHotspot: من ربط الراوتر وبيع أول بطاقة، إلى مراقبة الأبراج والأجهزة. لا تجد جوابك؟ استخدم «مساعدة GazaHotspot» داخل لوحة التحكم.

لا نتائج لبحثك — جرّب كلمة أخرى.

1إنشاء الحساب ومعالج البداية

  1. من الصفحة الرئيسية اضغط ابدأ مجاناً، وأدخل اسمك وبريدك وكلمة مرور، ثم اسم شبكتك (يظهر للمشترين في المتجر).
  2. أكّد بريدك من الرسالة التي تصلك (تحقق من مجلد الرسائل غير المرغوبة).
  3. يفتح معالج البداية: بيانات الشبكة ← طريقة استلام الأموال ← الراوتر ← أول فئة بطاقات. يمكنك تخطي أي خطوة والعودة لها لاحقاً.
ابدأ بفئة واحدة واستورد دفعة صغيرة، وجرّب الشراء بنفسك من المتجر قبل الإعلان للمشتركين.

2ربط راوتر MikroTik

من البرود باند ← أجهزة وراوترات MikroTik أضف الراوتر واختر طريقة الاتصال:

الطريقةمتى تستخدمها
API مباشرللراوتر بعنوان IP عام يمكن للمنصة الوصول إليه.
WireGuardللراوتر خلف NAT أو بدون IP ثابت (الأكثر شيوعاً في غزة). تعطيك المنصة سكربتاً تلصقه في Terminal فيُنشئ نفقاً آمناً.
سكربت فقطإن لم يمكن أي اتصال: تنزّل سكربت إضافة البطاقات وتلصقه يدوياً. لا تعمل معه الميزات التلقائية (الصلاحية من أول دخول، المراقبة).

مستخدم API آمن على الراوتر

/user group add name=gazahotspot policy=read,write,api,rest-api,test,!ftp,!ssh,!winbox,!web,!password,!policy,!reboot,!sensitive
/user add name=gazahotspot group=gazahotspot password=كلمة-مرور-قوية

ثم اضغط اختبار الاتصال. عند النجاح تظهر حالة الراوتر (المعالج، الذاكرة، مدة التشغيل) وتبدأ المنصة بإضافة البطاقات إليه تلقائياً.

كلمات مرور الراوتر تُحفظ مشفّرة ولا تظهر لأي أحد بعد الحفظ.

3الفئات والأسعار والصلاحية

من مخزن البطاقات ← الفئات والأسعار: لكل فئة اسم (مثل «يوم» أو «8 ساعات») وسعر وحدّ تنبيه للمخزون.

الصلاحية من أول دخول

اكتب في صالحة لمدة (ساعات) مثلاً 8: يبدأ العدّ عند أول دخول للمشترك، ويستمر حتى لو أغلق البطاقة أو خرج، ثم تُفصل البطاقة وتُحذف من الراوتر تلقائياً. يظهر للمشتري «⏱ صالحة 8 ساعات من أول دخول».

تحتاج هذه الميزة راوتراً متصلاً (API أو WireGuard). إن انقطع الاتصال بالراوتر يتأخر الفصل حتى يعود.

4استيراد البطاقات

  1. من مخزن البطاقات ← استيراد البطاقات اختر ملف الاتصالات كما وصلك (Excel أو CSV أو PDF نصي).
  2. اختر الفئة، والمخزن: الرئيسي (يُباع أولاً) أو الاحتياطي (يُباع فقط عند نفاد الرئيسي، ويصلك تنبيه).
  3. تتعرّف المنصة على الأعمدة تلقائياً، وتستبعد المكرر والتالف، ثم تعرض ملخصاً قبل الحفظ.
  4. بعد الحفظ تُضاف البطاقات إلى الراوتر تلقائياً، وتتابع حالتها في الدفعات.

أرقام البطاقات تُحفظ مشفّرة لكل شبكة على حدة، ولا تظهر كاملة إلا للمشتري بعد الدفع.

5البطاقات المختصرة

بدل أرقام الاتصالات الطويلة، يحصل المشتري على اسم مستخدم وكلمة مرور قصيرين (من رقمين حتى 10 أرقام؛ الافتراضي 4 + 4) يسهل كتابتهما. الرقمان يكفيان لـ 90 بطاقة فعّالة في نفس الوقت، و3 أرقام لـ 900. تُفعَّل من إعدادات الشبكة ← تقصير بطاقات الاتصالات (من قائمة اسم شبكتك أعلى اللوحة)، ويمكن ضبط عدد الأرقام.

  • البطاقات المستوردة بعد التفعيل تُختصر تلقائياً.
  • البطاقات القديمة في المخزون تحوّلها من نفس القسم (يُحدَّث الراوتر أيضاً).
  • في الشبكة المختصرة يُباع المختصر أولاً، ولا تُباع البطاقة الطويلة إلا إذا لم يبقَ غيرها.
إن كان الراوتر غير متصل أثناء التحويل تُتخطى بطاقاته ويظهر لك اسمه، فأعد التحويل بعد عودة الاتصال.

6الطباعة والبيع اليدوي

من مخزن البطاقات ← البطاقات حدّد بطاقات واطبعها، ويمكنك تخصيص شكلها من مصمم البطاقات. على كل بطاقة رمز QR: إن ضبطت رابط صفحة الدخول، يدخل المشترك مباشرة بمسح الرمز.

البطاقة المطبوعة تُعلَّم «مطبوعة» ولا تُباع أونلاين، وتُحسب مبيعاً عند أول استخدام لها على الراوتر.

7المتجر وتجربة المشتري

لكل شبكة متجر على https://gazahotspot.com/s/اسم-شبكتك (أو عنوانك الخاص، انظر القسم التالي). المشتري:

  1. يختار الفئة ويكتب رقم جواله ويدفع.
  2. بعد تأكيد الدفع تظهر بطاقته فوراً، ومعها زر ⚡ ادخل للإنترنت مباشرة لتسجيل الدخول بضغطة دون نسخ الأرقام.
  3. يجد بطاقاته لاحقاً في بطاقاتي على نفس الجهاز، ويجدّد نفس الباقة بنقرة.

من المبيعات ← ملصق QR للشراء اطبع ملصقاً بحجم A4 فيه رمز QR لمتجرك لتعلّقه في المحل.

ليعمل زر الدخول المباشر اكتب عنوان صفحة دخول الراوتر في إعدادات الشبكة ← الدخول للإنترنت والبيع. يكفي الدومين فقط (مثل wifi.local)، وتُكمل المنصة http:// و/login.

8عنوان المتجر (نطاق خاص)

من الإعدادات ← عنوان المتجر اطلب عنواناً قصيراً:

  • نطاق فرعي مجاني: اسمك.gazahotspot.com. اكتب الاسم فقط (أحرف إنجليزية صغيرة وأرقام وشرطة).
  • نطاق تملكه: مثل wifi-alnoor.com. أضف عند مزوّد النطاق سجل CNAME يشير إلى gazahotspot.com قبل الطلب.

يصل طلبك إلى إدارة المنصة، وعند التفعيل يصلك إشعار وبريد بأن عنوانك أصبح متاحاً. بعدها تستخدم كل الروابط ورموز QR الجديدة عنوانك، ويبقى الرابط القديم يعمل.

إن استخدمت نطاقاً خاصاً، أعد تنزيل ملف Walled Garden من مصمم الهوتسبوت بعد التفعيل ليُسمح بعنوانك قبل تسجيل الدخول.

9الدفع والمحفظة والسحب

طريقتا استلام المال

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

الإعداد من الإعدادات ← استلام المدفوعات.

طلب دفعة (سحب)

من المبيعات ← المحفظة وطلب دفعة اختر المبلغ وطريقة الاستلام: جوال باي، بال باي، بنك فلسطين، حساب بنكي، تحويل، أو نقداً. تصلك الدفعة مع إشعار التحويل ورقم الحركة.

الحوالة اليدوية

إن دفع المشتري بحوالة، تبقى بطاقته محجوزة له حتى يُتحقق من الإشعار، ثم تظهر له تلقائياً.

10صفحة الهوتسبوت

إن كانت لديك صفحة دخول من الاتصالات

من الإعدادات ← الربط مع صفحة الهوتسبوت (API) انسخ رابط الشراء وضعه كزر «اشترِ بطاقة» في صفحتك، وأضف نطاقات Walled Garden المعروضة حتى يفتح المشترك المتجر قبل تسجيل الدخول. بعد الشراء يدخل تلقائياً.

مصمم الهوتسبوت

من الإعدادات ← مصمم الهوتسبوت اختر القالب العصري (تطبيق بأربع صفحات: الدخول، الباقات بأسعارك، نقاط البيع، الدعم، مع وضع داكن/فاتح وحفظ البطاقات وفحص الاتصال) أو البسيط. عدّل الاسم والألوان والشريط المتحرك ونقاط البيع وأرقام الدعم، وشاهد التغيير مباشرة على شكل جوال، ثم نزّل ملف ZIP.

  1. في Winbox افتح Files وارفع محتوى الملف إلى مجلد hotspot مع المجلدات icons وfonts وimg (استبدل الملفات القديمة).
  2. افتح New Terminal والصق محتوى walled-garden.rsc.

الصفحات HTML بسيطة (التنسيق داخلها + ملف JS واحد)، ويمكنك تعديلها بأي محرر.

11العروض والإعلانات والولاء

  • مسابقات البطاقات المجانية: عروض معلنة مثل «اشترِ 9 واحصل على العاشرة مجاناً». تحدد الفئة التي يعمل عليها العرض، فيظهر تحت تلك البطاقة في المتجر، وتُمنح الهدية تلقائياً.
  • الإعلانات: صورة أو نص يظهر في المتجر أو في صفحة الهوتسبوت. اربطه بفئة ليظهر تحتها.
  • كوبونات الخصم: كود بنسبة أو مبلغ، بعدد استخدامات وتاريخ انتهاء.
  • مكافآت الولاء: بعد عدد مشتريات يحصل المشترك على كود هدية.
  • السحوبات والجوائز: سحب عشوائي بين المشترين خلال فترة، تُعرض أرقام الفائزين مخفية جزئياً.

12مراقبة الشبكة والخريطة

في قسم الشبكة والمراقبة تضيف أجهزتك (راوترات، سويتشات، نقاط وصول، أبراج، أجهزة ربط) وتتابعها:

طريقة الفحصالوصف
من الراوتر نفسه (API)لراوتر MikroTik المربوط بالمنصة.
Ping من راوتر MikroTik داخل الشبكةالراوتر يفحص الأجهزة خلفه. يعمل خلف NAT ولا يحتاج شيئاً إضافياً.
جامع محلي داخل الشبكةسكربت على حاسوب أو Raspberry Pi يفحص ويقرأ SNMP (انظر القسم التالي).
Ping من خادم المنصةللأجهزة ذات العنوان العام فقط.
  • الحالات: يعمل · أداء ضعيف (بطء، فقدان حزم، معالج أو ذاكرة مرتفعة، إشارة ضعيفة) · متوقف (بعد عدد فحوصات فاشلة متتالية تحدده) · غير معروف (لا دليل، مثل انقطاع الجهاز الفاحص) · صيانة.
  • الخريطة الجغرافية: حدّد موقع كل جهاز بالضغط على الخريطة. الألوان تتحدث مباشرة، ويظهر إشعار عند أي عطل جديد.
  • طوبولوجيا الشبكة: من يتصل بمن. حدّد «الجهاز الأب» لكل جهاز، ورتّب الرسم واحفظه.
  • مركز الأعطال: عند سقوط برج تُجمع أعطال الأجهزة خلفه تحت عطل واحد مع السبب المحتمل، وتستطيع تأكيد الاستلام وإضافة ملاحظات.
ضع الجهاز في وضع الصيانة قبل العمل عليه حتى لا تصلك تنبيهات خاطئة.

13الجامع المحلي و SNMP

الجامع ملف واحد يعمل على أي جهاز داخل شبكتك فيه PHP. هو من يتصل بالمنصة (اتصال صادر فقط)، فلا تحتاج فتح منافذ.

  1. من جامعات الشبكة أضف جامعاً واضغط تنزيل السكربت. ستحصل على ZIP فيه السكربت جاهزاً برمزه السري وتعليمات التشغيل.
  2. على Raspberry Pi أو Linux:
    sudo apt install php-cli php-curl
    sudo mkdir -p /opt/gh-collector && sudo cp gh-collector.php /opt/gh-collector/
    php /opt/gh-collector/gh-collector.php --once        # تجربة
    sudo cp gh-collector.service /etc/systemd/system/
    sudo systemctl enable --now gh-collector             # تشغيل دائم
    على Windows: ثبّت PHP ثم شغّل run-windows.bat.
  3. في أجهزة الشبكة عدّل الجهاز: طريقة الفحص = «جامع محلي داخل الشبكة»، واختر الجامع.

قراءة SNMP (الإشارة والمشتركون)

فعّل «قراءة SNMP» في صفحة الجهاز واكتب الـ community. ثم فعّل SNMP v2c (قراءة فقط) على الجهاز نفسه:

الشركةالتفعيلما يُقرأ
Ubiquiti airOSServices ← SNMP Agentالإشارة، الضجيج، CCQ، المشتركون، التردد، جودة airMAX
MikroTik/snmp set enabled=yesالمشتركون، الإشارة، التردد، المعالج
TP-LinkManagement ← SNMPالمعالج، الذاكرة، الواجهات
أي جهاز آخرحسب الجهازالاسم، مدة التشغيل، المعالج، الذاكرة، الواجهات
استخدم community غير public، واسمح فقط بعنوان جهاز الجامع. إن تسرّب ملف السكربت فنزّله من جديد، فيتوقف الرمز القديم فوراً.

إن توقف الجامع تظهر أجهزته «غير معروف» وليس «متوقف»، لأن صمت الجامع لا يعني تعطل الأجهزة.

14البرود باند

للاشتراكات الشهرية: أضف باقات البرود باند ثم مشتركو البرود باند. تُنشأ الفواتير شهرياً، ويدفعها المشترك من رابط الفاتورة. وتتابع المدفوع والمتأخر من فواتير البرود باند.

15الفريق والصلاحيات والأمان

  • الفريق: من الإعدادات ← الفريق والصلاحيات أضف مديراً أو كاشيراً أو موظف دعم، ولكلٍّ صلاحياته.
  • سجل النشاط: يرى المالك من فعل ماذا ومتى ومن أي جهاز.
  • التحقق بخطوتين: فعّله من ملفك الشخصي بتطبيق مثل Google Authenticator.
  • الأجهزة المحظورة: احظر جهازاً أو عنواناً أو رقماً لمدة تحددها، والمنصة تحظر تلقائياً محاولات تخمين البطاقات على الراوتر.

16الدعم والمساعد الذكي

في المتجر نافذة دعم يجيب فيها المساعد الذكي من قاعدة المعرفة. إن لم يكن متأكداً يحوّل المحادثة لك في نفس النافذة، فتردّ من المبيعات ← صندوق الدعم. أضف أسئلة شبكتك وأجوبتها في قاعدة معرفة المساعد.

17الخصوصية وحذف البيانات

  • حذف بيانات مشترٍ: من العملاء اختر «حذف بياناته». تُمحى بياناته الشخصية وتبقى الطلبات للمحاسبة.
  • حذف حساب موظف من ملفه الشخصي. المالك لا يحذف حسابه حتى لا تبقى الشبكة بلا مالك؛ تواصل مع الدعم.
  • التفاصيل في سياسة الخصوصية.

18حل المشكلات الشائعة

المشتري دفع ولم تظهر البطاقة

افتح الطلب من المبيعات ← الطلبات. حالة «قيد المراجعة» تعني أن الدفع وصل لكن المخزون نفد أو المبلغ غير مطابق. استورد بطاقات أو أعد المبلغ.

البطاقة لا تعمل على الراوتر

تحقق في الدفعات أن حالة الإضافة «أُضيفت للراوتر». إن كانت «فشلت»، فالراوتر غالباً غير متصل؛ أعد المحاولة بعد عودته.

زر «ادخل للإنترنت مباشرة» لا يعمل

تأكد أن المشتري متصل بواي فاي شبكتك، وأن عنوان صفحة الدخول صحيح (جرّبه بنفسك في المتصفح وأنت على الشبكة).

جهاز يظهر «غير معروف»

الجهاز الذي يفحصه (الراوتر أو الجامع) لا يتصل، أو لا يوجد عنوان IP. افتح الجهاز واقرأ رسالة «آخر خطأ».

قراءات SNMP فارغة

تأكد من الـ community والمنفذ 161، وأن SNMP مسموح لعنوان الجامع. بعض القيم غير متاحة في كل الموديلات، ونعرضها «غير متاح» بدل التخمين.