عن المشروع

Hola هي منصة حديثة لنشر تطبيقات المختبرات المنزلية، مصممة لعشاق التقنية والمستخدمين المتقدمين. توفر تجربة مستخدم إرشادية لاكتشاف وتثبيت وإدارة التطبيقات ذاتية الاستضافة على الخوادم الشخصية، كل ذلك من لوحة تحكم ويب. المشروع هو مستودع أحادي يعتمد على TypeScript باستخدام Bun workspaces، ويحتوي على واجهة ويب React، وAPI خادم مبني على Bun، وأنواع مشتركة، وCLI، وSDK، ومكدس Docker Compose. تشمل الميزات المنفذة كتالوج تطبيقات مع بحث وتفاصيل، ومعالج تثبيت إرشادي مع تحرير متغيرات البيئة، وتجاوزات Docker Compose، ورفع ملفات التكوين/الأسرار، والتحقق الصارم، وفحوصات مسبقة. تتوفر أيضًا عناصر التحكم في دورة حياة النشر (بدء، إيقاف، إعادة تشغيل، حذف، تراجع)، والتوجيه القائم على Traefik، وفحوصات الصحة، وسجلات مباشرة، وعروض الحالة. تبقى الحالة محفوظة عبر عمليات إعادة التشغيل، ويستخدم المصادقة مفتاح API إداري. تشمل عناصر خارطة الطريق غير المنفذة بعد الإشعارات، والنسخ الاحتياطي المجدول مع استعادة عبر الواجهة، والدخول الموحد للتطبيقات عبر مزود هوية خارجي. يستهدف المشروع صراحة البيئات المحلية/ذاتية الاستضافة، وليس حالات الاستخدام المؤسسية أو متعددة المستأجرين. يتضمن هيكل المستودع الأحادي حزمًا للويب، والخادم، والمشترك، وCLI، وSDK، وcompose. تستخدم حزمة التقنية Bun 1.3.14، وTypeScript 6.x، وVite، وReact، وTailwindCSS، وReact Router، وHTTP الأصلي لـ Bun مع SSE. التثبيت مباشر: مثبت بسطر واحد يجهز مكدس الإنتاج (Traefik + ويب + خادم) على مضيف مع Docker وDocker Compose v2. يمكن تثبيت CLI بشكل منفصل وتكوينه للإشارة إلى خادم موجود عبر متغيرات البيئة. للمطورين، يوفر المستودع نصوصًا للتطوير، والاختبار (بما في ذلك اختبارات تكامل Docker الحقيقية)، والتحقق من الأنواع، والفحص، والبناء. تغطي الوثائق البنية، والعمليات، وقرارات المصادقة، وإرشادات المساهمة.