pricing_system/docs/user_guide.md

# نظام تحليل المناقصات وتسعير المشاريع - دليل التثبيت والاستخدام

## مقدمة

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

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

- Python 3.8 أو أحدث
- Streamlit 1.10.0 أو أحدث
- Pandas 1.3.0 أو أحدث
- NumPy 1.20.0 أو أحدث
- Matplotlib 3.4.0 أو أحدث
- Seaborn 0.11.0 أو أحدث
- Plotly 5.3.0 أو أحدث
- OpenPyXL 3.0.0 أو أحدث
- XlsxWriter 3.0.0 أو أحدث

## التثبيت

1. قم بتثبيت Python من الموقع الرسمي: https://www.python.org/downloads/
2. قم بتثبيت المكتبات المطلوبة باستخدام الأمر التالي:

```bash

pip install streamlit pandas numpy matplotlib seaborn plotly openpyxl xlsxwriter

```

3. قم بتنزيل ملفات النظام وفك ضغطها في المجلد المطلوب.
4. انتقل إلى مجلد النظام واستخدم الأمر التالي لتشغيل النظام:

```bash

streamlit run app.py

```

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

يتكون النظام من الوحدات الرئيسية التالية:

1. **وحدة التسعير (PricingApp)**:
   - إدارة جداول الكميات (BOQ)
   - تحليل التكاليف
   - سيناريوهات التسعير
   - التحليل التنافسي
   - التقارير

2. **وحدة الموارد (ResourcesApp)**:
   - إدارة المعدات
   - إدارة المواد
   - إدارة العمالة
   - إدارة مقاولي الباطن

3. **وحدة الكتالوجات**:
   - كتالوج المعدات
   - كتالوج المواد
   - كتالوج العمالة
   - كتالوج مقاولي الباطن

4. **وحدة التحليل الذكي للأسعار**:
   - تحليل تكاليف البنود
   - تحليل المواد والمعدات والعمالة
   - تحليل التكاليف غير المباشرة
   - تحليل هامش الربح

5. **وحدة الإدارات المساندة**:
   - إدارة تكاليف الإدارات المساندة
   - توزيع التكاليف غير المباشرة

6. **وحدة استراتيجيات التسعير**:
   - التسعير القياسي
   - التسعير المتزن
   - التسعير غير المتزن
   - التسعير الموجه للربحية
   - التسعير بالتجميع
   - التسعير بالمحتوى المحلي

7. **وحدة تحليل المحتوى المحلي**:
   - حساب نسبة المحتوى المحلي
   - تحليل المحتوى المحلي حسب نوع الموارد
   - توصيات لتحسين نسبة المحتوى المحلي

## دليل الاستخدام

### الشاشة الرئيسية

عند تشغيل النظام، ستظهر الشاشة الرئيسية التي تحتوي على قائمة بالوحدات الرئيسية:

- التسعير
- الموارد
- المشاريع
- التقارير
- الإعدادات

اختر الوحدة المطلوبة للانتقال إليها.

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

تتضمن وحدة التسعير العديد من علامات التبويب:

#### جدول الكميات (BOQ)

- **استيراد جدول الكميات**: يمكنك استيراد جدول الكميات من ملف Excel.
- **إضافة بنود يدويًا**: يمكنك إضافة بنود جديدة يدويًا.
- **تحرير البنود**: يمكنك تحرير البنود الموجودة.
- **التحليل الذكي للبنود**: يمكنك تحليل كل بند إلى مكوناته (مواد، معدات، عمالة، تكاليف غير مباشرة).

#### تحليل التكاليف

- **تحليل التكاليف الإجمالية**: عرض تحليل التكاليف الإجمالية للمشروع.
- **تحليل التكاليف حسب البنود**: عرض تحليل التكاليف لكل بند.
- **تحليل المواد الأكثر تكلفة**: عرض المواد الأكثر تكلفة في المشروع.
- **تحليل المعدات الأكثر تكلفة**: عرض المعدات الأكثر تكلفة في المشروع.

#### سيناريوهات التسعير

- **استراتيجيات التسعير**: يمكنك اختيار استراتيجية التسعير المناسبة وتطبيقها.
- **مقارنة استراتيجيات التسعير**: يمكنك مقارنة نتائج استراتيجيات التسعير المختلفة.

#### كتالوجات الموارد

- **كتالوج المعدات**: إدارة كتالوج المعدات واستيراده من Excel.
- **كتالوج المواد**: إدارة كتالوج المواد واستيراده من Excel.
- **كتالوج العمالة**: إدارة كتالوج العمالة واستيراده من Excel.
- **كتالوج مقاولي الباطن**: إدارة كتالوج مقاولي الباطن واستيراده من Excel.

#### الإدارات المساندة

- **إدارة الإدارات المساندة**: إضافة وتحرير الإدارات المساندة.
- **تحليل تكاليف الإدارات المساندة**: عرض تحليل تكاليف الإدارات المساندة.
- **توزيع التكاليف**: توزيع تكاليف الإدارات المساندة على بنود المشروع.

#### المحتوى المحلي

