معالج الإعداد الأولي

بعد تفعيل مؤسستكم على وقتي، يوجّهكم معالج الإعداد (Onboarding Wizard) عبر الحد الأدنى من البنية اللازمة لتشغيل المشتريات بأمان: هوية الشركة، التنظيم، المستخدمون، آلية الموافقة على الإنفاق، الميزانيات، الموردون، و(اختيارياً) المشاريع التي تُسجَّل عليها المصروفات.

صُمم المعالج ليكون مرناً: يمكنكم تخطي خطوات، الانتقال مباشرة إلى أي خطوة ضمن المسموح، تخطي الإعداد بالكامل، أو العودة لاحقاً من التطبيق لإكمال أو تعديل البيانات.

نظرة عامة: سبع خطوات (0–6)

تُعرض التجربة كـ سبع خطوات رئيسية مرقّمة من 0 إلى 6، إضافة إلى حالة إنهاء تُعلِم النظام باكتمال الإعداد وتوجّهكم إلى لوحة التحكم.

الخطوة	المحتوى
0	معلومات الشركة وتفضيلات المشتريات
1	الأقسام
2	دعوة المستخدمين
3	مسارات الموافقة
4	الميزانيات
5	الموردون
6	المشاريع (اختياري)

عند إكمال المعالج تُحدَّث حقول الإعداد على الـ tenant ويُعاد التوجيه إلى /admin (لوحة التحكم الرئيسية). عند تخطي الإعداد بالكامل يُعلَم النظام أيضاً بأن الإعداد «مكتمل» لأغراض المنع من الدخول، مع التوجيه إلى /admin، مع إمكانية ضبط كل شيء لاحقاً.

العودة في أي وقت

تبقى شاشة الإعداد متاحة على المسار /onboarding حتى بعد الإكمال، فيستطيع المسؤولون إعادة فتح المعالج لتحديث بيانات الشركة أو إضافة أقسام أو توسيع المسارات دون تعطيل الاستخدام اليومي.

الخطوة 0: معلومات الشركة

تجمع هذه الخطوة ملف الشركة العام وبعض خيارات المشتريات المقيّدة بالخطة (plan-gated).

الهوية والاتصال

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

الشعارات والتوقيع

الأصل	القواعد
شعار الشركة	صورة اختيارية: PNG أو JPG أو JPEG أو SVG، حتى 2 ميغابايت. تُخزَّن على قرص التخزين المُعدّ (مثل التخزين السحابي).
صورة التوقيع	اختيارية: PNG أو JPG أو JPEG، حتى 1 ميغابايت. تُستخدم حيث يلزم توقيع مرئي على المستندات.

تُفحص التحميلات مقابل حدود التخزين للـ tenant؛ عند التجاوز تُرفض العملية برسالة تحقق مرتبطة بالشعار.

وضع المشتريات (Procurement mode)

يمكن اختيار وضع مشتريات يطبّق إعدادات افتراضية عبر المنتج:

• simple — تبسيط للفرق الأصغر.
• standard — توازن للمشتريات النموذجية.
• enterprise — هيكل أغنى للموافقات والرقابة المعقّدة.

قائمة الأوضاع المعروضة تأتي من ProcurementSettingsService (getAvailableModes / applyMode)، فتظهر فقط الأوضاع المسموحة لبنيتكم وخطتكم.

خيارات تعتمد على الخطة

بحسب ميزات الاشتراك:

• المطابقة الثلاثية (Three-way matching) — تفعيل enable_three_way_matching عندما تتضمن خطتكم three_way_matching لمواءمة الـ PO وإيصال الاستلام والفاتورة قبل الدفع.
• عتبات تنبيه الميزانية — مع ميزة budget_alerts يمكن إدخال نسب مئوية (0–100) لتنبيهات استهلاك الميزانية.

تُتحقق هذه الحقول كقيم اختيارية (boolean أو مصفوفة أعداد) وفق أهلية الـ tenant.

التقدم

حفظ معلومات الشركة يضبط onboarding_step إلى 1.

