Create README.md

README.md

@@ -1,12 +1,263 @@
 ---
-title: WAHBi AI V2
-emoji: 🔥
-colorFrom: yellow
-colorTo: indigo
+license: mit
+title: نظام متكامل لتحليل المناقصات والمشاريع المستقبلية لشركة شبه الجزيرة للمقاولات
 sdk: streamlit
-sdk_version: 1.43.2
-app_file: app.py
-pinned: false
+emoji: 🚀
+colorFrom: indigo
+colorTo: yellow
+short_description: تحليل متقدم للمناقصات، المحتوى المحلي، سلاسل الإمداد، والتوق
 ---
+# نظام تحليل المناقصات وتوقع المشاريع المستقبلية
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+<div dir="rtl" align="center">
+  <img src="web/assets/logos/peninsula_logo.png" alt="شعار شركة شبه الجزيرة للمقاولات" width="200" />
+  <h2>نظام متكامل لتحليل المناقصات والمشاريع المستقبلية لشركة شبه الجزيرة للمقاولات</h2>
+  <p>تحليل متقدم للمناقصات، المحتوى المحلي، سلاسل الإمداد، والتوقعات المستقبلية</p>
+  <p>مستوى ثقة 95%</p>
+  <p>مهندس التطوير: م. تامر الجوهري</p>
+</div>
+
+<div dir="rtl">
+
+## نبذة عن المشروع
+
+هذا النظام هو منصة متكاملة تستخدم الذكاء الاصطناعي وتقنيات التعلم العميق لتحليل المناقصات وعقود المشاريع الكبرى في المملكة العربية السعودية. يركز النظام بشكل خاص على تحليل المحتوى المحلي وسلاسل الإمداد والتوقعات المستقبلية للمناقصات في قطاعات البلديات وصندوق الاستثمار ووزارة النقل.
+
+### الإمكانيات الرئيسية
+
+- **تحليل المناقصات**: استخراج ومعالجة متطلبات المناقصات من الملفات بصيغ متعددة (PDF, Word, صور ممسوحة ضوئياً)
+- **تحليل المحتوى المحلي**: تقدير وحساب نسب المحتوى المحلي والامتثال للمتطلبات التنظيمية
+- **إدارة سلاسل الإمداد**: تحليل وتحسين سلاسل الإمداد المحلية واقتراح الموردين المحليين المناسبين
+- **التوقعات المستقبلية**: توقع المناقصات والمشاريع المستقبلية من مختلف الجهات الحكومية
+- **تقدير احتمالية النجاح**: حساب احتمالية الفوز بالمناقصات بناءً على تحليل البيانات التاريخية والسوق الحالي
+- **تقارير تحليلية**: إنشاء تقارير شاملة ولوحات معلومات تفاعلية لدعم اتخاذ القرار
+
+## متطلبات النظام
+
+### المتطلبات التقنية
+
+- Python 3.10 أو أحدث
+- بطاقة GPU بذاكرة 46 جيجابايت أو أكثر (للاستفادة الكاملة من قدرات النظام)
+- مساحة تخزين 20 جيجابايت على الأقل
+- اتصال إنترنت (مطلوب للوصول إلى واجهات برمجة التطبيقات الخارجية)
+
+### المكتبات المطلوبة
+
+يمكن تثبيت جميع المكتبات المطلوبة باستخدام ملف `requirements.txt` المرفق:
+
+```bash
+pip install -r requirements.txt
+```
+
+## طريقة الإعداد في بيئة HF中国镜像站
+
+### 1. إنشاء Space في HF中国镜像站
+
+1. قم بتسجيل الدخول إلى [HF中国镜像站](https://huggingface.co/)
+2. انتقل إلى [Spaces](https://huggingface.co/spaces) وانقر على "Create new Space"
+3. اختر اسماً للمشروع وحدد "Streamlit" كإطار عمل
+4. اختر "GPU" كنوع الجهاز (يفضل A10G أو أفضل)
+5. أنشئ المستودع
+
+### 2. رفع الملفات إلى المستودع
+
+يمكنك رفع ملفات المشروع إلى مستودع HF中国镜像站 بإحدى الطرق التالية:
+
+#### عبر واجهة الويب
+
+1. انتقل إلى صفحة Space الخاص بك
+2. انقر على "Files" ثم "Add file"
+3. قم برفع جميع الملفات أو المجلدات
+
+#### باستخدام Git
+
+```bash
+git clone https://huggingface.co/spaces/username/your-space-name
+cd your-space-name
+# نسخ ملفات المشروع هنا
+git add .
+git commit -m "إضافة ملفات المشروع"
+git push
+```
+
+#### باستخدام واجهة برمجة HF中国镜像站
+
+```bash
+pip install huggingface_hub
+```
+
+```python
+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. حمل النماذج التالية:
+
+```python
+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. استعرض العوامل المؤثرة والتوصيات
+
+## التحديثات والصيانة
+
+- **تدريب النماذج**: يمكن إعادة تدريب النماذج عبر صفحة الإدارة باستخدام بيانات جديدة
+- **تحديث قاعدة البيانات**: يمكن تحديث قاعدة بيانات الموردين والمقاولين من خلال الواجهة
+- **نسخ احتياطي**: يتم عمل نسخ احتياطية تلقائية للبيانات والنماذج
+
+## مواضيع متقدمة
+
+### تخصيص النماذج
+
+يمكن تخصيص النماذج المستخدمة في النظام عبر:
+
+```python
+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. قم بتحديث النماذج باستخدام البيانات الجديدة
+
+## التكامل مع الأنظمة الأخرى
+
+يتكامل النظام مع:
+
+- منصة منافسات الحكومية
+- منصة اعتماد
+- وزارة الشؤون البلدية والقروية والإسكان
+- صندوق الاستثمارات العامة
+
+## الدعم والمساعدة
+
+للحصول على مساعدة فنية:
+
+- البريد الإلكتروني: [email protected]
+- هاتف: +966 55 406 3339
+
+## رخصة الاستخدام
+
+هذا البرنامج مرخص للاستخدام الحصري من قبل شركة شبه الجزيرة للمقاولات. جميع الحقوق محفوظة.
+
+</div>