عن المشروع

HASHRATE (SGI) هو نظام إدارة داخلية مصمم للفوترة وإدارة العملاء. تم تحديث المشروع ليصبح مستودعًا أحاديًا يفصل بوضوح بين منطق العميل والخادم. تم بناء الواجهة الأمامية بتقنيات حديثة باستخدام Vite وReact وTypeScript، مما يوفر واجهة مستخدم تفاعلية. تشمل الشاشات الرئيسية Home وFacturación وHistorial وClientes وReportes. تدعم وظيفة الفوترة إنشاء ملفات PDF وحساب الإجماليات والمرشحات المتقدمة والتصدير إلى Excel. تستخدم الواجهة الخلفية Express وTypeScript، وتخزن بيانات العملاء والفواتير في قاعدة بيانات SQLite محلية (ملف data.db). توفر واجهة برمجة تطبيقات RESTful يمكن الوصول إليها عبر مسارات مثل /api/invoices و/api/clients. تم تحسين النظام لعمليات النشر القابلة للتوسع والموزعة: - الواجهة الأمامية: يمكن نشرها بسهولة على Vercel. - الواجهة الخلفية: متوافقة مع خدمات مثل Render أو Railway. لبيئات الإنتاج، يلزم تكوين متغيرات البيئة مثل CORS_ORIGIN وVITE_API_URL لربط الواجهة الأمامية بواجهة برمجة التطبيقات الخلفية بشكل صحيح. المتطلبات التقنية: Node.js 20+ وnpm 9+. يتيح التطوير المحلي تشغيل كل من الخادم والعميل في وقت واحد عبر نصوص مخصصة.