Part DB server

التوثيق | تجريبي | صورة عامل الميناء

جزء-DB

Part-DB هو نظام إدارة مخزون مفتوح المصدر للمكونات الإلكترونية الخاصة بك. يتم تثبيته على خادم ويب وبالتالي يمكن الوصول إليه باستخدام أي متصفح دون الحاجة إلى تثبيت برامج إضافية.

الإصدار الموجود في هذا المستودع عبارة عن إعادة كتابة كاملة لقاعدة بيانات Part-DB القديمة (الإصدار <1.0) استنادًا إلى إطار عمل حديث وهو الإصدار الموصى باستخدامه.

إذا وجدت خطأ، يرجى فتح مشكلة على GitHub، حتى يمكن إصلاحها للجميع.

تجريبي

إذا كنت تريد اختبار Part-DB دون تثبيته، فيمكنك استخدام مثيل Heroku هذا. (أو هذا الرابط للنسخة الألمانية).

يمكنك تسجيل الدخول باسم المستخدم: المستخدم وكلمة المرور: المستخدم .

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

سمات

• إدارة المخزون من الأجزاء الإلكترونية الخاصة بك. يمكن تعيين كل جزء إلى فئة وبصمة وشركة مصنعة ومواقع متاجر متعددة ومعلومات عن الأسعار. يمكن تجميع الأجزاء باستخدام العلامات. يمكنك ربط ملفات مختلفة مثل أوراق البيانات أو الصور بالأجزاء.
• دعم متعدد اللغات (حاليًا الألمانية والإنجليزية والروسية واليابانية والفرنسية والتشيكية والدنماركية والصينية)
• مولد الرموز الشريطية/الملصقات للأجزاء ومواقع التخزين، ومسح الرموز الشريطية ضوئيًا عبر كاميرا الويب باستخدام ماسح الباركود المدمج
• نظام المستخدم مع المجموعات والأذونات التفصيلية (الدقيقة). يتم دعم المصادقة الثنائية (Google Authenticator ومفاتيح Webauthn/U2F) ويمكن فرضها على المجموعات. يمكن إعداد إعادة تعيين كلمة المرور عبر البريد الإلكتروني.
• دعم اختياري لتسجيل الدخول الموحد (SSO) عبر SAML (باستخدام خدمة وسيطة مثل Keycloak، يمكنك توصيل Part-DB بخادم LDAP أو Active Directory موجود)
• نظام الاستيراد/التصدير للأجزاء وبنية البيانات. يتم دعم استيراد BOM للمشاريع من KiCAD.
• إدارة المشروع: قم بإنشاء المشاريع وتعيين أجزاء إلى قائمة المواد (BOM)، لإظهار عدد المرات التي يمكنك فيها إنشاء هذا المشروع وسحب جميع المكونات المطلوبة مباشرة من قاعدة البيانات
• سجل الأحداث: تتبع التغييرات التي تحدث لمخزونك، وتتبع المستخدم الذي يفعل ماذا. قم بإرجاع الأجزاء الخاصة بك إلى الإصدارات الأقدم.
• تصميم سريع الاستجابة: يمكنك استخدام Part-DB على جهاز الكمبيوتر الخاص بك والجهاز اللوحي والهاتف الذكي باستخدام نفس الواجهة.
• يتم دعم MySQL وSQLite وPostgreSQL كواجهة خلفية لقاعدة البيانات
• دعم لأوصاف النص الغني والتعليقات في أجزاء
• دعم عملات متعددة والتحديث التلقائي لأسعار الصرف المدعومة
• وظيفة بحث وتصفية قوية، بما في ذلك البحث البارامتري (البحث عن الأجزاء وفقًا لبعض المواصفات)
• إنشاء الصور المصغرة تلقائيًا للصور
• استخدم موفري الخدمات السحابية (مثل Octopart أو Digikey أو Farnell أو LCSC أو TME) للحصول تلقائيًا على معلومات الأجزاء وأوراق البيانات وأسعار الأجزاء
• API للوصول إلى Part-DB من التطبيقات/البرامج النصية الأخرى
• التكامل مع KiCad: استخدم Part-DB كمصدر بيانات مركزي لـ KiCad الخاص بك وشاهد الأجزاء المتاحة من Part-DB مباشرة داخل KiCad.

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

يتم استخدام Part-DB أيضًا من قبل الشركات الصغيرة والجامعات لإدارة مخزونها.

متطلبات

• خادم ويب (مثل Apache2 أو nginx) قادر على تشغيل Symfony 6، ويتضمن هذا الحد الأدنى من إصدار PHP PHP 8.1
• خادم قاعدة بيانات MySQL (5.7 على الأقل) / MariaDB (10.4 على الأقل)، أو PostgreSQL 10+ إذا كنت لا تريد استخدام SQLite.
• يوصى بشدة بالوصول إلى الخادم الخاص بك!
• لبناء الأصول من جانب العميل، هناك حاجة إلى خيوط و nodejs (>= 18.0).

تثبيت

إذا كنت تريد ترقية الإصدار القديم (< 1.0.0) من Part-DB إلى هذا الإصدار، فيرجى قراءة هذا أولاً.

تلميح: تتوفر صورة عامل الإرساء ضمن jbtronics/part-db1. كيفية إعداد Part-DB عبر عامل الإرساء موصوفة هنا.

تجد أدناه مخططًا تقريبيًا للغاية لعملية التثبيت، راجع هنا للحصول على دليل تفصيلي حول كيفية تثبيت Part-DB.

