الانتقال إلى المحتوى
سمارت ليد تك
الرئيسية
خدماتنا
أعمالنا
السعودية
من نحن
المدونة
تواصل معنا
🇬🇧Englishتواصل الآن
سمارت ليد تك

حلول برمجية ذكية

تابعنا

الشركة

  • من نحن
  • أعمالنا
  • خدماتنا
  • السعودية
  • نظام كاشير للمطاعم
  • تواصل معنا
  • احجز مكالمة

روابط سريعة

  • المدونة
  • الأسعار
  • سياسة الاسترداد
  • سياسة الخصوصية
  • الشروط والأحكام
  • حذف البيانات

تواصل معنا

  • الفرع المصري — المقر الرئيسي

    مكتب 6، عقار 23، شارع مكة المكرمة، العمرانية، الجيزة 3540203، مصر
  • الفرع السعودي

    مبنى 2646، رقم فرعي 123، شارع 7697، حي أشبيلية، الجبيل 35416، المملكة العربية السعودية
  • البريد الإلكتروني

    help@smartleadtech.com
  • رقم الهاتف 🇪🇬

    +20 102 201 4671
  • رقم الهاتف 🇸🇦

    0530 447 112

© 2026 سمارت ليد تك. جميع الحقوق محفوظة.

  • شركة سمارت ليد تك لتقنية المعلومات (ذ.م.م)·سجل تجاري ⁦61239⁩·رقم ضريبي ⁦774-391-316⁩

  • مؤسسة برمجيات الريادة الذكية·سجل تجاري ⁦7054902585⁩·الرقم الضريبي

Repositories وخدمات نظيفة في Laravel 11 — SOLID بلا مبالغة

كل ما ستقرؤه هنا ناتج عن بناء عشرات الـ APIs لعملاء حقيقيين. الهدف ليس «تطبيق SOLID من أجل SOLID»، بل تحقيق شيئين: كود قابل للاختبار، وطبقات واضحة لا تختلط.الطبقات التي نعتمدهاRoute: اسم الـ endpoint + Middleware.FormReq…

14‏/12‏/2024 — 13 دقائق قراءة

هندسة SOLID عمليًا في Laravel 11

كل ما ستقرؤه هنا ناتج عن بناء عشرات الـ APIs لعملاء حقيقيين. الهدف ليس «تطبيق SOLID من أجل SOLID»، بل تحقيق شيئين: كود قابل للاختبار، وطبقات واضحة لا تختلط.

الطبقات التي نعتمدها

  1. Route: اسم الـ endpoint + Middleware.
  2. FormRequest: تحقق من الإدخال فقط (بدون ترجمات أو منطق عمل).
  3. Controller: Try/Catch، يناول المدخلات للـ Service، ثمّ يغلّف النتيجة في Resource + Trait.
  4. Service: هنا يعيش منطق العمل. الـ Service وحده يُكلّم الـ Model.
  5. Resource: شكل الـ JSON النهائي — لا أكثر.
القاعدة الذهبيّة: المتحكم لا يعرف شيئًا عن Eloquent. الخدمة لا تعرف شيئًا عن HTTP.

ResponsesTrait ثابت على كل الـ APIs

نلفّ كل استجابة بنفس المغلف: { success, msg, data, meta? }. الواجهات الأمامية (Next.js) تعتمد هذا العقد بالضبط، فأي تغيير فيه يكسر الفرونت.

متى نبني Repository؟

لا نخترع Repositories بلا داعٍ. نضيفها فقط حين:

  • منطق الاستعلام مكرّر في 3 أماكن أو أكثر.
  • نحتاج واجهة (Interface) لاختبارها بـ fakes.
  • نريد Cache layer موحّد دون تلويث الـ Service.

الـ Events وDomain Events

الخدمات تُطلق Events عوضًا عن استدعاء بعضها مباشرة. مثال: ProjectPublished يُنشّط Observer لمسح الكاش + إطلاق webhook إلى Next.js.

اختبار عملي

هدفنا أن يمكننا اختبار كل Service بدون ضرب قاعدة البيانات: نستبدل الـ Repository بـ fake في الحاوية، ثم نستدعي الـ Service مباشرة. Pest يجعل هذا ممتعًا.

ما لا نفعله

  • لا نضع منطق العمل داخل Eloquent events (Model::saving).
  • لا نستخدم facades عشوائيًا داخل Services (DI أوضح).
  • لا نسمح للـ Controller بأن يلمس Model مباشرة.

مشاركة

مشاريع مرتبطة بالمقال

  • الذكاء الاصطناعيPython

    درب — Darb: نظام إدارة الحوادث المروريّة

    حلّ ذكي لإدارة ومعالجة الحوادث المروريّة بكفاءة عالية عبر تعلّم آلي ورؤية كمبيوتر وتكامل مع شركات التأمين.

    اعرض المزيد
    درب — إدارة الحوادث المروريّة بالذكاء الاصطناعي
  • الذكاء الاصطناعيPython

    كاشف السكّري البصري — Diabetes Vision Detector

    نظام ذكاء اصطناعي لفحص اعتلال الشبكيّة السكّري عبر تحليل صور قاع العين بدقّة طبّيّة عالية.

    اعرض المزيد
    كاشف السكّري البصري — تحليل قاع العين بالذكاء الاصطناعي
  • الذكاء الاصطناعيFlutter

    تطبيق كليم — Kaleem App

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

    اعرض المزيد
    تطبيق كليم — تخاطب الأطفال بالذكاء الاصطناعي

مقالات ذات صلة

  • تطبيق نقاط بيع بـ Flutter

    Flutter لأنظمة نقاط البيع: وضع عدم الاتصال أوّلًا

    لا تعمل أنظمة الكاشير في بيئة مثالية. يسقط الإنترنت، تنقطع الكهرباء، ويجب أن يظل الفرع يبيع. هذه الورقة تلخّص النمط الذي نستخدمه في TtaKkaa Cashier لضمان عمل سلس بغضّ النظر عن الشبكة.المبادئ الثلاثةSource of truth محلي: …

    05‏/11‏/2024 — 8 دقائق قراءة

  • مخطط يوضح نموذج لغة يتصل بنقاط بيع وأنظمة مخزون عبر خوادم MCP

    MCP للمدير التقني: كيف تجعل الذكاء الاصطناعي «يلمس» نقاط البيع والمخزون والـ CRM بأمان

    لسنوات كانت المشكلة واحدة: النموذج ذكي، لكنه معزول. يعرف كل شيء عن العالم ولا يعرف شيئاً عن مخزونك. Model Context Protocol (MCP) هو البروتوكول المفتوح الذي حلّ هذه العزلة بطريقة قياسية: بدلاً من أن يكتب كل فريق «تكاملاً …

    05‏/08‏/2026 — 9 دقائق قراءة

  • معمارية NestJS القابلة للتوسّع

    معمارية NestJS القابلة للتوسّع — من Module إلى Monorepo

    بدأنا مشاريعنا الكبيرة على NestJS كـ «تطبيق واحد بمودولات». اليوم، أصبحت كلّ الأنظمة التي تتعدّى 10 مودولات تسكن داخل monorepo. هذه الوثيقة توضّح متى نعمل كلّ قفزة وما يربح الفريق منها.المرحلة 1: Single app + modular mod…

    18‏/10‏/2024 — 10 دقائق قراءة