تم إضافة نظام Excel متكامل للتطبيق ✅ 📁 الملفات الجديدة المضافة: ───────────────────────────────────── 1️⃣ server/excel.js - مكتبة Excel كاملة للتعامل مع الملف - وظائف التصدير والاستيراد والحفظ والحذف 2️⃣ public/js/excel-manager.js - أداة JavaScript للواجهة الأمامية - أزرار وتنبيهات وتحميل الملفات 3️⃣ EXCEL_GUIDE.md - شرح مفصل لجميع الميزات - أمثلة API وكيفية الاستخدام 4️⃣ EXCEL_EXAMPLES.js - أمثلة عملية وأكواد جاهزة - حالات استخدام مختلفة 🚀 البدء السريع: ───────────────────────────────────── 1. تأكد من تثبيت المتطلبات: cd server npm install 2. شغّل السيرفر: npm start 3. استدعِ API للتصدير: GET http://localhost:3000/api/excel/export 4. تحميل الملف: GET http://localhost:3000/api/excel/download 📊 العمليات الممكنة: ───────────────────────────────────── ✅ التصدير: حفظ جميع البيانات في Excel ✅ التحميل: تنزيل ملف db.xlsx على جهازك ✅ الاستيراد: إرسال بيانات معدلة من Excel ✅ التعديل: تحديث سجل فردي ✅ الحذف: حذف سجل مع تحديث Excel 🔌 API Endpoints: ───────────────────────────────────── POST /api/excel/import - استيراد البيانات GET /api/excel/export - تصدير البيانات GET /api/excel/download - تحميل الملف PUT /api/excel/update/:table/:id - تحديث سجل DELETE /api/excel/delete/:table/:id - حذف سجل 📋 جداول Excel المتاحة: ───────────────────────────────────── • الفروع (Branches) • الموظفون (Employees) • الموردون (Suppliers) • الأقسام (Categories) • المنتجات (Products) • المبيعات (Sales) • المخزون (Inventory) 🎨 استخدام الواجهة: ───────────────────────────────────── في HTML:
💻 أمثلة في JavaScript: ───────────────────────────────────── // تصدير البيانات const result = await excelManager.export(); // تحديث موظف await excelManager.updateRecord('employees', 1, { name: 'أحمد محمد', phone: '0501234567' }); // حذف سجل await excelManager.deleteRecord('branches', 1); ⚙️ الإعدادات: ───────────────────────────────────── موقع الملف: server/data/db.xlsx معرف فريد: حقل "code" في كل جدول التحديث التلقائي: نعم، بعد كل عملية الأخطاء: معالجة تلقائية مع تنبيهات 📌 ملاحظات مهمة: ───────────────────────────────────── ⚠️ احتفظ بنسخة احتياطية قبل الاستيراد ⚠️ تأكد من صحة معرّف "code" قبل التحديث ⚠️ إذا كان code موجود = تحديث ⚠️ إذا كان code جديد = إضافة ⚠️ لا تحذف أعمدة من Excel 🆘 حل المشاكل: ───────────────────────────────────── مشكلة: "ملف Excel غير موجود" الحل: قم بالتصدير أولاً (GET /api/excel/export) مشكلة: "البيانات لم تُحدّث" الحل: تحقق من قيمة "code" والأعمدة مشكلة: "خطأ في الاستيراد" الحل: تحقق من صيغة البيانات والعناوين مشكلة: "لا يوجد سجلات" الحل: أضف بيانات أولاً أو استيرد من Excel ✨ الميزات الإضافية: ───────────────────────────────────── ✅ معالجة تلقائية للأخطاء ✅ تنبيهات صوتية ومرئية ✅ تحديث Excel بعد كل عملية ✅ دعم العربية الكامل ✅ واجهة سهلة الاستخدام 📚 للمزيد من المعلومات: ───────────────────────────────────── اقرأ: - EXCEL_GUIDE.md - شرح مفصل - EXCEL_EXAMPLES.js - أمثلة عملية - DATABASE_SETUP.md - معلومات القاعدة 🎉 تم التثبيت بنجاح! الآن يمكنك: ✓ حفظ البيانات في Excel ✓ تعديل البيانات بسهولة ✓ استيراد البيانات المعدلة ✓ حذف السجلات ✓ تصدير جميع البيانات استمتع باستخدام النظام! 🚀