الدرس 13: البنية المعمارية والانسجام

مع نمو المشاريع، لا يكفي التميز المحلي (أسماء المتغيرات الجيدة، الدوال الصغيرة). أنت بحاجة إلى Vibe على مستوى النظام — الانسجام المعماري الذي يحدد مكان وجود الملفات وكيفية تفاعل الوحدات.

فصل الاهتمامات (SoC)

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

هيكل الدليل الشائع المتوافق مع الـVibe

بدلاً من وضع كل شيء في مجلد src واحد، قم بالفصل حسب الدور التقني:

controllers/: يتعامل مع الطلبات الواردة (طبقة HTTP).
services/: يحتوي على منطق العمل الأساسي ('لماذا' التطبيق).
repositories/ أو data/: يتعامل مع الوصول إلى البيانات (التفاعل مع قاعدة البيانات).
utils/: دوال مساعدة عامة وقابلة لإعادة الاستخدام.

يوفر هذا الهيكل للمطور الجديد خريطة فورية للنظام: فهم يعرفون بالضبط مكان البحث لتعديل طبقة قاعدة البيانات مقابل تغيير مسار الويب.

فك الارتباط والتبعيات

الكود ذو الـVibe العالي يكون مرتبطاً بشكل فضفاض (loosely coupled). يجب أن تعتمد الوحدات على التجريدات (الواجهات) بدلاً من التطبيقات الملموسة. هذا يمنع 'تأثيرات التموج' عند تغيير وحدة واحدة.

عكس التحكم (IoC)

إن السماح للوحدات ذات المستوى الأعلى بتحديد السلوك للوحدات ذات المستوى الأدنى (غالباً ما يتم تنفيذه عبر حقن التبعية - Dependency Injection) يؤدي إلى كود مرن للغاية وقابل للاختبار، مما يوفر أفضل Vibe معماري طويل الأمد.