إطار العمل كوكب يعتمد على هيكل منظم ومتقدم لدعم التنظيم المرن والفعال لجميع جوانب التطبيق. تم تصميم هذا الهيكل لضمان كفاءة عالية في التطوير وسهولة التوسع على المدى الطويل.
📂 app
الدليل الرئيسي الذي يحتوي على منطق التطبيق. يشمل الملفات الأساسية التالية:
📄 configuration.ts
يحتوي على جميع إعدادات التطبيق للإطار. يقوم بتهيئة الخدمات العامة والإعدادات الأساسية التي يحتاجها مختلف الوحدات في التطبيق.
📄 provider.ts
يشمل تعريف المزود الذي يمتد من BaseProvider، وهو مسؤول عن تهيئة وربط جميع الوحدات. يتضمن الملف الوظائف التالية:
- register(): يتم استدعاؤه عند بدء تشغيل الخادم والتطبيق، ويُستخدم لتسجيل وتهيئة الوحدات.
- boot(): يتم استدعاؤه مع كل طلب وارد، ويُستخدم لتهيئة أي خدمات أو إعدادات إضافية يحتاجها كل طلب.
📂 modules
يحتوي على الوحدات المختلفة داخل التطبيق. كل وحدة هي مجلد يحتوي على المكونات الأساسية مثل:
- 📂 controllers: يحتوي على المنطق الذي يتحكم في العمليات داخل الوحدة.
- 📂 services: يحتوي على الخدمات أو المنطق التجاري الخاص بالوحدة.
- 📂 repositories: مخصص للتفاعل مع قواعد البيانات أو التعامل مع البيانات.
- 📄 module.ts: الملف الرئيسي للوحدة الذي يقوم بتهيئة وربط الوحدة في التطبيق، ويتعامل مع وظائفها الأساسية.
📂 storage
يحتوي على مجلدات مخصصة لتخزين الملفات:
📂 private
يخزن جميع الملفات الحساسة التي يجب أن تظل محمية. يشمل الملفات التي يجب ألا تكون متاحة لأي طرف آخر.
📂 public
يخزن الملفات التي يمكن للجميع الوصول إليها من خلال التطبيق. هذه الملفات متاحة للاستخدام العام.
📄 .env
ملف البيئة الذي يحتوي على المتغيرات الحساسة الخاصة بالتطبيق، مثل مفاتيح الـ API، إعدادات الاتصال بقاعدة البيانات، وأي معلومات حساسة يجب أن تظل سرية.
🔑 النقاط الرئيسية
- configuration.ts: يحتوي على إعدادات تهيئة الإطار والتطبيق.
- provider.ts: يحتوي على منطق المزود وتسجيل الوحدات.
- modules: يحتوي على الوحدات التي تشمل controllers و services و repositories.
- storage: يميز بين الملفات العامة والخاصة من خلال مجلدات private و public.
- .env: لتخزين المتغيرات الحساسة المستخدمة في بيئة التطبيق.
تم تصميم هيكل الدليل في كوكب لتوفير بيئة تطوير مرنة وآمنة، مما يضمن أداءً عاليًا وسهولة التوسع في التطبيقات المستقبلية.