كل ما تحتاجه لتثبيت وإعداد واستخدام OpenConstructionERP لتقدير تكاليف البناء الاحترافي.
الإعداد المبدئي ← مشروع جديد ← جدول الكميات BOQ ← الربط مع BIM ← DWG ← حساب الكميات من PDF ← تقدير كامل ← المهام ← مستكشف البيانات ← تقدير بالذكاء الاصطناعي AI ← المحفظة.
الترجمات والفصول والتشغيل بسرعة 1.5× مدمجة في المشغّل أعلاه. هل تفضّل المشاهدة مباشرة على YouTube؟ ▶ افتح على YouTube · اشترك في القناة لمتابعة جولات الإصدارات الجديدة.
كل مقطع أدناه عبارة عن صورة GIF قصيرة مقتطعة من الجولة الكاملة أعلاه - بالترتيب نفسه للفيديو، بحيث يمكنك الانتقال إلى أي سير عمل يهمّك أكثر. هل تريد تدفّقاً متواصلاً واحداً؟ ▶ شاهد الجولة التعريفية لمدة 12 دقيقة على YouTube.
OpenConstructionERP هي منصة متكاملة لتقدير تكاليف البناء وإدارة المشاريع تعمل بالكامل على جهازك. تحل محل مجموعات التقدير التجارية باهظة الثمن ببديل مفتوح ومستضاف ذاتياً. تغطي المنصة دورة حياة البناء بأكملها، من دراسات الجدوى الأولية وحساب الكميات إلى إعداد جدول الكميات BOQ التفصيلي وطرح المناقصات ومقارنة العطاءات وتنفيذ المشروع وإدارة الجودة والرقابة المالية. تبقى جميع بياناتك على خادمك. لا اعتماد على السحابة، ولا اشتراكات، ولا رسوم لكل مستخدم.
أبرز ما في v18.5.0: أكثر من 190 وحدة تغطي دورة حياة البناء كاملة: دليل جهات الاتصال، والمهام بنظام Kanban، وتتبع RFI، والمالية (الفواتير والميزانيات وEVM)، والمشتريات، والسلامة، والاجتماعات، وفحوصات الجودة، وNCR، وsubmittals، والمراسلات، وCDE (ISO 19650)، وtransmittals، وBIM Hub، وسجل الأصول مع تصدير COBie، والتقارير & لوحة KPI، وmarkups (PDF↔DWG↔hub)، وتصورات pivot & محدد أعمدة الرسوم البيانية، وخدمة بريد إلكتروني قابلة للتوصيل، وجهات اتصال متعددة المستأجرين، وتقارير مجدولة، وRegional Packs، واستيراد/تصدير كامل.