الخطوة 1: إنشاء الأقسام

الأقسام تقسّم الإنفاق والمسؤولية والتقارير.

الحقل	التحقق
الاسم	إلزامي، حتى 255 حرفاً.
الرمز (Code)	إلزامي، حتى 10 أحرف، فريد لكل tenant.
الوصف	اختياري، حتى 500 حرف.

تُنشأ الأقسام نشطة افتراضياً. الرموز المكررة تُرجع رسالة خطأ واضحة (department_code_already_exists).

نجاح الإنشاء يحرّك onboarding_step إلى 2.

الخطوة 2: دعوة المستخدمين

إضافة من سيسجّل الدخول إلى وقتي. في مسار المعالج يُنشأ المستخدم مباشرة مع كلمة مرور (وليس دعوة بريد فقط).

الحقل	ملاحظات
الاسم الكامل	إلزامي.
البريد	إلزامي؛ يجب أن يكون فريداً بين جميع المستخدمين.
كلمة المرور	إلزامي مع تأكيد؛ وفق قواعد Laravel الافتراضية لقوة كلمة المرور.
القسم	إلزامي؛ مرجع لقسم موجود في الـ tenant.
الدور (Role)	إلزامي؛ يجب أن يكون أحد المعرّفات (slugs) أدناه.
المدير	اختياري؛ إن تُرك فارغاً قد يستنتج النظام مديراً لأدوار معيّنة (مثل employee وprocurement_officer) بالبحث عن manager أو department_head في نفس القسم.

أدوار المعالج المسموحة

تقبل واجهة الإعداد قيم role التالية فقط:

admin، department_head، manager، employee، finance_viewer، cfo، finance_manager، procurement_manager، procurement_officer

إن لم يوجد صف Role بهذا الـ slug لـ tenantكم، ينشئ وقتي الدور تلقائياً مع وصف مختصر وصلاحيات فارغة—يُفضَّل ضبط الصلاحيات لاحقاً ضمن نموذج الأمان لديكم.

يُربط المستخدم بالدور عبر role_id وجدول الربط role_user (مع سياق الـ tenant لـ RLS).

نجاح الدعوة يضبط onboarding_step إلى 3.

الخطوة 3: مسارات الموافقة

توجّه المسارات أوامر الشراء حسب القسم ومبالغ العتبات.

الحقل	ملاحظات
اسم المسار	إلزامي.
القسم	إلزامي؛ يحد نطاق المسار.
الحد الأدنى للمبلغ	إلزامي؛ رقم ≥ 0.
الحد الأقصى للمبلغ	اختياري؛ إن وُجد يجب أن يكون أكبر من الحد الأدنى (يمكن ترك الحد العلوي مفتوحاً بقيمة فارغة).

عند الإنشاء يضيف وقتي خطوة افتراضية أولى بعنوان موافقة رئيس القسم مرتبطة بدور department_head عند توفره.

إنشاء مسار يضبط onboarding_step إلى 4.

::: note ميزة المسارات المخصصة للـ tenants الذين لديهم ميزة custom_workflows تتوفر إمكانيات أوسع في أجزاء أخرى من المنتج؛ المعالج ما يزال ينشئ مساراً أساسياً يمكن توسيعه لاحقاً. :::

الخطوة 4: ضبط الميزانيات

تثبّت الميزانيات أرصدة CAPEX وOPEX لكل قسم وسنة مالية.

الحقل	ملاحظات
القسم	إلزامي.
السنة	إلزامي؛ عدد صحيح بين 2020 و2100.
إجمالي CAPEX	إلزامي؛ شامِل ضريبة القيمة المضافة بنسبتكم.
إجمالي OPEX	إلزامي؛ كذلك.
نسبة ضريبة القيمة المضافة	اختياري؛ الافتراض 15 عند التجاهل.

يحسب النظام مبالغ ما قبل الضريبة من الإجماليات والنسبة، ويبدأ عدادات المستخدم والمحجوز من الصفر.

