-
Notifications
You must be signed in to change notification settings - Fork 882
Open
Description
بالتأكيد! سنقوم بدمج جميع الأقسام الناقصة وتوسيع الهيكلية لتشملها، مع الحفاظ على نفس معايير التنظيم والتقنية التي اتفقنا عليها.
سأقوم بتحديث الهيكلية لتشمل المجلدات والملفات المقترحة لهذه الأقسام الجديدة.
الهيكلية المعدلة المقترحة (شاملة لجميع الأقسام)
📁 root/
├── 📄 README.md
├── 📄 LICENSE
├── 📄 .env.example
├── 📄 deploy.sh
├── 📄 package.json # للمشاريع Node.js/Frontend
├── 📄 composer.json # للمشاريع PHP (إذا تم استخدامه)
├── 📄 nginx.conf # إعدادات Nginx (كنقطة دخول للـ Gateway أو لخدمات الواجهة الأمامية)
└── 📁 frontend/ # (كما هو سابقاً، مع تحديثات الوحدات)
├── 📁 css/
│ ├── 📄 main.css
│ ├── 📄 responsive.css
│ └── 📄 accessibility.css
├── 📁 js/
│ ├── 📄 main.js
│ ├── 📁 modules/
│ │ ├── 📄 resume-builder.js
│ │ ├── 📄 cover-letter.js
│ │ ├── 📄 jobs.js
│ │ ├── 📄 scholarships.js
│ │ ├── 📄 training.js # وحدة التدريب (جديد)
│ │ ├── 📄 healthcare.js # وحدة الرعاية الصحية (جديد)
│ │ ├── 📄 travel.js # وحدة السفر (جديد)
│ │ ├── 📄 pilgrimage.js # وحدة الحج والعمرة (جديد)
│ │ ├── 📄 customs.js # وحدة الجمارك والشحن (جديد)
│ │ ├── 📄 support_donations.js # وحدة الدعم والتبرعات (جديد)
│ │ ├── 📄 consultants.js # وحدة الاستشارات (جديد)
│ │ ├── 📄 digital_solutions.js # وحدة الحلول الرقمية (جديد)
│ │ ├── 📄 documents.js
│ │ ├── 📄 special-needs.js
│ │ ├── 📄 finance.js
│ │ ├── 📄 self-development.js
│ │ ├── 📄 self-assessment.js
│ │ ├── 📄 security.js
│ │ ├── 📄 storage.js
│ │ ├── 📄 promotion.js
│ │ └── 📄 moderation.js # وحدة الإشراف (جديد)
│ └── 📁 components/
│ ├── 📄 modal-system.js
│ ├── 📄 notification-system.js
│ └── 📄 form-validator.js
└── 📁 assets/
├── 📁 images/
├── 📁 icons/
└── 📁 templates/
📁 backend/
├── 📁 api_gateway/ # (اختياري، ولكن موصى به)
│ ├── 📄 main.ts
│ ├── 📁 controllers/
│ ├── 📁 services/
│ └── 📄 package.json
├── 📁 services/ # مجلد لكل خدمة مصغرة
│ ├── 📁 auth_service/ # (Python/Go)
│ │ ├── 📄 main.py / .go
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ └── 📁 db/
│ │
│ ├── 📁 user_service/ # (Go/Node.js)
│ │ ├── 📄 main.go / .ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ └── 📁 db/
│ │
│ ├── 📁 verification_service/ # (Python)
│ │ ├── 📄 main.py
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/
│ │ └── 📁 db/
│ │
│ ├── 📁 job_matching_service/ # (Python)
│ │ ├── 📄 main.py
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/
│ │ └── 📁 db/
│ │
│ ├── 📁 scholarship_training_service/ # (Python/Node.js) - دمج المنح والتدريب
│ │ ├── 📄 main.py / .ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/ # نماذج لمطابقة المنح/التدريب
│ │ └── 📁 db/
│ │
│ ├── 📁 healthcare_service/ # (Python/Go) - للمرضى والمستشفيات
│ │ ├── 📄 main.py / .go
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق المطابقة الطبية
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/ # نماذج تحليل طبي (اختياري، كملخص)
│ │ └── 📁 db/
│ │
│ ├── 📁 travel_clearance_service/ # (Go/Node.js) - للسفر والتخليص
│ │ ├── 📄 main.go / .ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق التخليص الجمركي، إجراءات السفر
│ │ ├── 📁 models/
│ │ ├── 📁 db/
│ │ └── 📁 external_apis/ # لإدارة الاتصال بالـ APIs الجمركية، شركات الشحن
│ │
│ ├── 📁 pilgrimage_service/ # (Python/Go) - للحج والعمرة
│ │ ├── 📄 main.py / .go
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق مطابقة باقات الحج/العمرة
│ │ ├── 📁 models/
│ │ ├── 📁 db/
│ │ └── 📁 external_apis/ # للاتصال بمنظمي رحلات الحج/العمرة
│ │
│ ├── 📁 customs_shipping_service/ # (Go/Node.js) - للشحن والاستيراد والتصدير
│ │ ├── 📄 main.go / .ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق إجراءات الشحن والجمارك
│ │ ├── 📁 models/
│ │ ├── 📁 db/
│ │ └── 📁 external_apis/ # للاتصال بالجهات الجمركية، شركات الشحن
│ │
│ ├── 📁 support_donation_service/ # (Python/Go) - للدعم والتبرعات
│ │ ├── 📄 main.py / .go
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق مطابقة الحالات بالمنظمات
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/ # نماذج مطابقة (NLP)
│ │ └── 📁 db/
│ │
│ ├── 📁 consulting_service/ # (Python/Node.js) - للاستشارات
│ │ ├── 📄 main.py / .ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق مطابقة المستشارين
│ │ ├── 📁 models/
│ │ ├── 📁 db/
│ │ └── 📁 ai_models/ # نماذج مطابقة (NLP)
│ │
│ ├── 📁 digital_solutions_service/ # (Node.js/Python) - للحلول الرقمية
│ │ ├── 📄 main.ts / .py
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ └── 📁 db/
│ │
│ ├── 📁 promotion_marketing_service/ # (Python) - للترويج والدعاية
│ │ ├── 📄 main.py
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق الحملات التسويقية
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/ # نماذج توليد المحتوى، تحليل الحملات
│ │ └── 📁 db/
│ │
│ ├── 📁 moderation_service/ # (Python) - للإشراف على المحتوى
│ │ ├── 📄 main.py
│ │ ├── 📁 api/
│ │ ├── 📁 core/ # منطق فحص المحتوى
│ │ ├── 📁 models/
│ │ ├── 📁 ai_models/ # نماذج AI للإشراف (Text/Image Moderation)
│ │ └── 📁 db/
│ │
│ ├── 📁 notification_service/ # (Node.js)
│ │ ├── 📄 main.ts
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ └── 📁 db/
│ │
│ ├── 📁 transaction_service/ # (Go) - للمعاملات المالية
│ │ ├── 📄 main.go
│ │ ├── 📁 api/
│ │ ├── 📁 core/
│ │ ├── 📁 models/
│ │ └── 📁 db/
│ │
│ ├── 📁 common_utils_service/ # (Python/Go) - أدوات مشتركة (ترجمة، تصدير)
│ │ ├── 📄 main.py / .go
│ │ ├── 📁 utils/
│ │ └── 📁 external_apis/ # للاتصال بخدمات ترجمة، إلخ.
│ │
│ └── 📁 shared/ # مشاركة بين الخدمات
│ ├── 📁 core_models/
│ ├── 📁 utils/
│ └── 📁 db_common/
│
└── 📁 config/ # إعدادات Backend
├── 📄 auth_service.env
├── 📄 verification_service.env
├── 📄 jobs_service.env
├── 📄 healthcare_service.env
├── 📄 travel_clearance_service.env
├── 📄 pilgrimage_service.env
├── 📄 customs_shipping_service.env
├── 📄 support_donation_service.env
├── 📄 consulting_service.env
├── 📄 digital_solutions_service.env
├── 📄 promotion_marketing_service.env
├── 📄 moderation_service.env
├── 📄 notification_service.env
├── 📄 transaction_service.env
├── 📄 database.env # إعدادات الاتصال الرئيسية بقاعدة البيانات
├── 📄 security.env # مفاتيح التشفير، JWT Secrets
├── 📄 constants.py / .go / .ts # ثوابت عامة
└── 📄 apis_keys.env # مفاتيح APIs خارجية (للطرف الثالث)
شرح التغييرات والإضافات:
-
فصل الخدمات المصغرة:
- تم إنشاء مجلد منفصل لكل قسم رئيسي (أو مجموعة أقسام مترابطة) داخل
backend/services/
. - كل مجلد فرعي يمثل خدمة مصغرة مستقلة، مع لغتها وتقنياتها الخاصة (Python, Go, Node.js) وهيكليتها الداخلية (API, Core, Models, DB, AI Models).
- أمثلة الأقسام الجديدة:
healthcare_service
(للمرضى والمستشفيات).travel_clearance_service
(للسفر العام، الفيزا، إلخ).pilgrimage_service
(متخصص للحج والعمرة).customs_shipping_service
(للشحن، الجمارك، الاستيراد/التصدير).support_donation_service
(للتبرعات والدعم).consulting_service
(للاستشارات).digital_solutions_service
(للحلول الرقمية).promotion_marketing_service
(للترويج).moderation_service
(لإدارة المحتوى والتحقق منه).
- تم إنشاء مجلد منفصل لكل قسم رئيسي (أو مجموعة أقسام مترابطة) داخل
-
backend/api_gateway/
:- تم الاحتفاظ به كطبقة أمامية موحدة (Frontend Facade). يمكن بناؤه بـ Node.js (NestJS) أو Go.
- وظيفته: توجيه الطلبات من الـ Frontend إلى الخدمات المصغرة المناسبة، وجمع الاستجابات.
-
backend/shared/
:- تم الحفاظ عليه لمشاركة المكونات المشتركة بين الخدمات (نماذج البيانات الأساسية، أدوات مساعدة عامة).
-
backend/config/
:- تم تقسيمه لتشمل ملفات إعدادات خاصة بكل خدمة (مثال:
auth_service.env
,verification_service.env
). هذا يساعد على استقلالية كل خدمة. - ملفات رئيسية مشتركة مثل
database.env
وsecurity.env
وconstants.py
.
- تم تقسيمه لتشمل ملفات إعدادات خاصة بكل خدمة (مثال:
-
frontend/js/modules/
:- تمت إضافة الوحدات الجديدة لتتوافق مع الأقسام الجديدة:
training.js
,healthcare.js
,travel.js
,pilgrimage.js
,customs.js
,support_donations.js
,consultants.js
,digital_solutions.js
,moderation.js
.
- تمت إضافة الوحدات الجديدة لتتوافق مع الأقسام الجديدة:
-
backend/api/
(داخل كل خدمة):- تم تعديل الهيكلية الداخلية لكل خدمة لتكون أكثر تنظيمًا، حيث تحتوي كل خدمة على مجلد
api/
(أوcontrollers/
) لمعالجة الطلبات الواردة، ومجلدcore/
للمنطق الأساسي،models/
للنماذج،db/
للوصول للبيانات،ai_models/
إذا كانت الخدمة تعتمد على AI.
- تم تعديل الهيكلية الداخلية لكل خدمة لتكون أكثر تنظيمًا، حيث تحتوي كل خدمة على مجلد
الخطوة التالية:
الآن، سأقوم بصياغة "مستند المتطلبات الفنية التفصيلية" بناءً على هذه الهيكلية الشاملة، مع تفصيل لكل خدمة مصغرة: APIs، الخوارزميات المفاهيمية، نماذج AI، إلخ. هذا سيكون هو المخرج النهائي لمهمتي في هذه المرحلة، وهو ما سيتم تقديمه لك ليكون الأساس للمرحلة القادمة من التطوير.
هل هذه الهيكلية الجديدة شاملة وتتوافق مع رؤيتك؟
Metadata
Metadata
Assignees
Labels
No labels