جداول كميات هرمية مع أقسام وبنود وموارد وتجميعات وهوامش ربح تلقائية.
قواعد تكلفة من 9 مصادر وطنية، تُنشر في 48 إصدارًا سوقيًا بالعملة واللغة المحليتين، مع 36 قاعدة بيانات إقليمية جاهزة للاستيراد.
أنشئ جدول الكميات BOQ من نص أو صور أو ملفات PDF أو Excel أو نماذج CAD/BIM باستخدام أي مزود لنماذج اللغة الكبيرة LLM.
استخرج الكميات من RVT وIFC وDWG وDGN عبر محولات DDC.
جدولة جانت مع طريقة المسار الحرج CPM، وإدارة القيمة المكتسبة، والمنحنى S، ومحاكاة مونت كارلو.
المالية والسلامة والجودة وبيئة البيانات المشتركة CDE ومركز BIM والمشتريات وطلب المعلومات RFI والمهام والاجتماعات وأكثر. فعّل فقط ما تحتاجه.
بعد تثبيت OpenConstructionERP، اتبع هذه الخطوات لإعداد مشروعك الأول وإنشاء تقدير التكلفة الأول. تستغرق العملية بأكملها حوالي 10 دقائق.
افتح متصفحك وانتقل إلى http://localhost:5173 (التطوير المحلي) أو http://localhost:8080 (Docker). سترى صفحة تسجيل الدخول مع لوحة "وصول تجريبي". انقر على Admin لتسجيل الدخول فوراً بالحساب التجريبي، أو أدخل بيانات اعتمادك الخاصة إذا سجّلت حساباً جديداً.
عند تسجيل الدخول لأول مرة، يرشدك معالج الإعداد المبدئي خلال الإعداد الأولي:
انقر على مشروع جديد في لوحة المعلومات أو انتقل إلى المشاريع. املأ:
بعد إنشاء المشروع، يتم توجيهك إلى صفحة تفاصيل المشروع حيث يمكنك البدء بإضافة جداول الكميات BOQ.
من صفحة المشروع، انقر على تقدير جديد. امنحه اسماً (مثل "تقدير التكلفة v1") واختر قالباً اختيارياً. يفتح محرّر BOQ بشبكة فارغة جاهزة لبندك الأول.
في محرّر BOQ، انقر على إضافة بند أو اضغط Enter على صف فارغ. املأ:
يُحسب عمود الإجمالي تلقائياً (الكمية × سعر الوحدة). يمكنك أيضاً البحث في قاعدة بيانات التكلفة بالنقر على أيقونة قاعدة البيانات بجانب أي بند للعثور على سعر من بنود CWICR التي تتجاوز 120,000 بند وتطبيقه.
صُمّم OpenConstructionERP ليكون سهل التثبيت بغضّ النظر عن خلفيتك التقنية. اختر الطريقة التي تتناسب مع إعداداتك - تستغرق جميع الخيارات أقل من 5 دقائق. يستخدم التطبيق PostgreSQL مضمّناً افتراضياً (بلا Docker وبلا خادم قاعدة بيانات منفصل وبلا أي إعداد)، لذا يعمل كل شيء جاهزاً. يتطلّب Python 3.12+ لمسارَي pip والسطر الواحد.
pip install --upgrade openconstructionerp
openconstructionerpيثبّت الواجهة الخلفية + واجهة React المبنية مسبقاً في حزمة wheel واحدة. يُفتح على http://localhost:8080 مع واجهة المستخدم الكاملة. PostgreSQL مدمج، بدون أي تهيئة. إذا بدا أي شيء غير صحيح، شغّل openconstructionerp doctor.
على Ubuntu 23.04+ (بما في ذلك Ubuntu 26) وDebian 12+، يفشل pip install مباشرة إلى Python النظام بالخطأ error: externally-managed-environment (PEP 668). استخدم بيئة افتراضية بدلاً من ذلك:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerpإذا لجأ pip إلى بناء من المصدر، ثبّت الرؤوس: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. دليل Linux الكامل مع استكشاف الأخطاء وإصلاحها: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexيختار Docker إذا كان مثبّتاً، وإلا فـ uv، وإلا فـ pip. يعمل على http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartيُفتح على http://localhost:8080 (~دقيقتان لأول بناء).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run devالواجهة الخلفية: http://localhost:8000 / الواجهة الأمامية: http://localhost:5173
| الحساب | البريد الإلكتروني | كلمة المرور | الدور |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | وصول كامل |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | مقدّر التكاليف |
| Manager | manager@openconstructionerp.com | DemoPass1234! | مدير |
5 مشاريع تجريبية (برلين، لندن، نيويورك، باريس، دبي) مع جداول كميات BOQ كاملة وجداول زمنية ونماذج تكلفة.
محرر جدول الكميات هو المكان الذي تقضي فيه معظم وقتك. يوفر واجهة احترافية شبيهة بجداول البيانات مدعومة بـ AG Grid مع ميزات خاصة بالبناء مدمجة فيها، مثل الأقسام الهرمية وربط الموارد ووصفات التجميعات وحسابات هوامش الربح التلقائية. يتم تتبع كل تغيير مع دعم كامل للتراجع والإعادة. تعمل 42 قاعدة تحقق تلقائياً في الخلفية، لاكتشاف الأخطاء مثل الكميات المفقودة والأسعار الصفرية والبنود المكررة ومشكلات الامتثال للتصنيف قبل أن تتحول إلى مشاكل.
🎬 شاهد محرّر BOQ أثناء العمل على YouTube - تحرير يعتمد على لوحة المفاتيح أولاً، أكثر من 120 ألف بند مسعّر، ودرجة جودة حية.



تنظم الأقسام جدول الكميات BOQ في مجموعات منطقية (مثل "300 الهيكل الإنشائي"، "400 التدفئة والتهوية وتكييف الهواء"). لإنشاء قسم:
يمكنك طي/توسيع الأقسام للتركيز على بنود أعمال محددة. اسحب الأقسام لإعادة ترتيب بنية جدول الكميات BOQ بأكملها.
يمكن أن يحتوي كل بند في جدول الكميات BOQ على موارد مرتبطة تُفصّل سعر الوحدة إلى مكونات:
لإضافة الموارد: وسّع صف البند، انقر على "إضافة مورد"، ابحث في الكتالوج، وحدد عامل الكمية (مثل 120 كجم حديد تسليح لكل م3 خرسانة). يتم تحديث سعر وحدة البند تلقائياً من مجموع موارده.
تُطبق هوامش الربح بعد الإجمالي الصافي (مجموع جميع البنود). تشمل هوامش الربح الشائعة:
انقر على إضافة هامش في شريط الأدوات. يمكنك تعيين إعدادات إقليمية افتراضية أو التخصيص لكل مشروع. يمكن أن تكون الهوامش بالنسبة المئوية أو بمبالغ ثابتة، وتتراكم بالترتيب (النفقات العامة أولاً، ثم الربح على المبلغ شامل النفقات العامة، ثم ضريبة القيمة المضافة على الإجمالي).
اضغط Ctrl+Shift+V أو انقر على أيقونة الدرع في شريط الأدوات لتشغيل التحقق. يفحص النظام BOQ الخاص بك مقابل مجموعات القواعد المختارة ويعرض النتائج مباشرة:
يدعم محرر جدول الكميات BOQ الاستيراد من مصادر متعددة:
| الاختصار | الإجراء |
|---|---|
Ctrl+K | لوحة الأوامر |
Ctrl+N | مشروع جديد |
Ctrl+Shift+V | تشغيل التحقق |
Ctrl+Z / Y | تراجع / إعادة |
استخدم أكبر قاعدة بيانات مفتوحة المصدر لتكاليف البناء في العالم: أكثر من 120,000 بند تكلفة في أكثر من 40 منطقة. تضيف قاعدة CWICR العالمية أكثر من 55,000 بند بأوصاف تصل إلى 9 لغات، منظمة حسب الأعمال (أعمال الحفر، والخرسانة، والبناء، والحديد، والأسقف، والواجهات، والتكييف، والكهرباء، والسباكة، والتشطيبات، وتنسيق المواقع). يتضمن كل بند وحدة قياس وسعراً أساسياً للمنطقة المحددة ورموز تصنيف (DIN 276 وNRM وMasterFormat) وعند توفره تفصيلاً للمواد والعمالة والمعدات.


