⚡ تثبيت Part-DB — نظام إدارة مخزون القطع والمكونات الإلكترونية على Docker

نشر نظام Part-DB على Ubuntu باستخدام Docker — النظام مفتوح المصدر الرائد لإدارة مخازن القطع الإلكترونية وقطع الغيار مع تتبع الأدراج والباركود والمخططات الفنية (Datasheets).

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر Part-DB على المنفذ 8229 مع قاعدة بيانات SQLite مدمجة وحفظ دائم للملفات والمرفقات.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/erp/part-db/part-db-ubuntu.sh
chmod +x part-db-ubuntu.sh
sudo bash part-db-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/erp/part-db/part-db-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x part-db-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين لقاعدة بيانات SQLite والمرفقات (`./db` و`./uploads` و`./media`) وتشغيل حاوية Part-DB على المنفذ 8229.

sudo bash part-db-ubuntu.sh

4 تسجيل الدخول وبدء الجرد

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8229. سجل الدخول بالبيانات الافتراضية (`admin` / `admin`)، وغير كلمة المرور فوراً، وابدأ في فهرسة مكوناتك الإلكترونية.

http://<your-server-ip>:8229

المنافذ المستخدمة

المنفذالغرض
8229Web UI (host → container 80) — default admin / admin, forced change
DATABASE_URLBuilt-in SQLite — no separate MySQL/MariaDB container
./dbSQLite catalogue (also ./uploads, ./media)

نظرة عامة

يعد Part-DB نظاماً ويب مفتوح المصدر متخصصاً في إدارة مخزون المكونات والقطع الإلكترونية وقطع الغيار مبنياً بلغة PHP وإطار عمل Symfony. يعمل النظام على المنفذ 8229 باستخدام قاعدة بيانات SQLite خفيفة وسريعة، وهو مصمم خصيصاً لمهندسي الإلكترونيات ومختبرات الهاردوير ومحلات الصيانة. وينظم آلاف المقاومات والمكثفات والدوائر المتكاملة (ICs) والمتحكمات الدقيقة والموصلات في تصنيفات هرمية وأماكن تخزين فعلية (غرف، أدراج، بكرات SMD)، مع إرفاق المواصفات الفنية والكتالوجات (Datasheets) وتوليد ملصقات الباركود.

لماذا تستخدمه

يصبح استخدام الجداول العادية مثل Excel لإدارة القطع الإلكترونية أمراً معقداً ومستحيلاً لتشعب المواصفات الفنية (قيم المقاومة والفولتية، وتفاوتات الجهد، وأبعاد التركيب SMD/THT، وأكواد المصنعين). تم تصميم Part-DB خصيصاً للقطع الإلكترونية: حيث يدعم البحث البارامتري الدقيق، ومسح الباركود ثنائي الأبعاد (DataMatrix / QR) لأدراج المكونات، واستيراد قوائم مكونات الدوائر المطبوعة (BOM) من برامج KiCad وAltium، وتخزين المخططات الفنية محلياً داخل سيرفرك.

متى تحتاجه

  • تمتلك أدراجاً وبكرات ومخازن مليئة بالقطع الإلكترونية وتحتاج لنظام جرد رقمي منظم وفائق السرعة
  • تدير ورشة صيانة إلكترونيات أو مختبر هاردوير وتحتاج لتتبع كميات القطع البديلة وأماكنها بدقة
  • تريد استيراد ملفات قائمة المكونات (BOM) من برامج تصميم الدوائر مثل KiCad للتأكد من توفر القطع قبل تصنيع اللوحات
  • ترغب في طباعة ملصقات باركود DataMatrix وQR ولصقها على أدراج القطع لمسحها فورياً بكاميرا الهاتف
  • تبحث عن أداة جرد خفيفة تعتمد على SQLite دون الحاجة لإدارة خادم قاعدة بيانات MySQL منفصل

من يحتاجه

  • مهندسو الإلكترونيات ومصممو الدوائر المطبوعة لتتبع بكرات ومكونات SMD واللوحات التطويرية
  • فنيو صيانة الهواتف والأجهزة الإلكترونية لتتبع الرقاقات والآيسيهات وقطع الغيار الدقيقة
  • مساحات العمل المشتركة ومختبرات كليات الهندسة وأندية الروبوتات لتنظيم أدراج المكونات المشتركة
  • الهواة وأصحاب السيرفرات المنزلية لفهرسة أدواتهم الإلكترونية وقطع غيار الطابعات ثلاثية الأبعاد
  • مديرو الأنظمة لنشر بيئة جرد مخصصة ومستقلة لفرق البحث والتطوير الهندسي