1. انسخ هذا المستودع أو استنسخه في مجلد على الخادم الخاص بك.
2. قم بتكوين خادم الويب الخاص بك للعرض من المجلد public/ . انظر هنا للحصول على معلومات إضافية.
3. انسخ ملف التكوين العام cp .env .env.local وقم بتحرير .env.local :
   • قم بتغيير السطر APP_ENV=dev إلى APP_ENV=prod
   • إذا كنت لا تريد استخدام SQLite، قم بتغيير قيمة DATABASE_URL= حسب احتياجاتك (انظر هنا) للتنسيق. في الحالات الأكبر ذات الوصول المتزامن، يكون MySQL أكثر أداءً. لا يمكن تغيير هذا بسهولة لاحقًا، لذا اختر بحكمة.
4. تثبيت تبعيات الملحن وإنشاء ملفات التحميل التلقائي: composer install -o --no-dev
5. تثبيت تبعيات جانب العميل وإنشائها: yarn install yarn build
6. اختياري (يسرع التحميل الأول): ذاكرة التخزين المؤقت للإحماء: php bin/console cache:warmup
7. قم بترقية قاعدة البيانات إلى نظام جديد (أو قم بإنشائها عندما تكون فارغة): php bin/console doctrine:migrations:migrate واتبع التعليمات المقدمة. أثناء العملية، يتم عرض كلمة المرور الخاصة بالمسؤول. انسخه. تنبيه : تعبث هذه الخطوات بقاعدة البيانات الخاصة بك ومن المحتمل أن تؤدي إلى تدميرها. لذلك تأكد من عمل نسخة احتياطية لقاعدة البيانات الخاصة بك.
8. يمكنك تكوين Part-DB عبر config/parameters.yaml . يجب عليك التحقق مما إذا كانت الإعدادات تتوافق مع توقعاتك بعد تثبيت/ترقية Part-DB. تحقق مما إذا كان partdb.default_currency يتطابق مع العملة المستخدمة بشكل أساسي (لا يمكن تغيير هذا بعد إنشاء معلومات السعر). قم بتشغيل php bin/console cache:clear عند تغيير شيء ما.
9. قم بالوصول إلى Part-DB في متصفحك (ضمن عنوان URL الذي وضعته) وقم بتسجيل الدخول باستخدام user admin . كلمة المرور هي التي يتم إخراجها أثناء إعداد قاعدة البيانات. إذا لم تتمكن من تذكر كلمة المرور، فقم بتعيين كلمة مرور جديدة باستخدام php bin/console app:set-password admin . يمكنك إنشاء مستخدمين جدد مع المستخدم المسؤول والبدء في استخدام Part-DB.

عندما تريد الترقية إلى إصدار أحدث، ما عليك سوى نسخ الملفات الجديدة إلى المجلد وتكرار الخطوات من 4 إلى 7.

عادةً يتم إنشاء كلمة مرور عشوائية عند إنشاء مستخدم المسؤول أثناء إنشاء قاعدة البيانات الأولية، ومع ذلك، يمكنك تعيين كلمة مرور المسؤول الأولية، عن طريق تعيين INITIAL_ADMIN_PW env var.

يمكنك تكوين Part-DB حسب احتياجاتك عن طريق تغيير متغيرات البيئة في الملف .env.local . انظر هنا لمزيد من المعلومات.

الوكيل العكسي

إذا كنت تستخدم وكيلًا عكسيًا، فيجب عليك التأكد من قيام الوكلاء بتعيين رؤوس X-Forwarded-* بشكل صحيح، وإلا ستحصل على مزيج من HTTP/HTTPS وأسماء مضيفات خاطئة. إذا كان الوكيل العكسي موجودًا على خادم مختلف (أو لا يمكنه الوصول إلى Part-DB عبر مضيف محلي)، فيجب عليك تعيين متغير البيئة TRUSTED_PROXIES لمطابقة عنوان IP الخاص بالوكيل العكسي (أو كتلة IP). يمكنك القيام بذلك في ملف .env.local أو (عند استخدام عامل الإرساء) في ملف docker-compose.yml الخاص بك.

التبرع من أجل التنمية

إذا كنت تريد التبرع لمطور Part-DB، فانظر زر الراعي في الشريط العلوي (بجوار اسم الريبو). ستجد هناك طرقًا مختلفة لدعم التطوير على أساس شهري أو لمرة واحدة.

بنيت مع

• Symfony 5: الإطار الرئيسي المستخدم لخادم PHP
• Bootstrap 5 وBootswatch: يستخدمان كموضوع لموقع الويب
• Fontawesome: يستخدم كمجموعة أيقونات
• Hotwire Stimulus وHotwire Turbo: الواجهة الأمامية لجافا سكريبت

المؤلفون

• جان بومر - العمل الأولي - جيثب

انظر أيضًا قائمة المساهمين الذين شاركوا في هذا المشروع.

استنادًا إلى الجزء الأصلي من Part-DB من تأليف كريستوف ليتشنر وك. جاكوبس

رخصة

تم ترخيص Part-DB بموجب رخصة GNU Affero العامة الإصدار 3.0 (أو حسب رأيك في أي وقت لاحق). يعني هذا في الغالب أنه يمكنك استخدام Part-DB لأي شيء تريده (حتى استخدامه تجاريًا) طالما أنك تنشر الكود المصدري لكل تغيير تجريه بموجب AGPL أيضًا.

راجع الترخيص لمزيد من المعلومات.