| المنطقة | العملة | المعيار | البنود |
|---|---|---|---|
| ألمانيا (DACH) | EUR | DIN 276 | 55,719 |
| المملكة المتحدة | GBP | NRM 1/2 | 55,719 |
| الولايات المتحدة | USD | MasterFormat | 55,719 |
| فرنسا | EUR | DPGF | 55,719 |
| روسيا | RUB | GESN | 55,719 |
| الإمارات | AED | محلي | 55,719 |
| الصين | CNY | GB/T | 55,719 |
| الهند | INR | CPWD | 55,719 |
قاعدة بيانات التكاليف مصممة لسير عملين رئيسيين:
يحتوي كل بند تكلفة على:
فعّل البحث الدلالي للعثور على بنود التكلفة حسب المعنى، وليس فقط حسب التطابق الدقيق للكلمات المفتاحية. عندما تبحث عن "جدار خرساني"، يجد النظام أيضاً بنوداً مثل "قاطع مسلح C30/37، 24 سم مع قوالب"، حتى لو لم تظهر الكلمات الدقيقة. يتم تشغيل ذلك بواسطة تضمينات sentence-transformer التي تحول الأوصاف إلى متجهات رقمية وتجد أقرب التطابقات في الفضاء متعدد الأبعاد. يتم دعم خلفيتين لقاعدة البيانات المتجهية: LanceDB (مدمجة، تعمل داخل العملية مثل SQLite، تضمينات بـ 384 بعداً) وQdrant (خادم إنتاجي مع لقطات جاهزة بـ 3072 بعداً قابلة للتنزيل من GitHub).
استخرج الكميات مباشرة من رسومات ونماذج مشروعك، دون الحاجة إلى عد يدوي. ارفع ملفات RVT أو IFC أو DWG أو DGN ويستخرج النظام كل عنصر بناء مع الأحجام والمساحات والأطوال. بالنسبة لرسومات PDF، افتحها مباشرة في المتصفح واستخدم أدوات القياس المعايرة لحساب المسافات والمساحات وأعداد العناصر. يمكن نقل جميع الكميات المستخرجة إلى جدول كميات BOQ للتسعير.
🎬 شاهد فصول الربط الجماعي من BIM إلى BOQ، وحصر الكميات حسب طبقات DWG، وقياس PDF على YouTube.





