مساعدة التثبيت

تثبيت OpenConstructionERP

اختر طريقة التشغيل التي تناسبك، واتبع الخطوات المرقمة، وإذا بدا شيء غير صحيح فابحث عن الرسالة التي تظهر لك في قائمة المشكلات أدناه. لا تعرّض أي من التحذيرات أثناء التثبيت مشاريعك للخطر.

لست متأكدًا مما تحتاجه؟

شاهد أولًا

كيفية تثبيت OpenConstructionERP

شرح بالفيديو على Windows، تم تسجيله بالإصدار 17.7.1. تبدو بعض الشاشات مختلفة في 18.5، وتم اختصار وقت الانتظار أثناء التثبيت في الفيديو.

المدة 4:41 · شاهد على YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeنحو 800 MB

قبل أن تبدأ Windows 10 أو 11، بنظام 64 بت. صلاحية المسؤول (يُثبَّت التطبيق لجميع المستخدمين). لا تحتاج إلى الإنترنت أثناء التثبيت: مكوّن النافذة (Microsoft WebView2) مضمّن في المثبّت.

شاهد هذه الخطوة:
  1. 1

    نزّل OpenConstructionERP_18.5.0_x64-setup.exe من صفحة الإصدار.

    ما ستراهملف بحجم نحو 800 MB في مجلد التنزيلات (Downloads).

  2. 2

    انقر عليه نقرًا مزدوجًا. إذا ظهرت نافذة زرقاء تقول "Windows حمى جهاز الكمبيوتر" ("Windows protected your PC")، فانقر "مزيد من المعلومات" ("More info")، وتأكد أن اسم الملف يبدأ بـ OpenConstructionERP، ثم انقر "تشغيل على أي حال" ("Run anyway").

    ما ستراهيطلب Windows صلاحية المسؤول. انقر "نعم".

  3. 3

    اختر لغة المثبّت، ووافق على الترخيص، وأبقِ المجلد المقترح C:\Program Files\OpenConstructionERP.

    ما ستراهشريط تقدم ثم صفحة إنهاء.

  4. 4

    انقر "إنهاء" أو شغّل OpenConstructionERP من قائمة ابدأ.

    ما ستراهشاشة تحميل "جارٍ بدء التطبيق" مع قائمة: بدء الواجهة الخلفية (backend)، بدء قاعدة البيانات المحلية، تجهيز قاعدة البيانات، بدء خادم التطبيق، فتح التطبيق.

  5. 5

    انتظر عند أول تشغيل. لا تغلق النافذة.

    ما ستراه"التشغيل الأول يجهّز قاعدة بياناتك المحلية. قد يستغرق دقيقة أو دقيقتين، يرجى الانتظار." التشغيلات التالية أسرع بكثير.

  6. 6

    اختر طريقة الفتح: كنافذة تطبيق (موصى به) أو في متصفحك المعتاد.

    ما ستراه"كيف تريد فتح OpenConstructionERP؟" ثم صفحة تسجيل الدخول.

  7. 7

    سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.

    ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.

  8. 8

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

إذا ظهرت لك رسالة

التثبيتنافذة زرقاء "Windows حمى جهاز الكمبيوتر" ("Windows protected your PC").

ماذا يعني هذا المثبّت غير موقّع رقميًا بعد، لذلك لا يعرف Windows الناشر. هذا تحذير وليس اكتشاف فيروس.

ماذا تفعل انقر "مزيد من المعلومات" ("More info")، وتأكد أن اسم الملف يبدأ بـ OpenConstructionERP، ثم انقر "تشغيل على أي حال" ("Run anyway").

التثبيتحظر Smart App Control التطبيق ولا يوجد زر للمتابعة.

ماذا يعني هذا يرفض Smart App Control في Windows 11 البرامج غير الموقّعة.

ماذا تفعل لا يستطيع Smart App Control السماح بتطبيق واحد فقط. لإبقائه مفعّلًا، شغّل OpenConstructionERP عبر Docker Desktop أو داخل WSL (نظام Linux المدمج في Windows)، فلا يفحصهما Smart App Control. الخطوات بالتفصيل: docs/desktop/WINDOWS_BLOCKED.md في المستودع.

التثبيت"Please choose an installation folder whose path uses only Latin letters, digits and spaces. The built-in database cannot start from a folder with other characters in its path" (الرسالة متوفرة بالإنجليزية فقط)المعنى: يجب ألا يحتوي مسار مجلد التثبيت إلا على أحرف لاتينية وأرقام ومسافات، لأن قاعدة البيانات المدمجة لا تستطيع العمل من أي مسار آخر.

ماذا يعني هذا يحتوي مسار المجلد الذي اخترته على أحرف سيريلية أو صينية أو أحرف بعلامات تشكيل أو أحرف غير لاتينية أخرى.

ماذا تفعل أبقِ المجلد المقترح C:\Program Files\OpenConstructionERP أو اختر مجلدًا مثل C:\OpenConstructionERP. ينتهي التثبيت الصامت (/S) بالرمز 3 ويكتب السبب في %TEMP%\OpenConstructionERP-install-error.log.

التثبيتيتوقف المثبّت بخطأ يخص WebView2.

