EGYADMIN commited on
Commit
a780454
·
verified ·
1 Parent(s): b518ba6

Delete docs

Browse files
docs/architecture.md DELETED
@@ -1,136 +0,0 @@
1
- # هيكلية النظام المحسنة لنظام إدارة المناقصات
2
-
3
- ## نظرة عامة
4
- هذا المستند يوضح هيكلية النظام المحسنة لنظام إدارة المناقصات، والذي يتضمن الوحدات التالية:
5
- - وحدة التسعير المتكاملة
6
- - وحدة الذكاء الاصطناعي
7
- - وحدة تحليل البيانات
8
- - وحدة الموارد
9
-
10
- ## هيكلية المجلدات
11
-
12
- ```
13
- tender_system/
14
- ├── app.py # نقطة الدخول الرئيسية للتطبيق
15
- ├── config.py # إعدادات التطبيق
16
- ├── requirements.txt # متطلبات المكتبات
17
- ├── README.md # توثيق النظام
18
- ├── assets/ # الأصول الثابتة
19
- │ ├── images/ # الصور
20
- │ ├── icons/ # الأيقونات
21
- │ └── fonts/ # الخطوط
22
- ├── data/ # البيانات
23
- │ ├── templates/ # قوالب البيانات
24
- │ └── charts/ # بيانات الرسوم البيانية
25
- ├── database/ # قاعدة البيانات
26
- │ ├── db_connector.py # موصل قاعدة البيانات
27
- │ └── models.py # نماذج البيانات
28
- ├── modules/ # وحدات النظام
29
- │ ├── pricing/ # وحدة التسعير
30
- │ │ ├── pricing_app.py # تطبيق التسعير
31
- │ │ └── services/ # خدمات التسعير
32
- │ │ ├── standard_pricing.py
33
- │ │ ├── unbalanced_pricing.py
34
- │ │ ├── local_content_calculator.py
35
- │ │ ├── price_prediction.py
36
- │ │ ├── construction_cost_calculator.py
37
- │ │ └── construction_templates.py
38
- │ ├── ai_assistant/ # وحدة الذكاء الاصطناعي
39
- │ │ ├── ai_app.py # تطبيق الذكاء الاصطناعي
40
- │ │ └── services/ # خدمات الذكاء الاصطناعي
41
- │ │ ├── openai_service.py
42
- │ │ ├── anthropic_service.py
43
- │ │ ├── local_llm_service.py
44
- │ │ └── prompt_templates.py
45
- │ ├── document_analysis/ # وحدة تحليل المستندات
46
- │ │ ├── document_app.py # تطبيق تحليل المستندات
47
- │ │ └── services/ # خدمات تحليل المستندات
48
- │ │ ├── text_extractor.py
49
- │ │ ├── item_extractor.py
50
- │ │ └── document_parser.py
51
- │ ├── resources/ # وحدة الموارد
52
- │ │ ├── resources_app.py # تطبيق الموارد
53
- │ │ └── services/ # خدمات الموارد
54
- │ │ ├── material_manager.py
55
- │ │ ├── labor_manager.py
56
- │ │ ├── equipment_manager.py
57
- │ │ └── subcontractor_manager.py
58
- │ ├── project_management/ # وحدة إدارة المشاريع
59
- │ │ └── project_app.py # تطبيق إدارة المشاريع
60
- │ └── reports/ # وحدة التقارير
61
- │ └── reports_app.py # تطبيق التقارير
62
- ├── styling/ # التنسيق
63
- │ ├── theme.py # سمات التطبيق
64
- │ ├── icons.py # أيقونات التطبيق
65
- │ └── charts.py # تنسيق الرسوم البيانية
66
- ├── utils/ # أدوات مساعدة
67
- │ ├── excel_handler.py # معالج ملفات Excel
68
- │ ├── pdf_handler.py # معالج ملفات PDF
69
- │ ├── helpers.py # دوال مساعدة
70
- │ └── auth.py # المصادقة
71
- └── tests/ # اختبارات
72
- ├── test_pricing.py # اختبارات وحدة التسعير
73
- ├── test_ai.py # اختبارات وحدة الذكاء الاصطناعي
74
- ├── test_document.py # اختبارات وحدة تحليل المستندات
75
- └── test_resources.py # اختبارات وحدة الموارد
76
- ```
77
-
78
- ## تفاصيل الوحدات
79
-
80
- ### 1. وحدة التسعير المتكاملة
81
- - **الوظائف الرئيسية**:
82
- - إنشاء تسعير جديد
83
- - تحليل سعر البند
84
- - نموذج التسعير الشامل
85
- - التسعير غير المتزن
86
- - المحتوى المحلي
87
- - حاسبة تكاليف البناء
88
- - الأدوات المساعدة
89
-
90
- ### 2. وحدة الذكاء الاصطناعي
91
- - **الوظائف ال��ئيسية**:
92
- - تحليل المستندات باستخدام الذكاء الاصطناعي
93
- - توليد توصيات ذكية للتسعير
94
- - تحليل المخاطر باستخدام الذكاء الاصطناعي
95
- - مساعد المحادثة الذكي
96
- - تلخيص المستندات
97
- - استخراج المعلومات الرئيسية
98
-
99
- ### 3. وحدة تحليل البيانات
100
- - **الوظائف الرئيسية**:
101
- - استخراج النصوص من المستندات
102
- - استخراج الجداول والبنود
103
- - تحليل المستندات
104
- - تحويل المستندات إلى بيانات منظمة
105
- - تحليل الصور والمخططات
106
-
107
- ### 4. وحدة الموارد
108
- - **الوظائف الرئيسية**:
109
- - إدارة المواد
110
- - إدارة العمالة
111
- - إدارة المعدات
112
- - إدارة المقاولين من الباطن
113
- - تحليل تكاليف الموارد
114
- - تخطيط الموارد
115
-
116
- ## واجهة المستخدم
117
- - تستخدم إطار عمل Streamlit لبناء واجهة مستخدم تفاعلية
118
- - تدعم اللغة العربية بشكل كامل
119
- - تتضمن تبويبات لكل وحدة من وحدات النظام
120
- - تدعم الوضعين الفاتح والداكن
121
- - تتضمن رسومات بيانية تفاعلية باستخدام Plotly
122
-
123
- ## تكامل الوحدات
124
- - تتكامل وحدة التسعير مع وحدة الموارد لاستخدام بيانات الأسعار
125
- - تتكامل وحدة تحليل البيانات مع وحدة التسعير لاستخراج بنود المناقصة
126
- - تتكامل وحدة الذكاء الاصطناعي مع جميع الوحدات لتقديم توصيات ذكية
127
- - تتكامل جميع الوحدات مع قاعدة البيانات المركزية
128
-
129
- ## التقنيات المستخدمة
130
- - **لغة البرمجة**: Python
131
- - **إطار عمل واجهة المستخدم**: Streamlit
132
- - **معالجة البيانات**: Pandas, NumPy
133
- - **الرسوم البيانية**: Plotly, Matplotlib
134
- - **الذكاء الاصطناعي**: OpenAI API, Anthropic API, Transformers
135
- - **معالجة المستندات**: PyPDF2, python-docx, pdf2image
136
- - **قاعدة البيانات**: SQLAlchemy
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
docs/missing_modules_analysis.md DELETED
@@ -1,88 +0,0 @@
1
- # تحليل الوحدات الناقصة والميزات المطلوبة
2
-
3
- ## الوحدات الناقصة في النظام الحالي
4
-
5
- بناءً على تحليل دليل المستخدم والمتطلبات المقدمة، تم تحديد الوحدات والميزات التالية التي يجب إضافتها أو تحسينها في النظام:
6
-
7
- ### 1. وحدة الخرائط والمواقع
8
- - خرائط تفاعلية لمواقع المشاريع
9
- - عرض المشاريع على الخريطة بناءً على الموقع الجغرافي
10
- - إمكانية تحديد المسافات والمناطق
11
-
12
- ### 2. وحدة الإشعارات الذكية
13
- - نظام إشعارات متكامل للتنبيهات المهمة
14
- - إشعارات للمواعيد النهائية والمهام
15
- - إشعارات لتغييرات حالة المناقصات والمشاريع
16
-
17
- ### 3. وحدة مقارنة المستندات
18
- - أدوات متطورة لمقارنة المستندات
19
- - تحديد الاختلافات بين إصدارات المستندات
20
- - تحليل التغييرات في الشروط والبنود
21
-
22
- ### 4. وحدة الترجمة
23
- - ترجمة المستندات والنصوص بين اللغات
24
- - دعم خاص للترجمة بين العربية والإنجليزية
25
- - ترجمة المصطلحات الفنية والقانونية
26
-
27
- ### 5. تحسين وحدة الذكاء الاصطناعي
28
- - تكامل مع نماذج الذكاء الاصطناعي المتقدمة
29
- - العمل في بيئة هجينة (محلية وسحابية)
30
- - طلب مفاتيح API من قسم الأمان
31
-
32
- ### 6. تحسين وحدة التسعير المتكامل
33
- - تطوير نظام تسعير شامل ومتكامل
34
- - تحسين واجهة المستخدم وسهولة الاستخدام
35
- - إضافة ميزات تحليل الأسعار المتقدمة
36
-
37
- ### 7. تحسين وحدة إدارة المشاريع
38
- - تطوير وحدة متكاملة لإدارة المشاريع المرساة
39
- - متابعة تنفيذ المشاريع ومراحلها
40
- - إدارة الموارد والجداول الزمنية للمشاريع
41
-
42
- ## تحسينات الواجهة المرئية المطلوبة
43
-
44
- ### 1. تحسين التصميم العام
45
- - تطوير واجهة مستخدم أكثر احترافية
46
- - تحسين الألوان والتباين
47
- - تنسيق متناسق بين جميع الوحدات
48
-
49
- ### 2. تحسين القوائم والتنقل
50
- - تطوير شريط قوائم رئيسي متكامل
51
- - تحسين تجربة التنقل بين الوحدات
52
- - إضافة اختصارات للوظائف الأكثر استخداماً
53
-
54
- ### 3. تحسين عرض الشعار والهوية
55
- - تحسين عرض شعار الشركة
56
- - تطبيق هوية بصرية موحدة في جميع أجزاء النظام
57
- - إضافة خيارات تخصيص الواجهة
58
-
59
- ### 4. تحسين لوحات المعلومات
60
- - تطوير لوحات معلومات تفاعلية وجذابة
61
- - تحسين عرض المؤشرات والإحصائيات
62
- - إضافة رسوم بيانية متقدمة
63
-
64
- ## متطلبات التكامل والاتساق
65
-
66
- ### 1. تكامل الوحدات
67
- - ضمان التكامل السلس بين جميع وحدات النظام
68
- - مشاركة البيانات بين الوحدات المختلفة
69
- - واجهة مستخدم موحدة عبر جميع الوحدات
70
-
71
- ### 2. اتساق البيانات
72
- - ضمان اتساق البيانات بين جميع أجزاء النظام
73
- - تزامن البيانات بين الوحدات المختلفة
74
- - منع تكرار البيانات وتضاربها
75
-
76
- ### 3. أداء النظام
77
- - تحسين سرعة استجابة النظام
78
- - تحسين كفاءة استخدام الموارد
79
- - تحسين تجربة المستخدم العامة
80
-
81
- ## الاعتماديات والمتطلبات الفنية
82
-
83
- يجب تحديث ملف المتطلبات ليشمل جميع المكتبات اللازمة للوحدات الجديدة والمحسنة، بما في ذلك:
84
- - مكتبات الخرائط والتحليل المكاني
85
- - مكتبات الترجمة ومعالجة اللغات
86
- - مكتبات الذكاء الاصطناعي والتعلم الآلي
87
- - مكتبات الرسوم البيانية والتصور
88
- - مكتبات واجهة المستخدم المتقدمة
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
docs/pricing_module_design.md DELETED
@@ -1,714 +0,0 @@
1
- # تصميم وحدة التسعير المتكاملة وتحليل الأسعار
2
-
3
- ## هيكل قاعدة البيانات
4
-
5
- ### جدول فئات البنود (pricing_categories)
6
- ```sql
7
- CREATE TABLE pricing_categories (
8
- id INTEGER PRIMARY KEY AUTOINCREMENT,
9
- name TEXT NOT NULL,
10
- description TEXT,
11
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
12
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
13
- );
14
- ```
15
-
16
- ### جدول وحدات القياس (measurement_units)
17
- ```sql
18
- CREATE TABLE measurement_units (
19
- id INTEGER PRIMARY KEY AUTOINCREMENT,
20
- name TEXT NOT NULL,
21
- symbol TEXT NOT NULL,
22
- description TEXT,
23
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
24
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
25
- );
26
- ```
27
-
28
- ### جدول بنود التسعير الأساسية (pricing_items_base)
29
- ```sql
30
- CREATE TABLE pricing_items_base (
31
- id INTEGER PRIMARY KEY AUTOINCREMENT,
32
- code TEXT NOT NULL,
33
- name TEXT NOT NULL,
34
- description TEXT,
35
- category_id INTEGER,
36
- unit_id INTEGER,
37
- base_price REAL NOT NULL,
38
- last_updated_date TEXT,
39
- price_source TEXT,
40
- notes TEXT,
41
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
42
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
43
- FOREIGN KEY (category_id) REFERENCES pricing_categories (id),
44
- FOREIGN KEY (unit_id) REFERENCES measurement_units (id)
45
- );
46
- ```
47
-
48
- ### جدول تاريخ أسعار البنود (pricing_items_history)
49
- ```sql
50
- CREATE TABLE pricing_items_history (
51
- id INTEGER PRIMARY KEY AUTOINCREMENT,
52
- base_item_id INTEGER,
53
- price REAL NOT NULL,
54
- price_date TEXT NOT NULL,
55
- price_source TEXT,
56
- notes TEXT,
57
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
58
- FOREIGN KEY (base_item_id) REFERENCES pricing_items_base (id)
59
- );
60
- ```
61
-
62
- ### جدول بنود التسعير للمشاريع (project_pricing_items)
63
- ```sql
64
- CREATE TABLE project_pricing_items (
65
- id INTEGER PRIMARY KEY AUTOINCREMENT,
66
- project_id INTEGER,
67
- base_item_id INTEGER,
68
- item_number TEXT NOT NULL,
69
- description TEXT NOT NULL,
70
- unit_id INTEGER,
71
- quantity REAL NOT NULL,
72
- unit_price REAL NOT NULL,
73
- total_price REAL NOT NULL,
74
- direct_cost REAL,
75
- indirect_cost REAL,
76
- profit_margin REAL,
77
- risk_factor REAL,
78
- notes TEXT,
79
- created_by INTEGER,
80
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
81
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
82
- FOREIGN KEY (project_id) REFERENCES projects (id),
83
- FOREIGN KEY (base_item_id) REFERENCES pricing_items_base (id),
84
- FOREIGN KEY (unit_id) REFERENCES measurement_units (id),
85
- FOREIGN KEY (created_by) REFERENCES users (id)
86
- );
87
- ```
88
-
89
- ### جدول مكونات بنود التسعير (pricing_item_components)
90
- ```sql
91
- CREATE TABLE pricing_item_components (
92
- id INTEGER PRIMARY KEY AUTOINCREMENT,
93
- pricing_item_id INTEGER,
94
- component_type TEXT NOT NULL, -- 'material', 'labor', 'equipment', 'subcontractor', 'other'
95
- component_name TEXT NOT NULL,
96
- unit_id INTEGER,
97
- quantity REAL NOT NULL,
98
- unit_price REAL NOT NULL,
99
- total_price REAL NOT NULL,
100
- notes TEXT,
101
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
102
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
103
- FOREIGN KEY (pricing_item_id) REFERENCES project_pricing_items (id),
104
- FOREIGN KEY (unit_id) REFERENCES measurement_units (id)
105
- );
106
- ```
107
-
108
- ### جدول عوامل التعديل (adjustment_factors)
109
- ```sql
110
- CREATE TABLE adjustment_factors (
111
- id INTEGER PRIMARY KEY AUTOINCREMENT,
112
- name TEXT NOT NULL,
113
- description TEXT,
114
- factor_type TEXT NOT NULL, -- 'inflation', 'location', 'risk', 'market', 'other'
115
- value REAL NOT NULL,
116
- start_date TEXT,
117
- end_date TEXT,
118
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
119
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
120
- );
121
- ```
122
-
123
- ### جدول نماذج التسعير (pricing_templates)
124
- ```sql
125
- CREATE TABLE pricing_templates (
126
- id INTEGER PRIMARY KEY AUTOINCREMENT,
127
- name TEXT NOT NULL,
128
- description TEXT,
129
- created_by INTEGER,
130
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
131
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
132
- FOREIGN KEY (created_by) REFERENCES users (id)
133
- );
134
- ```
135
-
136
- ### جدول بنود نماذج التسعير (pricing_template_items)
137
- ```sql
138
- CREATE TABLE pricing_template_items (
139
- id INTEGER PRIMARY KEY AUTOINCREMENT,
140
- template_id INTEGER,
141
- base_item_id INTEGER,
142
- item_number TEXT NOT NULL,
143
- description TEXT NOT NULL,
144
- unit_id INTEGER,
145
- unit_price REAL NOT NULL,
146
- notes TEXT,
147
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
148
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
149
- FOREIGN KEY (template_id) REFERENCES pricing_templates (id),
150
- FOREIGN KEY (base_item_id) REFERENCES pricing_items_base (id),
151
- FOREIGN KEY (unit_id) REFERENCES measurement_units (id)
152
- );
153
- ```
154
-
155
- ### جدول تنبؤات الأسعار (price_forecasts)
156
- ```sql
157
- CREATE TABLE price_forecasts (
158
- id INTEGER PRIMARY KEY AUTOINCREMENT,
159
- base_item_id INTEGER,
160
- forecast_date TEXT NOT NULL,
161
- forecast_price REAL NOT NULL,
162
- forecast_model TEXT,
163
- confidence_level REAL,
164
- scenario TEXT, -- 'optimistic', 'baseline', 'pessimistic'
165
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
166
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
167
- FOREIGN KEY (base_item_id) REFERENCES pricing_items_base (id)
168
- );
169
- ```
170
-
171
- ## هيكل الكلاسات
172
-
173
- ### 1. مدير التسعير (PricingManager)
174
- ```python
175
- class PricingManager:
176
- """فئة مدير التسعير الرئيسية"""
177
-
178
- def __init__(self, db_connector, config):
179
- """تهيئة مدير التسعير"""
180
- self.db = db_connector
181
- self.config = config
182
- self.item_manager = PricingItemManager(db_connector)
183
- self.cost_calculator = CostCalculator(db_connector)
184
- self.price_analyzer = PriceAnalyzer(db_connector)
185
- self.price_forecaster = PriceForecaster(db_connector)
186
- self.report_generator = PricingReportGenerator(db_connector)
187
-
188
- def initialize_database(self):
189
- """تهيئة قاعدة البيانات للتسعير"""
190
- # إنشاء الجداول إذا لم تكن موجودة
191
- pass
192
-
193
- def load_default_data(self):
194
- """تحميل البيانات الافتراضية"""
195
- # تحميل الفئات ووحدات القياس الافتراضية
196
- pass
197
-
198
- def get_project_pricing_summary(self, project_id):
199
- """الحصول على ملخص التسعير للمشروع"""
200
- pass
201
-
202
- def import_pricing_data(self, file_path, import_type):
203
- """استيراد بيانات التسعير من ملف خارجي"""
204
- pass
205
-
206
- def export_pricing_data(self, project_id, export_type, file_path):
207
- """تصدير بيانات التسعير إلى ملف خارجي"""
208
- pass
209
- ```
210
-
211
- ### 2. مدير بنود التسعير (PricingItemManager)
212
- ```python
213
- class PricingItemManager:
214
- """فئة إدارة بنود التسعير"""
215
-
216
- def __init__(self, db_connector):
217
- """تهيئة مدير بنود التسعير"""
218
- self.db = db_connector
219
-
220
- def get_all_base_items(self, filters=None):
221
- """الحصول على جميع البنود الأساسية"""
222
- pass
223
-
224
- def get_base_item_by_id(self, item_id):
225
- """الحصول على بند أساسي بواسطة المعرف"""
226
- pass
227
-
228
- def add_base_item(self, item_data):
229
- """إضافة بند أساسي جديد"""
230
- pass
231
-
232
- def update_base_item(self, item_id, item_data):
233
- """تحديث بند أساسي"""
234
- pass
235
-
236
- def delete_base_item(self, item_id):
237
- """حذف بند أساسي"""
238
- pass
239
-
240
- def get_project_items(self, project_id):
241
- """الحصول على بنود المشروع"""
242
- pass
243
-
244
- def add_project_item(self, project_id, item_data):
245
- """إضافة بند للمشروع"""
246
- pass
247
-
248
- def update_project_item(self, item_id, item_data):
249
- """تحديث بند المشروع"""
250
- pass
251
-
252
- def delete_project_item(self, item_id):
253
- """حذف بند المشروع"""
254
- pass
255
-
256
- def get_item_components(self, item_id):
257
- """الحصول على مكونات البند"""
258
- pass
259
-
260
- def add_item_component(self, item_id, component_data):
261
- """إضافة مكون للبند"""
262
- pass
263
-
264
- def update_item_component(self, component_id, component_data):
265
- """تحديث مكون البند"""
266
- pass
267
-
268
- def delete_item_component(self, component_id):
269
- """حذف مكون البند"""
270
- pass
271
-
272
- def get_categories(self):
273
- """الحصول على فئات البنود"""
274
- pass
275
-
276
- def get_measurement_units(self):
277
- """الحصول على وحدات القياس"""
278
- pass
279
-
280
- def get_templates(self):
281
- """الحصول على نماذج التسعير"""
282
- pass
283
-
284
- def get_template_items(self, template_id):
285
- """الحصول على بنود النموذج"""
286
- pass
287
-
288
- def apply_template_to_project(self, project_id, template_id):
289
- """تطبيق نموذج على مشروع"""
290
- pass
291
- ```
292
-
293
- ### 3. حاسبة التكاليف (CostCalculator)
294
- ```python
295
- class CostCalculator:
296
- """فئة حساب التكاليف"""
297
-
298
- def __init__(self, db_connector):
299
- """تهيئة حاسبة التكاليف"""
300
- self.db = db_connector
301
-
302
- def calculate_direct_costs(self, project_id):
303
- """حساب التكاليف المباشرة"""
304
- pass
305
-
306
- def calculate_indirect_costs(self, project_id, indirect_cost_percentage):
307
- """حساب التكاليف غير المباشرة"""
308
- pass
309
-
310
- def calculate_profit_margin(self, project_id, profit_percentage):
311
- """حساب هامش الربح"""
312
- pass
313
-
314
- def calculate_risk_contingency(self, project_id, risk_factors):
315
- """حساب احتياطي المخاطر"""
316
- pass
317
-
318
- def calculate_taxes_and_fees(self, project_id, tax_rates):
319
- """حساب الضرائب والرسوم"""
320
- pass
321
-
322
- def calculate_total_cost(self, project_id):
323
- """حساب التكلفة الإجمالية"""
324
- pass
325
-
326
- def calculate_unit_rates(self, project_id):
327
- """حساب معدلات الوحدات"""
328
- pass
329
-
330
- def apply_adjustment_factors(self, project_id, factors):
331
- """تطبيق عوامل التعديل"""
332
- pass
333
-
334
- def calculate_cost_breakdown(self, project_id):
335
- """حساب تفصيل التكاليف"""
336
- pass
337
- ```
338
-
339
- ### 4. محلل الأسعار (PriceAnalyzer)
340
- ```python
341
- class PriceAnalyzer:
342
- """فئة تحليل الأسعار"""
343
-
344
- def __init__(self, db_connector):
345
- """تهيئة محلل الأسعار"""
346
- self.db = db_connector
347
-
348
- def get_price_history(self, item_id):
349
- """الحصول على تاريخ الأسعار"""
350
- pass
351
-
352
- def analyze_price_trends(self, item_id, start_date, end_date):
353
- """تحليل اتجاهات الأسعار"""
354
- pass
355
-
356
- def compare_prices(self, items, date=None):
357
- """مقارنة الأسعار"""
358
- pass
359
-
360
- def calculate_price_volatility(self, item_id, period):
361
- """حساب تقلب الأسعار"""
362
- pass
363
-
364
- def perform_sensitivity_analysis(self, project_id, variable_items, ranges):
365
- """إجراء تحليل الحساسية"""
366
- pass
367
-
368
- def analyze_price_correlations(self, items):
369
- """تحليل ارتباطات الأسعار"""
370
- pass
371
-
372
- def compare_with_market_prices(self, items):
373
- """مقارنة مع أسعار السوق"""
374
- pass
375
-
376
- def analyze_cost_drivers(self, project_id):
377
- """تحليل محركات التكلفة"""
378
- pass
379
-
380
- def generate_price_analysis_charts(self, analysis_type, params):
381
- """إنشاء رسوم بيانية لتحليل الأسعار"""
382
- pass
383
- ```
384
-
385
- ### 5. متنبئ الأسعار (PriceForecaster)
386
- ```python
387
- class PriceForecaster:
388
- """فئة التنبؤ بالأسعار"""
389
-
390
- def __init__(self, db_connector):
391
- """تهيئة متنبئ الأسعار"""
392
- self.db = db_connector
393
-
394
- def forecast_price(self, item_id, forecast_date, model_type='arima'):
395
- """التنبؤ بالسعر"""
396
- pass
397
-
398
- def generate_price_scenarios(self, item_id, forecast_date):
399
- """إنشاء سيناريوهات الأسعار"""
400
- pass
401
-
402
- def calculate_inflation_impact(self, project_id, inflation_rate, duration):
403
- """حساب تأثير التضخم"""
404
- pass
405
-
406
- def forecast_project_costs(self, project_id, forecast_date):
407
- """التنبؤ بتكاليف المشروع"""
408
- pass
409
-
410
- def evaluate_forecast_accuracy(self, item_id):
411
- """تقييم دقة التنبؤ"""
412
- pass
413
-
414
- def generate_forecast_charts(self, item_id, forecast_date):
415
- """إنشاء رسوم بيانية للتنبؤ"""
416
- pass
417
- ```
418
-
419
- ### 6. مولد تقارير التسعير (PricingReportGenerator)
420
- ```python
421
- class PricingReportGenerator:
422
- """فئة إنشاء تقارير التسعير"""
423
-
424
- def __init__(self, db_connector):
425
- """تهيئة مولد تقارير التسعير"""
426
- self.db = db_connector
427
-
428
- def generate_cost_summary_report(self, project_id):
429
- """إنشاء تقرير ملخص التكاليف"""
430
- pass
431
-
432
- def generate_detailed_items_report(self, project_id):
433
- """إنشاء تقرير تفصيلي للبنود"""
434
- pass
435
-
436
- def generate_price_comparison_report(self, items, parameters):
437
- """إنشاء تقرير مقارنة الأسعار"""
438
- pass
439
-
440
- def generate_sensitivity_analysis_report(self, project_id, parameters):
441
- """إنشاء تقرير تحليل الحساسية"""
442
- pass
443
-
444
- def generate_price_forecast_report(self, items, forecast_date):
445
- """إنشاء تقرير التنبؤ بالأسعار"""
446
- pass
447
-
448
- def generate_price_risk_report(self, project_id):
449
- """إنشاء تقرير مخاطر الأسعار"""
450
- pass
451
-
452
- def export_report_to_pdf(self, report_data, file_path):
453
- """تصدير التقرير إلى PDF"""
454
- pass
455
-
456
- def export_report_to_excel(self, report_data, file_path):
457
- """تصدير التقرير إلى Excel"""
458
- pass
459
- ```
460
-
461
- ## تصميم واجهة المستخدم
462
-
463
- ### 1. الشاشة الرئيسية لوحدة التسعير
464
-
465
- ```
466
- +--------------------------------------------------+
467
- | وحدة التسعير |
468
- +--------------------------------------------------+
469
- | |
470
- | +----------------+ +----------------------+ |
471
- | | المناقصات | | إحصائيات التسعير | |
472
- | | الحالية | | | |
473
- | | | | | |
474
- | | | | | |
475
- | | | | | |
476
- | +----------------+ +----------------------+ |
477
- | |
478
- | +----------------+ +----------------------+ |
479
- | | الوصول | | آخر التحديثات | |
480
- | | السريع | | | |
481
- | | | | | |
482
- | | | | | |
483
- | | | | | |
484
- | +----------------+ +----------------------+ |
485
- | |
486
- +--------------------------------------------------+
487
- ```
488
-
489
- ### 2. شاشة إدارة بنود التسعير
490
-
491
- ```
492
- +--------------------------------------------------+
493
- | إدارة بنود التسعير |
494
- +--------------------------------------------------+
495
- | بحث: [ ] [تصفية▼] [تصدير] |
496
- +--------------------------------------------------+
497
- | # | الكود | الوصف | الوحدة | الكمية | السعر | المجموع |
498
- +--------------------------------------------------+
499
- | 1 | | | | | | |
500
- | 2 | | | | | | |
501
- | 3 | | | | | | |
502
- | 4 | | | | | | |
503
- | 5 | | | | | | |
504
- +--------------------------------------------------+
505
- | [إضافة بند] [حذف المحدد] [استيراد من Excel] |
506
- +--------------------------------------------------+
507
- | المجموع الكلي: |
508
- +--------------------------------------------------+
509
- ```
510
-
511
- ### 3. شاشة تفاصيل البند
512
-
513
- ```
514
- +--------------------------------------------------+
515
- | تفاصيل البند |
516
- +--------------------------------------------------+
517
- | الكود: [ ] الوصف: [ ] |
518
- | الفئة: [ ▼] الوحدة: [ ▼] |
519
- +--------------------------------------------------+
520
- | مكونات البند: |
521
- +--------------------------------------------------+
522
- | النوع | الوصف | الوحدة | الكمية | السعر | المجموع |
523
- +--------------------------------------------------+
524
- | مواد | | | | | |
525
- | عمالة | | | | | |
526
- | معدات | | | | | |
527
- | أخرى | | | | | |
528
- +--------------------------------------------------+
529
- | [إضافة مكون] [حذف المحدد] |
530
- +--------------------------------------------------+
531
- | التكلفة المباشرة: |
532
- | التكلفة غير المباشرة: |
533
- | هامش الربح: |
534
- | احتياطي المخاطر: |
535
- | السعر النهائي: |
536
- +--------------------------------------------------+
537
- | [حفظ] [إلغاء] |
538
- +--------------------------------------------------+
539
- ```
540
-
541
- ### 4. شاشة تحليل الأسعار
542
-
543
- ```
544
- +--------------------------------------------------+
545
- | تحليل الأسعار |
546
- +--------------------------------------------------+
547
- | [اختيار البند▼] [الفترة الزمنية▼] [تحليل] |
548
- +--------------------------------------------------+
549
- | |
550
- | |
551
- | |
552
- | (رسم بياني للأسعار) |
553
- | |
554
- | |
555
- | |
556
- +--------------------------------------------------+
557
- | إحصائيات: |
558
- | - متوسط السعر: |
559
- | - أعلى سعر: |
560
- | - أدنى سعر: |
561
- | - معدل التغير: |
562
- | - التقلب: |
563
- +--------------------------------------------------+
564
- | [مقارنة مع بنود أخرى] [تصدير التحليل] |
565
- +--------------------------------------------------+
566
- ```
567
-
568
- ### 5. ش��شة التنبؤ بالأسعار
569
-
570
- ```
571
- +--------------------------------------------------+
572
- | التنبؤ بالأسعار |
573
- +--------------------------------------------------+
574
- | [اختيار البند▼] [تاريخ التنبؤ] [نموذج التنبؤ▼] |
575
- +--------------------------------------------------+
576
- | |
577
- | |
578
- | |
579
- | (رسم بياني للتنبؤ بالأسعار) |
580
- | |
581
- | |
582
- | |
583
- +--------------------------------------------------+
584
- | السيناريوهات: |
585
- | - متفائل: |
586
- | - متوسط: |
587
- | - متشائم: |
588
- +--------------------------------------------------+
589
- | عوامل التأثير: |
590
- | - التضخم: |
591
- | - تغيرات السوق: |
592
- | - العوامل الموسمية: |
593
- +--------------------------------------------------+
594
- | [تطبيق على المشروع] [تصدير التنبؤ] |
595
- +--------------------------------------------------+
596
- ```
597
-
598
- ### 6. شاشة تحليل الحساسية
599
-
600
- ```
601
- +--------------------------------------------------+
602
- | تحليل الحساسية |
603
- +--------------------------------------------------+
604
- | المشروع: [ ▼] |
605
- +--------------------------------------------------+
606
- | المتغيرات: |
607
- | [✓] أسعار المواد الخام (±20%) |
608
- | [✓] تكلفة العمالة (±15%) |
609
- | [✓] تكلفة المعدات (±10%) |
610
- | [ ] المصاريف العامة (±5%) |
611
- +--------------------------------------------------+
612
- | |
613
- | |
614
- | (رسم بياني لتحليل الحساسية) |
615
- | |
616
- | |
617
- | |
618
- +--------------------------------------------------+
619
- | النتائج: |
620
- | - أكثر العوامل تأثيراً: |
621
- | - نطاق التغير المتوقع: |
622
- | - توصيات: |
623
- +--------------------------------------------------+
624
- | [تحديث التحليل] [تصدير النتائج] |
625
- +--------------------------------------------------+
626
- ```
627
-
628
- ### 7. شاشة التقارير
629
-
630
- ```
631
- +--------------------------------------------------+
632
- | التقارير |
633
- +--------------------------------------------------+
634
- | [نوع التقرير▼] [المشروع▼] [إنشاء تقرير] |
635
- +--------------------------------------------------+
636
- | التقارير المتاحة: |
637
- | |
638
- | ○ ملخص التكاليف |
639
- | ○ تفصيل البنود |
640
- | ○ مقارنة الأسعار |
641
- | ○ تحليل الحساسية |
642
- | ○ التنبؤ بالأسعار |
643
- | ○ مخاطر الأسعار |
644
- | |
645
- +--------------------------------------------------+
646
- | خيارات التقرير: |
647
- | |
648
- | [✓] تضمين الرسوم البيانية |
649
- | [✓] تضمين التوصيات |
650
- | [ ] تضمين البيانات التفصيلية |
651
- | |
652
- +--------------------------------------------------+
653
- | [PDF] [Excel] [طباعة] |
654
- +--------------------------------------------------+
655
- ```
656
-
657
- ## تكامل النظام
658
-
659
- ### 1. تكامل مع وحدة تحليل المستندات
660
- - استخراج بنود التسعير من وثائق المناقصة
661
- - تحديد الكميات والمواصفات من المستندات
662
- - مقارنة البنود المستخرجة مع قاعدة البيانات
663
-
664
- ### 2. تكامل مع وحدة تحليل المخاطر
665
- - ��حديد المخاطر المرتبطة بالتسعير
666
- - تقييم تأثير المخاطر على التكاليف
667
- - تحديد احتياطي المخاطر المناسب
668
-
669
- ### 3. تكامل مع وحدة إدارة المشاريع
670
- - متابعة التكاليف الفعلية مقابل المخططة
671
- - تحديث التنبؤات بناءً على بيانات المشروع الفعلية
672
- - تحليل انحرافات التكاليف
673
-
674
- ### 4. تكامل مع وحدة التقارير
675
- - إنشاء تقارير متكاملة تشمل بيانات التسعير
676
- - دمج تحليلات التسعير في تقارير المشروع
677
- - توفير لوحات معلومات متكاملة
678
-
679
- ## خطة التنفيذ التفصيلية
680
-
681
- ### المرحلة 1: إعداد البنية التحتية (3 أيام)
682
- - تصميم وإنشاء جداول قاعدة البيانات
683
- - إعداد هيكل الملفات والمجلدات
684
- - تهيئة البيئة التطويرية
685
-
686
- ### المرحلة 2: تنفيذ الوظائف الأساسية (5 أيام)
687
- - تنفيذ فئة مدير التسعير
688
- - تنفيذ فئة مدير بنود التسعير
689
- - تنفيذ فئة حاسبة التكاليف
690
- - إنشاء واجهات المستخدم الأساسية
691
-
692
- ### المرحلة 3: تنفيذ وظائف التحليل (7 أيام)
693
- - تنفيذ فئة محلل الأسعار
694
- - تنفيذ فئة متنبئ الأسعار
695
- - إنشاء الرسوم البيانية والتحليلات
696
- - تنفيذ واجهات المستخدم للتحليل
697
-
698
- ### المرحلة 4: تنفيذ التقارير والتكامل (5 أيام)
699
- - تنفيذ فئة مولد تقارير التسعير
700
- - تكامل مع الوحدات الأخرى
701
- - إنشاء واجهات المستخدم للتقارير
702
- - اختبار التكامل
703
-
704
- ### المرحلة 5: الاختبار والتحسين (3 أيام)
705
- - اختبار جميع الوظائف
706
- - تحسين الأداء
707
- - إصلاح الأخطاء
708
- - تحسين واجهة المستخدم
709
-
710
- ### المرحلة 6: التوثيق والتسليم (2 أيام)
711
- - إعداد وثائق المستخدم
712
- - إعداد وثائق المطور
713
- - تجهيز النسخة النهائية
714
- - تسليم النظام
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
docs/pricing_module_requirements.md DELETED
@@ -1,155 +0,0 @@
1
- # متطلبات وحدة التسعير المتكاملة وتحليل الأسعار
2
-
3
- ## الهدف
4
- تطوير وحدة متكاملة للتسعير وتحليل الأسعار في نظام إدارة المناقصات لتمكين المستخدمين من إدارة عمليات التسعير بشكل أكثر دقة وفعالية، وتوفير أدوات تحليلية متقدمة لاتخاذ قرارات أفضل.
5
-
6
- ## المتطلبات الوظيفية
7
-
8
- ### 1. إدارة بنود التسعير
9
- - إنشاء وتحرير وحذف بنود التسعير
10
- - تصنيف البنود حسب الفئات (مواد، عمالة، معدات، مصاريف عامة)
11
- - دعم الوحدات المختلفة (متر مربع، متر مكعب، عدد، طن، إلخ)
12
- - إمكانية استيراد بنود التسعير من ملفات Excel
13
- - إمكانية تصدير بنود التسعير إلى ملفات Excel
14
-
15
- ### 2. حساب التكاليف
16
- - حساب تكلفة المواد المباشرة
17
- - حساب تكلفة العمالة المباشرة
18
- - حساب تكلفة المعدات
19
- - حساب المصاريف العامة والإدارية
20
- - حساب هامش الربح
21
- - حساب الضرائب والرسوم
22
-
23
- ### 3. تحليل الأسعار
24
- - مقارنة الأسعار التاريخية للبنود
25
- - تحليل تغيرات الأسعار عبر الزمن
26
- - تحليل حساسية الأسعار للمتغيرات المختلفة
27
- - تحليل المخاطر المرتبطة بتغيرات الأسعار
28
- - مقارنة الأسعار مع أسعار السوق
29
- - تحليل تأثير تغير أسعار المواد الخام على التكلفة الإجمالية
30
-
31
- ### 4. التنبؤ بالأسعار
32
- - التنبؤ بتغيرات الأسعار المستقبلية
33
- - حساب معدلات التضخم المتوقعة
34
- - تقدير تأثير العوامل الاقتصادية على الأسعار
35
- - إنشاء سيناريوهات مختلفة للأسعار (متفائل، متوسط، متشائم)
36
-
37
- ### 5. تقارير التسعير
38
- - تقرير ملخص التكاليف
39
- - تقرير تفصيلي للبنود
40
- - تقرير مقارنة الأسعار
41
- - تقرير تحليل الحساسية
42
- - تقرير التنبؤ بالأسعار
43
- - تقرير المخاطر المرتبطة بالأسعار
44
-
45
- ### 6. لوحة معلومات التسعير
46
- - عرض مؤشرات الأداء الرئيسية للتسعير
47
- - عرض الرسوم البيانية لتحليل الأسعار
48
- - عرض تنبيهات لتغيرات الأسعار الكبيرة
49
- - عرض مقارنات مع المناقصات السابقة
50
-
51
- ## المتطلبات غير الوظيفية
52
-
53
- ### 1. الأداء
54
- - سرعة استجابة عالية عند التعامل مع كميات كبيرة من البيانات
55
- - قدرة على معالجة آلاف البنود في المناقصة الواحدة
56
-
57
- ### 2. قابلية الاستخدام
58
- - واجهة مستخدم بديهية وسهلة الاستخدام
59
- - إمكانية تخصيص العرض حسب احتياجات المستخدم
60
- - توفير أدوات مساعدة وشروحات للمستخدمين
61
-
62
- ### 3. التكامل
63
- - تكامل مع وحدة تحليل المستندات لاستخراج بنود التسعير من وثائق المناقصة
64
- - تكامل مع وحدة تحليل المخاطر لتقييم مخاطر التسعير
65
- - تكامل مع وحدة إدارة المشاريع لمتابعة التكاليف الفعلية مقابل المخططة
66
-
67
- ### 4. الأمان
68
- - تحديد صلاحيات الوصول لبيانات التسعير
69
- - تسجيل جميع التغييرات على بيانات التسعير
70
- - حماية البيانات الحساسة المتعلقة بالتسعير
71
-
72
- ## التقنيات المقترحة
73
-
74
- ### 1. تخزين البيانات
75
- - استخدام قاعدة بيانات SQLite لتخزين بيانات التسعير
76
- - تصميم جداول مناسبة لتخزين البنود والتكاليف والأسعار التاريخية
77
-
78
- ### 2. تحليل البيانات
79
- - استخدام مكتبة Pandas لمعالجة وتحليل بيانات الأسعار
80
- - استخدام مكتبة NumPy للعمليات الحسابية المتقدمة
81
- - استخدام مكتبة SciPy للتحليل الإحصائي
82
-
83
- ### 3. التنبؤ بالأسعار
84
- - استخدام مكتبة Statsmodels للنماذج الإحصائية
85
- - استخدام مكتبة Prophet للتنبؤ بالسلاسل الزمنية
86
- - استخدام مكتبة scikit-learn لنماذج التعلم الآلي
87
-
88
- ### 4. العرض المرئي
89
- - استخدام مكتبة Matplotlib لإنشاء الرسوم البيانية الأساسية
90
- - استخدام مكتبة Seaborn للرسوم البيانية الإحصائية المتقدمة
91
- - استخدام مكتبة Plotly للرسوم البيانية التفاعلية
92
-
93
- ## الواجهة المقترح��
94
-
95
- ### 1. الشاشة الرئيسية لوحدة التسعير
96
- - قائمة بالمناقصات الحالية
97
- - ملخص لإحصائيات التسعير
98
- - الوصول السريع للوظائف الشائعة
99
-
100
- ### 2. شاشة إدارة بنود التسعير
101
- - جدول لعرض وتحرير البنود
102
- - أدوات للتصفية والبحث
103
- - أزرار للإضافة والحذف والاستيراد والتصدير
104
-
105
- ### 3. شاشة حساب التكاليف
106
- - نموذج لإدخال معلومات التكاليف
107
- - عرض ملخص للتكاليف حسب الفئات
108
- - حاسبة تفاعلية للتكاليف
109
-
110
- ### 4. شاشة تحليل الأسعار
111
- - رسوم بيانية لتحليل الأسعار
112
- - أدوات للمقارنة والتحليل
113
- - خيارات لتخصيص التحليل
114
-
115
- ### 5. شاشة التنبؤ بالأسعار
116
- - نماذج للتنبؤ بالأسعار
117
- - عرض السيناريوهات المختلفة
118
- - تحليل الحساسية للمتغيرات
119
-
120
- ### 6. شاشة تقارير التسعير
121
- - قائمة بالتقارير المتاحة
122
- - خيارات لتخصيص التقارير
123
- - أدوات لتصدير التقارير
124
-
125
- ## خطة التنفيذ
126
-
127
- ### المرحلة 1: تصميم قاعدة البيانات وهيكل الوحدة
128
- - تصميم جداول قاعدة البيانات
129
- - تصميم هيكل الكلاسات والوظائف
130
- - تصميم واجهة المستخدم
131
-
132
- ### المرحلة 2: تنفيذ إدارة بنود التسعير وحساب التكاليف
133
- - تنفيذ وظائف إدارة البنود
134
- - تنفيذ وظائف حساب التكاليف
135
- - تنفيذ واجهة المستخدم لهذه الوظائف
136
-
137
- ### المرحلة 3: تنفيذ تحليل الأسعار والتنبؤ
138
- - تنفيذ وظائف تحليل الأسعار
139
- - تنفيذ وظائف التنبؤ بالأسعار
140
- - تنفيذ واجهة المستخدم لهذه الوظائف
141
-
142
- ### المرحلة 4: تنفيذ التقارير ولوحة المعلومات
143
- - تنفيذ وظائف إنشاء التقارير
144
- - تنفيذ لوحة معلومات التسعير
145
- - تنفيذ واجهة المستخدم لهذه الوظائف
146
-
147
- ### المرحلة 5: التكامل والاختبار
148
- - تكامل الوحدة مع النظام الحالي
149
- - اختبار الوظائف والأداء
150
- - تصحيح الأخطاء وتحسين الأداء
151
-
152
- ### المرحلة 6: التوثيق والتسليم
153
- - توثيق الوحدة وكيفية استخدامها
154
- - إعداد أمثلة ودروس تعليمية
155
- - تسليم الوحدة للمستخدم النهائي
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
docs/technical_docs.md DELETED
@@ -1,165 +0,0 @@
1
- # التوثيق التقني
2
- ## نظام تحليل العقود والمناقصات بالذكاء الاصطناعي - شركة شبه الجزيرة للمقاولات
3
-
4
- <p align="center">
5
- <img src="../static/images/logo.png" alt="شعار النظام" width="200"/>
6
- <br>
7
- <em>إصدار التوثيق: 1.0.2 - تاريخ التحديث: 2025/03/01</em>
8
- </p>
9
-
10
- ## جدول المحتويات
11
-
12
- 1. [نظرة عامة](#نظرة-عامة)
13
- 2. [المعمارية التقنية](#المعمارية-التقنية)
14
- 3. [متطلبات النظام](#متطلبات-النظام)
15
- 4. [الإعداد والتثبيت](#الإعداد-والتثبيت)
16
- 5. [بيئة Hybrid Face](#بيئة-hybrid-face)
17
- 6. [هيكل قاعدة البيانات](#هيكل-قاعدة-البيانات)
18
- 7. [وحدات النظام](#وحدات-النظام)
19
- 8. [واجهات برمجة التطبيقات (APIs)](#واجهات-برمجة-التطبيقات-apis)
20
- 9. [الأمان والمصادقة](#الأمان-والمصادقة)
21
- 10. [الأداء وقابلية التوسع](#الأداء-وقابلية-التوسع)
22
- 11. [استراتيجية النسخ الاحتياطي واستعادة البيانات](#استراتيجية-النسخ-الاحتياطي-واستعادة-البيانات)
23
- 12. [إرشادات التطوير](#إرشادات-التطوير)
24
- 13. [اختبار النظام](#اختبار-النظام)
25
- 14. [التكامل مع الأنظمة الخارجية](#التكامل-مع-الأنظمة-الخارجية)
26
- 15. [سجل التغييرات](#سجل-التغييرات)
27
-
28
- ## نظرة عامة
29
-
30
- ### عن النظام
31
-
32
- نظام تحليل العقود والمناقصات بالذكاء الاصطناعي هو منصة متكاملة تعتمد على تقنيات الذكاء الاصطناعي ومعالجة اللغة العربية الطبيعية لمساعدة شركة شبه الجزيرة للمقاولات في تحليل وتسعير المناقصات وإدارة المشاريع.
33
-
34
- ### المكونات الرئيسية
35
-
36
- 1. **واجهة المستخدم (Frontend)**: تطبيق ويب تفاعلي مبني بواسطة Streamlit
37
- 2. **خدمات الخلفية (Backend)**: مجموعة من الخدمات والوحدات البرمجية بلغة Python
38
- 3. **قاعدة البيانات**: SQLite للتطوير والنشر المحلي، MySQL للنشر المؤسسي
39
- 4. **محركات الذكاء الاصطناعي**: نماذج معالجة اللغة الطبيعية والتعلم الآلي
40
- 5. **خدمات التكامل**: واجهات برمجة للتكامل مع الأنظمة الخارجية
41
-
42
- ## المعمارية التقنية
43
-
44
- ### المخطط العام للنظام
45
-
46
- ```mermaid
47
- graph TD
48
- User[المستخدم] --> UI[واجهة المستخدم Streamlit]
49
- UI --> API[طبقة API]
50
- API --> Core[النواة]
51
- Core --> DB[(قاعدة البيانات)]
52
- Core --> NLP[معالجة اللغة العربية]
53
- Core --> ML[نماذج التعلم الآلي]
54
- Core --> FS[نظام الملفات]
55
- Core --> External[أنظمة خارجية]
56
-
57
- subgraph Core Modules
58
- NLP
59
- ML
60
- Doc[تحليل المستندات]
61
- Pricing[التسعير]
62
- Risk[تحليل المخاطر]
63
- Res[إدارة الموارد]
64
- Proj[إدارة المشاريع]
65
- Rep[التقارير]
66
- end
67
- ```
68
-
69
- ### نمط المعمارية
70
-
71
- النظام يعتمد على نمط المعمارية طبقية (Layered Architecture) ونمط وحدات الخدمة (Service Modules):
72
-
73
- 1. **طبقة العرض**: واجهة المستخدم Streamlit
74
- 2. **طبقة الخدمات**: واجهات برمجة التطبيقات RESTful
75
- 3. **طبقة الأعمال**: وحدات المعالجة المنطقية
76
- 4. **طبقة البيانات**: الوصول إلى قاعدة البيانات وتخزين الملفات
77
-
78
- ## متطلبات النظام
79
-
80
- ### متطلبات الأجهزة
81
-
82
- | المكون | الحد الأدنى | الموصى به |
83
- |--------|-------------|-----------|
84
- | المعالج | Intel Core i5 (8 أنوية) | Intel Core i7 (12 أنوية) أو أعلى |
85
- | الذاكرة | 16GB RAM | 32GB RAM أو أكثر |
86
- | التخزين | 10GB + مساحة للمستندات | SSD بسعة 50GB أو أكثر |
87
- | الشبكة | اتصال إنترنت 10Mbps | اتصال إنترنت 50Mbps أو أسرع |
88
- | الشاشة | دقة 1080p | دقة 1440p أو أعلى |
89
-
90
- ### متطلبات البرمجيات
91
-
92
- | البرمجيات | الإصدار المطلوب |
93
- |-----------|-----------------|
94
- | نظام التشغيل | Windows 10/11، MacOS 12+، Ubuntu 20.04+ |
95
- | Python | 3.9 أو أحدث |
96
- | بيئة Hybrid Face | 2.5 أو أحدث |
97
- | متصفح | Chrome 90+، Firefox 88+، Edge 90+ |
98
- | MySQL (اختياري) | 8.0 أو أحدث |
99
-
100
- ### المكتبات الأس��سية
101
-
102
- ```python
103
- # المكتبات الأساسية المستخدمة
104
- streamlit==1.10.0
105
- pandas==1.5.0
106
- numpy==1.23.0
107
- scikit-learn==1.1.0
108
- nltk==3.7.0
109
- spacy==3.4.0
110
- transformers==4.20.0
111
- pyarabic==0.6.15
112
- sqlalchemy==1.4.40
113
- plotly==5.9.0
114
- pymysql==1.0.2
115
- pdfplumber==0.7.0
116
- python-docx==0.8.11
117
- openpyxl==3.0.10
118
- ezdxf==0.17.2
119
- ```
120
-
121
- ## الإعداد والتثبيت
122
-
123
- ### إعداد بيئة التطوير
124
-
125
- ```bash
126
- # إنشاء بيئة Python افتراضية
127
- python -m venv venv
128
- source venv/bin/activate # Linux/MacOS
129
- venv\Scripts\activate # Windows
130
-
131
- # تثبيت المكتبات المطلوبة
132
- pip install -r requirements.txt
133
- pip install -r arabic_support_requirements.txt
134
- ```
135
-
136
- ### تثبيت نماذج معالجة اللغة العربية
137
-
138
- ```bash
139
- # تثبيت نموذج اللغة العربية لـ SpaCy
140
- python -m spacy download ar_core_news_lg
141
-
142
- # تحميل موارد NLTK للغة العربية
143
- python -m nltk.downloader stopwords
144
- python -m nltk.downloader punkt
145
- python -m nltk.downloader wordnet
146
- ```
147
-
148
- ### إعداد قاعدة البيانات
149
-
150
- #### SQLite (للتطوير المحلي)
151
-
152
- ```bash
153
- # إنشاء قاعدة بيانات SQLite
154
- python setup_db.py --mode=local
155
- ```
156
-
157
- #### MySQL (للنشر المؤسسي)
158
-
159
- ```bash
160
- # إعداد قاعدة بيانات MySQL
161
- python setup_db.py --mode=enterprise \
162
- --db-host=YOUR_DB_HOST \
163
- --db-user=YOUR_DB_USER \
164
- --db-pass=YOUR_DB_PASS \
165
- --db-name=tender_analysis_system
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
docs/user_manual.md DELETED
@@ -1,594 +0,0 @@
1
- # دليل المستخدم
2
- ## نظام تحليل العقود والمناقصات بالذكاء الاصطناعي - شركة شبه الجزيرة للمقاولات
3
-
4
- <p align="center">
5
- <img src="../static/images/logo.png" alt="شعار النظام" width="200"/>
6
- <br>
7
- <em>الإصدار 2.0.0</em>
8
- </p>
9
-
10
- ## جدول المحتويات
11
-
12
- 1. [مقدمة](#مقدمة)
13
- 2. [بدء الاستخدام](#بدء-الاستخدام)
14
- 3. [الواجهة الرئيسية](#الواجهة-الرئيسية)
15
- 4. [إدارة المناقصات والعقود](#إدارة-المناقصات-والعقود)
16
- 5. [تحليل المستندات](#تحليل-المستندات)
17
- 6. [نظام التسعير الشامل](#نظام-التسعير-الشامل)
18
- 7. [حاسبة تكاليف البناء](#حاسبة-تكاليف-البناء)
19
- 8. [إدارة الموارد والتكاليف](#إدارة-الموارد-والتكاليف)
20
- 9. [تحليل المخاطر](#تحليل-المخاطر)
21
- 10. [إدارة المشاريع المرساة](#إدارة-المشاريع-المرساة)
22
- 11. [الخرائط والمواقع](#الخرائط-والمواقع)
23
- 12. [الإشعارات الذكية](#الإشعارات-الذكية)
24
- 13. [الجدول الزمني التفاعلي](#الجدول-الزمني-التفاعلي)
25
- 14. [مساعد الذكاء الاصطناعي](#مساعد-الذكاء-الاصطناعي)
26
- 15. [مقارنة المستندات](#مقارنة-المستندات)
27
- 16. [التقارير والتحليلات](#التقارير-والتحليلات)
28
- 17. [إعدادات النظام](#إعدادات-النظام)
29
- 18. [الأسئلة الشائعة](#الأسئلة-الشائعة)
30
- 19. [استكشاف الأخطاء وإصلاحها](#استكشاف-الأخطاء-وإصلاحها)
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
- 1. افتح تطبيق نظام تحليل العقود والمناقصات
58
- 2. أدخل اسم المستخدم وكلمة المرور
59
- 3. انقر على زر "تسجيل الدخول"
60
-
61
- ![شاشة تسجيل الدخول](../static/images/screenshots/login.png)
62
-
63
- ### الصلاحيات ومستويات الوصول
64
-
65
- النظام يدعم عدة مستويات من الصلاحيات:
66
-
67
- | المستوى | الوصف | الصلاحيات |
68
- |---------|-------|-----------|
69
- | مدير النظام | المسؤول الرئيسي عن النظام | كامل الصلاحيات |
70
- | مدير المناقصات | مسؤول عن إدارة المناقصات | إضافة وتعديل وحذف المناقصات، التسعير |
71
- | محلل عقود | مختص بتحليل العقود والمستندات | قراءة وتحليل المستندات |
72
- | محاسب | مسؤول عن الجوانب المالية | الوصول للتكاليف والتسعير |
73
- | مستخدم عادي | مستخدم بصلاحيات محدودة | عرض المناقصات والتقارير فقط |
74
-
75
- ## الواجهة الرئيسية
76
-
77
- ### مكونات الواجهة
78
-
79
- ![الواجهة الرئيسية](../static/images/screenshots/dashboard.png)
80
-
81
- 1. **شريط القوائم**: للوصول إلى الوظائف الرئيسية
82
- 2. **لوحة المعلومات**: عرض ملخص للمناقصات والمشاريع
83
- 3. **المناقصات النشطة**: قائمة بالمناقصات قيد الدراسة
84
- 4. **المواعيد الهامة**: تنبيهات بالمواعيد النهائية
85
- 5. **المؤشرات الرئيسية**: إحصائيات ومؤشرات أداء رئيسية
86
- 6. **معلومات الشركة**: بيان "هذا النظام يعمل لصالح شركة شبه الجزيرة للمقاولات، جميع الحقوق محفوظة 2025"
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
- 1. انقر على "المناقصات والعقود" من شريط القوائم
112
- 2. اختر "إضافة مناقصة جديدة"
113
- 3. املأ النموذج بالمعلومات المطلوبة:
114
- - اسم المناقصة
115
- - الجهة المالكة
116
- - رقم المناقصة
117
- - تاريخ الطرح
118
- - تاريخ الإقفال
119
- - موقع المشروع
120
- - نوع المشروع
121
-
122
- ![إضافة مناقصة](../static/images/screenshots/add_tender.png)
123
-
124
- ### رفع المستندات
125
-
126
- 1. من صفحة تفاصيل المناقصة، انقر على "رفع مستند"
127
- 2. اختر نوع المستند:
128
- - كراسة شروط
129
- - جدول كميات
130
- - مخططات
131
- - عقد
132
- - ملحق
133
- 3. انقر على "استعراض" واختر الملف من جهازك
134
- 4. يدعم النظام صيغ المستندات التالية: PDF, DOCX, XLSX, DWG
135
- 5. **جديد**: يمكنك الآن رفع صور موقع المشروع ومقاطع الفيديو ومعلومات المزايا/المخاطر واستفسارات المالك
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
- 1. من صفحة تفاصيل المناقصة، اختر المستند المراد تحليله
162
- 2. انقر على زر "تحليل المستند"
163
- 3. اختر نوع التحليل:
164
- - تحليل كامل
165
- - استخراج البنود والشروط
166
- - تحديد المخاطر
167
- - استخراج معلومات التسعير
168
-
169
- ![تحليل المستندات](../static/images/screenshots/document_analysis.png)
170
-
171
- ### مراجعة نتائج التحليل
172
-
173
- بعد اكتمال التحليل، يعرض النظام:
174
-
175
- 1. **البنود المستخرجة**: قائمة بالبنود والشروط المهمة مرتبة حسب أهميتها
176
- 2. **المخاطر المحددة**: المخاطر المحتملة مصنفة حسب نوعها وأهميتها
177
- 3. **المتطلبات الرئيسية**: قائمة بالمتطلبات الأساسية للمناقصة
178
- 4. **الكلمات المفتاحية**: الكلمات والمصطلحات المهمة في المستند
179
- 5. **جديد**: متطلبات المحتوى المحلي في المشاريع السعودية
180
-
181
- يمكنك النقر على أي بند لعرض النص الأصلي في المستند وسياقه.
182
-
183
- ## نظام التسعير الشامل
184
-
185
- ### بدء عملية التسعير
186
-
187
- 1. من صفحة تفاصيل المناقصة، انقر على "بدء التسعير"
188
- 2. اختر جدول الكميات المراد تسعيره
189
- 3. حدد نوع التسعير:
190
- - تسعير قياسي
191
- - تسعير غير متزن
192
- - تسعير مختلط
193
-
194
- ![بدء التسعير](../static/images/screenshots/pricing_start.png)
195
-
196
- ### تسعير البنود
197
-
198
- 1. لكل بند في جدول الكميات، يعرض النظام:
199
- - وصف البند
200
- - الوحدة
201
- - الكمية
202
- - التكاليف المقدرة (المواد، العمالة، المعدات)
203
- 2. يمكنك تعديل التكاليف يدوياً أو الاعتماد على التقديرات الآلية
204
- 3. النظام يحسب تلقائياً:
205
- - المصاريف العامة
206
- - هامش الربح
207
- - السعر الإجمالي
208
-
209
- ### التسعير غير المتزن
210
-
211
- لتطبيق استراتيجية التسعير غير المتزن:
212
-
213
- 1. انقر على "التسعير غير المتزن" من صفحة التسعير
214
- 2. اختر نوع الاستراتيجية:
215
- - التحميل الأمامي
216
- - التحميل الخلفي
217
- - التسعير الاستراتيجي
218
- - التسعير القائم على المخاطر
219
- 3. عدل المعلمات حسب الحاجة
220
- 4. راجع التغييرات في توزيع التكاليف والأسعار
221
-
222
- ![التسعير غير المتزن](../static/images/screenshots/unbalanced_pricing.png)
223
-
224
- ### المحتوى المحلي
225
-
226
- لحساب وتحسين نسبة المحتوى المحلي:
227
-
228
- 1. انقر على "المحتوى المحلي" من صفحة التسعير
229
- 2. قم بتقييم المعايير المختلفة:
230
- - نسبة الموظفين السعوديين
231
- - نسبة المواد المحلية
232
- - نسبة المعدات المحلية
233
- - نسبة المقاولين من الباطن المحليين
234
- 3. راجع الدرجة الإجمالية للمحتوى المحلي والأفضلية السعرية المقابلة
235
-
236
- ## حاسبة تكاليف البناء
237
-
238
- ### نظرة عامة
239
-
240
- **جديد**: حاسبة تكاليف البناء المتكاملة تتيح لك حساب تكاليف المشاريع بالتفصيل، مع تقسيم واضح للعناصر المختلفة:
241
-
242
- - المواد الخام
243
- - المعدات
244
- - العمالة
245
- - المصاريف الإدارية
246
- - هوامش الربح
247
-
248
- ### استخدام الحاسبة
249
-
250
- 1. انقر على "حاسبة تكاليف البناء" من شريط القوائم
251
- 2. اختر نوع المشروع من القائمة
252
- 3. أدخل مواصفات المشروع الأساسية (المساحة، الموقع، نوع البناء)
253
- 4. استعرض التكاليف المقدرة لكل مكون
254
- 5. عدل البنود حسب الحاجة
255
- 6. راجع تفصيل الأسعار والتكلفة الإجمالية
256
-
257
- ### كتالوج القوالب الإنشائية
258
-
259
- **جديد**: يتضمن النظام الآن كتالوجًا شاملاً للقوالب الإنشائية لمختلف أنواع المشاريع:
260
-
261
- 1. مباني سكنية
262
- 2. مباني تجارية
263
- 3. مشاريع بنية تحتية
264
- 4. منشآت صناعية
265
- 5. مرافق عامة
266
-
267
- استخدم هذه القوالب لبدء حسابات التكلفة بسرعة، ثم قم بتخصيصها حسب احتياجات مشروعك.
268
-
269
- ## إدارة الموارد والتكاليف
270
-
271
- ### إدارة المواد
272
-
273
- 1. انقر على "الموارد والتكاليف" من شريط القوائم
274
- 2. اختر "المواد"
275
- 3. يمكنك:
276
- - استعراض قائمة المواد
277
- - إضافة مواد جديدة
278
- - تحديث أسعار المواد
279
- - ربط المواد بالموردين
280
- - **جديد**: تقديم طلبات أسعار للمواد الخام
281
-
282
- ![إدارة المواد](../static/images/screenshots/materials.png)
283
-
284
- ### إدارة المعدات
285
-
286
- 1. انقر على "الموارد والتكاليف" من شريط القوائم
287
- 2. اختر "المعدات"
288
- 3. يمكنك:
289
- - استعراض قائمة المعدات
290
- - تسجيل معدلات الأداء
291
- - تحديث أسعار التأجير
292
- - تسجيل تكاليف التشغيل
293
- - **جديد**: إدارة المعدات الخاصة والمستأجرة
294
-
295
- ### إدارة العمالة
296
-
297
- 1. انقر على "الموارد والتكاليف" من شريط القوائم
298
- 2. اختر "العمالة"
299
- 3. يمكنك:
300
- - استعراض فئات العمالة
301
- - تسجيل معدلات الإنتاجية
302
- - تحديث أسعار العمالة
303
- - تكوين فرق العمل النموذجية
304
-
305
- ## تحليل المخاطر
306
-
307
- ### تقييم المخاطر
308
-
309
- 1. انقر على "تحليل المخاطر" من شريط القوائم
310
- 2. اختر المناقصة المراد تقييم مخاطرها
311
- 3. يعرض النظام المخاطر المحددة مصنفة إلى:
312
- - مخاطر تعاقدية
313
- - مخاطر مالية
314
- - مخاطر فنية
315
- - مخاطر لوجستية
316
-
317
- ![تحليل المخاطر](../static/images/screenshots/risk_analysis.png)
318
-
319
- ### إدارة المخاطر
320
-
321
- لكل خطر محدد، يمكنك:
322
-
323
- 1. مراجعة تفاصيل الخطر
324
- 2. تعديل تقييم احتمالية الحدوث والتأثير
325
- 3. إضافة إجراءات التخفيف
326
- 4. تعيين مسؤول المتابعة
327
- 5. تحديد تكلفة التخفيف
328
-
329
- ## إدارة المشاريع المرساة
330
-
331
- ### متابعة المشاريع
332
-
333
- 1. انقر على "المشاريع" من شريط القوائم
334
- 2. اختر المشروع المراد متابعته
335
- 3. يعرض النظام:
336
- - ملخص المشروع
337
- - حالة التنفيذ
338
- - المستخلصات
339
- - المراسلات
340
-
341
- ![متابعة المشاريع](../static/images/screenshots/project_management.png)
342
-
343
- ### إدارة المستخلصات
344
-
345
- 1. من صفحة تفاصيل المشروع، انقر على "المستخلصات"
346
- 2. يمكنك:
347
- - إنشاء مستخلص جديد
348
- - متابعة حالة المستخلصات
349
- - الاطلاع على المدفوعات
350
-
351
- ## الخرائط والمواقع
352
-
353
- ### نظرة عامة
354
-
355
- **جديد**: نظام الخرائط التفاعلي يتيح لك:
356
-
357
- 1. عرض مواقع جميع المشاريع على خريطة واحدة
358
- 2. تصفية المشاريع حسب الحالة والنوع والمنطقة
359
- 3. عرض معلومات تفصيلية عن كل موقع
360
- 4. تحليل التوزيع الجغرافي للمشاريع
361
- 5. حساب المسافات واتجاهات السير إلى المواقع
362
-
363
- ### استخدام الخرائط
364
-
365
- 1. انقر على "الخرائط" من شريط القوائم
366
- 2. استخدم أدوات التصفية لعرض المشاريع المطلوبة
367
- 3. انقر على أي علامة موقع لعرض تفاصيل المشروع
368
- 4. استخدم خيار "تفاصيل الوصول" لعرض معلومات الوصول إلى الموقع
369
- 5. يمكنك تصدير معلومات الموقع أو مشاركتها مع فريق العمل
370
-
371
- ## الإشعارات الذكية
372
-
373
- ### نظرة عامة
374
-
375
- **جديد**: نظام الإشعارات الذكية يقوم بتنبيهك تلقائيًا بشأن:
376
-
377
- 1. المواعيد النهائية للمناقصات
378
- 2. تحديثات حالة المناقصات والمشاريع
379
- 3. المهام المستحقة
380
- 4. تغييرات الأسعار في المواد الرئيسية
381
- 5. الفرص الجديدة المحتملة
382
-
383
- ### إعدادات الإشعارات
384
-
385
- 1. انقر على "الإعدادات" ثم "إعدادات الإشعارات"
386
- 2. خصص أنواع الإشعارات التي ترغب في تلقيها
387
- 3. حدد طريقة التنبيه (داخل النظام، بريد إلكتروني، رسائل نصية)
388
- 4. ضبط مستوى الأهمية والتكرار
389
-
390
- ## الجدول الزمني التفاعلي
391
-
392
- ### نظرة عامة
393
-
394
- **جديد**: الجدول الزمني التفاعلي يتيح لك:
395
-
396
- 1. عرض مراحل المشروع بتنسيق رسومي سهل الفهم
397
- 2. تتبع المراحل والإنجازات الرئيسية
398
- 3. تحديث حالة المهام في الوقت الفعلي
399
- 4. توقع المشكلات المحتملة قبل حدوثها
400
- 5. مشاهدة تأثير التأخيرات على الخطة الزمنية الكلية
401
-
402
- ### استخدام الجدول الزمني
403
-
404
- 1. انقر على "الجدول الزمني" من شريط القوائم
405
- 2. اختر المشروع المراد عرض جدوله الزمني
406
- 3. استعرض المراحل والمهام
407
- 4. انقر على أي مرحلة لعرض التفاصيل أو تحديث الحالة
408
- 5. استخدم ميزة "ماذا لو" لتقييم تأثير التغييرات المحتملة
409
-
410
- ## مساعد الذكاء الاصطناعي
411
-
412
- ### نظرة عامة
413
-
414
- **جديد**: مساعد الذكاء الاصطناعي التفاعلي يمكنه:
415
-
416
- 1. الإجابة على الأسئلة حول المناقصات والعقود
417
- 2. توفير تحليلات سريعة للمستندات
418
- 3. اقتراح حلول للمشكلات الشائعة
419
- 4. مساعدتك في فهم البنود القانونية المعقدة
420
- 5. توفير ملخصات دقيقة للمستندات الطويلة
421
-
422
- ### استخدام المساعد
423
-
424
- 1. انقر على رمز المساعد في أي صفحة من صفحات النظام
425
- 2. اكتب سؤالك أو طلبك بلغة طبيعية
426
- 3. يمكنك تحميل مستند للتحليل أو الإشارة إلى مستند موجود
427
- 4. راجع الإجابة واطرح أسئلة متابعة إذا لزم الأمر
428
-
429
- ## مقارنة المستندات
430
-
431
- ### نظرة عامة
432
-
433
- **جديد**: أدوات مقارنة المستندات المتطورة تتيح لك:
434
-
435
- 1. مقارنة نسخ مختلفة من العقود أو المناقصات
436
- 2. تحديد التغييرات بين المستندات بدقة
437
- 3. تقييم تأثير التعديلات على المخاطر والتكاليف
438
- 4. اكتشاف التناقضات بين البنود المختلفة
439
- 5. مقارنة العقود بالنماذج القياسية
440
-
441
- ### استخدام أدوات المقارنة
442
-
443
- 1. انقر على "مقارنة المستندات" من شريط القو��ئم
444
- 2. حدد المستندين المراد مقارنتهما
445
- 3. اختر نوع المقارنة (نصية، هيكلية، دلالية)
446
- 4. راجع نتائج المقارنة مع تمييز الاختلافات
447
- 5. يمكنك تصدير تقرير المقارنة
448
-
449
- ## التقارير والتحليلات
450
-
451
- ### إنشاء التقارير
452
-
453
- 1. انقر على "التقارير" من شريط القوائم
454
- 2. اختر نوع التقرير:
455
- - تقرير المناقصات
456
- - تقرير المشاريع
457
- - تقرير مالي
458
- - تقرير المخاطر
459
- - **جديد**: تقرير المحتوى المحلي
460
- - **جديد**: تقرير توقعات الفرص المستقبلية
461
- 3. حدد معايير التقرير
462
- 4. انقر على "إنشاء التقرير"
463
-
464
- ![التقارير](../static/images/screenshots/reports.png)
465
-
466
- ### تصدير التقارير
467
-
468
- يمكن تصدير التقارير بصيغ متعددة:
469
- - PDF
470
- - Excel
471
- - Word
472
- - PowerPoint
473
- - **جديد**: صيغة JSON للتكامل مع الأنظمة الأخرى
474
-
475
- ## إعدادات النظام
476
-
477
- ### نظرة عامة
478
-
479
- **جديد**: صفحة الإعدادات المحسنة تتيح لك:
480
-
481
- 1. تخصيص واجهة المستخدم
482
- 2. تغيير لغة النظام
483
- 3. إدارة إعدادات الإشعارات
484
- 4. تكوين عمليات النسخ الاحتياطي التلقائية
485
- 5. إدارة حسابات المستخدمين والصلاحيات
486
-
487
- ### الإعدادات الشخصية
488
-
489
- 1. انقر على "الإعدادات" ثم "الإعدادات الشخصية"
490
- 2. اختر لغة النظام (العربية، الإنجليزية)
491
- 3. خصص الواجهة (الألوان، الخط، ترتيب العناصر)
492
- 4. ضبط إعدادات الإشعارات الشخصية
493
-
494
- ### إدارة المستخدمين
495
-
496
- 1. انقر على "الإعدادات" ثم "إدارة المستخدمين" (للمديرين فقط)
497
- 2. استعرض قائمة المستخدمين
498
- 3. أضف مستخدمًا جديدًا أو عدل بيانات مستخدم موجود
499
- 4. حدد صلاحيات الوصول والأدوار
500
-
501
- ## الأسئلة الشائعة
502
-
503
- ### أسئلة عامة
504
-
505
- **س: كيف يمكنني الحصول على حساب للنظام؟**
506
- ج: يرجى التواصل مع مدير النظام في شركتك.
507
-
508
- **س: هل يمكن استخدام النظام عبر الأجهزة المحمولة؟**
509
- ج: نعم، النظام متوافق مع جميع الأجهزة بما فيها الهواتف الذكية والأجهزة اللوحية.
510
-
511
- **س: هل يمكنني استخدام النظام دون اتصال بالإنترنت؟**
512
- ج: بعض الوظائف متاحة دون اتصال، لكن معظم الميزات تتطلب اتصالًا بالإنترنت.
513
-
514
- ### أسئلة عن تحليل المستندات
515
-
516
- **س: ما هي أنواع المستندات التي يدعمها النظام؟**
517
- ج: يدعم النظام مستندات PDF وWord وExcel والمخططات DWG.
518
-
519
- **س: هل يستطيع النظام تحليل المستندات الممسوحة ضوئياً؟**
520
- ج: نعم، يمكن للنظام تحليل المستندات الممسوحة ضوئياً، لكن دقة التحليل تعتمد على جودة المسح.
521
-
522
- **س: كم من الوقت يستغرق تحليل مستند كبير؟**
523
- ج: يعتمد على حجم وتعقيد المستند، لكن معظم المستندات تحلل في غضون دقائق.
524
-
525
- ### أسئلة عن التسعير وحاسبة التكاليف
526
-
527
- **س: كيف يحدد النظام تكاليف المواد والعمالة؟**
528
- ج: يعتمد النظام على قاعدة بيانات الأسعار المتاحة ومعدلات الأداء المسجلة.
529
-
530
- **س: ما هو التسعير غير المتزن؟**
531
- ج: هو استراتيجية لتوزيع التكاليف بشكل غير متساوٍ على بنود المناقصة لتحقيق ميزة تنافسية أو تحسين التدفق النقدي.
532
-
533
- **س: هل يمكن إضافة عناصر مخصصة لحاسبة تكاليف البناء؟**
534
- ج: نعم، يمكنك إضافة عناصر مخصصة وتعديل المعلمات حسب متطلبات المشروع.
535
-
536
- ## استكشاف الأخطاء وإصلاحها
537
-
538
- ### مشاكل تسجيل الدخول
539
-
540
- **المشكلة: لا يمكن تسجيل الدخول**
541
- الحل:
542
- 1. تأكد من صحة اسم المستخدم وكلمة المرور
543
- 2. تأكد من اتصالك بالإنترنت
544
- 3. امسح ذاكرة التخزين المؤقت للمتصفح
545
- 4. إذا استمرت المشكلة، تواصل مع الدعم الفني
546
-
547
- ### مشاكل تحليل المستندات
548
-
549
- **المشكلة: فشل تحليل المستند**
550
- الحل:
551
- 1. تأكد من أن المستند بتنسيق مدعوم
552
- 2. تحقق من جودة المسح إذا كان المستند ممسوحاً ضوئياً
553
- 3. قلل حجم الملف إذا كان كبيراً جداً
554
- 4. جرب تقسيم المستند إلى أجزاء أصغر
555
-
556
- ### مشاكل التسعير
557
-
558
- **المشكلة: عدم ظهور التكاليف المقدرة**
559
- الحل:
560
- 1. تأكد من تحديث قاعدة بيانات الأسعار
561
- 2. تحقق من صحة وحدات البنود
562
- 3. تأكد من ربط البنود بالمواد والعمالة المناسبة
563
- 4. أعد تشغيل عملية التسعير
564
-
565
- ### مشاكل الجدول الزمني
566
-
567
- **المشكلة: عدم ظهور بعض المراحل في الجدول الزمني**
568
- الحل:
569
- 1. تأكد من إضافة جميع المراحل في تفاصيل المشروع
570
- 2. تحقق من تواريخ البدء والانتهاء
571
- 3. تأكد من تسلسل المراحل المنطقي
572
- 4. حاول تحديث الصفحة أو إعادة تحميلها
573
-
574
- ---
575
-
576
- ## حول النظام
577
-
578
- نظام تحليل العقود والمناقصات بالذكاء الاصطناعي هو منتج متطور تم تصميمه وتطويره خصيصًا لشركة شبه الجزيرة للمقاولات. يعمل النظام على تحسين كفاءة دراسة المناقصات وإدارة المشاريع من خلال الاستفادة من تقنيات الذكاء الاصطناعي وتحليل البيانات المتقدمة.
579
-
580
- **مزايا النظام الرئيسية:**
581
- - تحليل متعمق للمناقصات والعقود باللغة العربية
582
- - حاسبة تكاليف متكاملة مع تفاصيل دقيقة
583
- - أدوات متقدمة لإدارة المشاريع
584
- - تحليل المخاطر الآلي
585
- - الجدول الزمني التفاعلي
586
- - نظام الخرائط والمواقع
587
- - مساعد الذكاء الاصطناعي
588
-
589
- ---
590
-
591
- لمزيد من المساعدة، يرجى التواصل مع:
592
- - البريد الإلكتروني: [email protected]
593
- - رقم الهاتف: +966 123456789
594
- - نظام التذاكر: https://support.peninsula-contracting.com