╔════════════════════════════════════════════════════════════╗ ║ 🎯 بطاقة مرجعية سريعة - نظام Excel ║ ╚════════════════════════════════════════════════════════════╝ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📁 المسارات المهمة: نوى Excel الرئيسية: server/excel.js أداة الواجهة: public/js/excel-manager.js لوحة التحكم: public/excel-dashboard.html موقع الملف: server/data/db.xlsx ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔗 API Endpoints: ✓ GET /api/excel/export └─→ تصدير جميع البيانات ✓ GET /api/excel/download └─→ تحميل ملف Excel ✓ POST /api/excel/import └─→ استيراد البيانات ✓ PUT /api/excel/update/:table/:id └─→ تحديث سجل ✓ DELETE /api/excel/delete/:table/:id └─→ حذف سجل ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💻 أوامر JavaScript: تصدير: await excelManager.export(); تحميل: await excelManager.download(); استيراد: await excelManager.import(); تحديث: await excelManager.updateRecord('employees', 1, { name: 'أحمد', phone: '0501234567' }); حذف: await excelManager.deleteRecord('employees', 1); ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔧 أوامر Terminal: تصدير: curl http://localhost:3000/api/excel/export تحميل: curl http://localhost:3000/api/excel/download > db.xlsx استيراد: curl -X POST http://localhost:3000/api/excel/import تحديث: curl -X PUT http://localhost:3000/api/excel/update/employees/1 \ -H "Content-Type: application/json" \ -d '{"name":"أحمد"}' حذف: curl -X DELETE http://localhost:3000/api/excel/delete/employees/1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📋 الجداول المتاحة: الفروع ← Branches الموظفون ← Employees الموردون ← Suppliers الأقسام ← Categories المنتجات ← Products المبيعات ← Sales المخزون ← Inventory ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✨ الخطوات الأساسية: 1️⃣ شغّل الخادم: npm start 2️⃣ اذهب للوحة التحكم: http://localhost:3000/excel-dashboard.html 3️⃣ اختر العملية: 💾 تصدير | ⬇️ تحميل | ⬆️ استيراد 4️⃣ عدّل الملف في Excel 5️⃣ استوردِ البيانات المعدلة ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚡ نقاط مهمة: ⚠️ حقل "code" = معرّف فريد ⚠️ إذا code موجود = تحديث ⚠️ إذا code جديد = إضافة ⚠️ احفظ نسخة احتياطية قبل الاستيراد ⚠️ لا تحذف الأعمدة الأساسية ⚠️ تأكد من صحة البيانات ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🚨 حل سريع للمشاكل: ❌ الملف غير موجود ✅ استدعِ GET /api/excel/export ❌ الخادم لا يستجيب ✅ تأكد من: npm start ❌ البيانات لم تُحدّث ✅ تحقق من قيمة code ❌ خطأ في الاستيراد ✅ تحقق من أسماء الأعمدة ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📚 ملفات المساعدة: 📖 EXCEL_GUIDE.md └─→ شرح مفصل شامل 📖 EXCEL_EXAMPLES.js └─→ أمثلة عملية متنوعة 📖 EXCEL_IMPLEMENTATION.md └─→ ملخص التحديثات 📖 QUICK_START_EXCEL.txt └─→ بدء سريع ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎉 نظام Excel جاهز للاستخدام الآن! ╚════════════════════════════════════════════════════════════╝