ماذا يعني هذا رفض Windows تثبيت Microsoft WebView2، وهو المكوّن الذي يرسم نافذة التطبيق. هو مضمّن في المثبّت فلا حاجة للإنترنت؛ الخطأ يأتي من Windows نفسه (سياسة، أو تحديث معلّق، أو WebView2 أقدم تالف).

ماذا تفعل أعد تشغيل الكمبيوتر وشغّل المثبّت مرة أخرى. إذا فشل ثانية، ثبّت "Microsoft Edge WebView2 Runtime" من Microsoft ثم شغّل مثبّتنا مرة أخرى.

التثبيتبرنامج مكافحة الفيروسات يحذف ملفًا أو يعزله أثناء التثبيت أو عند أول تشغيل.

ماذا يعني هذا البرنامج جديد وغير موقّع، وبعض برامج مكافحة الفيروسات تتعامل معه بريبة.

ماذا تفعل استعد الملف من العزل وأضف هذين المجلدين إلى الاستثناءات: مجلد البرنامج C:\Program Files\OpenConstructionERP ومجلد بياناتك C:\Users\<your name>\.openestimate. ثم شغّل المثبّت مرة أخرى فوق التثبيت الحالي. إذا لم تكن متأكدًا من أصالة الملف فراسلنا أولًا.

الترقيةشاشة تسأل هل تريد الكتابة فوق الإصدار المثبّت أم إزالته أولًا، مع سطر يقترح الإزالة.

ماذا تفعل أبقِ الخيار المحدد مسبقًا (الكتابة فوق). مشاريعك تبقى كما هي. قد يستغرق أول تشغيل بعد الترقية وقتًا أطول بينما تحدّث قاعدة البيانات نفسها.

الترقيةتشغّل OpenConstructionERP أيضًا عبر pip أو من الطرفية على الجهاز نفسه، ويتوقف أثناء الترقية.

ماذا يعني هذا كلاهما يستخدم المجلد نفسه .openestimate وقاعدة البيانات نفسها. يوقف المثبّت تلك القاعدة ليستبدل البرنامج. عند الترقية من 18.4.0 يغلق برنامج الإزالة القديم أيضًا أي برنامج اسمه openconstructionerp.exe.

ماذا تفعل أوقف نسخة الطرفية (Ctrl+C) قبل التثبيت أو الترقية، ثم شغّلها من جديد بعد ذلك.

بدء التشغيلتبقى شاشة التحميل دقيقة أو أكثر عند أول تشغيل.

ماذا يعني هذا ينشئ التطبيق قاعدة بياناته المحلية. يحدث هذا مرة واحدة فقط.

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

بدء التشغيلمربع "OpenConstructionERP failed to start" يذكر ملف سجل.

ماذا يعني هذا لم يتمكن التطبيق من فتح نافذته إطلاقًا.

ماذا تفعل شغّله مرة أخرى. إذا ظهر المربع ثانية، أرسل لنا ملف السجل الذي يذكره.

بدء التشغيل"The backend started, but the local database is not answering, so the app cannot open."المعنى: بدأ جزء الخادم، لكن قاعدة بياناته المحلية لا تستجيب، لذلك لا يمكن فتح التطبيق.

ماذا يعني هذا لم تبدأ قاعدة البيانات المحلية، وغالبًا بعد جلسة لم تُغلق بشكل سليم.

ماذا تفعل أعد تشغيل الكمبيوتر ثم شغّل التطبيق مجددًا. إذا تكرر ذلك، أرسل لنا desktop-launcher.log وسجل قاعدة البيانات (انظر السجلات).

بدء التشغيل"The backend started, but this installation is missing the application files it serves"المعنى: بدأ جزء الخادم، لكن ملفات واجهة المستخدم غير موجودة في التثبيت.

ماذا يعني هذا ينقص جزء من مجلد البرنامج، عادةً لأن برنامج مكافحة الفيروسات أزاله.

ماذا تفعل افحص عزل برنامج مكافحة الفيروسات، ثم شغّل المثبّت مرة أخرى فوق التثبيت الحالي. مشاريعك لا تُمسّ.

بدء التشغيل"The application backend did not start in time" أو "The application backend stopped responding while preparing the local database" (أو في خطوة أخرى).

ماذا يعني هذا استغرق البدء أطول مما ينتظر التطبيق. تذكر الرسالة الخطوة التي كان عندها.

ماذا تفعل أغلق النافذة وشغّل من جديد. حرّر مساحة على القرص أولًا إن كان شبه ممتلئ. إذا توقف مجددًا عند الخطوة نفسها، أرسل لنا desktop-launcher.log.

بدء التشغيل"The drive ran out of space while the application was starting" أو "There is not enough free space to start the application".

ماذا يعني هذا هذا بالضبط. تذكر الرسالة المجلد والمساحة الحرة المتبقية.

ماذا تفعل حرّر مساحة على ذلك القرص وشغّل من جديد.

بدء التشغيلرسالة تقول إن مجلد قاعدة البيانات المحلية "sits too deep in the filesystem"، مع رقمين.

ماذا يعني هذا يحدّ Windows من طول المسار، ومسار مجلد بياناتك أطول من أن تستوعبه ملفات قاعدة البيانات. تفعيل المسارات الطويلة في Windows لا يفيد.

