تنظيم Service في Laravel وتجنب التعقيد

لو اشتغلت قبل كده على مشروع كبير باستخدام Laravel، أكيد قابلت موقف غريب شوية…
تفتح ملف Service علشان تعدّل حاجة بسيطة، تلاقيه بينادي Service تاني… والـ Service التاني بينادي Service ثالث 😅

وفجأة تلاقي نفسك تايه بين الملفات ومش فاهم فين أصل المشكلة.

على الورق، الموضوع بيبان كأنه Architecture نظيفة ومنظمة.
لكن في الواقع أحيانًا بيكون العكس تمامًا.

في البوست ده هنتكلم عن تجربة واقعية مع تنظيم الكود في Laravel، وامتى فعلًا نحتاج Service، وامتى استخدامه بيزود التعقيد بدل ما يحل المشكلة.

المشكلة الشائعة في مشاريع Laravel الكبيرة​

كتير من المطورين بيحاولوا يطبقوا Clean Architecture أو Service Layer Pattern بشكل حرفي جدًا.
النتيجة غالبًا بتكون:

• Controller بسيط جدًا
• Service لكل عملية
• Repository للوصول إلى قاعدة البيانات

الهيكل بيكون غالبًا بالشكل ده:

Controller
   ↓
Service
   ↓
Repository
   ↓
Database

المشكلة إن التنظيم ده أحيانًا بيكون مبالغ فيه وبيخلق تعقيد غير ضروري.

---

عندما يتحول Service Layer إلى عبء​

خلينا نشوف بعض الحالات اللي بتحصل كتير في مشاريع Laravel.

Service لكل عملية CRUD​

واحدة من أشهر الأخطاء إن كل عملية CRUD تبقى لها Service مستقل.
مثال:

CreateUserService
UpdateUserService
DeleteUserService

في الحالة دي غالبًا:

• نفس المنطق تقريبًا
• نفس البيانات
• اختلاف بسيط جدًا

لكن الكود متقسم على عدة ملفات بدون داعي حقيقي.
النتيجة؟

• التنقل بين الملفات بقى أبطأ
• قراءة الكود أصعب
• الصيانة أصعب

Service داخل Service​

مشكلة تانية شائعة جدًا هي تداخل الخدمات.
مثال بسيط:

UserService
   → OrderService
       → WalletService

كل Service بينادي Service تاني.
النتيجة:

• Trace طويل جدًا
• صعوبة تتبع تدفق التنفيذ
• Debug مرهق

وأحيانًا بتحتاج تفتح 5 أو 6 ملفات علشان تفهم عملية واحدة بس.

Debug أصبح كابوس​

المشكلة الأكبر بتظهر وقت اكتشاف الأخطاء (Debugging).
Bug بسيط ممكن يخليك تتنقل بين:

• Controller
• Service
• Service تاني
• Repository
• Model
• Helper

والـ Stack Trace بيكون أطول من المشكلة نفسها.
وده بيأثر جدًا على سرعة تطوير المشروع.

---

الحل الواقعي لتنظيم الكود في Laravel​

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

---

اجعل Controller واضحًا وليس فارغًا​

بعض المطورين بيحاولوا يخلو Controller شبه فارغ.
لكن في الحقيقة Controller ممكن يحتوي على:

• Validation
• Decision logic بسيط
• استدعاء مباشر للعمليات

مثال بسيط:

public function store(Request $request)
{
    $data = $request->validate([
        'name' => 'required',
        'email' => 'required|email'
    ]);

    $user = User::create($data);

    return response()->json($user);
}

الكود واضح ومباشر، بدون طبقات إضافية غير ضرورية.

---

استخدم Service فقط عندما يكون هناك منطق فعلي​

الـ Service Layer في Laravel مفيد جدًا… لكن بشرط.
استخدمه عندما يكون هناك:

• Business Logic حقيقي
• عمليات مركبة
• منطق بيتكرر في أماكن مختلفة

مثال:

class TransferBalanceService
{
    public function transfer($fromUser, $toUser, $amount)
    {
        $fromUser->wallet -= $amount;
        $toUser->wallet += $amount;

        $fromUser->save();
        $toUser->save();
    }
}

في الحالة دي وجود Service منطقي جدًا.

---

استخدم Repository فقط للوصول إلى البيانات​

الـ Repository Pattern مفيد عندما تريد فصل الوصول إلى البيانات عن باقي الكود.
لكن مهم جدًا إن Repository يحتوي على:

• Queries فقط
• بدون Business Logic

مثال:

class UserRepository
{
    public function findByEmail($email)
    {
        return User::where('email', $email)->first();
    }
}

بكده بيكون دور Repository واضح ومحدد.

---

متى تحتاج Service فعلًا في Laravel؟​

اسأل نفسك السؤال ده قبل إنشاء Service جديد.
هل المنطق:

✔ معقد؟​

✔ يتكرر في أكثر من مكان؟​

✔ مستقل عن HTTP؟​

✔ ممكن يستخدم في Job أو Command أو Listener؟​

لو الإجابة نعم…
يبقى Service مناسب جدًا.

لكن لو المنطق بسيط وموجود في Controller مرة واحدة فقط…
الأفضل إنك تخليه مباشر وبسيط.

---

القاعدة الذهبية في تصميم مشاريع Laravel​

التعقيد مش دليل احتراف. أحيانًا أفضل Architecture هي الأبسط.
كل طبقة إضافية في المشروع تعني:

• ملفات أكثر
• وقت Debug أطول
• صيانة أصعب

علشان كده حاول دائمًا توازن بين: تنظيم الكود و بساطة التنفيذ

---

خلاصة التجربة​

استخدام Service Layer في Laravel مفيد جدًا عندما يكون هناك منطق حقيقي يحتاج تنظيم.
لكن استخدامه بشكل مفرط ممكن يحول المشروع إلى شبكة معقدة من الطبقات.
القاعدة البسيطة: Service بدون سبب = عبء صيانة.
اجعل الكود واضح، بسيط، وسهل الفهم لأي مطور يفتح المشروع بعدك.

---

سؤال للمطورين​

لو اشتغلت قبل كده على مشروع Laravel كبير 👨‍💻
إيه الطبقة اللي حسيت إنها كانت سبب التعقيد الحقيقي في المشروع؟

• Service Layer؟
• Repository Pattern؟
• Controllers؟
• ولا حاجة تانية؟

شارك تجربتك… لأن أغلب المطورين مرّوا بنفس المشكلة.