منصة مطاعم العيسى الذكية
تصميم وبرمجة: العيسى هوست للخدمات البرمجية — أربيل، شارع 100 — 07734432235
=====================================================================

■ التشغيل على الكمبيوتر (ويندوز)
  1) ثبّت برنامج Node.js مرة واحدة فقط من: https://nodejs.org  (نسخة LTS)
  2) دبل كلك على الملف:  start.bat
  3) تنفتح لوحة الإدارة تلقائياً بالمتصفح.
  ملاحظة: لا تسكّر النافذة السوداء — هي السيرفر. إذا سكّرتها يتوقف الموقع.

■ رموز الدخول التجريبية
  صاحب المطعم (كل شيء) ........ 1111
  الكاشير (الطلبات والطاولات) .. 2222
  المطبخ (شاشة المطبخ فقط) .... 3333
  غيّرها من: الإعدادات ← الموظفين

■ الصفحات
  /menu    منيو الزبون (الذي يفتح من الباركود)
  /admin   الكاشير + المطبخ + لوحة صاحب المطعم
  /        صفحة تعريفية للعرض على أصحاب المطاعم

■ تجربة الطلب من الموبايل
  - الموبايل لازم يكون على نفس الواي فاي مال الكمبيوتر.
  - افتح "باركود الطاولات" في لوحة الإدارة وصوّر أي باركود بالموبايل.
  - اطلب أي أكلة ← يوصل الطلب للكاشير فوراً مع صوت تنبيه.
  - إذا ما فتح بالموبايل: اسمح للبرنامج بجدار الحماية (Windows Firewall) عند أول تشغيل.

■ الرفع على الاستضافة (cPanel ← Setup Node.js App) حتى صاحب المطعم يتابع من البيت
  1) ارفع كل الملفات إلى مجلد مثل: restaurant
  2) Setup Node.js App ← Create Application
       Node.js version: 18 أو 20
       Application root: restaurant
       Application URL: الدومين أو السب دومين (مثلاً restaurant.alissahost.net)
       Application startup file: server.js
  3) اضغط Create ثم Start. لا يحتاج npm install (بدون مكتبات خارجية).
  4) من لوحة الإدارة ← الإعدادات ← "رابط الموقع العام" اكتب رابط الدومين
     حتى تصير الباركودات على رابط الإنترنت، ثم اطبعها من "باركود الطاولات".

■ البيانات
  - كل البيانات محفوظة في الملف: data\db.json
  - نسخة احتياطية يومية تلقائية في نفس المجلد (backup-التاريخ.json)
  - تنزيل نسخة احتياطية: الإعدادات أو التقارير ← "نسخة احتياطية"
  - قبل العرض على زبون: الإعدادات ← "إعادة البيانات التجريبية"

■ كيف يعمل النظام (للشرح لصاحب المطعم)
  1) الزبون يصوّر الباركود ← يكتب رقم الطاولة ← يختار الأكل ← يرسل.
  2) الطلب يوصل للكاشير برقم الطاولة + الطاولة تتحول "مشغولة".
  3) الكاشير يقبل ← يروح للمطبخ ← المواد (لحم، صمون، صلصة...) تنخصم من المخزن تلقائياً حسب الوصفة.
  4) المطبخ يضغط "جاهز" ← النادل يقدّم ← الكاشير يستلم الدفع ويطبع الفاتورة.
  5) بعد الدفع الطاولة تتحول "تحتاج تنظيف" ← بعد التنظيف "متاحة".
  6) صاحب المطعم يشوف من البيت: المبيعات، الأرباح الصافية، المخزن، النواقص،
     ديون الشركات، المصروفات، والأكثر مبيعاً — كلها مباشرة.