ماذا تفعل اضبط متغير بيئة المستخدم OE_DATA_DIR على مسار قصير مثل C:\OpenConstructionERP\data (ابدأ، اكتب "متغيرات البيئة"، تحرير متغيرات البيئة لحسابك، جديد)، ثم شغّل من جديد.

بدء التشغيلاسم مستخدم Windows لديك يحتوي على أحرف غير لاتينية (مثل السيريلية أو الصينية) وتبحث عن قاعدة بياناتك.

ماذا يعني هذا لا تستطيع قاعدة البيانات المدمجة العمل من مسار كهذا، لذلك يحتفظ بها التطبيق منذ 18.5.0 في C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. قبل 18.5.0 لم يكن التطبيق يبدأ أصلًا لمثل هذه الحسابات.

ماذا تفعل لا يوجد ما يلزم إصلاحه. الملف pgdata.location في مجلد .openestimate يذكر مجلد قاعدة البيانات بالضبط. للنسخ الاحتياطي انسخ المجلدين معًا.

أثناء التشغيل"The application backend stopped, restarting" وتُعاد تحميل النافذة.

ماذا يعني هذا توقف الجزء الخلفي من التطبيق بشكل غير متوقع وأعاد التطبيق تشغيله. العمل المحفوظ يبقى. يفعل ذلك مرتين على الأكثر خلال 30 دقيقة.

ماذا تفعل تابع العمل. إذا تكرر ذلك أو ظهرت "The application backend has stopped"، أرسل لنا desktop-launcher.log وlogs/backend-crash.log.

بدء التشغيلفي كل مرة تشغّل فيها التطبيق يُسجَّل خروجك وتعود اللغة إلى الإنجليزية.

ماذا يعني هذا برنامج آخر يستخدم المنفذ 8732 الذي يستخدمه التطبيق عادةً. عندها يختار الإصدار 18.5.0 منفذًا حرًا عشوائيًا عند كل تشغيل، وتعامل النافذة كل منفذ جديد على أنه موقع جديد، فلا يُعثر على تسجيل الدخول واللغة.

ماذا تفعل أغلق البرنامج الآخر الذي يستخدم المنفذ 8732 أو أعد ضبطه (في Windows شغّل netstat -ano | findstr :8732 في الطرفية لترى معرّف العملية). مشاريعك غير متأثرة، فقط تسجيل الدخول واختيار اللغة.

بدء التشغيلتخشى أن يتعارض التطبيق مع PostgreSQL تشغّله أصلًا على المنفذ 5432.

ماذا يعني هذا لا يتعارض. تأخذ قاعدة البيانات المدمجة في Windows منفذًا محليًا حرًا عشوائيًا، وفي macOS وLinux تستمع على مقبس محلي فقط لا على منفذ TCP.

ماذا تفعل لا حاجة لأي إجراء.

أين توجد السجلات

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logكل ما فعله تطبيق سطح المكتب عند البدء. دائمًا في مجلدك الرئيسي، حتى لو نقلت مجلد البيانات.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logتفاصيل عن توقف غير متوقع. يوجد في مجلد البيانات، لذلك ينتقل مع OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)لماذا لم تبدأ قاعدة البيانات المدمجة.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (اكتب %TEMP% في شريط عنوان مستكشف الملفات)لماذا رفض مثبّت Windows مجلد التثبيت.

لفتح المجلد، الصق هذا في شريط عنوان مستكشف الملفات:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgنحو 640 MB

قبل أن تبدأ جهاز Mac بمعالج Apple Silicon (M1 أو أحدث). لا يوجد إصدار لأجهزة Mac بمعالج Intel؛ على Mac بمعالج Intel استخدم pip أو Docker.

  1. 1

    نزّل OpenConstructionERP_18.5.0_aarch64.dmg وافتحه.

    ما ستراهنافذة تحمل أيقونة تطبيق OpenConstructionERP.

  2. 2

    اسحب OpenConstructionERP إلى Applications.

    ما ستراهيظهر التطبيق في مجلد Applications.

  3. 3

    افتح Terminal مرة واحدة وشغّل.

    xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app

    ما ستراهلا يوجد ناتج. وهذا صحيح. يزيل الأمر علامة التنزيل لأن Apple لم توثّق (notarize) التطبيق بعد.

  4. 4

    افتح OpenConstructionERP من Applications.

    ما ستراهشاشة التحميل "جارٍ بدء التطبيق". يجهّز أول تشغيل قاعدة البيانات المحلية ويستغرق دقيقة أو دقيقتين.

  5. 5

    اختر نافذة تطبيق أو متصفحًا.

    ما ستراهصفحة تسجيل الدخول.

  6. 6

    سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.

    ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.

  7. 7

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

إذا ظهرت لك رسالة

بدء التشغيلتبقى شاشة التحميل دقيقة أو أكثر عند أول تشغيل.

ماذا يعني هذا ينشئ التطبيق قاعدة بياناته المحلية. يحدث هذا مرة واحدة فقط.

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

بدء التشغيل"The backend started, but the local database is not answering, so the app cannot open."المعنى: بدأ جزء الخادم، لكن قاعدة بياناته المحلية لا تستجيب، لذلك لا يمكن فتح التطبيق.

ماذا يعني هذا لم تبدأ قاعدة البيانات المحلية، وغالبًا بعد جلسة لم تُغلق بشكل سليم.

