WAHBi-AI-V2 / README.md
EGYADMIN's picture
Create README.md
964eddf verified
|
raw
history blame
11.7 kB
metadata
license: mit
title: نظام متكامل لتحليل المناقصات والمشاريع المستقبلية لشركة شبه الجزيرة للمقاولات
sdk: streamlit
emoji: 🚀
colorFrom: indigo
colorTo: yellow
short_description: تحليل متقدم للمناقصات، المحتوى المحلي، سلاسل الإمداد، والتوق

نظام تحليل المناقصات وتوقع المشاريع المستقبلية

شعار شركة شبه الجزيرة للمقاولات

نظام متكامل لتحليل المناقصات والمشاريع المستقبلية لشركة شبه الجزيرة للمقاولات

تحليل متقدم للمناقصات، المحتوى المحلي، سلاسل الإمداد، والتوقعات المستقبلية

مستوى ثقة 95%

مهندس التطوير: م. تامر الجوهري

نبذة عن المشروع

هذا النظام هو منصة متكاملة تستخدم الذكاء الاصطناعي وتقنيات التعلم العميق لتحليل المناقصات وعقود المشاريع الكبرى في المملكة العربية السعودية. يركز النظام بشكل خاص على تحليل المحتوى المحلي وسلاسل الإمداد والتوقعات المستقبلية للمناقصات في قطاعات البلديات وصندوق الاستثمار ووزارة النقل.

الإمكانيات الرئيسية

  • تحليل المناقصات: استخراج ومعالجة متطلبات المناقصات من الملفات بصيغ متعددة (PDF, Word, صور ممسوحة ضوئياً)
  • تحليل المحتوى المحلي: تقدير وحساب نسب المحتوى المحلي والامتثال للمتطلبات التنظيمية
  • إدارة سلاسل الإمداد: تحليل وتحسين سلاسل الإمداد المحلية واقتراح الموردين المحليين المناسبين
  • التوقعات المستقبلية: توقع المناقصات والمشاريع المستقبلية من مختلف الجهات الحكومية
  • تقدير احتمالية النجاح: حساب احتمالية الفوز بالمناقصات بناءً على تحليل البيانات التاريخية والسوق الحالي
  • تقارير تحليلية: إنشاء تقارير شاملة ولوحات معلومات تفاعلية لدعم اتخاذ القرار

متطلبات النظام

المتطلبات التقنية

  • Python 3.10 أو أحدث
  • بطاقة GPU بذاكرة 46 جيجابايت أو أكثر (للاستفادة الكاملة من قدرات النظام)
  • مساحة تخزين 20 جيجابايت على الأقل
  • اتصال إنترنت (مطلوب للوصول إلى واجهات برمجة التطبيقات الخارجية)

المكتبات المطلوبة

يمكن تثبيت جميع المكتبات المطلوبة باستخدام ملف requirements.txt المرفق:

pip install -r requirements.txt

طريقة الإعداد في بيئة HF中国镜像站

1. إنشاء Space في HF中国镜像站

  1. قم بتسجيل الدخول إلى HF中国镜像站
  2. انتقل إلى Spaces وانقر على "Create new Space"
  3. اختر اسماً للمشروع وحدد "Streamlit" كإطار عمل
  4. اختر "GPU" كنوع الجهاز (يفضل A10G أو أفضل)
  5. أنشئ المستودع

2. رفع الملفات إلى المستودع

يمكنك رفع ملفات المشروع إلى مستودع HF中国镜像站 بإحدى الطرق التالية:

عبر واجهة الويب

  1. انتقل إلى صفحة Space الخاص بك
  2. انقر على "Files" ثم "Add file"
  3. قم برفع جميع الملفات أو المجلدات

باستخدام Git

git clone https://huggingface.co/spaces/username/your-space-name
cd your-space-name
# نسخ ملفات المشروع هنا
git add .
git commit -m "إضافة ملفات المشروع"
git push

باستخدام واجهة برمجة HF中国镜像站

pip install huggingface_hub
from huggingface_hub import HfApi

api = HfApi()
api.upload_folder(
    folder_path="./tender_analysis_system",
    repo_id="username/your-space-name",
    repo_type="space"
)

3. تحميل النماذج المدربة مسبقاً

النظام يستخدم عدة نماذج مدربة مسبقاً. لتحميلها:

  1. قم بإنشاء مجلد models/trained في مستودعك
  2. حمل النماذج التالية:
from huggingface_hub import snapshot_download

# نموذج ArabERT
snapshot_download(repo_id="aubmindlab/arabert-base-v2", 
                 local_dir="./models/trained/arabert")

# نموذج مدرب للتصنيف
snapshot_download(repo_id="username/tender-classifier", 
                 local_dir="./models/trained/tender_classifier")

4. إعداد ملفات الإعدادات

  1. تأكد من أن ملفات الإعدادات في مجلد config/ تحتوي على القيم الصحيحة
  2. عدل config/anthropic_config.yaml لإضافة مفتاح واجهة برمجة Anthropic الخاص بك
  3. عدل config/prediction_config.yaml حسب احتياجاتك

5. تشغيل التطبيق

