Spaces:

EGYADMIN
/

v3

Paused

File size: 20,249 Bytes

---
license: mit
title: نظام تحليل العقود والمناقصات بالذكاء الاصطناعي
sdk: streamlit
emoji: 📊
colorFrom: green
colorTo: green
sdk_version: 1.44.0
---
# نظام تحليل العقود والمناقصات | WAHBi-AI v2
## شركة شبه الجزيرة للمقاولات

<div align="center">
  <img src="https://imgg.io/images/2025/03/23/96dc2ab758cdd5e3267ff8221c2becc2.jpg" alt="شعار النظام" width="200"/>
  <p>
    <strong>هذا النظام خاص بشركة شبه الجزيرة للمقاولات، جميع الحقوق محفوظة 2025</strong>
  </p>
  <p>
    <img src="https://img.shields.io/badge/إصدار-2.0.0-blue" alt="Version 2.0.0" />
    <img src="https://img.shields.io/badge/الحالة-تطوير%20نشط-success" alt="Status: Active Development" />
    <img src="https://img.shields.io/badge/اللغة-العربية-green" alt="Language: Arabic" />
    <img src="https://img.shields.io/badge/AI-Claude%20+%20GPT--4o-purple" alt="AI: Claude + GPT-4o" />
  </p>
</div>

## نبذة عامة

نظام **WAHBi-AI** هو منصة متكاملة مدعومة بالذكاء الاصطناعي متخصصة في تحليل العقود والمناقصات باللغة العربية. يوفر النظام حلاً شاملاً لدراسة المشاريع الهندسية والمقاولات، مع التركيز على تسعير البنود بدقة عالية، وتحليل المخاطر التعاقدية، وتقييم فرص المشاريع الجديدة.

يتميز النظام بواجهة مستخدم متطورة باللغة العربية، مدعومة بأحدث تقنيات الذكاء الاصطناعي (Claude 3.7 Sonnet و GPT-4o) لمعالجة وتحليل وثائق المناقصات والعقود المعقدة. كما يتضمن نظام Streamlit المتكامل لحساب التكاليف وإدارة الموارد.

### فريق التطوير

- **مطور النظام**: م. تامر الجوهري
- **مدير التطوير**: م. بدر وهبي
- **المستشار الفني**: م. إسلام عيسى - مدير المكتب الفني (القصيم)
- **مدير تكنولوجيا المعلومات**: م. إرشاد يعقوب

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

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

- **نظام التشغيل**: Windows 10/11، MacOS 12+، Linux Ubuntu 20.04+
- **المعالج**: Intel Core i5 أو ما يعادله (8 أنوية على الأقل)
- **الذاكرة**: 16GB RAM (يوصى بـ 32GB للمشاريع الكبيرة)
- **مساحة التخزين**: 10GB للنظام + مساحة إضافية للمستندات والبيانات
- **الشاشة**: دقة 1920×1080 أو أعلى

### متطلبات البرمجيات

- **Python**: الإصدار 3.9 أو أحدث
- **بيئة Hybrid Face**: الإصدار 2.5 أو أحدث
- **قاعدة البيانات**: SQLite (للنشر المحلي) أو MySQL 8.0+ (للنشر المؤسسي)
- **متصفح**: Chrome 90+، Firefox 88+، Edge 90+

## التثبيت والإعداد

### 1. تثبيت بيئة Hybrid Face

```bash
# تثبيت بيئة Hybrid Face
curl -sSL https://get.hybridface.io/install.sh | bash

# تفعيل البيئة
source ~/.hybridface/bin/activate
```

### 2. استنساخ المستودع

```bash
# استنساخ المستودع
git clone https://gitlab.peninsula-contracting.com/ai-systems/tender-analysis-system.git
cd tender-analysis-system
```

### 3. تثبيت المتطلبات

```bash
# تثبيت حزم Python المطلوبة
pip install -r requirements.txt

# تثبيت حزم لدعم اللغة العربية
pip install -r arabic_support_requirements.txt
```

### 4. إعداد قاعدة البيانات

```bash
# إعداد قاعدة البيانات المحلية
python setup_db.py --mode=local

# أو إعداد قاعدة بيانات MySQL للمؤسسة
python setup_db.py --mode=enterprise --db-host=DB_HOST --db-user=DB_USER --db-pass=DB_PASS
```

### 5. تحميل نماذج اللغة والذكاء الاصطناعي

```bash
# تحميل نماذج معالجة اللغة العربية
python download_models.py --models=nlp,arabic

# تحميل نماذج التعلم الآلي
python download_models.py --models=ml,pricing
```

### 6. تشغيل النظام

```bash
# تشغيل النظام على الخادم المحلي
hface run --app=tender_system --port=8501
```

## الهيكل التقني للنظام

### النظام الأساسي
النظام مبني على هيكلية حديثة تتكون من:
- **واجهة مستخدم متطورة**: مطورة باستخدام React.js + TypeScript مع واجهة عربية سلسة
- **خادم API قوي**: مبني بلغة Node.js مع Express
- **تطبيق تحليل البيانات**: مطور بلغة Python مع Streamlit
- **قاعدة بيانات متكاملة**: تعتمد على PostgreSQL مع دعم Supabase
- **نماذج ذكاء اصطناعي**: متكاملة مع Claude و GPT-4o

### مكونات النظام

```bash
tender-analysis-system/
├── app.py                          # نقطة الدخول الرئيسية للتطبيق
├── config/                         # إعدادات النظام
│   ├── settings.py                 # إعدادات عامة للتطبيق
│   ├── ai_models_config.py         # إعدادات نماذج الذكاء الاصطناعي
│   └── logging_config.py           # إعدادات التسجيل والتتبع
│
├── database/                       # وحدة قاعدة البيانات
│   ├── db_connector.py             # اتصال قاعدة البيانات
│   ├── orm/                        # وحدة تحديد العلاقات
│   │   ├── models.py               # نماذج البيانات
│   │   └── schemas.py              # مخططات البيانات
│   └── migrations/                 # تحديثات قاعدة البيانات
│
├── modules/                        # وحدات النظام الوظيفية
│   ├── ai_assistant/               # المساعد الذكي
│   │   ├── assistant_app.py        # واجهة المساعد
│   │   └── ai_assistant.py         # محرك المساعد الذكي
│   │
│   ├── document_comparison/        # مقارنة المستندات
│   │   ├── comparison_app.py       # واجهة المقارنة
│   │   └── document_comparator.py  # محرك المقارنة
│   │
│   ├── pricing/                    # وحدة التسعير والتكاليف
│   │   ├── pricing_app.py          # واجهة التسعير
│   │   ├── construction_calculator.py # حاسبة مواد البناء
│   │   └── services/               # خدمات التسعير
│   │       ├── templates_catalog/  # كتالوج البنود النموذجية
│   │       ├── materials_pricing/  # تسعير المواد
│   │       └── labor_rates/        # معدلات العمالة
│   │
│   ├── resources/                  # إدارة الموارد
│   │   ├── resources_app.py        # واجهة الموارد
│   │   └── resource_manager.py     # مدير الموارد
│   │
│   ├── risk_assessment/            # تقييم المخاطر
│   │   ├── risk_assessment_app.py  # واجهة تقييم المخاطر
│   │   └── contract_risk_analyzer.py # محلل مخاطر العقود
│   │
│   ├── projects/                   # إدارة المشاريع
│   │   ├── projects_app.py         # واجهة المشاريع
│   │   └── projects_management.py  # إدارة المشاريع
│   │
│   ├── maps/                       # الخرائط التفاعلية
│   │   ├── maps_app.py             # واجهة الخرائط
│   │   └── interactive_map.py      # خريطة تفاعلية
│   │
│   ├── notifications/              # نظام الإشعارات
│   │   ├── notifications_app.py    # واجهة الإشعارات
│   │   └── smart_notifications.py  # الإشعارات الذكية
│   │
│   ├── ai_finetuning/              # تحسين نماذج الذكاء الاصطناعي
│   │   ├── finetuning_app.py       # واجهة التحسين
│   │   └── model_finetuning.py     # محرك تحسين النماذج
│   │
│   ├── voice_narration/            # التعليق الصوتي
│   │   ├── voice_narration_app.py  # واجهة التعليق الصوتي
│   │   └── voice_over_system.py    # نظام التعليق الصوتي
│   │
│   ├── achievements/               # نظام الإنجازات
│   │   ├── achievements_app.py     # واجهة الإنجازات
│   │   └── achievement_system.py   # نظام الإنجازات
│   │
│   └── project_tracker/            # متتبع المشاريع
│       ├── tracker_app.py          # واجهة المتابعة
│       └── status_tracker.py       # متتبع الحالة
│
├── utils/                          # أدوات مساعدة
│   ├── helpers/                    # دوال مساعدة
│   │   ├── __init__.py             # ملف التهيئة
│   │   └── utils.py                # وظائف مساعدة
│   │
│   └── components/                 # مكونات واجهة المستخدم
│       ├── sidebar.py              # الشريط الجانبي
│       └── about_system.py         # صفحة حول النظام
│
├── static/                         # ملفات ثابتة
│   ├── css/                        # أنماط CSS
│   ├── js/                         # سكربتات JavaScript
│   ├── images/                     # الصور والشعارات
│   └── templates/                  # قوالب HTML
│
├── tests/                          # اختبارات النظام
│   ├── unit/                       # اختبارات الوحدات
│   └── integration/                # اختبارات التكامل
│
└── docs/                           # التوثيق
    ├── user_manual.md              # دليل المستخدم
    ├── api_reference.md            # مرجع API
    ├── developer_guide.md          # دليل المطور
    └── deployment_guide.md         # دليل النشر
```

