دليل الإعداد للمرة الأولى

وجّه المتصفح إلى نطاقك (الدومين) مع إضافة /install في النهاية، مثال: https://your-domain.com/install. إذا لم يكن التطبيق مثبّتًا بعد، ستظهر هذه الشاشة تلقائيًا — وستشاهد شاشة الترحيب أدناه. اضغط Next (التالي) للبدء.

تتحقق أداة التثبيت تلقائيًا من أن خادمك مُعد بشكل صحيح لتشغيل ABICex. يجب أن تظهر علامة صح خضراء أمام كل عنصر قبل المتابعة.

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

أدخل بيانات الاتصال بقاعدة البيانات التي أنشأتها قبل البدء. تحفظ أداة التثبيت هذه البيانات تلقائيًا نيابةً عنك، لذا تأكد من صحتها قبل المتابعة.

• مضيف قاعدة البيانات (Database Host) — غالبًا localhost ما لم يوفر لك مزوّد الاستضافة عنوانًا مختلفًا.
• اسم المستخدم / كلمة المرور — مستخدم MySQL يملك صلاحيات كاملة على قاعدة البيانات أدناه.
• اسم قاعدة البيانات — قاعدة البيانات الفارغة التي أنشأتها لتطبيق ABICex.

أنشئ أول حساب في النظام — حساب المدير العام (Super Admin) الذي يدير المنصة بالكامل (جميع الشركات/المستأجرين، والباقات، والاشتراكات، والإعدادات العامة). هذا هو الحساب الذي ستستخدمه فعليًا لاحقًا، وليس أيًا من بيانات الدخول التجريبية الظاهرة في مكان آخر.

• استخدم بريدًا إلكترونيًا حقيقيًا تملكه — سيصبح اسم المستخدم لتسجيل الدخول.
• اختر كلمة مرور قوية؛ ستُدخلها في الخطوة التالية، ثم تستخدمها لتسجيل الدخول بعد انتهاء الإعداد.

الصق كود الشراء (Purchase Code) من تأكيد طلبك، ثم اضغط Finish (إنهاء).

1. يتم التحقق من الكود عبر الإنترنت.
2. يتم إعداد قاعدة بياناتك وتعبئتها بالبيانات الافتراضية.
3. يُحفظ حساب المدير الذي أدخلته في الخطوة 4.
4. يُعلَّم الإعداد على أنه اكتمل، وتتم إعادة توجيهك مباشرة إلى صفحة تسجيل الدخول.

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

اذهب إلى الإعدادات ← الإعدادات العامة (Setting → General Settings). هذا أول شيء يجب تعبئته — شعارك وألوانك تظهر في لوحة التحكم وفي الصفحات التي يراها عملاؤك بدءًا من هذه اللحظة.

• الشعار (Logo)، والشعار الفاتح (للخلفيات الداكنة)، وأيقونة المتصفح (Favicon) — ارفع كل واحدة على حدة.
• اسم التطبيق، الهاتف، البريد الإلكتروني، العنوان، ونص حقوق النشر.
• العملة — اضبطها مبكرًا؛ تُستخدم في كل مكان يُعرض فيه مبلغ مالي.
• بادئة تتبع الشحنة / بادئة الفاتورة — رمز قصير يُضاف إلى كل رقم تتبع وفاتورة تُنشئها (مثال: NF-).
• اللون الأساسي / لون النص — يعيد تلوين لوحة التحكم لتطابق هوية علامتك التجارية.

كل شركة على ABICex تحصل على موقعها الإلكتروني العام الخاص بها — الصفحة التي يصل إليها عملاؤك للتعرف على خدمتك وتتبع شحناتهم. لست بحاجة لبنائها من الصفر: هي موجودة بالفعل، وقسم الموقع الإلكتروني (Front Web) في القائمة الجانبية (فوق الإعدادات مباشرة) هو المكان الذي تعدّل منه محتواها.

• الصفحات (Pages) — من نحن، اتصل بنا، الأسئلة الشائعة، سياسة الخصوصية، الشروط والأحكام — جاهزة للتعديل.
• الأقسام (Section) — أقسام الصفحة الرئيسية (البانر الرئيسي، أبرز المزايا، إلخ).
• الخدمات، ولماذا نحن، والشركاء، والمدونة، والأسئلة الشائعة، وروابط التواصل الاجتماعي — عناصر محتوى وقوائم مساندة تظهر على الموقع.

الموقع نفسه يعمل بالفعل على نطاق (دومين) شركتك. صفحة تتبع الشحنة هي الأهم من الناحية التشغيلية — هي التي تُطلع عليها عملاءك ليتحققوا من حالة شحنتهم بأنفسهم دون الاتصال بك.

الفرع (يُسمى "Hub" داخليًا) هو موقع فعلي تمر به الشحنات — مستودع، مكتب فرز، أو نقطة استلام. اذهب إلى إدارة الفروع ← الفرع ← إضافة جديد.

• أدخل اسم الفرع وهاتفه وعنوانه — الشحنات ومندوبو التوصيل يُسندون إلى هذا الفرع.
• تحتاج إلى فرع واحد على الأقل قبل أن تتمكن من إضافة مندوب توصيل أو تحريك أي شحنة عبر النظام.

بعد إنشاء الفرع، افتحه وعيّن له مدير فرع ("In-Charge") — الموظف المسؤول عن التشغيل اليومي لذلك الموقع.

التاجر هو أحد عملائك الذي يشحن الطرود عبر شركتك — متجر إلكتروني مثلًا. اذهب إلى إدارة التجار ← التجار ← إضافة جديد.

