Skip to content

omran tashile platform #167

@shmsayb

Description

@shmsayb

بالتأكيد! سنقوم بدمج جميع الأقسام الناقصة وتوسيع الهيكلية لتشملها، مع الحفاظ على نفس معايير التنظيم والتقنية التي اتفقنا عليها.

سأقوم بتحديث الهيكلية لتشمل المجلدات والملفات المقترحة لهذه الأقسام الجديدة.


الهيكلية المعدلة المقترحة (شاملة لجميع الأقسام)

📁 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 خارجية (للطرف الثالث)


شرح التغييرات والإضافات:

  1. فصل الخدمات المصغرة:

    • تم إنشاء مجلد منفصل لكل قسم رئيسي (أو مجموعة أقسام مترابطة) داخل 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 (لإدارة المحتوى والتحقق منه).
  2. backend/api_gateway/:

    • تم الاحتفاظ به كطبقة أمامية موحدة (Frontend Facade). يمكن بناؤه بـ Node.js (NestJS) أو Go.
    • وظيفته: توجيه الطلبات من الـ Frontend إلى الخدمات المصغرة المناسبة، وجمع الاستجابات.
  3. backend/shared/:

    • تم الحفاظ عليه لمشاركة المكونات المشتركة بين الخدمات (نماذج البيانات الأساسية، أدوات مساعدة عامة).
  4. backend/config/:

    • تم تقسيمه لتشمل ملفات إعدادات خاصة بكل خدمة (مثال: auth_service.env, verification_service.env). هذا يساعد على استقلالية كل خدمة.
    • ملفات رئيسية مشتركة مثل database.env و security.env و constants.py.
  5. frontend/js/modules/:

    • تمت إضافة الوحدات الجديدة لتتوافق مع الأقسام الجديدة: training.js, healthcare.js, travel.js, pilgrimage.js, customs.js, support_donations.js, consultants.js, digital_solutions.js, moderation.js.
  6. backend/api/ (داخل كل خدمة):

    • تم تعديل الهيكلية الداخلية لكل خدمة لتكون أكثر تنظيمًا، حيث تحتوي كل خدمة على مجلد api/ (أو controllers/) لمعالجة الطلبات الواردة، ومجلد core/ للمنطق الأساسي، models/ للنماذج، db/ للوصول للبيانات، ai_models/ إذا كانت الخدمة تعتمد على AI.

الخطوة التالية:

الآن، سأقوم بصياغة "مستند المتطلبات الفنية التفصيلية" بناءً على هذه الهيكلية الشاملة، مع تفصيل لكل خدمة مصغرة: APIs، الخوارزميات المفاهيمية، نماذج AI، إلخ. هذا سيكون هو المخرج النهائي لمهمتي في هذه المرحلة، وهو ما سيتم تقديمه لك ليكون الأساس للمرحلة القادمة من التطوير.

هل هذه الهيكلية الجديدة شاملة وتتوافق مع رؤيتك؟

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions