metadata

license: mit
title: نظام تحليل العقود والمناقصات بالذكاء الاصطناعي
sdk: streamlit
emoji: 📊
colorFrom: green
colorTo: green
sdk_version: 1.44.0

نظام تحليل العقود والمناقصات | WAHBi-AI v2

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

نبذة عامة

نظام 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

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

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

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

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

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

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

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

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

# إعداد قاعدة البيانات المحلية
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. تحميل نماذج اللغة والذكاء الاصطناعي

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

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

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

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

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

النظام الأساسي

النظام مبني على هيكلية حديثة تتكون من:

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

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

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. تسجيل الدخول

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

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

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

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

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

# تحليل مستندات المناقصة
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

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

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

2. إنشاء مشروع في Supabase

قم بإنشاء حساب على Supabase إذا لم يكن لديك حساب
أنشئ مشروعًا جديدًا واختر اسمًا مناسبًا (مثل "wahbi-ai")
احصل على معلومات الاتصال من لوحة التحكم (Settings > Database)

3. استيراد البيانات إلى Supabase

# استيراد هيكل قاعدة البيانات
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. اختبار الاتصال

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

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
واجهة المساعدة التفاعلية: متاحة داخل التطبيق عبر زر "المساعدة"

الدعم الفني

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

البريد الإلكتروني: tgoahry@sajco.com.sa.com
رقم الهاتف: ⁦+966 55 406 3339⁩
نظام التذاكر: https://info@sajco.com