تم إضافة نظام 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
✓ تعديل البيانات بسهولة
✓ استيراد البيانات المعدلة
✓ حذف السجلات
✓ تصدير جميع البيانات
استمتع باستخدام النظام! 🚀