حفظ ميزانية في المعالج يضبط onboarding_step إلى 4 في الخلفية (قد يتطابق مؤشر التقدم مع خطوة المسارات حسب ترتيب إجراءاتكم).

الخطوة 5: إضافة موردين

في أغلب العمليات يلزم مورد واحد على الأقل لرفع PO.

الحقل	إلزامي	ملاحظات
اسم المورد	نعم	حتى 255 حرفاً.
البريد	نعم	بريد صالح.
الهاتف	نعم	حتى 20 حرفاً.
الرقم الضريبي (VAT)	نعم	حتى 50 حرفاً.
السجل التجاري (CR)	لا	اختياري.

يُولَّد رمز مورد تلقائياً بصيغة VEN-##### حسب آخر رمز في الـ tenant.

إنشاء مورد يضبط onboarding_step إلى 5.

الخطوة 6: إنشاء مشاريع (اختياري)

إن كانت المشاريع ضمن خطتكم، تتيح هذه الخطوة هيكلة مبادرات رأسمالية أو تشغيلية.

الحقل	ملاحظات
اسم المشروع	إلزامي.
القسم	إلزامي.
الميزانية	إلزامي؛ إجمالي ≥ 0.
ميزانية CAPEX / OPEX	اختياري؛ افتراض 0 إن تُرك.
تاريخ البدء / الانتهاء	اختياري؛ يجب أن يكون الانتهاء بعد البدء عند تعبئة الاثنين.
الوصف	اختياري.

يُمنح المشروع رمزاً تلقائياً مثل PRJ-YYYY-##### ضمن تسلسل السنة الحالية.

إنشاء مشروع يضبط onboarding_step إلى 6.

Milestones على Enterprise+

للـ tenants بميزة milestones قد تُعرض أيضاً قوالب المراحل (milestone templates) في سياق المعالج للاستخدام لاحقاً مع أوامر الشراء.

التنقل داخل المعالج

تخطي خطوة للأمام

استدعاء الخطوة التالية دون إكمال بيانات اختيارية يزيد onboarding_step بمقدار واحد حتى حد أقصى 7 (قيمة داخلية للنهاية).

الانتقال إلى خطوة محددة

الذهاب إلى خطوة يقبل أي عدد صحيح من 0 إلى 7 للتنقل المباشر للتصحيح أو لإكمال ما يناسب جدولكم.

تخطي الإعداد بالكامل

تخطي الإعداد يضبط onboarding_skipped و**onboarding_completed** و**onboarding_completed_at** ثم إعادة توجيه إلى /admin. Middleware الإجبار على الإعداد لن يمنعكم بعد ذلك.

الإنهاء

إكمال الإعداد يضبط onboarding_completed و**onboarding_step = 7** و**onboarding_completed_at** ثم إعادة توجيه Inertia إلى /admin.

بعد الإعداد

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

نصائح

الأقسام قبل المستخدمين

المستخدمون يجب أن ينتموا إلى قسم. أنشئوا قسماً واحداً على الأقل في الخطوة 1 قبل دعوة الفريق في الخطوة 2.

ابدأوا بمسار بسيط

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

نسبة ضريبة القيمة المضافة

إن كانت نسبة الضريبة القانونية لديكم غير 15% فحدّدوا نسبة VAT صراحة في الخطوة 4 لكل ميزانية ليبقى تحليل «ما قبل الضريبة» دقيقاً.

جودة بيانات المورد

الهاتف والبريد والرقم الضريبي إلزامية في نموذج المورد داخل المعالج—حافظوا على دقتها للفوترة الإلكترونية والمطابقة والتواصل.

المشاريع لاحقاً

الخطوة 6 اختيارية لكثير من العملاء. يمكن تخطيها أثناء الإعداد وإضافة المشاريع لاحقاً عند الحاجة للميزة.

مواضيع ذات صلة

• دليل البدء السريع — أول PO وقائمة يوم أول.
• الخطوات الأولى — تعمّق بعد تسجيل الدخول.