ماذا تفعل أعد تشغيل الكمبيوتر ثم شغّل التطبيق مجددًا. إذا تكرر ذلك، أرسل لنا desktop-launcher.log وسجل قاعدة البيانات (انظر السجلات).

بدء التشغيل"The backend started, but this installation is missing the application files it serves"المعنى: بدأ جزء الخادم، لكن ملفات واجهة المستخدم غير موجودة في التثبيت.

ماذا يعني هذا ينقص جزء من مجلد البرنامج، عادةً لأن برنامج مكافحة الفيروسات أزاله.

ماذا تفعل افحص عزل برنامج مكافحة الفيروسات، ثم شغّل المثبّت مرة أخرى فوق التثبيت الحالي. مشاريعك لا تُمسّ.

بدء التشغيل"The application backend did not start in time" أو "The application backend stopped responding while preparing the local database" (أو في خطوة أخرى).

ماذا يعني هذا استغرق البدء أطول مما ينتظر التطبيق. تذكر الرسالة الخطوة التي كان عندها.

ماذا تفعل أغلق النافذة وشغّل من جديد. حرّر مساحة على القرص أولًا إن كان شبه ممتلئ. إذا توقف مجددًا عند الخطوة نفسها، أرسل لنا desktop-launcher.log.

بدء التشغيل"The application never finished unpacking itself, so its backend never started." أو "The application could not unpack itself into the temporary folder it uses."

ماذا يعني هذا في macOS وLinux يفك التطبيق ضغط واجهته الخلفية عند كل تشغيل. يعيق ذلك قرص بطيء أو ممتلئ أو برنامج مكافحة فيروسات يقفل الملفات. (تطبيق Windows لم يعد يفك ضغط نفسه منذ 18.5.)

ماذا تفعل حرّر مساحة على القرص الذي يوجد عليه مجلدك المؤقت أو اسمح للتطبيق في برنامج مكافحة الفيروسات، ثم شغّل من جديد.

بدء التشغيل"The drive ran out of space while the application was starting" أو "There is not enough free space to start the application".

ماذا يعني هذا هذا بالضبط. تذكر الرسالة المجلد والمساحة الحرة المتبقية.

ماذا تفعل حرّر مساحة على ذلك القرص وشغّل من جديد.

أثناء التشغيل"The application backend stopped, restarting" وتُعاد تحميل النافذة.

ماذا يعني هذا توقف الجزء الخلفي من التطبيق بشكل غير متوقع وأعاد التطبيق تشغيله. العمل المحفوظ يبقى. يفعل ذلك مرتين على الأكثر خلال 30 دقيقة.

ماذا تفعل تابع العمل. إذا تكرر ذلك أو ظهرت "The application backend has stopped"، أرسل لنا desktop-launcher.log وlogs/backend-crash.log.

بدء التشغيلفي كل مرة تشغّل فيها التطبيق يُسجَّل خروجك وتعود اللغة إلى الإنجليزية.

ماذا يعني هذا برنامج آخر يستخدم المنفذ 8732 الذي يستخدمه التطبيق عادةً. عندها يختار الإصدار 18.5.0 منفذًا حرًا عشوائيًا عند كل تشغيل، وتعامل النافذة كل منفذ جديد على أنه موقع جديد، فلا يُعثر على تسجيل الدخول واللغة.

ماذا تفعل أغلق البرنامج الآخر الذي يستخدم المنفذ 8732 أو أعد ضبطه (في Windows شغّل netstat -ano | findstr :8732 في الطرفية لترى معرّف العملية). مشاريعك غير متأثرة، فقط تسجيل الدخول واختيار اللغة.

بدء التشغيلتخشى أن يتعارض التطبيق مع PostgreSQL تشغّله أصلًا على المنفذ 5432.

ماذا يعني هذا لا يتعارض. تأخذ قاعدة البيانات المدمجة في Windows منفذًا محليًا حرًا عشوائيًا، وفي macOS وLinux تستمع على مقبس محلي فقط لا على منفذ TCP.

ماذا تفعل لا حاجة لأي إجراء.

التثبيت"OpenConstructionERP is damaged and can't be opened" (قد يظهر النص بلغة نظامك).

ماذا يعني هذا لم توثّق Apple التطبيق بعد وما زال يحمل علامة التنزيل. التطبيق ليس تالفًا.

ماذا تفعل هذا وحده ينفع: في Terminal شغّل مرة واحدة xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app ثم افتح التطبيق بشكل عادي.

التثبيت"OpenConstructionERP cannot be opened because the developer cannot be verified" (أو لم تستطع Apple التحقق من خلوّه من البرمجيات الخبيثة؛ قد يظهر النص بلغة نظامك).

ماذا يعني هذا التطبيق موقّع بتوقيع ad hoc لكن Apple لم توثّقه بعد.

ماذا تفعل شغّل أمر xattr نفسه أو افتح System Settings، ثم Privacy & Security، ومرّر للأسفل وانقر Open Anyway. تفعل ذلك مرة واحدة فقط.

التثبيتالتطبيق لا يعمل على جهاز Mac لديك إطلاقًا.

ماذا يعني هذا إصدار Mac مخصص لـ Apple Silicon فقط (M1 وما بعده). لا يوجد إصدار لـ Intel.

ماذا تفعل على Mac بمعالج Intel استخدم pip (Python 3.12 أو أحدث) أو Docker.

أين توجد السجلات

  • desktop-launcher.log~/.openestimate/desktop-launcher.logكل ما فعله تطبيق سطح المكتب عند البدء. دائمًا في مجلدك الرئيسي، حتى لو نقلت مجلد البيانات.
  • backend-crash.log~/.openestimate/logs/backend-crash.logتفاصيل عن توقف غير متوقع. يوجد في مجلد البيانات، لذلك ينتقل مع OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logلماذا لم تبدأ قاعدة البيانات المدمجة.

لفتح المجلد من الطرفية:

open ~/.openestimate

Linux

Linux: .deb (Ubuntu, Debian, Mint)
OpenConstructionERP_18.5.0_amd64.debنحو 830 MB

قبل أن تبدأ x86 بنظام 64 بت (amd64). تحتاج الحزمة إلى libwebkit2gtk-4.1-0 وسيثبّتها apt عنك. بُنيت على Ubuntu 22.04، لذا الخيار الآمن Ubuntu 22.04 أو أحدث وDebian 12 أو أحدث.

  1. 1

    نزّل OpenConstructionERP_18.5.0_amd64.deb.

    ما ستراهملف بحجم نحو 830 MB.

  2. 2

    في الطرفية، داخل مجلد التنزيل، شغّل.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    ما ستراهيعرض apt الحزمة والمكتبات التي تحتاجها ثم يثبّتها. الرمز ./ قبل اسم الملف مهم.

  3. 3

    شغّل OpenConstructionERP من قائمة التطبيقات.

    ما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.

  4. 4

    سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.

    ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.

  5. 5

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

Linux: .rpm (Fedora, RHEL, Rocky)
OpenConstructionERP-18.5.0-1.x86_64.rpmنحو 850 MB

قبل أن تبدأ x86 بنظام 64 بت. تحتاج الحزمة إلى مكتبة WebKitGTK 4.1 وسيثبّتها مدير الحزم عنك.

  1. 1

    نزّل OpenConstructionERP-18.5.0-1.x86_64.rpm.

    ما ستراهملف بحجم نحو 850 MB.

  2. 2

    شغّل.

    sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpm

    ما ستراهيحل dnf الاعتماديات ويثبّت.

  3. 3

    شغّل OpenConstructionERP من قائمة التطبيقات.

    ما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.

  4. 4

    سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.

    ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.

  5. 5

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

Linux: AppImage (any distribution)
OpenConstructionERP_18.5.0_amd64.AppImageنحو 910 MB

قبل أن تبدأ x86 بنظام 64 بت ومكتبة FUSE 2 (libfuse2؛ في Ubuntu 24.04 اسم الحزمة libfuse2t64).

  1. 1

    نزّل OpenConstructionERP_18.5.0_amd64.AppImage.

    ما ستراهملف بحجم نحو 910 MB.

  2. 2

    اجعله قابلًا للتنفيذ.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    ما ستراهلا يوجد ناتج.

  3. 3

    شغّله.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    ما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.

  4. 4

    سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.

    ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.

  5. 5

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

إذا ظهرت لك رسالة

بدء التشغيلتبقى شاشة التحميل دقيقة أو أكثر عند أول تشغيل.

ماذا يعني هذا ينشئ التطبيق قاعدة بياناته المحلية. يحدث هذا مرة واحدة فقط.

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

بدء التشغيل"The backend started, but the local database is not answering, so the app cannot open."المعنى: بدأ جزء الخادم، لكن قاعدة بياناته المحلية لا تستجيب، لذلك لا يمكن فتح التطبيق.

ماذا يعني هذا لم تبدأ قاعدة البيانات المحلية، وغالبًا بعد جلسة لم تُغلق بشكل سليم.

ماذا تفعل أعد تشغيل الكمبيوتر ثم شغّل التطبيق مجددًا. إذا تكرر ذلك، أرسل لنا desktop-launcher.log وسجل قاعدة البيانات (انظر السجلات).

بدء التشغيل"The backend started, but this installation is missing the application files it serves"المعنى: بدأ جزء الخادم، لكن ملفات واجهة المستخدم غير موجودة في التثبيت.

ماذا يعني هذا ينقص جزء من مجلد البرنامج، عادةً لأن برنامج مكافحة الفيروسات أزاله.

ماذا تفعل افحص عزل برنامج مكافحة الفيروسات، ثم شغّل المثبّت مرة أخرى فوق التثبيت الحالي. مشاريعك لا تُمسّ.

بدء التشغيل"The application backend did not start in time" أو "The application backend stopped responding while preparing the local database" (أو في خطوة أخرى).

ماذا يعني هذا استغرق البدء أطول مما ينتظر التطبيق. تذكر الرسالة الخطوة التي كان عندها.

ماذا تفعل أغلق النافذة وشغّل من جديد. حرّر مساحة على القرص أولًا إن كان شبه ممتلئ. إذا توقف مجددًا عند الخطوة نفسها، أرسل لنا desktop-launcher.log.

بدء التشغيل"The application never finished unpacking itself, so its backend never started." أو "The application could not unpack itself into the temporary folder it uses."