### وصف مكونات النظام الرئيسية

| المكون | الوصف |
|--------|-------|
| **المساعد الذكي** | يوفر واجهة محادثة ذكية للاستعلام عن المناقصات والعقود باللغة العربية باستخدام Claude و GPT-4o |
| **مقارنة المستندات** | يحلل الاختلافات بين الإصدارات المختلفة للعقود والاتفاقيات بدقة عالية |
| **وحدة التسعير** | تقدم نظاماً شاملاً لحساب تكاليف البنود مع إدارة المواد والعمالة والمعدات |
| **تقييم المخاطر** | تحدد وتحلل المخاطر في العقود والمناقصات باستخدام خوارزميات متقدمة للذكاء الاصطناعي |
| **إدارة المشاريع** | تتبع حالة المناقصات والمشاريع المرساة مع مؤشرات الأداء الرئيسية |
| **الخرائط التفاعلية** | تقدم تمثيلاً مرئياً لمواقع المشاريع مع معلومات جغرافية مفصلة |
| **نظام الإشعارات** | يدير تنبيهات ذكية للمستخدمين حسب أدوارهم واهتماماتهم |

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

| الوحدة | الوصف |
|--------|-------|
| **تحليل المستندات** | تحليل كراسات الشروط والعقود باستخدام معالجة اللغة العربية الطبيعية |
| **التسعير المتكامل** | نموذج شامل للتسعير يربط بين مختلف وحدات النظام |
| **الموارد والتكاليف** | إدارة بيانات المواد والمعدات والعمالة وتكاليفها |
| **تحليل المخاطر** | تقييم المخاطر التعاقدية والمالية والفنية |
| **إدارة المشاريع** | متابعة المناقصات والمشاريع المرساة |
| **التقارير والتحليلات** | تقارير وتحليلات متقدمة لدعم اتخاذ القرار |
| **الذكاء الاصطناعي** | محرك الذكاء الاصطناعي لمختلف وظائف النظام |

## المزايا الرئيسية للنظام

### 1. تحليل المستندات باللغة العربية
- معالجة متقدمة للغة العربية في كراسات الشروط والعقود
- استخراج البنود الرئيسية والشروط الخاصة تلقائيًا
- تحديد بنود التكاليف والغرامات والضمانات
- مقارنة أتوماتيكية بين الإصدارات المختلفة للمستندات

### 2. حاسبة التكاليف المتكاملة
- تحليل تفصيلي لتكاليف البنود
- قاعدة بيانات متكاملة للمواد والعمالة والمعدات
- نظام طلب تسعير للمواد والمعدات
- حساب تلقائي للمصاريف الإدارية ونسب الربح

### 3. إدارة الموارد والمشاريع
- تتبع استخدام المواد والمعدات عبر المشاريع
- جدولة زمنية متكاملة للمشاريع القائمة والمتوقعة
- خرائط تفاعلية لمواقع المشاريع
- تتبع مؤشرات الأداء الرئيسية للمشاريع

### 4. نظام الإشعارات الذكية
- تنبيهات آلية للمواعيد النهائية والمهام
- متابعة حالة المناقصات والردود على الاستفسارات
- تنبيهات أتوماتيكية لتغييرات الأسعار والمواد
- إشعارات مخصصة لكل مستخدم حسب دوره ومسؤولياته

### 5. المساعد الذكي المتكامل
- محادثة تفاعلية بالعربية مع المساعد الذكي
- ملخصات تلقائية للمناقصات والعقود
- اقتراحات ذكية لتحسين العروض التقنية والمالية
- إجابات فورية على الاستفسارات المتعلقة بالمشاريع

### 6. التحليل المالي والمخاطر
- تقييم ذكي للمخاطر التعاقدية والمالية
- تحليل الربحية وتوقعات التدفق النقدي
- دراسة متقدمة للأسعار غير المتوازنة
- تقارير شاملة عن صحة المشاريع المالية

## استخدام النظام

### 1. تسجيل الدخول

```bash
# تسجيل الدخول إلى النظام
hface login --username=USER --password=PASS
```

### 2. إدارة المشاريع