حالات الاستخدام الشائعة

  • تنظيم مكثفات ومقاومات SMD حسب القيمة ومقاس الحزمة (0805 و0603 و0402) ورقم الدرج بدقة
  • مسح باركود DataMatrix ثنائي الأبعاد على بكرات المكونات لخصم الكميات المستهلكة أثناء تجميع الدوائر
  • إرفاق ملفات المواصفات الفنية (PDF Datasheets) ومخططات الأرجل (Pinouts) مع كل قطعة في الكتالوج
  • استيراد ملفات KiCad BOM بصيغة CSV للتحقق من جاهزية كافة قطع المشروع قبل إرسال أمر التصنيع
  • تحديد حد أدنى للتنبيه عند نقص المخزون لإعادة طلب القطع من الموردين (Mouser وDigi-Key وLCSC) في الوقت المناسب

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

  • تصنيف مخصص للقطع الإلكترونية: تصنيفات هرمية، حزم التركيب (Footprints)، المصنعون، والموردون
  • إدارة مواقع التخزين الفعلية: ربط كل قطعة بغرفة محددة وخزانة ورف ورقم الدرج الداخلي
  • مولد ومفحص باركود مدمج: طباعة ملصقات QR وDataMatrix للأدراج مع دعم المسح بكاميرا الهاتف
  • أداة قوائم المواد (BOM Tool): استيراد ملفات BOM من KiCad وEagle لحساب تكلفة المشاريع وحجز القطع
  • مرفقات المستندات والوسائط: رفع ملفات PDF والمخططات الهندسية ونماذج 3D CAD مباشرة
  • نظام متكامل لصلاحيات المستخدمين (RBAC): صلاحيات للمشرف والمحرر ووضع القراءة فقط للطلاب
  • محرك قاعدة بيانات SQLite مدمج بدون أي اعتماديات خارجية لسهولة الصيانة والنسخ الاحتياطي
  • نشر منظم عبر Docker مع ربط مجلدات `./db` و`./uploads` و`./media` لضمان الحفظ الدائم للمخزون

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8229 للوصول لواجهة تسجيل الدخول
  • سجل الدخول باسم المستخدم الافتراضي `admin` وكلمة المرور الافتراضية `admin`
  • تنبيه أمني هام: غيّر كلمة مرور المشرف الافتراضية فوراً بعد تسجيل الدخول الأول من إعدادات الحساب
  • انتقل إلى Storage Locations ← New لإنشاء هيكل التخزين الفعلي (مثل: 'المختبر 1 ← الخزانة A ← الدرج 5')
  • انتقل إلى Categories ← New لإنشاء تصنيفات المكونات (مثل: 'أشباه الموصلات ← ميكروكنترولر ← ESP32')
  • أضف قطعتك الأولى من قسم Parts ← New Part مع تحديد الكود والمقاس والكتالوج والكمية المتوفرة
  • ضع Part-DB خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL لتأمين الاتصال بالسيرفر

أفضل ممارسات الأمان

  • غيّر كلمة مرور حساب المشرف الافتراضية (`admin / admin`) فور تشغيل الحاوية لحماية بيانات المخزون
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية الاتصال عند الوصول من شبكات الواي فاي والإنترنت
  • لا تكشف المنفذ 8229 للإنترنت العام؛ واقصر الوصول على شبكتك المحلية أو شبكة VPN
  • احمِ مجلد البيانات `./db` الذي يحتوي على ملف قاعدة بيانات SQLite بصلاحيات نظام مناسبة بالسيرفر
  • أنشئ حسابات مخصصة بصلاحيات قراءة فقط (Read-only) للطلاب والزوار لتجنب تعديل الكميات خطأً
  • حدّث صورة الحاوية jbtronics/part-db1 دورياً للحصول على الميزات والتحديثات الأمنية

المنافذ وإعدادات جدار الحماية

