دليل المستخدم الشامل - Adly ERP

نسخة مُعاد بناؤها من الصفر، مع استيفاء شاشات العمل عمليًا شاشة بشاشة.

Laravel 12 Filament 4.8 Multi-Tenant Arabic RTL Task + Process Driven
آخر تحديث
15-03-2026
نطاق المستند
Production + Training Ready

1) تعريف سريع بالنظام

النظام مصمم لإدارة دورة تشغيل خدمات المعدات من أول العقد حتى آخر قيد محاسبي، مع تقارير تشغيلية، حركة مخزون، صيانة، وكشوف حسابات للعملاء والموردين.

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

2) كيف تستخدم هذا الدليل

  • لو أنت مستخدم جديد: ابدأ من القسم 3 ثم 4 ثم 11.
  • لو أنت مشرف تشغيل: ركز على الأقسام 4، 5، 8، 11.
  • لو أنت محاسب: ركز على الأقسام 6، 8، 9، 11.
  • لو أنت مدير: ركز على الأقسام 8، 10، 11، 12.
هذا الملف يشرح ما يجب فعله داخل الشاشة، وليس فقط تعريف نظري للكيانات.

3) دورة العمل الكاملة من التنفيذ حتى القيد

الخطوة 1: إنشاء العقد وبنود الأسعار المتفق عليها.
الخطوة 2: تسجيل أوامر التشغيل اليومية بالمعدة والسائق والموقع.
الخطوة 3: اعتماد أوامر التشغيل الصحيحة.
الخطوة 4: تجميع بيان التنفيذ للفترة عبر Generate Lines.
الخطوة 5: اعتماد بيان التنفيذ confirmed.
الخطوة 6: توليد مستخلص من البيان + تطبيق الخصومات.
الخطوة 7: إرسال واعتماد المستخلص.
الخطوة 8: إنشاء وترحيل القيد المحاسبي تلقائيًا من المستخلص المعتمد.

4) شاشات التشغيل بالتفصيل (Screen by Screen)

الغرض: تعريف الاتفاق التجاري وسعر كل بند خدمة.

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

أفضل ممارسة: لا تبدأ أوامر تشغيل قبل تفعيل العقد إلى active.

الحالات: draft active completed cancelled

الغرض: تسجيل التنفيذ الميداني اليومي.

الحقول الحرجة: order_date, company, site, machine, driver, contract, lines.

الإجراءات: Draft -> Submit -> Approve/Reject.

متى تستخدم Reject: عند نقص بيانات أو كمية غير منطقية أو بند غير تعاقدي.

الحالات: draftsubmittedapprovedrejectedinvoiced

الغرض: تجميع أوامر التشغيل المعتمدة/المفوترة على مستوى الفترة.

الإجراءات الرئيسية: Generate Lines ثم Confirm.

ملحوظة: التجميع يعتمد على company + period + status approved/invoiced.

الحالات: draft confirmed

الغرض: تحويل التنفيذ لقيمة مالية قابلة للتحصيل.

المدخلات: lines + deductions + period + contract/company.

المعادلة: gross - deductions = net.

أكشنات مهمة: Submit, Approve, Revise, Create from Execution Summary.

الحالات: draftsubmittedapprovedrejectedinvoiced

الغرض: إدارة عطل المعدة وربط الصرف والتركيب والتكلفة.

التدفق: Open -> Approved -> In Progress -> Completed.

كيف تحسب actual_cost: مجموع (installed_qty * stockMovement.unit_cost) للتركيبات المرتبطة.

الحالات: openapprovedin_progresscompletedcancelled

5) شاشات المخزون وقطع الغيار بالتفصيل

الشاشة ماذا تفعل؟ متى تستخدمها؟ نصيحة تشغيلية
Products تعريف الصنف ووحداته وبياناته الأساسية. قبل أي حركة مخزون. ثبّت وحدة القياس الأساسية من البداية.
Warehouses تعريف المخازن الفعلية. قبل إدخال أرصدة أو صرف. راجع المخزن الافتراضي لكل عملية.
ProductWarehouses عرض/إدارة رصيد الصنف في كل مخزن. للتأكد من الرصيد قبل الصرف. اعمل مراجعة أسبوعية للرصيد المتاح vs المحجوز.
StockMovements توثيق كل دخول/خروج/تسوية مخزون. عند أي حركة كمية أو تكلفة. المرجع (reference_type/id) مهم جدًا للتتبع.
StockIssueRequests طلب صرف قطعة/صنف للمعدة، ويمكن ربطه بأمر صيانة. قبل الصرف الفعلي. لا تعتمد طلب ناقص machine أو product.
SparePartInstallations تأكيد تركيب القطعة فعليًا على المعدة. بعد إصدار القطعة من المخزن. التركيب الصحيح = تكلفة صيانة أدق لاحقًا.

