HomeBox: نظام خفيف لاستضافة وإدارة جرد الأصول والعتاد المنزلي محليًا

التوثيق المادي: إدارة عتاد المعمل المنزلي وقطع الغيار بنقاء لغة Go

مع تراكم الخوادم، والأقراص الصلبة، وكابلات الشبكة، وبطاقات التوسعة، وقطع الغيار داخل المعمل المنزلي (Homelab) أو ورشة العمل، يتحول تتبع مكان وجود كل قطعة وتاريخ شرائها وفترة ضمانها إلى تحدٍ تنظيمي مرهق. تلجأ العديد من التجارب إلى جداول بيانات Excel المتفرقة أو أنظمة إدارة الأصول المؤسسية المعقدة مثل Snipe-IT التي تتطلب خوادم وقواعد بيانات ثقيلة. يقدم مشروع HomeBox التوازن المثالي عبر تطبيق جرد فائق السرعة والخفة مبني بلغة Go.

يتميز HomeBox بحجم حاوية لا يتجاوز 20 ميجابايت، ويعمل بقاعدة بيانات SQLite مدمجة دون أي متطلبات إضافية، مما يتيح لك تصنيف الأصول، وتوليد وطباعة ملصقات QR Code للصناديق والرفوف، وإرفاق الفواتير وأدلة الاستخدام بلمح البصر.

ما هو HomeBox؟

HomeBox هو نظام إدارة جرد وأصول رقمي مفتوح المصدر (AGPL-3.0) مصمم خصيصًا للمستخدمين المنزليين وأصحاب المعامل ومحبي التنظيم. يتيح لك بناء هيكلية شجرية تمثل منزلك أو معملك: (مبنى → غرفة → خزانة → صندوق → قطعة عتاد).

يتيح النظام إدخال الأرقام التسلسلية (Serial Numbers)، وتواريخ انتهاء الضمان، والقيمة الشرائية للأجهزة، مع إمكانية مسح رمز QR عبر كاميرا الهاتف للانتقال الفوري إلى صفحة القطعة وتعديل حالتها أو معرفة محتويات أي صندوق مغلق دون الحاجة لفتحه.

لماذا لم تسمع به من قبل؟

نشأ المشروع كاستجابة لحاجة مجتمع r/selfhosted إلى أداة مخصصة للمنازل والمعامل بدلاً من البرمجيات المؤسسية الضخمة. وعندما توقف المطور الأصلي عن الصيانة، تولى مجتمع SysadminsMedia قيادة المشروع وإعادة كتابته وتنقيته وتحديث واجهاته، ليصبح اليوم المعيار الذهبي لإدارة المخزون الشخصي المستضاف ذاتيًا.

كيف يعمل تحت الغطاء؟

بُني HomeBox على أسس هندسية تضمن استمرارية البيانات لسنوات طويلة:

نواة Go مستقلة (Single Binary): يتم تجميع واجهة الويب الأمامية والخلفية البرمجية في ملف تنفيذي وحيد يستهلك أقل من 15 ميجابايت من الذاكرة العشوائية أثناء التشغيل.
محرك تخزين SQLite المدمج: تحفظ كافة السجلات في ملف قاعدة بيانات واحد يسهل نسخه احتياطيًا، مع دعم كامل لمحركات PostgreSQL الاختيارية للمنشآت الأكبر.
نظام توليد ملصقات QR مدمج: يولد رموز QR مخصصة تحتوي على روابط مباشرة للأصول ومصممة هندسيًا لتناسب طابعات الملصقات الحرارية الشائعة (مثل Brother و Dymo).

تشغيل الأداة ونشرها

يمكن تشغيل HomeBox في ثوانٍ معدودة عبر Docker Compose:

services:
  homebox:
    image: ghcr.io/sysadminsmedia/homebox:latest
    container_name: homebox
    restart: unless-stopped
    ports:
      - "7745:7745"
    volumes:
      - ./data:/data
    environment:
      - HBOX_MODE=production
      - HBOX_STORAGE_SQLITE_URL=/data/homebox.db?_pragma=busy_timeout(5000)&_pragma=journal_mode(WAL)
      - HBOX_OPTIONS_ALLOW_REGISTRATION=false

لتشغيل الحاوية:

docker compose up -d

توجه إلى http://localhost:7745 لتسجيل حسابك الأول والبدء في تنظيم عتادك وأجهزتك.

ما الذي يستبدله؟

يستبدل Snipe-IT الثقيل: يوفر تجربة سريعة وسلسة للمنازل والمعامل دون الحاجة لبيئات PHP و MySQL و Redis المعقدة.
يستبدل جداول Google Sheets و Excel: يمنحك واجهة بصرية مهيكلة مع بحث فوري، ودعم للصور والمرفقات، ومسح رموز QR عبر الجوال.
يستبدل ضياع الفواتير وكتيبات التشغيل: يتيح إرفاق ملفات PDF والصور الخاصة بالضمانات مع تنبيهات عند اقتراب موعد انتهائها.

الحدود والقيود التقنية

صُمم HomeBox عمدًا للبساطة؛ لذلك فهو لا يحتوي على ميزات إدارة دورات حياة الأصول المعقدة الخاصة بالشركات الكبرى (مثل حسابات الإهلاك الضريبي المحاسبي أو طلبات الشراء المؤسسية)، بل يركز حصريًا على الجرد الفعلي والتوثيق المنزلي.

الفئات المستهدفة

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

الخلاصة

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