- **تحليل المحتوى المحلي**: عرض تحليل المحتوى المحلي للمشروع.
- **تحليل المحتوى المحلي حسب نوع الموارد**: عرض تحليل المحتوى المحلي حسب نوع الموارد.
- **توصيات لتحسين نسبة المحتوى المحلي**: عرض توصيات لتحسين نسبة المحتوى المحلي.

### وحدة الموارد

تتضمن وحدة الموارد إدارة الموارد المختلفة:

- **إدارة المعدات**: إضافة وتحرير المعدات.
- **إدارة المواد**: إضافة وتحرير المواد.
- **إدارة العمالة**: إضافة وتحرير العمالة.
- **إدارة مقاولي الباطن**: إضافة وتحرير مقاولي الباطن.

### وحدة المشاريع

تتضمن وحدة المشاريع إدارة المشاريع:

- **قائمة المشاريع**: عرض قائمة المشاريع.
- **إضافة مشروع جديد**: إضافة مشروع جديد.
- **تفاصيل المشروع**: عرض تفاصيل المشروع.

### وحدة التقارير

تتضمن وحدة التقارير إنشاء وعرض التقارير المختلفة:

- **تقرير ملخص المشروع**: إنشاء تقرير ملخص للمشروع.
- **تقرير تحليل التكاليف**: إنشاء تقرير تحليل التكاليف.
- **تقرير سيناريوهات التسعير**: إنشاء تقرير سيناريوهات التسعير.
- **تقرير المحتوى المحلي**: إنشاء تقرير المحتوى المحلي.
- **تقرير الإدارات المساندة**: إنشاء تقرير الإدارات المساندة.
- **تقرير المقارنة التنافسية**: إنشاء تقرير المقارنة التنافسية.
- **تقرير الموارد المستخدمة**: إنشاء تقرير الموارد المستخدمة.

### وحدة الإعدادات

تتضمن وحدة الإعدادات تخصيص إعدادات النظام:

- **إعدادات عامة**: تخصيص الإعدادات العامة مثل اللغة والسمة.
- **إعدادات المستخدم**: تخصيص إعدادات المستخدم.
- **إعدادات النظام**: تخصيص إعدادات النظام.
- **النسخ الاحتياطي**: إنشاء واستعادة النسخ الاحتياطية.

## الميزات الرئيسية

### 1. إدارة البنود (BOQ)

- استيراد جداول الكميات من Excel
- إدخال البنود يدويًا وتحريرها
- تحليل كل بند إلى مكوناته

### 2. التحليل الذكي للأسعار

- تحليل تفصيلي لتكاليف المواد والمعدات والعمالة
- حساب المصاريف غير المباشرة وهامش الربح
- تحليل التكاليف الإجمالية للمشروع

### 3. كتالوجات الموارد

- كتالوج شامل للمعدات المستخدمة في مشاريع البنية التحتية والصرف الصحي والطرق والسيول والكباري
- كتالوج شامل للمواد المستخدمة في هذه المشاريع مع الأسعار التقريبية للسوق السعودي
- كتالوج شامل للعمالة والمهندسين مع الأسعار بالساعة واليوم والأسبوع والشهر
- كتالوج شامل لمقاولي الباطن المتخصصين في أعمال اليوتيلتيز والكهرباء وأنظمة ITC وCCTV وأنظمة التحكم وشبكات الري

### 4. إدارة الإدارات المساندة

- إدارة تكاليف الإدارات المساندة المختلفة
- توزيع التكاليف غير المباشرة على بنود المشروع

### 5. استراتيجيات التسعير المتقدمة

- التسعير القياسي: تحديد سعر كل بند بناءً على تكلفته الفعلية مضافاً إليها نسبة ربح ثابتة
- التسعير المتزن: توزيع هامش الربح بشكل متوازن على جميع بنود المشروع مع مراعاة المخاطر
- التسعير غير المتزن: زيادة أسعار البنود المبكرة في المشروع وتخفيض أسعار البنود المتأخرة
- التسعير الموجه للربحية: زيادة أسعار البنود ذات التكلفة المنخفضة والكميات الكبيرة
- التسعير بالتجميع: تجميع البنود المتشابهة وتسعيرها كمجموعة واحدة
- التسعير بالمحتوى المحلي: زيادة نسبة المحتوى المحلي في المشروع لتحقيق متطلبات الجهات المالكة

### 6. تحليل المحتوى المحلي

- حساب نسبة المحتوى المحلي في المشروع
- تحليل المحتوى المحلي حسب نوع الموارد
- توصيات لتحسين نسبة المحتوى المحلي

### 7. التقارير المتقدمة

- تقارير تفصيلية وإجمالية للمشروع
- تقارير تحليل التكاليف
- تقارير سيناريوهات التسعير
- تقارير المحتوى المحلي
- تقارير الإدارات المساندة
- تقارير المقارنة التنافسية
- تقارير الموارد المستخدمة

## الدعم الفني

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

- البريد الإلكتروني: [email protected]
- الهاتف: +966 12 345 6789

## حقوق الملكية

جميع حقوق الملكية محفوظة © 2025 نظام تحليل المناقصات وتسعير المشاريع.