يقدم Part-DB واجهته عبر منفذ TCP 8229 (المحول من 80 الداخلي). في الإنتاج، يجب تهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 وربطه بـ 8229، مع إبقاء المنفذ 8229 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./db` (/var/www/html/var/db) احتياطياً، والذي يحتوي على ملف قاعدة بيانات SQLite بكافة القطع وسجل المخزون
  • انسخ مجلدي `./uploads` و`./media` لحفظ ملفات الـ Datasheets وصور المكونات ومخططات الثري دي
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • اختبر الاستعادة بربط مجلدات البيانات بحاوية تجريبية والتأكد من فتح كافة القطع والمرفقات بنجاح

الأخطاء الشائعة

  • ترك بيانات تسجيل الدخول الافتراضية (`admin / admin`) نشطة على حواسيب المختبرات المشتركة
  • عدم ربط مجلدات التخزين الدائم `./db` و`./uploads`، مما يسبب مسح كافة سجلات المكونات عند تحديث الحاوية
  • محاولة رفع ملفات CAD ثلاثية الأبعاد ضخمة جداً دون تعديل حدود رفع PHP في متغيرات البيئة
  • البدء في إضافة القطع قبل تحديد أماكن التخزين الفعلية والأدراج في النظام
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر في شبكات واي فاي عامة

استكشاف الأخطاء وإصلاحها

  • خطأ في صلاحيات قاعدة البيانات (Permission denied) — تأكد من منح صلاحيات الكتابة للمجلدات `./db` و`./uploads` للمستخدم `www-data` (UID 33)
  • فشل فتح ملفات الـ Datasheets المرفوعة — تأكد من صحة ربط مجلد `./uploads` في ملف Compose
  • ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs part-db -f` لمعرفة أخطاء Symfony
  • نسيان كلمة مرور المشرف — أعد تعيين كلمة المرور من سطر الأوامر: `docker exec -it part-db php bin/console partdb:user:change-password admin`
  • قارئ الباركود لا يكتب البيانات — تأكد من ضبط القارئ لإرسال زر Enter تلقائياً بعد كل مسح للرمز

البدائل

منصة InvenTree نظام متطور وقوي مبني بـ Python لإدارة المخزون والتصنيع والإنتاج. نظام Snipe-IT مخصص لتتبع أصول تقنية المعلومات والحواسيب وتراخيص البرامج. نظام Homebox أداة خفيفة لجرد الأغراض المنزلية. نظام PartKeepr النظام القديم السابق لأنظمة الجرد الإلكتروني.

متى لا تستخدمه

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

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الذي يميز Part-DB عن برامج الجرد والمخازن العادية؟

صُمم Part-DB خصيصاً لمجال الإلكترونيات: حيث يدعم حزم التركيب (SMD/THT)، وأرقام القطع المصنعية (MPN)، وإرفاق ملفات المواصفات (Datasheets)، ومطابقة قوائم BOM للوحات الدوائر المطبوعة، وطباعة ملصقات الباركود ثنائية الأبعاد للأدراج.

هل يتطلب Part-DB قاعدة بيانات MySQL أو PostgreSQL منفصلة؟

لا، يعتمد Part-DB على قاعدة بيانات SQLite مدمجة ومحفوظة داخل مجلد `./db`. وهذا يجعل التثبيت والنسخ الاحتياطي والترحيل أمراً فائق السهولة بدون أي استهلاك لموارد السيرفر.

هل يمكنني طباعة ملصقات باركود لأدراج المكونات؟

نعم! يحتوي Part-DB على مولد ملصقات مدمج يدعم رموز DataMatrix وQR المتوافقة مع طابعات الملصقات الحرارية (مثل Brother وDymo) لمسحها بسهولة بكاميرا الهاتف.

هل يمكن استيراد ملفات BOM من برنامج KiCad أو Altium؟

نعم، يتضمن Part-DB أداة مخصصة لملفات BOM تتيح رفع ملف CSV المستخرج من KiCad أو Eagle للتحقق فورياً من توفر كافة قطع مشروعك في المخزن قبل البدء في التصنيع.

كم يستهلك Part-DB من الذاكرة العشوائية (RAM)؟

يعد Part-DB خفيفاً للغاية بفضل محرك PHP وSQLite، حيث يستهلك عادة أقل من 60 إلى 100 ميجابايت من الذاكرة العشوائية تحت الاستخدام الطبيعي.