عن المشروع

Chefsy هو نظام داخلي لإدارة الطلبات مصمم للمطاعم. تقدم هذه المرحلة الأولى قاعدة وظيفية كاملة لتتبع الطلبات من إنشائها حتى تسليمها. ## المجموعة التقنية - Next.js 14 مع App Router - TypeScript (كود مكتوب بالكامل) - Tailwind CSS للأنماط العملية - React Context + useReducer لحالة الذاكرة، بدون مكتبات خارجية ## الوظائف الرئيسية - لوحة التحكم: مقاييس اليوم والطلبات الأخيرة - إدارة الطلبات: قائمة كاملة مع فلاتر حسب الحالة، إنشاء طلبات جديدة عبر نموذج - عرض المندوبين: واجهة للجوال للموزعين - تدفق الحالات: جديد → في المطبخ → جاهز → قيد التوصيل → تم التسليم، مع إمكانية الإلغاء من أي حالة نشطة ## هيكل المشروع المشروع منظم في مسارات رئيسية: - /dashboard - مقاييس وطلبات أخيرة - /pedidos - قائمة كاملة مع فلاتر - /nuevo-pedido - نموذج إنشاء - /cadeteria - عرض الجوال للموزع تنقسم المكونات إلى تخطيط (Sidebar، Header)، طلبات (TarjetaPedido، BadgeEstado، FormularioPedido) ولوحة تحكم (TarjetaMetrica). تتم إدارة الحالة العامة عبر سياق مع useReducer، وتوجد بيانات الاختبار في ملف mock. ## كيفية التشغيل 1. تثبيت التبعيات: npm install 2. وضع التطوير: npm run dev (متاح على http://localhost:3000) 3. بناء الإنتاج: npm run build و npm run start ## خطة التوسع يتضمن المشروع خارطة طريق واضحة للمراحل المستقبلية: - المرحلة 2: الاستمرارية مع API REST أو Supabase - المرحلة 3: المصادقة مع next-auth والأدوار (مشغل، مطبخ، مندوب) - المرحلة 4: الوقت الفعلي مع WebSockets أو Supabase Realtime - المرحلة 5: وحدة القائمة والمنتجات مع الإكمال التلقائي ## قرارات البنية - استخدام Route Group (principal) لفصل التخطيط مع الشريط الجانبي عن التخطيط البسيط للمندوبين - useReducer بدلاً من عدة useState لتركيز المنطق - بيانات mock متزامنة بدون useEffect، مما يسهل الانتقال إلى async - مكونات بدون رسوم متحركة لإعطاء الأولوية للوظائف والسرعة - كود باللغة الإسبانية للاتساق مع الفريق المستهدف