ماذا يعني هذا في macOS وLinux يفك التطبيق ضغط واجهته الخلفية عند كل تشغيل. يعيق ذلك قرص بطيء أو ممتلئ أو برنامج مكافحة فيروسات يقفل الملفات. (تطبيق Windows لم يعد يفك ضغط نفسه منذ 18.5.)

ماذا تفعل حرّر مساحة على القرص الذي يوجد عليه مجلدك المؤقت أو اسمح للتطبيق في برنامج مكافحة الفيروسات، ثم شغّل من جديد.

بدء التشغيل"The drive ran out of space while the application was starting" أو "There is not enough free space to start the application".

ماذا يعني هذا هذا بالضبط. تذكر الرسالة المجلد والمساحة الحرة المتبقية.

ماذا تفعل حرّر مساحة على ذلك القرص وشغّل من جديد.

أثناء التشغيل"The application backend stopped, restarting" وتُعاد تحميل النافذة.

ماذا يعني هذا توقف الجزء الخلفي من التطبيق بشكل غير متوقع وأعاد التطبيق تشغيله. العمل المحفوظ يبقى. يفعل ذلك مرتين على الأكثر خلال 30 دقيقة.

ماذا تفعل تابع العمل. إذا تكرر ذلك أو ظهرت "The application backend has stopped"، أرسل لنا desktop-launcher.log وlogs/backend-crash.log.

بدء التشغيلفي كل مرة تشغّل فيها التطبيق يُسجَّل خروجك وتعود اللغة إلى الإنجليزية.

ماذا يعني هذا برنامج آخر يستخدم المنفذ 8732 الذي يستخدمه التطبيق عادةً. عندها يختار الإصدار 18.5.0 منفذًا حرًا عشوائيًا عند كل تشغيل، وتعامل النافذة كل منفذ جديد على أنه موقع جديد، فلا يُعثر على تسجيل الدخول واللغة.

ماذا تفعل أغلق البرنامج الآخر الذي يستخدم المنفذ 8732 أو أعد ضبطه (في Windows شغّل netstat -ano | findstr :8732 في الطرفية لترى معرّف العملية). مشاريعك غير متأثرة، فقط تسجيل الدخول واختيار اللغة.

بدء التشغيلتخشى أن يتعارض التطبيق مع PostgreSQL تشغّله أصلًا على المنفذ 5432.

ماذا يعني هذا لا يتعارض. تأخذ قاعدة البيانات المدمجة في Windows منفذًا محليًا حرًا عشوائيًا، وفي macOS وLinux تستمع على مقبس محلي فقط لا على منفذ TCP.

ماذا تفعل لا حاجة لأي إجراء.

التثبيتيطلب ملف .deb الحزمة libwebkit2gtk-4.1-0 أو يبلغ dpkg عن اعتماديات غير مستوفاة.

ماذا يعني هذا يحتاج التطبيق إلى WebKitGTK 4.1 لرسم نافذته. الأمر dpkg -i لا يثبّت الاعتماديات.

ماذا تفعل ثبّت بالأمر sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb فهو يجلب المكتبة أيضًا. إذا لم تتوفر libwebkit2gtk-4.1-0 في توزيعتك (Ubuntu أقدم من 22.04، أو Debian أقدم من 12) فاستخدم pip.

التثبيتلا يفعل AppImage شيئًا عند النقر المزدوج.

ماذا يعني هذا الملف لم يُعلَّم بعد كبرنامج.

ماذا تفعل شغّل chmod +x OpenConstructionERP_18.5.0_amd64.AppImage ثم شغّله من جديد.

التثبيتخطأ في AppImage يذكر FUSE أو libfuse.so.2.

ماذا يعني هذا التوزيعات الأحدث لم تعد تثبّت مكتبة FUSE 2 التي تستخدمها ملفات AppImage.

ماذا تفعل ثبّتها (sudo apt install libfuse2، وفي Ubuntu 24.04 sudo apt install libfuse2t64) أو استخدم .deb أو .rpm أو pip.

أين توجد السجلات

  • desktop-launcher.log~/.openestimate/desktop-launcher.logكل ما فعله تطبيق سطح المكتب عند البدء. دائمًا في مجلدك الرئيسي، حتى لو نقلت مجلد البيانات.
  • backend-crash.log~/.openestimate/logs/backend-crash.logتفاصيل عن توقف غير متوقع. يوجد في مجلد البيانات، لذلك ينتقل مع OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logلماذا لم تبدأ قاعدة البيانات المدمجة.

لفتح المجلد من الطرفية:

xdg-open ~/.openestimate

pip

الحزمة openconstructionerp

قبل أن تبدأ Python 3.12 أو أحدث. تحقق بالأمر python --version. بدون Docker وبدون قاعدة بيانات منفصلة: يأتي pip مع PostgreSQL مدمج.

شاهد هذه الخطوة:
  1. 1

    شغّل.

    pip install --upgrade openconstructionerp

    ما ستراهينزّل pip الحزمة واعتمادياتها.

  2. 2

    شغّل.

    openconstructionerp

    ما ستراهتحية قصيرة. عند أول تشغيل يسأل هل تريد تحميل المشاريع التجريبية وهل تريد فتح المتصفح.

  3. 3

    انتظر بينما تُجهَّز قاعدة البيانات المحلية.

    ما ستراه"Database: embedded PostgreSQL 16 (no Docker)" ثم يبدأ الخادم. يفتح متصفحك http://127.0.0.1:8080 (وهو نفسه http://localhost:8080).

  4. 4

    سجّل الدخول. مع البيانات التجريبية يمكنك استخدام demo@openconstructionerp.com / DemoPass1234!

    ما ستراهلوحة التحكم.

  5. 5

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

  6. 6

    للإيقاف اضغط Ctrl+C في الطرفية. في المرة القادمة شغّل openconstructionerp من جديد فقط.

    ما ستراهيتوقف الخادم. تبقى بياناتك في مجلد .openestimate داخل مجلدك الرئيسي.

أوامر مفيدة

الأمر openconstructionerp غير موجود

python -m openconstructionerp

شيء لا يعمل: يفحص Python والمنفذ ومجلد البيانات وقاعدة البيانات ويخبرك بما تفعله

openconstructionerp doctor

المنفذ 8080 يستخدمه برنامج آخر

openconstructionerp serve --port 8081

يجب أن تصل أجهزة أخرى في شبكتك إليه

openconstructionerp serve --host 0.0.0.0 --port 8080

عليك إخبارنا بإصدارك

openconstructionerp --version

إذا ظهرت لك رسالة

التثبيتيقول pip إنه لم يجد توزيعة مناسبة أو إن المطلوب Python مختلف.

ماذا يعني هذا يحتاج OpenConstructionERP إلى Python 3.12 أو أحدث.

ماذا تفعل ثبّت Python 3.12 أو أحدث وشغّل python3.12 -m pip install --upgrade openconstructionerp (في Windows: py -3.12 -m pip install --upgrade openconstructionerp).

التثبيتerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).المعنى: نظام Linux لديك يحمي نسخة Python الخاصة به ويرفض تثبيت الحزم فيها.

ماذا يعني هذا لا يسمح Python الخاص بالنظام لـ pip بالتثبيت داخله.

ماذا تفعل استخدم pipx install openconstructionerp أو أنشئ بيئة افتراضية أولًا: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

بدء التشغيل"openconstructionerp" is not recognized أو command not found.

ماذا يعني هذا المجلد الذي يضع فيه pip الأوامر ليس ضمن PATH لديك (شائع في Windows).

ماذا تفعل شغّل بدلًا من ذلك python -m openconstructionerp. يعمل على أي نظام دون المساس بـ PATH.

بدء التشغيل"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"المعنى: برنامج آخر يستخدم المنفذ 8080 بالفعل، لذا شغّل التطبيق على منفذ آخر، مثل 8081.

ماذا يعني هذا برنامج آخر يستخدم المنفذ 8080.

ماذا تفعل شغّل الأمر المقترح وافتح العنوان الذي يطبعه.

بدء التشغيل"Embedded PostgreSQL could not start".المعنى: تعذر تشغيل قاعدة بيانات PostgreSQL المدمجة.

ماذا يعني هذا لم تبدأ قاعدة البيانات المدمجة. تطبع الرسالة مسار سجلها.

ماذا تفعل شغّل openconstructionerp doctor. إذا لم يفد، أعد التثبيت بالأمر pip install --upgrade --force-reinstall openconstructionerp وأرسل لنا السجل الذي يذكره.

أين توجد السجلات

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)بالنسبة إلى pip وDocker انسخ ما طبعته الطرفية وناتج openconstructionerp doctor.

Docker

الحزمة ghcr.io/datadrivenconstruction/openconstructionerp (tags 18.5.0, 18.5, latest; linux/amd64)

قبل أن تبدأ Docker مع Docker Compose. الصورة المنشورة مبنية لمعمارية x86-64 (amd64). على Apple Silicon أو أجهزة ARM الأخرى ابنِ من الشيفرة المصدرية (make quickstart) أو استخدم pip. الأوامر أدناه لصدفة bash (Linux أو macOS أو Git Bash أو WSL على Windows). لا يملك Windows PowerShell الأداة openssl ويكتب الملفات بصيغة لا يستطيع compose قراءتها.

  1. 1

    في مجلد فارغ نزّل ملفي compose.

    curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.yml
    curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.yml

    ما ستراهملفان في المجلد.

  2. 2

    أنشئ ملف الأسرار مرة واحدة.

    echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .env
    echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env

    ما ستراهملف .env. احتفظ به: يحوي كلمة مرور قاعدة البيانات وسر تسجيل الدخول.

  3. 3

    شغّله.

    docker compose pull app && docker compose up -d

    ما ستراهتبدأ حاويتان: postgres وapp.

  4. 4

    افتح http://localhost:8080 وسجّل الدخول بـ demo@openconstructionerp.com / DemoPass1234!

    ما ستراهصفحة تسجيل الدخول. قد يستغرق أول تشغيل دقيقة بينما تُجهَّز قاعدة البيانات.

  5. 5

    في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.

    ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.

أوامر مفيدة

تحقق أن الحاويتين تعملان وسليمتان

docker compose ps

اعرف سبب عدم بدء التطبيق

docker compose logs app

المنفذ 8080 على جهازك مشغول

OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d

إعداد compose هذا مخصص للتقييم والاستخدام المحلي. لخادم الإنتاج انظر docs/INSTALL_LINUX.md وdocker-compose.prod.yml في المستودع.

إذا ظهرت لك رسالة

بدء التشغيليتوقف Compose برسالة "POSTGRES_PASSWORD must be set" أو "JWT_SECRET must be set".

ماذا يعني هذا ملف .env الذي يحوي السرّين مفقود أو ليس في المجلد نفسه.

ماذا تفعل أنشئ ملف .env كما في الخطوة 2 داخل المجلد الذي فيه docker-compose.yml.

بدء التشغيللا يفتح http://localhost:8080.

ماذا يعني هذا الحاوية لا تعمل بعد أو المنفذ 8080 مشغول.

ماذا تفعل شغّل docker compose ps وdocker compose logs app. لمنفذ آخر: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d ثم افتح http://localhost:8081.

التثبيتعلى Mac بمعالج Apple Silicon أو جهاز ARM آخر، يحذّر Docker من أن منصة الصورة linux/amd64 لا تطابق، أو يعمل التطبيق ببطء شديد.

ماذا يعني هذا الصورة المنشورة مبنية لمعمارية x86-64 فقط.

ماذا تفعل ابنِ من الشيفرة المصدرية بالأمر make quickstart أو استخدم pip.

أين توجد السجلات

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)بالنسبة إلى pip وDocker انسخ ما طبعته الطرفية وناتج openconstructionerp doctor.

بياناتك والترقيات والإزالة

الترقية

ثبّت الإصدار الجديد فوق القديم. مجلد .openestimate ليس جزءًا من البرنامج، لذلك تبقى المشاريع والمستخدمون والإعدادات. قد يستغرق أول تشغيل بعد الترقية وقتًا أطول بينما تحدّث قاعدة البيانات نفسها.

الإزالة

تزيل الإزالة البرنامج وتُبقي مشاريعك. في Windows يعرض برنامج الإزالة خيار "Delete the application data" (بلغة المثبّت): وهو يحذف فقط تسجيل الدخول واللغة المحفوظين من نافذة التطبيق (في %APPDATA% و%LOCALAPPDATA%\io.openconstructionerp.desktop)، لا مشاريعك. للبدء من الصفر، أزل البرنامج، وانسخ .openestimate إلى مكان آمن، ثم احذفه.

نسخة احتياطية

أغلق التطبيق وانسخ مجلد .openestimate (ومجلد ProgramData المذكور في pgdata.location إن وُجد).

ما زلت عالقًا؟ سنساعدك

يرجى إرفاق:

قد تحتوي ملفات السجل على اسم المستخدم وأسماء المجلدات. راجعها قبل نشرها؛ الأفضل إرسالها بالبريد الإلكتروني إن أردت.

الخطوات التالية بعد التثبيت

ثبّتّ وسجّلت الدخول؟ شاهد هذه الفيديوهات بالترتيب. كل فيديو قصير ويعرض التطبيق الفعلي.

  1. الخطوات الأولى بعد التثبيت

    النصف الثاني من فيديو التثبيت: التشغيل الأول، واللغة والمنطقة، والوحدات، والمستخدمون، ومشروعك الأول.

  2. شاهد المنتج كاملاً

    مفيد أيضاً

    جولة في المنتج: BOQ وBIM وDWG وحصر الكميات من PDF والتقدير بالذكاء الاصطناعي

    12:01 دقيقة، سُجّل بإصدار أقدم. يعرض أيضاً التثبيت عبر pip.

    جولة قصيرة، 2:37: مبنى واحد ومصدر واحد للحقيقة

  3. أساسيات التقدير

  4. سوقك من البداية إلى النهاية

    Builder's Playbook UK: Construction in England6 فيديوهات · ENالإدارة التجارية في المملكة المتحدة: تسعير العطاءات وفق NRM 2، ومقارنة العروض، ودفعات JCT والمبالغ المحتجزة، وpay less notices، وCIS والتحصيل العكسي لضريبة القيمة المضافة، وأوامر التغيير.Builder's Playbook: Canada6 فيديوهات · ENكندا/أونتاريو: التسعير، ومناقصات مقاولي الباطن، ودفعات الإنجاز وفق CCDC 2، والدفع في الوقت المحدد (prompt payment)، وأوامر التغيير، والإنجاز الجوهري.Builder's Playbook: Québec5 فيديوهات · FRكيبيك بالفرنسية: البدء، والتقدير، ومناقصات BSDQ، والفوترة مع المبالغ المحتجزة والرهن القانوني، والاستلام والعيوب.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 فيديوهات · DEسلسلة ألمانية من إعداد المشروع مروراً بالمخططات/RFI والكميات وفحوصات BIM وLV وأسعار الوحدات وGAEB X83/X84 وصولاً إلى الترسية (مرقّمة /12، نُشر منها 8).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 فيديوهات · HRكرواتيا: استيراد BOQ التعاقدي من Excel، والفواتير الواردة، ومقاولو الباطن، والمستخلصات المرحلية، والموقف المالي، والأعمال الإضافية.
  5. إدارة الموقع: الميزانية والمشتريات وساعات العمل والفواتير

كل قوائم التشغيل على قناة OpenConstruction Academy

النص الكامل متوفر أيضًا على GitHub بالصيغ English وDeutsch وРусский.