6) شاشات المالية والمحاسبة

CustomerPayments / SupplierPayments

  • تسجيل التحصيل/الدفع وربطها بالطرف الصحيح.
  • تؤثر مباشرة على كشوف الحساب والرصيد الجاري.
  • استخدم تاريخ الدفع الصحيح لأنه يدخل في الفترات المحاسبية.

Cashboxes / CashMovements

  • الخزنة تمثل نقطة تجميع الحركة النقدية.
  • أي حركة بلا مرجع واضح تصعب المراجعة لاحقًا.
  • راجع التقرير اليومي للخزينة نهاية اليوم.

Journal Mappings

  • هي القاعدة الذهبية لترحيل المستخلصات تلقائيًا.
  • لا تعتمد مستخلص قبل التأكد من المابينج المطلوب.

Journal Entries / Account Balances

  • تتابع القيود اليومية المُنشأة يدويًا أو تلقائيًا.
  • تستخدم للتحقق من سلامة الأرصدة قبل التقارير المالية.
اعتماد المستخلص يطلق syncJournalEntry تلقائيًا. أي خلل في المابينج سيمنع الاعتماد لحماية الدفاتر.

7) شاشات الأراضي والمزارع بالتفصيل

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

تسجيل المصروفات (عمالة، صيانة، كهرباء، مياه...). استخدم نوع المصروف بدقة ليظهر تحليل صحيح بالتقارير.

تسجيل الإيرادات (محصول، كمية، سعر وحدة). يساهم مباشرة في حساب صافي أداء الأرض.

تنظيم تشغيل المزارع ودورات التربية، وربطها بالتقارير وكشوف الحساب الخاصة بالنشاط.

8) شاشات التقارير: ماذا تقرأ ومتى؟

التقريرتوقيت الاستخدامالأسئلة التي يجيب عليها
WorkOrdersReportيومي/أسبوعيكم أمر تم تنفيذه واعتماده؟ وما القيمة التشغيلية؟
ExtractsSummaryReportنهاية الفترةكم مستخلص؟ ما إجمالي/خصومات/صافي؟
MachinePerformanceReportأسبوعي/شهريما ربحية كل معدة؟ أين نزيف التكلفة؟
ContractVarianceReportأسبوعيهل التنفيذ متوافق مع التعاقد؟
Customer/Supplier Statementحسب التحصيلما الرصيد الافتتاحي/الحركات/الختامي؟
CashboxMovementReportيوميما حركة الخزنة وصافي اليوم؟
InventoryValuation/Items Movementأسبوعي/شهريما قيمة المخزون وما اتجاه الاستهلاك؟
Trial Balance / IS / BS / FPشهريهل الحسابات متوازنة؟ وما النتائج المالية؟

9) التكاملات (Email / WhatsApp / PDF)

  • إرسال كشف الحساب بالبريد يتم عبر Job مخصص + PDF.
  • الإرسال عبر WhatsApp يدعم مسارين: Twilio وGateway.
  • القوالب المستخدمة موحدة: customer-statement / supplier-statement.
  • يتم تخزين PDF مؤقتًا ثم إزالته لاحقًا تلقائيًا.

10) الأدوار والصلاحيات

مشرف تشغيل
إدخال ومراجعة واعتماد أوامر التشغيل وبيانات التنفيذ.
محاسب
مراجعة المستخلصات، المدفوعات، التقارير المالية، كشف الحساب.
مدير
متابعة الأداء والانحراف والربحية واتخاذ القرار.

11) SOP تشغيلي يومي مختصر

  1. مراجعة Dashboard + التقارير الحرجة.
  2. إكمال دورة أوامر التشغيل حتى Approved.
  3. تحديث طلبات الصرف والتركيبات المرتبطة بالصيانة.
  4. تجميع بيانات التنفيذ حسب الفترة.
  5. إعداد/اعتماد المستخلصات المطلوبة.
  6. متابعة القيود الناتجة والتقارير المالية.
  7. إرسال كشوف الحساب المطلوبة.

12) FAQ

غالبًا نقص في Journal Mapping أو قيمة gross_amount تساوي صفر.

راجع نطاق التاريخ، وحالة العمليات الملغاة، وتأكد من صحة تاريخ الدفع.

لا تترك أوامر في Draft طويلًا، وراجع يوميًا Submitted/Rejected، واستخدم تقرير الانحراف أسبوعيًا.