بعد رفع جميع الملفات، سيقوم HF中国镜像站 Space بتثبيت المكتبات وتشغيل التطبيق تلقائياً. يمكنك الوصول إليه عبر الرابط: https://huggingface.co/spaces/username/your-space-name

هيكل المشروع

tender_analysis_system/
├── app.py                 # تطبيق الواجهة الرئيسية
├── requirements.txt       # متطلبات المكتبات
├── README.md              # هذا الملف
├── config/                # ملفات الإعدادات
├── models/                # النماذج وواجهات التحميل
├── preprocessing/         # معالجة المستندات والبيانات
├── analysis/              # وحدات التحليل المختلفة
├── supply_chain/          # تحليل سلاسل الإمداد
├── prediction/            # التوقعات المستقبلية
├── local_content/         # تحليل المحتوى المحلي
├── data/                  # البيانات والقوالب
├── utils/                 # أدوات مساعدة
├── training/              # وحدات تدريب النماذج
├── web/                   # مكونات الواجهة
└── logs/                  # ملفات السجلات

الوحدات الرئيسية

معالجة المستندات

  • document_reader.py: قراءة وتحليل المستندات بأنواعها المختلفة
  • ocr_processor.py: معالجة الصور والمستندات الممسوحة ضوئياً

التحليل

  • requirement_analyzer.py: تحليل متطلبات المناقصة
  • cost_estimator.py: تقدير تكاليف المشروع
  • risk_analyzer.py: تحليل المخاطر المحتملة
  • local_content_analyzer.py: تحليل نسب المحتوى المحلي
  • future_projects_analyzer.py: تحليل المشاريع المستقبلية

نماذج التوقع

  • tender_forecaster.py: توقع المناقصات المستقبلية
  • success_predictor.py: توقع احتمالية النجاح
  • future_prediction_model.py: نموذج التوقعات المستقبلية الشامل

واجهة المستخدم

  • web/pages/: صفحات التطبيق المختلفة
  • web/components/: مكونات واجهة المستخدم القابلة لإعادة الاستخدام
  • web/styles/: أنماط CSS للتطبيق

دليل الاستخدام

تحليل مناقصة جديدة

  1. انتقل إلى صفحة "تحليل المناقصات"
  2. ارفع ملفات المناقصة (PDF، Word، صور)
  3. انقر على "تحليل" وانتظر اكتمال المعالجة
  4. تصفح نتائج التحليل المختلفة عبر علامات التبويب

تحليل المحتوى المحلي

  1. انتقل إلى صفحة "المحتوى المحلي"
  2. أدخل تفاصيل المشروع والمتطلبات
  3. استعرض التحليل ونسب المحتوى المحلي المتوقعة
  4. تصفح الموردين المحليين المقترحين

توقع المشاريع المستقبلية

  1. انتقل إلى صفحة "المشاريع المستقبلية"
  2. اختر الجهة الحكومية (البلديات، صندوق الاستثمار، وزارة النقل، الكل)
  3. حدد الفترة الزمنية للتوقع
  4. استعرض الرسوم البيانية والتوقعات المستقبلية

توقع احتمالية النجاح

  1. انتقل إلى صفحة "توقع احتمالية النجاح"
  2. أدخل تفاصيل المناقصة (القطاع، المنطقة، الميزانية، إلخ)
  3. انقر على "تحليل" لعرض احتمالية النجاح ومستوى الثقة
  4. استعرض العوامل المؤثرة والتوصيات

التحديثات والصيانة

  • تدريب النماذج: يمكن إعادة تدريب النماذج عبر صفحة الإدارة باستخدام بيانات جديدة
  • تحديث قاعدة البيانات: يمكن تحديث قاعدة بيانات الموردين والمقاولين من خلال الواجهة
  • نسخ احتياطي: يتم عمل نسخ احتياطية تلقائية للبيانات والنماذج

مواضيع متقدمة

تخصيص النماذج

يمكن تخصيص النماذج المستخدمة في النظام عبر:

from training.future_prediction_model import FuturePredictionModel

# تدريب نموذج جديد
model = FuturePredictionModel(config_path="config/prediction_config.yaml")
model.train_classification_model(
    data_path="data/processed/new_tenders.csv",
    model_name="aubmindlab/arabert-base-v2",
    output_dir="models/trained/new_tender_classifier",
    epochs=5,
    batch_size=16,
    use_gpu=True
)

إضافة مصادر بيانات جديدة

لإضافة مصادر بيانات جديدة:

  1. قم بإنشاء ملف في مجلد api_integrations/ للاتصال بالمصدر الجديد
  2. أضف المصدر الجديد إلى config/prediction_config.yaml
  3. قم بتحديث النماذج باستخدام البيانات الجديدة

التكامل مع الأنظمة الأخرى

يتكامل النظام مع:

  • منصة منافسات الحكومية
  • منصة اعتماد
  • وزارة الشؤون البلدية والقروية والإسكان
  • صندوق الاستثمارات العامة

الدعم والمساعدة

للحصول على مساعدة فنية:

رخصة الاستخدام

هذا البرنامج مرخص للاستخدام الحصري من قبل شركة شبه الجزيرة للمقاولات. جميع الحقوق محفوظة.