```bash
# إنشاء مشروع جديد
hface project create --name="اسم المشروع" --client="اسم العميل"

# استيراد كراسة شروط
hface document import --project-id=123 --type=tender --file=path/to/document.pdf
```

### 3. تشغيل التحليل والتسعير

```bash
# تحليل مستندات المناقصة
hface analyze --project-id=123 --mode=full

# تشغيل التسعير الشامل
hface pricing --project-id=123 --strategy=comprehensive
```

## خطة تطوير النظام

### المرحلة الأولى (مكتملة)
- ✅ تطوير الهيكلية الأساسية للنظام
- ✅ بناء واجهة المستخدم الرئيسية
- ✅ تكامل نماذج الذكاء الاصطناعي للتحليل
- ✅ إدارة المستخدمين والصلاحيات
- ✅ حاسبة التكاليف الأساسية

### المرحلة الثانية (1-2 أسابيع)
- 🔄 تطوير كتالوج البنود النموذجية
- 🔄 تحسين حاسبة التكاليف المتقدمة
- 🔄 إضافة نظام طلب تسعير المواد والمعدات
- 🔄 تحسين واجهة المستخدم وتجربة الاستخدام

### المرحلة الثالثة (2-3 أسابيع)
- نظام حساب المحتوى المحلي
- تحليل التسعير غير المتوازن
- إضافة نظام الخرائط التفاعلي للمواقع
- تطوير نظام الإشعارات الذكية

### المرحلة الرابعة (3-4 أسابيع)
- نظام متكامل لإدارة المشاريع والمواقع
- تحسين دقة التحليل من خلال تدريب النماذج
- إضافة تحليل متقدم للمخاطر والفرص
- تطوير نظام التقارير الشاملة

### المرحلة الخامسة (نهائية)
- تطبيق للهواتف الذكية للوصول للنظام من المواقع
- دعم التحليل ثلاثي الأبعاد للمواقع والكميات
- تكامل مع برامج التصميم وحساب الكميات
- نظام التنبؤ بالفرص المستقبلية

## نقل قاعدة البيانات إلى Supabase

يمكن نقل قاعدة البيانات من Replit PostgreSQL إلى Supabase باتباع الخطوات التالية:

### 1. تصدير البيانات من Replit
```bash
# تصدير هيكل قاعدة البيانات
pg_dump -s -f schema.sql $DATABASE_URL

# تصدير البيانات
pg_dump -a -f data.sql $DATABASE_URL
```

### 2. إنشاء مشروع في Supabase
- قم بإنشاء حساب على [Supabase](https://supabase.com) إذا لم يكن لديك حساب
- أنشئ مشروعًا جديدًا واختر اسمًا مناسبًا (مثل "wahbi-ai")
- احصل على معلومات الاتصال من لوحة التحكم (Settings > Database)

### 3. استيراد البيانات إلى Supabase
```bash
# استيراد هيكل قاعدة البيانات
psql [SUPABASE_CONNECTION_STRING] -f schema.sql

# استيراد البيانات
psql [SUPABASE_CONNECTION_STRING] -f data.sql
```

### 4. تحديث متغيرات البيئة
قم بتحديث ملف `.env` بمعلومات اتصال Supabase:
```
DATABASE_URL=postgresql://postgres:[PASSWORD]@db.[PROJECT_ID].supabase.co:5432/postgres
PGHOST=db.[PROJECT_ID].supabase.co
PGPORT=5432
PGUSER=postgres
PGPASSWORD=[PASSWORD]
PGDATABASE=postgres
```

### 5. اختبار الاتصال
تحقق من الاتصال بقاعدة البيانات الجديدة:
```python
import psycopg2
from dotenv import load_dotenv
import os

load_dotenv()

connection = psycopg2.connect(os.getenv("DATABASE_URL"))
cursor = connection.cursor()
cursor.execute("SELECT NOW()")
result = cursor.fetchone()
print("Connected to Supabase database:", result)
cursor.close()
connection.close()
```

## التوثيق والدعم الفني

### المستندات والتوثيق
- **دليل المستخدم**: `/docs/user_manual.md`
- **التوثيق التقني**: `/docs/technical_docs.md`
- **واجهة المساعدة التفاعلية**: متاحة داخل التطبيق عبر زر "المساعدة"

### الدعم الفني
للحصول على الدعم الفني، يرجى التواصل مع:

- البريد الإلكتروني: [email protected]
- رقم الهاتف: ⁦+966 55 406 3339⁩
- نظام التذاكر: https://[email protected]

---

<div align="center">
  <strong>شركة شبه الجزيرة للمقاولات - نظام WAHBi-AI لتحليل المناقصات</strong><br>
  جميع الحقوق محفوظة &copy; 2025
</div>