إدارة الملفات

```html

- 1. وش بالضبط وحدة الملفات؟
 

وحدة الملفات هي **خزانة المستندات الرئيسية** للنظام، مصممة عشان تخزن وتنظم وتعرض معاينة وتتحكم في الوصول لـ **كل الملفات اللي تخص العملاء**.
 

تخيلوه كـ:
 

**خزانة ملفات عملاء + عارض آمن + ذكاء المجلدات**

هذا مو بس **رفع/تنزيل** — هذي **تحكم مدمج بالمستندات**.


 

- 2. مين يستخدم وحدة الملفات؟
 

- مدير النظام / صاحب المنظمة
 

• رفع ملفات للعملاء

• إنشاء وإدارة المجلدات

• تغيير الاسم، حذف، تنظيم الملفات

• معاينة كل أنواع الملفات

• التحكم في الصلاحيات

• تدقيق مستندات العملاء
   

- أعضاء الفريق
 

• رفع ملفات للعملاء

• عرض وتنزيل الملفات المصرح لها

• معاينة المستندات

• ما يقدرون يحذفون (إلا إذا كان مصرح لهم)
   

- العملاء (تسجيل دخول العميل)
 

• عرض ملفاتهم

• تنزيل المستندات المشتركة

• معاينة الملفات (بدون تعديل)

• ما فيه وصول للمجلدات الداخلية
  
  
   

  - 3. منطق المجلدات (مهم جداً)
   

  أنواع المجلدات مشروحة بوضوح
   

  فيه **طبقتين للمجلدات**:
   

  1️⃣ مجلدات عامة
   

• تُنشأ في **الإعدادات → ملفات العميل**

• متوفرة لـ **كل العملاء**
   

• أمثلة:

  • افتراضي

  • توقيعات

  • نماذج

  • ملفات البريد الإلكتروني

  • ملفات الواتساب

  • مجلدات مخصصة
     

• 2️⃣ مجلدات خاصة بالعميل
   

• موجودة **داخل العميل**

• ممكن تشمل:

  • مجلدات رئيسية

  • مجلدات فرعية

• تساعد في تنظيم مجموعات كبيرة من مستندات العملاء
  
  - الملفات دايماً تخص:
  
  عميل → مجلد → (مجلد فرعي اختياري) → ملف
  
   

• - 4. عملية رفع الملفات (خطوات مرئية)
   

  تجربة الرفع خطوة بخطوة
   

• اضغطوا على **➕ إضافة**

• اختاروا ملف واحد أو أكثر

• اختاروا:

  • مجلد

  • مجلد فرعي (إذا كان موجود)

• دخلوا **اسم عرض للملف / ملاحظات**

• حفظ
  
   

  - سلوك النظام:
   

• الملفات يتغير اسمها تلقائياً (اسم آمن)

• المعنى الأصلي ينحفظ في **الملاحظات**

• تاريخ الرفع ينحفظ

• الملف يكون ظاهر على طول في القائمة
  
  
   

  -  5. عرض الملفات وذكاء المعاينة
   

  وحدة الملفات **ما تتعامل مع كل الملفات بنفس الطريقة**.
   

  سلوك المعاينة حسب نوع الملف
   

• **PDF**
   

  • عارض PDF مدمج

  • تمرير، تكبير، إطار iframe آمن
     

• **صور (JPG, PNG وغيره)**
   

  • عارض صور

  • تقريب/إبعاد
     

  • **ملفات الأوفيس (DOC, XLS, PPT)**
     

    • عارض مستندات جوجل / أوفيس أونلاين
       

  • **فيديو / صوت**
     

    • مشغل وسائط مدمج
       

  • **ملفات غير مدعومة**
     

    • إطار iframe آمن أو بديل تنزيل
       

•  المستخدمين يقدرون **يسوون معاينة بدون ما يحملون**، وهذا شي حاسم للأمان.
  
   

  - 6. قائمة الملفات – ويش يشوفون المستخدمين
   

  كل سطر ملف يوصل معلومات بشكل مرئي:
   

•  نوع الملف (أيقونة / صورة مصغرة)

•  اسم العرض (قابل للتعديل)

•  اسم العميل

•  تاريخ الرفع
   

• ⚙️ الإجراءات:
   

  • عرض

  • تنزيل

  • تغيير الاسم

  • حذف (يعتمد على الصلاحية)
     

• وهذا يحول القائمة إلى **لوحة تحكم مستندات فعالة**، مو مجرد تخزين.
  
  
   

  - 7. البحث والتصفية (وصول سريع)
   

  المستخدمين يقدرون فوراً:
   

• يبحثون حسب **اسم الملف**

• يصفّون حسب **المجلد**

• يصفّون حسب **المجلد الفرعي**

• يعرضون الملفات لكل **عميل**

• يضيّقون النتائج بدون إعادة تحميل (AJAX)
  
  
   

  ✏️ 8. تغيير الاسم بدون إعادة رفع
   

  بدال ما ترفع الملفات مرة ثانية:
   

• ممكن تعدل **اسم عرض** الملف

• الملف الفعلي يبقى بدون تغيير

• هذا مفيد بالذات لـ:

• مستندات موقعة

• تصحيح أخطاء التسمية

• توحيد تسميات الملفات

• تحديثات قاعدة البيانات بشكل فوري

• يخلي التخزين نظيف
  
  
   

  - 9. حذف الملفات – متحكم فيه ومؤمن
   

  الحذف القائم على الصلاحيات
   

  فقط المستخدمين اللي عندهم:
  allow_to_delete_folders = 1
  يقدرون يحذفون الملفات.
   

  عملية الحذف:
   

• تحذف سجل DB

• تحذف ملف من السيرفر

• العملاء **ما يقدرون يحذفون ملفات**.
  
   

  10. نموذج الأمان (خلف الكواليس)
   

  وحدة الملفات تفرض:
   

• وصول قائم على الأدوار

• تحقق من ملكية العميل

• مسارات ملفات آمنة

• روابط URL معاينة متحكم فيها

• عمليات حذف قائمة على الصلاحيات
  
  
  الملفات **أبداً ما تنعرض مباشرة** — يتم تقديمها عن طريق نقطة نهاية عارض آمنة.
  
   

• - 11. كيف تتصل الملفات بالوحدات الثانية
  
  
  وحدة الملفات
  
  │
  ├── العملاء → سجل مستندات العميل
  ├── المستندات → فواتير، طلبات، عروض أسعار
  ├── التوقيعات → عقود موقعة
  ├── النماذج → رفع النماذج والردود
  ├── البريد الإلكتروني → أرشيف مرفقات البريد الإلكتروني
  ├── الواتساب → مرفقات من الدردشة
  ├── التذاكر → مرفقات الدعم
  ├── المشاريع → مستندات المشروع
  └── لوحة التحكم → أحدث الملفات والإحصائيات
  
  
  
   

  - 12. التصدير والاستخدام الخارجي
   

  ممكن:
   

• تنزيل الملفات بشكل منفصل

• يتم الوصول إليها من العملاء

• إعادة الاستخدام بين الوحدات

• إرفاقها بالمستندات والرسائل
  
  
   

  -  13. قرارات تصميم ذكية (ليش هذا يشتغل)
   

  ✔ الملفات دايماً تخص **العميل**
  ✔ منطق المجلدات **مرن ومتعدد اللغات**
  ✔ المعاينة تمنع التنزيلات غير الضرورية
  ✔ الصلاحيات تمنع فقدان البيانات
  ✔ يدعم حالات الاستخدام القانونية، المبيعات، التشغيل والدعم
  
  
   

  - ملخص وظيفي نهائي
   

  **وحدة الملفات مو مجرد تخزين.**
  **هي نظام مستندات منظم وآمن ويركز على العميل.**

  
  هو يضمن إن:
   

• سهل تلاقي الملفات

• سهل تسوي معاينة

• سهل تتحكم فيه

• سهل تدقق فيه

• سهل توسيعه