نظام Qcut للحجوزات والإدارة

Qcut نظام حجوزات طُور لعميل، ويخدم العملاء والحلاقين وفريق الإدارة. يضم المشروع واجهة برمجية للحجوزات ولوحة Qcut-admin مستقلة للإدارة. تستخدم تطبيقات العملاء والحلاقين مسارات الحجز التي يوفرها الخادم، بينما يتابع الموظفون الحسابات والمواعيد والبيانات المالية وطلبات الدعم من اللوحة.

المشكلة

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

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

• يسجل انضمام الحلاق ساعات العمل وفترات الاستراحة وقرار قبول الإدارة.
• تحسب قواعد الحجز المواعيد المتاحة وتتحقق من سعة الخدمة قبل تأكيد الحجز.
• تدعم المواعيد قائمة انتظار للحجوزات المعلقة وطلبات تغيير الوقت.
• تنظم الفواتير الشهرية وسجلات التحصيل النقدي علاقة الفوترة مع الحلاقين.
• تتيح اللوحة إدارة الحلاقين والعملاء والمواعيد وبلاغات المحتوى.
• تعرض شاشات الإيرادات والأرباح السجلات المالية مع تصفية حسب التاريخ.
• يستخدم الدعم المباشر Socket.IO، وترسل الإشعارات عبر Firebase Cloud Messaging.
• تبدل اللوحة بين الإنجليزية والعربية مع تغيير اتجاه العرض.

البنية التقنية

بُنيت الواجهة البرمجية باستخدام TypeScript وExpress وZod للتحقق من الطلبات، مع نماذج Mongoose وقاعدة MongoDB. يدعم Redis بيانات التحقق المؤقتة وحدود الطلبات وطابور البريد. تحدّث المهام المجدولة حالات المواعيد والفواتير. ينقل Socket.IO رسائل الدعم، بينما يستخدم النظام Firebase للإشعارات الفورية وتخزين الوسائط. بنيت لوحة الإدارة باستخدام React وVite، وتتصل بالخادم عبر عميل Axios مشترك. يدير TanStack Query بيانات الخادم، ويحتفظ Redux Toolkit بحالة الواجهة.

جوانب هندسية

• تتحقق قواعد المواعيد من السعة عند إنشاء الحجز أو تغيير وقته.
• تمنع عمليات upsert والفهرس الفريد في MongoDB تكرار فاتورة الحلاق للفترة نفسها.
• يستخدم الدخول رموز تحقق، وتحمي اللوحة مسارات الموظفين.
• يتغير اتجاه واجهة الإدارة مع اللغة المختارة.

دوري

بنيت خادم Qcut ولوحة إدارته ضمن مشروع العميل نفسه. شمل العمل واجهات الحجز والفوترة، وشاشات التشغيل، والدعم المباشر، وربط اللوحة بالخادم.