Hugging Face's logo

Spaces:
EGYADMIN
/
Wahbi-AI
Paused

App Files Community
Wahbi-AI
File size: 6,505 Bytes 
25d2b3e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
 
# التوثيق التقني
## نظام تحليل العقود والمناقصات بالذكاء الاصطناعي - شركة شبه الجزيرة للمقاولات

<p align="center">
  <img src="../static/images/logo.png" alt="شعار النظام" width="200"/>
  <br>
  <em>إصدار التوثيق: 1.0.2 - تاريخ التحديث: 2025/03/01</em>
</p>

## جدول المحتويات

1. [نظرة عامة](#نظرة-عامة)
2. [المعمارية التقنية](#المعمارية-التقنية)
3. [متطلبات النظام](#متطلبات-النظام)
4. [الإعداد والتثبيت](#الإعداد-والتثبيت)
5. [بيئة Hybrid Face](#بيئة-hybrid-face)
6. [هيكل قاعدة البيانات](#هيكل-قاعدة-البيانات)
7. [وحدات النظام](#وحدات-النظام)
8. [واجهات برمجة التطبيقات (APIs)](#واجهات-برمجة-التطبيقات-apis)
9. [الأمان والمصادقة](#الأمان-والمصادقة)
10. [الأداء وقابلية التوسع](#الأداء-وقابلية-التوسع)
11. [استراتيجية النسخ الاحتياطي واستعادة البيانات](#استراتيجية-النسخ-الاحتياطي-واستعادة-البيانات)
12. [إرشادات التطوير](#إرشادات-التطوير)
13. [اختبار النظام](#اختبار-النظام)
14. [التكامل مع الأنظمة الخارجية](#التكامل-مع-الأنظمة-الخارجية)
15. [سجل التغييرات](#سجل-التغييرات)

## نظرة عامة

### عن النظام

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

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

1. **واجهة المستخدم (Frontend)**: تطبيق ويب تفاعلي مبني بواسطة Streamlit
2. **خدمات الخلفية (Backend)**: مجموعة من الخدمات والوحدات البرمجية بلغة Python
3. **قاعدة البيانات**: SQLite للتطوير والنشر المحلي، MySQL للنشر المؤسسي
4. **محركات الذكاء الاصطناعي**: نماذج معالجة اللغة الطبيعية والتعلم الآلي
5. **خدمات التكامل**: واجهات برمجة للتكامل مع الأنظمة الخارجية

## المعمارية التقنية

### المخطط العام للنظام

```mermaid

graph TD

    User[المستخدم] --> UI[واجهة المستخدم Streamlit]

    UI --> API[طبقة API]

    API --> Core[النواة]

    Core --> DB[(قاعدة البيانات)]

    Core --> NLP[معالجة اللغة العربية]

    Core --> ML[نماذج التعلم الآلي]

    Core --> FS[نظام الملفات]

    Core --> External[أنظمة خارجية]

    

    subgraph Core Modules

        NLP

        ML

        Doc[تحليل المستندات]

        Pricing[التسعير]

        Risk[تحليل المخاطر]

        Res[إدارة الموارد]

        Proj[إدارة المشاريع]

        Rep[التقارير]

    end

```

### نمط المعمارية

النظام يعتمد على نمط المعمارية طبقية (Layered Architecture) ونمط وحدات الخدمة (Service Modules):

1. **طبقة العرض**: واجهة المستخدم Streamlit
2. **طبقة الخدمات**: واجهات برمجة التطبيقات RESTful
3. **طبقة الأعمال**: وحدات المعالجة المنطقية
4. **طبقة البيانات**: الوصول إلى قاعدة البيانات وتخزين الملفات

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

### متطلبات الأجهزة

| المكون | الحد الأدنى | الموصى به |
|--------|-------------|-----------|
| المعالج | Intel Core i5 (8 أنوية) | Intel Core i7 (12 أنوية) أو أعلى |
| الذاكرة | 16GB RAM | 32GB RAM أو أكثر |
| التخزين | 10GB + مساحة للمستندات | SSD بسعة 50GB أو أكثر |
| الشبكة | اتصال إنترنت 10Mbps | اتصال إنترنت 50Mbps أو أسرع |
| الشاشة | دقة 1080p | دقة 1440p أو أعلى |

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

| البرمجيات | الإصدار المطلوب |
|-----------|-----------------|
| نظام التشغيل | Windows 10/11، MacOS 12+، Ubuntu 20.04+ |
| Python | 3.9 أو أحدث |
| بيئة Hybrid Face | 2.5 أو أحدث |
| متصفح | Chrome 90+، Firefox 88+، Edge 90+ |
| MySQL (اختياري) | 8.0 أو أحدث |

### المكتبات الأساسية

```python

# المكتبات الأساسية المستخدمة

streamlit==1.10.0

pandas==1.5.0

numpy==1.23.0

scikit-learn==1.1.0

nltk==3.7.0

spacy==3.4.0

transformers==4.20.0

pyarabic==0.6.15

sqlalchemy==1.4.40

plotly==5.9.0

pymysql==1.0.2

pdfplumber==0.7.0

python-docx==0.8.11

openpyxl==3.0.10

ezdxf==0.17.2

```

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

### إعداد بيئة التطوير

```bash

# إنشاء بيئة Python افتراضية

python -m venv venv

source venv/bin/activate  # Linux/MacOS

venv\Scripts\activate  # Windows



# تثبيت المكتبات المطلوبة

pip install -r requirements.txt

pip install -r arabic_support_requirements.txt

```

### تثبيت نماذج معالجة اللغة العربية

```bash

# تثبيت نموذج اللغة العربية لـ SpaCy

python -m spacy download ar_core_news_lg



# تحميل موارد NLTK للغة العربية

python -m nltk.downloader stopwords

python -m nltk.downloader punkt

python -m nltk.downloader wordnet

```

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

#### SQLite (للتطوير المحلي)

```bash

# إنشاء قاعدة بيانات SQLite

python setup_db.py --mode=local

```

#### MySQL (للنشر المؤسسي)

```bash

# إعداد قاعدة بيانات MySQL

python setup_db.py --mode=enterprise \

  --db-host=YOUR_DB_HOST \

  --db-user=YOUR_DB_USER \

  --db-pass=YOUR_DB_PASS \

  --db-name=tender_analysis_system