# 📁 مدير الملفات - File Manager

نظام إدارة ملفات متكامل لإدارة ملفات ومجلدات الموقع بشكل كامل.

## ✨ المميزات

### 1. رفع الملفات
- رفع ملف واحد أو عدة ملفات في نفس الوقت
- السحب والإفلات (Drag & Drop)
- عرض تقدم الرفع
- إعادة تسمية تلقائية للملفات المكررة

### 2. إنشاء المجلدات
- إنشاء مجلدات جديدة
- التنقل بين المجلدات
- عرض المسار الكامل (Breadcrumb)

### 3. حذف الملفات والمجلدات
- حذف ملف واحد
- حذف مجلد كامل مع جميع محتوياته
- تأكيد قبل الحذف

### 4. عرض الملفات
- عرض معلومات الملف (الاسم، النوع، الحجم، تاريخ التعديل)
- أيقونات مختلفة حسب نوع الملف
- معاينة الملفات
- تحميل الملفات

### 5. الإحصائيات
- عدد الملفات الإجمالي
- عدد المجلدات الإجمالي
- المساحة المستخدمة

## 🔒 الأمان

- التحقق من المسارات لمنع الوصول خارج المجلد المحدد
- تنظيف أسماء الملفات والمجلدات
- التحقق من صحة العمليات

## 📂 الملفات

- `index.php` - الواجهة الرئيسية
- `api.php` - معالجة العمليات (رفع، إنشاء، حذف)
- `README.md` - هذا الملف

## 🚀 الاستخدام

1. افتح مدير الملفات من لوحة التحكم
2. استخدم الأزرار في الأعلى للعمليات المختلفة
3. انقر على المجلدات للتنقل بينها
4. استخدم زر "رجوع" للعودة للمجلد السابق

## 📍 المسار الأساسي

المسار الأساسي للملفات: `backend/uploads/`

جميع العمليات تتم داخل هذا المجلد فقط لضمان الأمان.

## 🎨 التصميم

- تصميم عصري وسهل الاستخدام
- متجاوب مع جميع الأجهزة
- أيقونات ملونة حسب نوع الملف
- رسوم متحركة سلسة

## 🆕 التحديثات (v1.1)

### ✅ الميزات الجديدة:
- [x] جلب ملفات من روابط خارجية
- [x] عرض معلومات الاستضافة التفصيلية
- [x] حساب دقيق للمساحة المستخدمة
- [x] شريط تقدم المساحة الملون
- [x] تحسينات الواجهة والتصميم

### 📊 الإحصائيات المحسّنة:
- عدد الملفات في جميع المجلدات
- المساحة الكلية الحقيقية
- نسبة الاستخدام من الحد الأقصى
- معلومات القرص والذاكرة

## 🔧 التطوير المستقبلي

- [ ] إعادة تسمية الملفات والمجلدات
- [ ] نقل ونسخ الملفات
- [ ] ضغط وفك ضغط الملفات
- [ ] معاينة الصور والفيديوهات
- [ ] محرر نصوص مدمج
- [ ] البحث في الملفات
- [ ] رفع المجلدات كاملة
- [ ] مشاركة الملفات

## 📂 الملفات

- `index.php` - الواجهة الرئيسية
- `api.php` - معالجة العمليات (رفع، إنشاء، حذف، تحميل)
- `server-info.php` - معلومات الاستضافة والمساحة
- `README.md` - هذا الملف

---

✅ تم التطوير بواسطة Kiro AI 🤖
📅 آخر تحديث: نوفمبر 2025
🔄 الإصدار: 1.1