• اسم النشاط التجاري، واسم جهة الاتصال، والبريد الإلكتروني، والهاتف، وكلمة المرور (لتسجيل دخوله إلى لوحة التاجر المنفصلة)، والفرع (فرعه الرئيسي).
• رسوم الدفع عند الاستلام (COD Charge) — رسوم التحصيل النقدي التي تفرضها، وتُحدَّد بشكل منفصل لشحنات داخل المدينة / ضواحي المدينة / خارج المدينة.
• نسبة رسوم الإرجاع (%) — ما تتقاضاه من التاجر عند رجوع شحنة دون تسليم.
• اختياري: جهة اتصال مرجعية، مدة السداد، تفعيل المحفظة، رفع الهوية الوطنية/السجل التجاري.

اذهب إلى الفريق ← مندوب التوصيل ← إضافة جديد.

• الاسم، الهاتف، البريد الإلكتروني، كلمة المرور (لتسجيل دخوله إلى تطبيق التوصيل)، الفرع المسند إليه، العنوان.
• رسوم التوصيل / رسوم الاستلام — ما تدفعه له عن كل شحنة يسلّمها أو يستلمها.
• رسوم الإرجاع، الرصيد الافتتاحي، والراتب إذا كنت تدفع راتبًا أساسيًا أيضًا.
• رفع رخصة القيادة، اختياري.

قبل أن يتم تسعير الشحنات تلقائيًا، أخبر ABICex بما تتقاضاه. يقع هذا تحت الإعدادات.

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

• نفس اليوم، اليوم التالي، ضواحي المدينة، خارج المدينة — أربعة أعمدة أسعار حسب السرعة/المنطقة.
• يمكن لصف السعر أن يستهدف منطقة (Region) محددة أيضًا (سعر مختلف لمدينة معينة، وسعر آخر لبقية المناطق) — الصفوف المتروكة على "كل المناطق" هي السعر الاحتياطي المستخدم متى لم يوجد صف خاص بالمنطقة.
• تواريخ السريان والأولوية تتيحان جدولة تغيير سعر مؤقت دون حذف تسعيرك المعتاد.

بعد أن أصبح لديك فرع وتاجر وأسعار جاهزة، اذهب إلى العمليات ← الشحنات ← إضافة.

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

تمر كل شحنة بتسلسل ثابت من الحالات، تظهر كشارة ملوّنة في قائمة الشحنات وتُحدَّث عند كل نقطة تسليم:

1. معلّقة (Pending) — أُنشئت للتو، ولم تُستلم بعد.
2. إسناد استلام — تم تعيين مندوب لاستلامها من التاجر.
3. استُلمت من المندوب ← استُلمت بالمستودع — وصلت إلى فرعك.
4. تحويل إلى فرع ← استُلمت بالفرع — انتقلت إلى الفرع الذي سيسلّمها، إن اختلف عن الأول.
5. إسناد توصيل — تم تعيينها لمندوب توصيل للمرحلة الأخيرة.
6. تم التسليم (أو تسليم جزئي للشحنات متعددة القطع) — نجاح.

وإذا فشلت محاولة التسليم، تسلك الشحنة مسار الإرجاع بدلًا من ذلك:

1. إرجاع للمستودع — تُعاد إلى فرعك بدلًا من تسليمها.
2. إرجاع لشركة الشحن / إسناد إرجاع للتاجر — تُوجَّه رجوعًا إلى من يجب أن يستلمها.
3. أُرجعت للتاجر — تأكيد استلام التاجر لها، لإغلاق الدورة.

يمكن إعادة جدولة أي خطوة (طلب العميل موعدًا آخر) أو إلغاؤها والتراجع عنها — إلغاء حالة يعيد الشحنة إلى الخطوة السابقة لها، بدلًا من فقدان سجل تاريخها.

لتاجر يرسل دفعة كبيرة من الشحنات، اذهب إلى العمليات ← الشحنات ← استيراد بدلًا من إنشاء كل شحنة يدويًا.

1. نزّل ملف إكسل النموذجي من زر نموذج.
2. عبّئ صفًا واحدًا لكل شحنة، مستخدمًا رموز الفئة ونوع التوصيل الموضحة في الصفحة.
3. اختر التاجر الذي تخص هذه الشحنات، ثم ارفع الملف.
4. أي صفوف تفشل في التحقق تُعرض مع رقم الصف وسبب الخطأ، لتتمكن من تصحيحها وإعادة رفعها فقط.

عندما يريد تاجر أن تُستلم شحنة منه، هذا هو طلب الاستلام — منفصل عن الشحنة نفسها. يتتبّع ABICex نوعين، لكل منهما شاشته الخاصة تحت العمليات:

• طلب استلام — عادي (Regular): استلام بأولوية عادية، يُجدوَل ضمن مسارات الاستلام المعتادة.
• طلب استلام — سريع (Express): طلبات استلام عاجلة في نفس اليوم، ينبغي أن تتقدم على الطابور.

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

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

المحاسبة اليومية تقع تحت الحسابات:

• الحسابات (Accounts) — حساباتك الدفترية (نقدي، بنك، محفظة إلكترونية، إلخ) — أعدّها أولًا.
• الإيرادات / المصروفات — تسجيل أموال داخلة أو خارجة من أحد حساباتك، مصنّفة تحت رأس حساب (Account Head).
• تحويل الأموال — نقل مبلغ بين اثنين من حساباتك الخاصة (مثلًا من النقدي إلى البنك).
• معاملات البنك — تسوية المعاملات مقابل حساب بنكي تحديدًا.

لوحة التحكم التي رأيتها عند أول تسجيل دخول (الخطوة 6) كانت تحتوي بالفعل على رسوم بيانية للإيرادات/المصروفات — بمجرد أن تسجّل قيودًا حقيقية هنا، تُملأ تلك الرسوم وبطاقة "إجمالي الحسابات" تلقائيًا.