| الصيغة | البرنامج | المحوّل |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (أي BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
اربط أي مزود لنماذج اللغة الكبيرة LLM لإنشاء تقديرات تكاليف البناء من أوصاف نصية بسيطة أو صور المباني أو ملفات PDF الممسوحة ضوئياً أو جداول Excel أو نماذج CAD/BIM. ينشئ نظام الذكاء الاصطناعي AI بنوداً كاملة لجدول الكميات BOQ مع كميات وتسعير بأسعار السوق. بعد الإنشاء، يمكنك مطابقة كل بند مع قاعدة بيانات تكاليف CWICR لاستبدال الأسعار المقدّرة بالذكاء الاصطناعي AI بأسعار سوق إقليمية موثقة. ميزات الذكاء الاصطناعي AI اختيارية بالكامل، وتعمل المنصة بشكل كامل بدونها.
🎬 شاهد "تقدير بالذكاء الاصطناعي من صورة" على YouTube - ارفع صورة لموقع إنشائي، واحصل على BOQ محدّد النطاق في ثوانٍ.


| المزود | النماذج | الميزات |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | نص، رؤية، مستندات |
| OpenAI | GPT-4o | نص، رؤية، مستندات |
| Gemini Pro | نص، رؤية | |
| Mistral / Groq / DeepSeek | متنوعة | نص |
صِف مشروعك بنص بسيط وينشئ الذكاء الاصطناعي AI ما بين 15 و30 بنداً لجدول الكميات BOQ مع كميات وأسعار سوقية.
طابق تقديرات الذكاء الاصطناعي AI مع قاعدة بيانات CWICR لاستبدال الأسعار المُخمّنة بأسعار سوق حقيقية.
تحدث مع الذكاء الاصطناعي AI حول التكاليف والمواد والتسعير باستخدام قاعدة بيانات التكاليف الخاصة بك كسياق.

خطط الجدول الزمني لمشروع البناء وتتبع التكاليف بمرور الوقت باستخدام أدوات الجدولة والنمذجة المالية المتكاملة.
توفر وحدة الجدولة مخطط جانت احترافياً لإدارة الجدول الزمني للبناء. أنشئ الأنشطة، وحدد المدد، وعرّف الاعتماديات، ويحسب النظام تلقائياً المسار الحرج الذي يبيّن الأنشطة التي يجب ألا تتأخر.
يربط نموذج التكلفة بيانات جدول الكميات BOQ بالجدول الزمني للمشروع، مما يمنحك عرضاً مرحلياً زمنياً لتكاليف البناء مع مقاييس إدارة القيمة المكتسبة.
أدر سير عمل المشتريات الكامل من إنشاء حزم العطاءات إلى مقارنة العروض ومنح العقود للمقاولين من الباطن.
انتقل إلى المشتريات، واختر مشروعاً، وانقر على "إنشاء حزمة". حدد اسم الحزمة، ووصف النطاق، والموعد النهائي للتقديم، واختر بنود جدول الكميات BOQ المراد تضمينها. يمكنك إنشاء حزم متعددة لكل مشروع (مثل الأعمال الإنشائية، والأعمال الكهروميكانيكية MEP، والتشطيبات).
أضف عطاءات من المقاولين من الباطن مع اسم الشركة وتفاصيل الاتصال والأسعار المعروضة لكل بند في جدول الكميات BOQ. يدعم النظام عطاءات متعددة لكل حزمة للمقارنة جنباً إلى جنب.
تعرض مرآة الأسعار جميع العطاءات في جدول مقارنة مع أسعار الوحدة والإجماليات لكل بند. تبرز المؤشرات المرئية أدنى وأعلى العطاءات. صدّر المقارنة بصيغة CSV لمراجعة أصحاب المصلحة.
حدد العطاء الفائز بزر المنح وأضف ملاحظات التبرير. تتبع حالة الحزمة عبر: مسودة، صادرة، قيد التجميع، قيد التقييم، ممنوحة، مغلقة.
حدد وقيّم وأدِر مخاطر المشروع باستخدام مصفوفة الاحتمال والأثر. حدد مقدار التعرض للمخاطر وخطط لاستراتيجيات التخفيف لكل خطر محدد.
تعرض المصفوفة جميع المخاطر على شبكة الاحتمال (0.1-0.9) مقابل الأثر (منخفض/متوسط/مرتفع/حرج) مع ترميز لوني. يعرض كل خطر درجة التعرض المحسوبة (الاحتمال مضروباً في تكلفة الأثر).
لكل خطر، وثّق: الرمز الفريد (R-001)، العنوان، الفئة (فنية، مالية، جدولة، تنظيمية، بيئية، سلامة)، استراتيجية التخفيف، خطة الطوارئ، مالك المخاطر، الأثر على التكلفة، والأثر على الجدول الزمني بالأيام. تتبع الحالة عبر: محدد، مُقيّم، قيد التخفيف، مغلق، أو وقع.
تتبع تغييرات النطاق وأثرها على تكلفة المشروع وجدوله الزمني. توفر أوامر التغيير مساراً تدقيقياً لجميع التعديلات التي تتم بعد التقدير الأولي.
أنشئ أمر تغيير برمز (CO-001) وعنوان وفئة سبب (طلب العميل، تغيير التصميم، حالة غير متوقعة، تنظيمية). أضف بنوداً تفصيلية تحدد بنود جدول الكميات BOQ المتأثرة مع الكميات/الأسعار الأصلية والجديدة. يحسب النظام فروق التكلفة تلقائياً. تنتقل الحالة عبر: مسودة، مُقدّم، قيد المراجعة، موافق عليه/مرفوض.

شغّل فحوصات جودة آلية على جداول الكميات BOQ الخاصة بك لاكتشاف الأخطاء قبل أن تتحول إلى مشاكل. يطبق محرك التحقق 42 قاعدة قابلة للتكوين على بيانات تقديرك.
ينتج كل تحقق درجة جودة (0-100%) مع نتائج مرمّزة بالألوان: أخطاء (أحمر، يجب إصلاحها)، تحذيرات (أصفر، ينبغي مراجعتها)، معلومات (أزرق، اقتراحات). انقر على أي نتيجة للانتقال مباشرة إلى بند جدول الكميات BOQ المتأثر.



أنشئ مستندات احترافية من بيانات مشروعك لأصحاب المصلحة والعملاء والامتثال التنظيمي.

مركزة جميع مستندات المشروع. ارفع الرسومات والعقود والمواصفات والصور مع تصنيف وبحث تلقائيين.


اعرض أداء الميزانية عبر المشاريع. تجمّع لوحة المعلومات البيانات المالية عبر جميع المشاريع لتحديد الاتجاهات والانحرافات والميزانيات المعرضة للخطر.
أدِر جميع أصحاب المصلحة في المشروع في دليل مركزي. تتبع العملاء والمقاولين من الباطن والموردين والمعماريين والاستشاريين مع تفاصيل اتصال كاملة، وارتباطات بالشركات، وتصنيف قائم على الأدوار. اربط جهات الاتصال بالمشاريع والمناقصات وأوامر الشراء والمراسلات لتتبع كامل.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/contacts/ | عرض جميع جهات الاتصال |
| POST | /api/v1/contacts/ | إنشاء جهة اتصال |
| GET | /api/v1/contacts/{id} | الحصول على تفاصيل جهة الاتصال |
| PUT | /api/v1/contacts/{id} | تحديث جهة الاتصال |
| POST | /api/v1/contacts/import | استيراد جماعي لجهات الاتصال |
نظم أعمال المشروع بتصنيف مهام من 5 أنواع ولوحة Kanban مرئية. يمكن تعيين المهام لأعضاء الفريق، وربطها ببنود محددة في جدول الكميات BOQ أو بمستندات أو طلبات معلومات RFI، وتتبعها عبر مراحل سير عمل قابلة للتخصيص. لكل نوع مهمة ترميزه اللوني الخاص وحقوله الافتراضية.

| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/tasks/ | عرض المهام (قابل للتصفية حسب المشروع، المُكلَّف، الحالة) |
| POST | /api/v1/tasks/ | إنشاء مهمة |
| PATCH | /api/v1/tasks/{id} | تحديث المهمة (الحالة، المُكلَّف، الأولوية) |
| GET | /api/v1/tasks/board/{project_id} | الحصول على بيانات لوحة Kanban |
تتبّع طلبات المعلومات الرسمية بين أطراف المشروع مع إسناد المسؤولية الحالية (ball-in-court). تمرّ طلبات RFI عبر دورة حياة منظّمة من المسودة حتى الإغلاق، بما يضمن حصول كل سؤال على إجابة موثّقة. يُظهر تتبّع المسؤولية الحالية من يملك الإجراء في أي وقت.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/rfis/ | عرض قائمة طلبات RFI |
| POST | /api/v1/rfis/ | إنشاء طلب RFI |
| POST | /api/v1/rfis/{id}/respond | إرسال رد |
| PATCH | /api/v1/rfis/{id}/status | تحديث الحالة / المسؤولية الحالية |
إدارة مالية كاملة للمشروع تشمل الفواتير والموازنات والمدفوعات وإدارة القيمة المكتسبة (EVM). تتبّع التكاليف المخطّطة مقابل الفعلية، وإنشاء طلبات الدفع، ومراقبة سلامة الموازنة عبر تحليل التباين في الوقت الفعلي. يتكامل مع بيانات BOQ لإنشاء خط أساس للتكلفة تلقائياً.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/finance/invoices/ | عرض قائمة الفواتير |
| POST | /api/v1/finance/invoices/ | إنشاء فاتورة |
| GET | /api/v1/finance/budgets/ | عرض قائمة الموازنات |
| POST | /api/v1/finance/budgets/import | استيراد موازنة من Excel |
| GET | /api/v1/finance/evm/{project_id} | الحصول على مؤشرات EVM |
| GET | /api/v1/finance/payments/ | عرض قائمة المدفوعات |
إدارة أوامر الشراء ومحاضر استلام البضائع لمواد وخدمات البناء. أنشئ أوامر شراء مرتبطة ببنود BOQ، وتتبّع حالة التسليم، وسجّل استلام البضائع مع التحقق من الكميات. يتكامل مع وحدة جهات الاتصال لإدارة المورّدين.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/procurement/orders/ | عرض قائمة أوامر الشراء |
| POST | /api/v1/procurement/orders/ | إنشاء أمر شراء |
| POST | /api/v1/procurement/orders/{id}/receive | تسجيل استلام البضائع |
| GET | /api/v1/procurement/receipts/ | عرض قائمة محاضر استلام البضائع |
سجّل حوادث السلامة والحوادث الوشيكة والملاحظات السلوكية باستخدام نظام تسجيل المخاطر. تتبّع مؤشرات أداء السلامة عبر المشاريع، وحدّد الاتجاهات، وتأكّد من الامتثال للوائح الصحة والسلامة المهنية.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/safety/incidents/ | عرض قائمة الحوادث |
| POST | /api/v1/safety/incidents/ | الإبلاغ عن حادث |
| GET | /api/v1/safety/observations/ | عرض قائمة الملاحظات |
| POST | /api/v1/safety/observations/ | تسجيل ملاحظة |
| GET | /api/v1/safety/dashboard/{project_id} | الحصول على مؤشرات أداء السلامة |
أدر محاضر الاجتماعات بجداول أعمال منظّمة وبنود إجراءات قابلة للتتبّع. أنشئ سلاسل اجتماعات متكررة (مثل اجتماعات الموقع الأسبوعية)، وسجّل الحضور، واحتفظ بنقاط المناقشة، وأنشئ بنود إجراءات تلقائياً تتكامل مع وحدة المهام.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/meetings/ | عرض قائمة الاجتماعات |
| POST | /api/v1/meetings/ | إنشاء اجتماع |
| GET | /api/v1/meetings/{id}/minutes | الحصول على محضر الاجتماع |
| POST | /api/v1/meetings/{id}/actions | إضافة بند إجراء |
نفّذ عمليات تفتيش الجودة باستخدام قوائم تحقق قابلة للتهيئة. حدّد قوالب تفتيش لكل حِرفة أو نوع نشاط، واملأها في الموقع، وأرفق الصور، وتتبّع معالجة أوجه القصور. تُغذّي نتائج التفتيش درجة جودة المشروع وسير عمل NCR.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/inspections/ | عرض قائمة عمليات التفتيش |
| POST | /api/v1/inspections/ | إنشاء تفتيش من قالب |
| GET | /api/v1/inspections/templates/ | عرض قائمة قوالب قوائم التحقق |
| PATCH | /api/v1/inspections/{id}/items | تحديث نتائج بنود قائمة التحقق |
وثّق وتتبّع حالات عدم مطابقة الجودة عندما لا يفي العمل بالمواصفات. تتبع تقارير NCR دورة حياة رسمية من التحديد مروراً بتحليل السبب الجذري وصولاً إلى التحقق من الإجراء التصحيحي، بما يضمن معالجة كل انحرافات الجودة وتوثيقها بشكل سليم.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/ncr/ | عرض قائمة تقارير NCR |
| POST | /api/v1/ncr/ | إنشاء تقرير NCR |
| PATCH | /api/v1/ncr/{id}/status | تحديث حالة تقرير NCR |
| POST | /api/v1/ncr/{id}/actions | إضافة إجراء تصحيحي |
أدر عملية مراجعة المستندات المقدّمة لمواد البناء ومخططات التنفيذ وبيانات المنتجات. تتبّع سير عمل المراجعة متعدد المراحل حيث تمرّ المستندات المقدّمة عبر عدة مراجعين قبل الموافقة النهائية. احتفظ بسجل تدقيق كامل لجميع دورات المراجعة وتاريخ المراجعات.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/submittals/ | عرض قائمة المستندات المقدّمة |
| POST | /api/v1/submittals/ | إنشاء مستند مقدّم |
| POST | /api/v1/submittals/{id}/review | إرسال قرار المراجعة |
| POST | /api/v1/submittals/{id}/revise | رفع مراجعة جديدة |
احتفظ بسجل تواصل رسمي لجميع مراسلات المشروع. تتبّع الخطابات ورسائل البريد الإلكتروني والإشعارات والتعليمات بين أطراف المشروع بأرقام مرجعية فريدة، وتتبّع الردود، والبحث النصي الكامل. يضمن توثيق المراسلات التعاقدية وإمكانية تتبّعها بشكل سليم.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/correspondence/ | عرض قائمة المراسلات |
| POST | /api/v1/correspondence/ | إنشاء قيد مراسلة |
| GET | /api/v1/correspondence/{id} | الحصول على التفاصيل مع المرفقات |
| GET | /api/v1/correspondence/{id}/thread | الحصول على سلسلة المراسلات المرتبطة |
بيئة بيانات مشتركة متوافقة مع ISO 19650 لإدارة معلومات المشروع مع انتقالات حالة مُتحكَّم بها. تنتقل المستندات عبر حالات قيد العمل (WIP) والمشتركة والمنشورة والمؤرشفة مع بوابات موافقة. يضمن أن تتّبع إدارة المعلومات معايير BIM للتسليم التعاوني.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/cde/documents/ | عرض قائمة مستندات CDE (قابلة للتصفية حسب الحالة والملاءمة) |
| POST | /api/v1/cde/documents/ | رفع مستند إلى CDE |
| PATCH | /api/v1/cde/documents/{id}/status | انتقال حالة المستند |
| GET | /api/v1/cde/documents/{id}/history | الحصول على تاريخ المراجعات |
وزّع المستندات رسمياً على الأطراف الخارجية مع تتبّع التسليم والإقرار. أنشئ حِزم نقل تحتوي على عدة مستندات، وحدّد المستلمين، وتتبّع ما إذا كان كل مستلم قد استلم المستندات وأقرّ بها. يوفّر سجلاً تعاقدياً لتبادل المعلومات.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/transmittals/ | عرض قائمة إشعارات النقل |
| POST | /api/v1/transmittals/ | إنشاء إشعار نقل |
| POST | /api/v1/transmittals/{id}/send | إرسال إشعار النقل إلى المستلمين |
| PATCH | /api/v1/transmittals/{id}/acknowledge | تسجيل إقرار المستلم |
مركز محوري لإدارة نماذج BIM مع الوصول إلى البيانات على مستوى العناصر وربط مباشر بـ BOQ. ارفع نماذج IFC/RVT، وتصفّح عناصر المبنى مع خصائصها وكمياتها، واربط العناصر ببنود BOQ لتكامل التكلفة 5D. يوفّر جسراً بين بيانات التصميم وتقدير التكلفة.
🎬 عرض الربط الجماعي لـ BIM على YouTube - 100 جدار من BIM ← بند BOQ واحد بمساحة وحجم وطول مجمّعة.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/bim/models/ | عرض قائمة نماذج BIM |
| POST | /api/v1/bim/models/ | رفع نموذج BIM |
| GET | /api/v1/bim/models/{id}/elements | عرض قائمة عناصر النموذج |
| POST | /api/v1/bim/elements/{id}/link-boq | ربط عنصر ببند BOQ |
محرّك تقارير شامل مع لوحة مؤشرات KPI وقوالب تقارير قابلة للتخصيص وإنشاء تقارير مجدولة. اجمع البيانات عبر المشاريع للحصول على رؤى على مستوى المحفظة. أنشئ قوالب تقارير مخصصة تجمع بيانات من أي وحدة (BOQ، المالية، الجدول الزمني، السلامة، الجودة).
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | الحصول على مؤشرات KPI للمشروع |
| GET | /api/v1/reporting/templates/ | عرض قائمة قوالب التقارير |
| POST | /api/v1/reporting/generate | إنشاء تقرير من قالب |
| GET | /api/v1/reporting/portfolio/ | الحصول على بيانات لوحة المحفظة |
نظام إشعارات داخل التطبيق يُبقي المستخدمين على اطّلاع بالأحداث ذات الصلة بهم. تُفعَّل الإشعارات بإجراءات عبر جميع الوحدات - إسناد المهام، وردود RFI، ومراجعات المستندات المقدّمة، وطلبات الموافقة، والبنود المتأخرة، والمزيد. يتحكّم المستخدمون في تفضيلات إشعاراتهم لكل فئة.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/notifications/ | عرض قائمة الإشعارات (غير المقروءة أولاً) |
| PATCH | /api/v1/notifications/{id}/read | وضع علامة مقروء على الإشعار |
| POST | /api/v1/notifications/read-all | وضع علامة مقروء على الكل |
| GET | /api/v1/notifications/preferences | الحصول على تفضيلات الإشعارات |
مخطط Gantt قائم على SVG الخالص لتصور الجدول الزمني للبناء. يعرض الخطوط الزمنية والاعتماديات والمعالم والمسار الحرج مباشرة في المتصفح دون مكتبات خارجية. يدعم التكبير من العرض على مستوى اليوم إلى مستوى السنة ويصدّر إلى PDF/PNG لإعداد التقارير.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | الحصول على بيانات مخطط Gantt (الأنشطة، الاعتماديات) |
| PATCH | /api/v1/schedule/activities/{id} | تحديث تواريخ/تقدّم النشاط |
| POST | /api/v1/schedule/dependencies/ | إنشاء اعتمادية |
اضبط تفضيلات المنطقة الزمنية والعملة وتنسيق الأرقام وتنسيق التاريخ لكل مستخدم ولكل مشروع. تتدرّج الإعدادات الإقليمية من الإعدادات الافتراضية للنظام إلى تجاوزات على مستوى المشروع إلى تفضيلات على مستوى المستخدم، بما يضمن أن يرى كل عضو في الفريق البيانات منسّقة وفق إعداداته المحلية.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/settings/regional/ | الحصول على الإعدادات الإقليمية الحالية |
| PUT | /api/v1/settings/regional/ | تحديث الإعدادات الإقليمية |
| GET | /api/v1/settings/regional/timezones | عرض قائمة المناطق الزمنية المتاحة |
| GET | /api/v1/settings/regional/currencies | عرض قائمة العملات المدعومة |
فعّل أو عطّل وحدات المنصة لتخصيص OpenConstructionERP وفق سير عملك. يمكن تبديل كل وحدة بشكل مستقل دون التأثير على الوحدات الأخرى. تُخفى الوحدات المعطّلة من واجهة المستخدم، وتُعيد نقاط API الخاصة بها 404، وتبقى جداول قاعدة بياناتها سليمة لإعادة التفعيل.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/modules/ | عرض قائمة جميع الوحدات مع الحالة |
| PATCH | /api/v1/modules/{name}/toggle | تفعيل أو تعطيل وحدة |
| GET | /api/v1/modules/{name}/dependencies | فحص اعتماديات الوحدة |
حزم إقليمية مُهيّأة مسبقاً تُعدّ معايير التصنيف وقواعد الضرائب والإعدادات الافتراضية لقاعدة بيانات التكلفة وقوالب التقارير وقواعد الامتثال التنظيمي لأسواق محددة. ثبّت حزمة إقليمية لتهيئة المنصة فوراً لبلدك أو منطقتك.
| الحزمة | المنطقة | المعايير | العملة |
|---|---|---|---|
| US | الولايات المتحدة | MasterFormat, UniFormat, CSI | USD |
| DACH | ألمانيا، النمسا، سويسرا | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | المملكة المتحدة | NRM 1/2, RICS, JCT | GBP |
| Russia | روسيا، رابطة الدول المستقلة | GESN, FER, TER, SNIP | RUB |
| الشرق الأوسط | الإمارات، السعودية، قطر | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | الصين، اليابان، أستراليا | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | الهند | CPWD, IS standards, DSR | INR |
| LatAm | البرازيل، المكسيك، كولومبيا | SINAPI, CMIC, local norms | BRL/MXN/COP |
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /api/v1/regional-packs/ | عرض قائمة الحزم الإقليمية المتاحة |
| POST | /api/v1/regional-packs/{name}/install | تثبيت حزمة إقليمية |
| GET | /api/v1/regional-packs/{name}/details | الحصول على محتويات الحزمة وتهيئتها |
قدرات شاملة لاستيراد البيانات وتصديرها عبر جميع الوحدات. استورد جهات الاتصال والموازنات وقوائم BOQ وقواعد بيانات التكلفة من ملفات Excel وCSV مع تعيين ذكي للأعمدة. صدّر بيانات المشروع إلى Excel وPDF وCSV مع قوالب قابلة للتخصيص. تحافظ جميع عمليات التصدير على التنسيق وتتضمّن رؤوس بيانات وصفية.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| POST | /api/v1/import/contacts | استيراد جهات الاتصال من ملف |
| POST | /api/v1/import/budget | استيراد موازنة من Excel |
| POST | /api/v1/export/boq/{id} | تصدير BOQ (التنسيق: excel، pdf، gaeb، csv) |
| POST | /api/v1/export/report | إنشاء تقرير وتصديره |



| المتغير | الافتراضي | الوصف |
|---|---|---|
DATABASE_URL | (غير محدد = PostgreSQL مدمج) | قاعدة البيانات (PostgreSQL المدمج افتراضياً؛ حدّد قيمة لاستخدام PostgreSQL خارجي). اتركها غير محددة لاستخدام PostgreSQL المدمج، أو حدّدها بقاعدة بيانات خارجية، مثل postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | مفتاح JWT السري (غيّره في بيئة الإنتاج!) |
SEED_DEMO | true | إنشاء حسابات تجريبية |
VECTOR_BACKEND | lancedb | واجهة البحث المتجهي الخلفية |
يوفّر OpenConstructionERP واجهة REST API شاملة تشغّل الواجهة الأمامية ويمكن استخدامها للتكامل والأتمتة وسير العمل المخصّص. كل إجراء متاح في الواجهة - إنشاء المشاريع، تحرير جداول BOQ، تشغيل التقديرات بالذكاء الاصطناعي، البحث في التكاليف - متاح كنقطة نهاية API. وتتوفّر وثائق Swagger التفاعلية مع أزرار التجربة المباشرة على /api/docs عند تشغيل الخادم الخلفي.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| POST | /api/v1/users/auth/login | تسجيل الدخول |
| GET | /api/v1/projects/ | عرض قائمة المشاريع |
| GET | /api/v1/boq/boqs/?project_id=... | عرض قائمة قوائم BOQ |
| GET | /api/v1/costs/?q=concrete | البحث في التكاليف |
| POST | /api/v1/ai/quick-estimate | تقدير AI |
| POST | /api/v1/takeoff/cad-extract | استخراج CAD |
| GET | /api/health | فحص الحالة |
| الوحدة | البادئة | الوصف |
|---|---|---|
| Contacts | /api/v1/contacts/ | عمليات CRUD لدليل جهات الاتصال، الاستيراد |
| Tasks | /api/v1/tasks/ | إدارة المهام، لوحة Kanban |
| RFI | /api/v1/rfis/ | طلبات المعلومات |
| Finance | /api/v1/finance/ | الفواتير، الموازنات، المدفوعات، EVM |
| Procurement | /api/v1/procurement/ | أوامر الشراء، محاضر استلام البضائع |
| Safety | /api/v1/safety/ | الحوادث، الملاحظات، تسجيل المخاطر |
| Meetings | /api/v1/meetings/ | المحاضر، جدول الأعمال، بنود الإجراءات |
| Inspections | /api/v1/inspections/ | عمليات تفتيش الجودة، قوائم التحقق |
| NCR | /api/v1/ncr/ | تقارير عدم المطابقة |
| Submittals | /api/v1/submittals/ | مراجعة المستندات المقدّمة متعددة المراحل |
| Correspondence | /api/v1/correspondence/ | سجل التواصل |
| CDE | /api/v1/cde/ | بيئة مستندات ISO 19650 |
| Transmittals | /api/v1/transmittals/ | توزيع المستندات |
| BIM Hub | /api/v1/bim/ | نماذج BIM، العناصر، ربط BOQ |
| Reporting | /api/v1/reporting/ | لوحة مؤشرات KPI، قوالب التقارير |
| Notifications | /api/v1/notifications/ | نظام الإشعارات داخل التطبيق |
| Comments | /api/v1/comments/ | تعليقات بسلاسل على أي كيان |
| Gantt | /api/v1/schedule/gantt/ | تصور الجدول الزمني بـ SVG |
| Regional | /api/v1/settings/regional/ | المنطقة الزمنية، العملة، تفضيلات التنسيق |
| Modules | /api/v1/modules/ | تفعيل/تعطيل الوحدات |
| Regional Packs | /api/v1/regional-packs/ | تثبيت الإعدادات الإقليمية |
| Import/Export | /api/v1/import/ / /api/v1/export/ | استيراد وتصدير البيانات بالجملة |
راجع قسم كل وحدة أعلاه للحصول على توثيق مفصّل لنقاط النهاية مع المعاملات والأوصاف.
تحليل للمشروع مدعوم بالذكاء الاصطناعي يقيّم مشروعك عبر 9 مجالات مرجّحة ويولّد درجة اكتمال من 0 إلى 100 (تقديرات من A إلى F).
API: GET /api/v1/project_intelligence/score/?project_id=X - يعيد الدرجة الإجمالية ودرجات المجالات والثغرات الحرجة والإنجازات.
أدر أعضاء الفريق والأدوار والتحكّم في الوصول لكل وحدة.
يمكن للمسؤولين تهيئة رؤية الوحدات ومستويات الوصول لكل مستخدم (بدون، عرض، تحرير، كامل) عبر صفحة /users. ويمكن إسناد أسماء أدوار مخصّصة (مثل "مهندس موقع"، "مدير تكلفة").
ضع نجمة على المستودع لمساعدة الآخرين على اكتشاف المشروع.
اشترك للحصول على شروحات الإصدارات والدروس التعليمية. ابدأ بـ جولة المنتج التي مدتها 12 دقيقة.
افتح مشكلة (issue) على GitHub.
انضم إلى مجتمع Telegram لطرح الأسئلة.
تواصل معنا للنشر والتدريب.
الترخيص: AGPL-3.0. الترخيص التجاري: info@datadrivenconstruction.io
التعليقات
نظام تعليقات بسلاسل يمكن إرفاقه بأي كيان في المنصة - بنود BOQ، والمهام، وطلبات RFI، والمستندات المقدّمة، والمستندات، وعمليات التفتيش، والمزيد. يدعم الإشارات @ لإخطار أعضاء الفريق، والمرفقات، وتتبّع المعالجة للمناقشات الموجّهة نحو الإجراءات.
الميزات الرئيسية
نقاط نهاية API
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve