مساعدة التثبيت
تثبيت OpenConstructionERP
اختر طريقة التشغيل التي تناسبك، واتبع الخطوات المرقمة، وإذا بدا شيء غير صحيح فابحث عن الرسالة التي تظهر لك في قائمة المشكلات أدناه. لا تعرّض أي من التحذيرات أثناء التثبيت مشاريعك للخطر.
لست متأكدًا مما تحتاجه؟
- تستخدم Windows 10 أو 11مثبّت Windows (.exe)
- لديك جهاز Mac بمعالج M1 أو M2 أو M3 أو M4macOS (.dmg، Apple Silicon)
- لديك جهاز Mac بمعالج Intelpip أو Docker (لا يوجد تطبيق لأجهزة Mac بمعالج Intel)
- تستخدم Ubuntu أو Debian أو Linux MintLinux .deb
- تستخدم Fedora أو RHEL أو Rocky LinuxLinux .rpm
- تستخدم توزيعة Linux أخرىLinux AppImage
- لديك Python 3.12 أو أحدث، أو تريده على خادمpip
- تستخدم Docker أو تجهّزه لفريقDocker
شاهد أولًا
كيفية تثبيت OpenConstructionERP
شرح بالفيديو على Windows، تم تسجيله بالإصدار 17.7.1. تبدو بعض الشاشات مختلفة في 18.5، وتم اختصار وقت الانتظار أثناء التثبيت في الفيديو.
Windows
- 1
نزّل
OpenConstructionERP_18.5.0_x64-setup.exeمن صفحة الإصدار.ما ستراهملف بحجم نحو 800 MB في مجلد التنزيلات (Downloads).
- 2
انقر عليه نقرًا مزدوجًا. إذا ظهرت نافذة زرقاء تقول "Windows حمى جهاز الكمبيوتر" ("Windows protected your PC")، فانقر "مزيد من المعلومات" ("More info")، وتأكد أن اسم الملف يبدأ بـ OpenConstructionERP، ثم انقر "تشغيل على أي حال" ("Run anyway").
ما ستراهيطلب Windows صلاحية المسؤول. انقر "نعم".
- 3
اختر لغة المثبّت، ووافق على الترخيص، وأبقِ المجلد المقترح
C:\Program Files\OpenConstructionERP.ما ستراهشريط تقدم ثم صفحة إنهاء.
- 4
انقر "إنهاء" أو شغّل OpenConstructionERP من قائمة ابدأ.
ما ستراهشاشة تحميل "جارٍ بدء التطبيق" مع قائمة: بدء الواجهة الخلفية (backend)، بدء قاعدة البيانات المحلية، تجهيز قاعدة البيانات، بدء خادم التطبيق، فتح التطبيق.
- 5
انتظر عند أول تشغيل. لا تغلق النافذة.
ما ستراه"التشغيل الأول يجهّز قاعدة بياناتك المحلية. قد يستغرق دقيقة أو دقيقتين، يرجى الانتظار." التشغيلات التالية أسرع بكثير.
- 6
اختر طريقة الفتح: كنافذة تطبيق (موصى به) أو في متصفحك المعتاد.
ما ستراه"كيف تريد فتح OpenConstructionERP؟" ثم صفحة تسجيل الدخول.
- 7
سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.
ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.
- 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 frompgdata.location>\log)لماذا لم تبدأ قاعدة البيانات المدمجة.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(اكتب%TEMP%في شريط عنوان مستكشف الملفات)لماذا رفض مثبّت Windows مجلد التثبيت.
لفتح المجلد، الصق هذا في شريط عنوان مستكشف الملفات:
%USERPROFILE%\.openestimatemacOS
- 1
نزّل
OpenConstructionERP_18.5.0_aarch64.dmgوافتحه.ما ستراهنافذة تحمل أيقونة تطبيق OpenConstructionERP.
- 2
اسحب OpenConstructionERP إلى Applications.
ما ستراهيظهر التطبيق في مجلد Applications.
- 3
افتح Terminal مرة واحدة وشغّل.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appما ستراهلا يوجد ناتج. وهذا صحيح. يزيل الأمر علامة التنزيل لأن Apple لم توثّق (notarize) التطبيق بعد.
- 4
افتح OpenConstructionERP من Applications.
ما ستراهشاشة التحميل "جارٍ بدء التطبيق". يجهّز أول تشغيل قاعدة البيانات المحلية ويستغرق دقيقة أو دقيقتين.
- 5
اختر نافذة تطبيق أو متصفحًا.
ما ستراهصفحة تسجيل الدخول.
- 6
سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.
ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.
- 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 ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
نزّل
OpenConstructionERP_18.5.0_amd64.deb.ما ستراهملف بحجم نحو 830 MB.
- 2
في الطرفية، داخل مجلد التنزيل، شغّل.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debما ستراهيعرض apt الحزمة والمكتبات التي تحتاجها ثم يثبّتها. الرمز ./ قبل اسم الملف مهم.
- 3
شغّل OpenConstructionERP من قائمة التطبيقات.
ما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.
- 4
سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.
ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.
- 5
في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.
ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
نزّل
OpenConstructionERP-18.5.0-1.x86_64.rpm.ما ستراهملف بحجم نحو 850 MB.
- 2
شغّل.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmما ستراهيحل dnf الاعتماديات ويثبّت.
- 3
شغّل OpenConstructionERP من قائمة التطبيقات.
ما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.
- 4
سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.
ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.
- 5
في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.
ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.
Linux: AppImage (any distribution)
- 1
نزّل
OpenConstructionERP_18.5.0_amd64.AppImage.ما ستراهملف بحجم نحو 910 MB.
- 2
اجعله قابلًا للتنفيذ.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageما ستراهلا يوجد ناتج.
- 3
شغّله.
./OpenConstructionERP_18.5.0_amd64.AppImageما ستراهشاشة التحميل. يستغرق أول تشغيل دقيقة أو دقيقتين.
- 4
سجّل الدخول بالحساب التجريبي: البريد الإلكتروني demo@openconstructionerp.com، وكلمة المرور DemoPass1234!. بعد ذلك يمكنك إنشاء حسابك ومشاريعك.
ما ستراهالتطبيق. تُنشأ المشاريع التجريبية في الخلفية عند أول تشغيل، لذلك قد تقول قائمة المشاريع لوقت قصير إنها في الطريق.
- 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 ~/.openestimatepip
- 1
شغّل.
pip install --upgrade openconstructionerpما ستراهينزّل pip الحزمة واعتمادياتها.
- 2
شغّل.
openconstructionerpما ستراهتحية قصيرة. عند أول تشغيل يسأل هل تريد تحميل المشاريع التجريبية وهل تريد فتح المتصفح.
- 3
انتظر بينما تُجهَّز قاعدة البيانات المحلية.
ما ستراه"Database: embedded PostgreSQL 16 (no Docker)" ثم يبدأ الخادم. يفتح متصفحك http://127.0.0.1:8080 (وهو نفسه http://localhost:8080).
- 4
سجّل الدخول. مع البيانات التجريبية يمكنك استخدام demo@openconstructionerp.com / DemoPass1234!
ما ستراهلوحة التحكم.
- 5
في التثبيت الجديد يُسأل المسؤول مرة واحدة عن الوحدات التي ستستخدمها. حدّد ما تحتاجه وتابع. يمكنك تغيير ذلك لاحقًا من زر "الخدمات الخلفية" في الشريط العلوي.
ما ستراهقائمة وحدات تظهر مرة واحدة مع الذاكرة التي تحتاجها كل وحدة.
- 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
- 1
في مجلد فارغ نزّل ملفي compose.
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.ymlcurl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.ymlما ستراهملفان في المجلد.
- 2
أنشئ ملف الأسرار مرة واحدة.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envما ستراهملف
.env. احتفظ به: يحوي كلمة مرور قاعدة البيانات وسر تسجيل الدخول. - 3
شغّله.
docker compose pull app && docker compose up -dما ستراهتبدأ حاويتان: postgres وapp.
- 4
افتح http://localhost:8080 وسجّل الدخول بـ demo@openconstructionerp.com / DemoPass1234!
ما ستراهصفحة تسجيل الدخول. قد يستغرق أول تشغيل دقيقة بينما تُجهَّز قاعدة البيانات.
- 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.
بياناتك والترقيات والإزالة
- Windows
C:\Users\<your name>\.openestimateإضافة إلىC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdataإذا كان اسم المستخدم لديك يحوي أحرفًا غير لاتينية؛ يذكره الملفpgdata.location. - macOS~/
.openestimate(مخفي؛ اضغط Cmd+Shift+. في Finder) - Linux~/
.openestimate - pip~/
.openestimate، وهو المجلد نفسه الذي يستخدمه تطبيق سطح المكتب، إلا إذا مرّرت--data-dirأو ضبطتOE_DATA_DIR - Dockerوحدات تخزين Docker <folder>_pg_data (قاعدة البيانات) و<folder>_app_data (الملفات)، حيث <folder> هو اسم المجلد الذي فيه
docker-compose.yml
الترقية
ثبّت الإصدار الجديد فوق القديم. مجلد .openestimate ليس جزءًا من البرنامج، لذلك تبقى المشاريع والمستخدمون والإعدادات. قد يستغرق أول تشغيل بعد الترقية وقتًا أطول بينما تحدّث قاعدة البيانات نفسها.
الإزالة
تزيل الإزالة البرنامج وتُبقي مشاريعك. في Windows يعرض برنامج الإزالة خيار "Delete the application data" (بلغة المثبّت): وهو يحذف فقط تسجيل الدخول واللغة المحفوظين من نافذة التطبيق (في %APPDATA% و%LOCALAPPDATA%\io.openconstructionerp.desktop)، لا مشاريعك. للبدء من الصفر، أزل البرنامج، وانسخ .openestimate إلى مكان آمن، ثم احذفه.
نسخة احتياطية
أغلق التطبيق وانسخ مجلد .openestimate (ومجلد ProgramData المذكور في pgdata.location إن وُجد).
ما زلت عالقًا؟ سنساعدك
يرجى إرفاق:
- الإصدار (موجود في اسم الملف الذي نزّلته؛ pip:
openconstructionerp --version؛ Docker: وسم الصورة) وطريقة التثبيت (مثبّت Windows أو .dmg أو .deb أو .rpm أو AppImage أو pip أو Docker) - نظامك (Windows: ابدأ، اكتب
winver؛ macOS: قائمة Apple ثم About This Mac؛ Linux: التوزيعة والإصدار) - النص الدقيق للرسالة أو لقطة شاشة
- ملفات السجل المذكورة أعلاه
قد تحتوي ملفات السجل على اسم المستخدم وأسماء المجلدات. راجعها قبل نشرها؛ الأفضل إرسالها بالبريد الإلكتروني إن أردت.
الخطوات التالية بعد التثبيت
النص الكامل متوفر أيضًا على GitHub بالصيغ English وDeutsch وРусский.