تخزين الملفات وإدارة المحتوى
يحتوي تطبيقك على نظام ملفات محتوى مخصص لتخزين الملفات التي تم تحميلها بواسطة المستخدم مثل الصور والمستندات وملفات PDF ومقاطع الفيديو. وهذا منفصل عن كود تطبيقك وهو مصمم للمحتوى الديناميكي الذي يقوم المستخدمون بإنشائه أو تحميله أثناء استخدام تطبيقك.
الحدود والملاحظات الهامة
- يمكن أن يصل حجم الملفات الفردية إلى 500 ميجابايت
- يعد حذف الملف دائمًا — فلا توجد سلة مهملات ولا سلة محذوفات
- يتم احتساب استخدام مساحة التخزين ضمن حصة حسابك
ما الذي يتيحه نظام ملفات المحتوى
يوفر نظام ملفات المحتوى إمكانات قوية لإدارة الملفات لتطبيقك:
- تخزين الصور الرمزية للمستخدم، وصور الملف الشخصي، ومعارض الصور
- قبول تحميلات المستندات مثل السير الذاتية أو العقود أو ملفات PDF
- إنشاء ميزات مشاركة الملفات بين المستخدمين في تطبيقك
- إنشاء تطبيقات كثيفة الصور من خلال التحسين التلقائي
- السماح للمستخدمين بتنزيل الملفات التي قاموا بتحميلها أو التي تخصهم
- إنشاء أدوات إدارية حيث يمكنك إدارة الملفات نيابةً عن المستخدمين
كيف يعمل
عندما تصف ميزة تحتاج إلى تخزين ملفات للذكاء الاصطناعي، فإنها تتعامل تلقائيًا مع التنفيذ بالكامل:
إعداد واجهة التحميل — إنشاء نماذج أو مناطق سحب وإفلات حيث يمكن للمستخدمين تحديد الملفات من أجهزتهم
تكوين التحكم في الوصول — يحدد من يمكنه عرض الملفات أو تحميلها أو حذفها بناءً على ما تقوم بإنشائه
تنفيذ تحسين الصورة — يقوم تلقائيًا بتغيير حجم الصور وعرضها بكفاءة حتى يتم تحميل تطبيقك بسرعة
إنشاء بنية التخزين — تنظيم الملفات في مجلدات منطقية مثل /content/uploads/ أو /content/avatars/
يتعامل مع الواجهة الخلفية — يدير تخزين الملفات الفعلي واسترجاعه وتسليمه دون الحاجة إلى التفكير في الأمر
يتم تخزين الملفات في مسارات مثل /content/uploads/photo.jpg ويمكن الرجوع إليها مباشرة في تطبيقك. يتتبع النظام من رفع كل ملف ومتى أُنشئ، ويفرض قواعد الوصول الخاصة بك.
التحكم في الوصول للملفات
تمامًا مثل جداول قاعدة البيانات وEdge functions، تحتوي الملفات على سياسات أمان تتحكم في من يمكنه الوصول إليها. الملفات خاصة بشكل افتراضي — لا يمكن لأحد الوصول إليها حتى تقوم بتكوين الأذونات. يقوم الذكاء الاصطناعي بإعداد هذه العناصر بناءً على ما تقوم ببنائه:
الملفات العامة
يمكن لأي شخص مشاهدتها، حتى بدون تسجيل الدخول. يمكن للمستخدمين الذين قاموا بتسجيل الدخول التحميل، ولا يمكن حذفه إلا للشخص الذي قام بتحميل الملف. مثالي لمعارض الصور أو مشاركة الصور العامة أو مواقع المحتوى التي ينشئها المستخدمون.
الملفات الخاصة
يمكن فقط للمستخدم الذي قام بتحميل الملف عرضه أو حذفه. يُستخدم للمستندات الحساسة أو الصور الخاصة أو السجلات الطبية أو أي شيء لا يريد المستخدمون أن يراه الآخرون.
الملفات المشتركة داخل المؤسسة
يمكن للمستخدمين من نفس المؤسسة عرض الملفات التي تم تحميلها بواسطة أي شخص في مؤسستهم. يمكن للأفراد حذف الملفات التي قاموا بتحميلها فقط. رائعة لمشاركة مستندات الفريق أو موارد الشركة أو مساحات العمل التعاونية.
الوصول للمالك فقط
يمكنك أنت فقط (منشئ التطبيق) الوصول إلى هذه الملفات، وليس المستخدمين النهائيين لديك. مفيد لتخزين ملفات النظام أو القوالب أو الموارد الإدارية التي تعمل على تشغيل تطبيقك ولكن لا ينبغي أن تكون موجهة للمستخدم.
التحكم المتقدم في الوصول
يمكن للذكاء الاصطناعي إنشاء قواعد وصول معقدة بناءً على البيانات الوصفية للملف. على سبيل المثال:
- المقالات المنشورة عامة، لكن المسودات تكون مرئية للمؤلف فقط
- تكون الملفات التي تم وضع علامة عليها بقسم مرئية فقط للمستخدمين في هذا القسم
- يتطلب المحتوى المميز علامة اشتراك على حساب المستخدم
- تكون الملفات المشتركة مرئية للمتعاونين المدرجين في البيانات التعريفية للملف
تحسين الصورة
يتم تحسين الصور التي يتم تحميلها إلى نظام ملفات المحتوى تلقائيًا للتحميل السريع. عندما تقوم بعرض صورة، يمكنك طلب عرض محدد وسيتولى النظام الباقي:
<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />
<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />
<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />
<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />
كيف يعمل التحسين
التحميل التدريجي — في المرة الأولى التي يطلب فيها شخص ما حجمًا محسنًا، يقدم النظام أقرب إصدار متاح وينشئ الحجم الدقيق في الخلفية. يحصل كل طلب بعد ذلك على الصورة المحسنة ذات الحجم المثالي. يتم الاحتفاظ بالملف الأصلي دائمًا.
تسليم التنسيق الحديث — يقدم النظام تلقائيًا تنسيقات الصور الحديثة (AVIF أو WebP) إلى المتصفحات التي تدعمها، مع الرجوع التلقائي إلى JPEG أو PNG للمتصفحات الأقدم. يحدث هذا بشفافية - ما عليك سوى تحديد العرض، وسيحصل المستخدمون على أسرع إصدار تحميل يمكن لمتصفحهم التعامل معه.
تحسين الأداء — استخدم عروضًا أصغر لتحسين الأداء. يتم تحميل الصورة المصغرة بحجم 200 بكسل بشكل أسرع بكثير من الصورة الأصلية بحجم 4000 بكسل وتستخدم نطاقًا تردديًا أقل. اختر العرض الذي يطابق كيفية عرض الصورة.
استخدام الملفات في التطبيق الخاص بك
يقوم الذكاء الاصطناعي بدمج نظام ملفات المحتوى في تطبيق React الخاص بك تلقائيًا. عندما تطلب ميزات تتضمن ملفات، فإنها تقوم بإنشاء مكونات واجهة المستخدم، وربط منطق التحميل/التنزيل، ومعالجة الأخطاء.
الأنماط الشائعة التي ينفذها الذكاء الاصطناعي
تحميل الصورة الرمزية — واجهة تحميل صورة الملف الشخصي التي تتحقق من صحة أنواع الصور، وتظهر تقدم التحميل، وتعاين الصورة، وتحفظ المسار إلى الملف الشخصي للمستخدم.
معرض المستندات — متصفح ملفات يسرد المستندات التي تم تحميلها، ويعرض صورًا مصغرة للصور، ويوفر روابط التنزيل، ويسمح بالتصفية أو البحث.
التحميل بالسحب والإفلات — منطقة تحميل بديهية حيث يمكن للمستخدمين سحب الملفات من سطح المكتب الخاص بهم، ورؤية تقدم التحميل، وإلغاء التحميلات الجارية، والحصول على رسائل خطأ للملفات غير الصالحة.
منتقي الملفات — نافذة منبثقة أو شريط جانبي يعرض الملفات التي قام المستخدم بتحميلها مسبقًا، ويسمح له باختيار ملف لإعادة استخدامه، ويعرض الصور المصغرة وأسماء الملفات.
التكامل مع Edge functions
يمكن لـ Edge functions (الكود الموجود على جانب الخادم) الوصول إلى نظام ملفات المحتوى لمعالجة الملفات أو إنشاء الملفات برمجيًا أو تنفيذ منطق مخصص لمعالجة الملفات.
ما الذي يمكن لـ Edge functions فعله بالملفات
- إنشاء تقارير PDF وحفظها ليتمكن المستخدمون من تنزيلها
- معالجة الصور التي تم تحميلها (تطبيق العلامات المائية وإنشاء صور مصغرة واستخراج البيانات الوصفية)
- فحص المستندات المرفوعة بحثًا عن بيانات حساسة قبل قبولها
- تنفيذ النسخ الاحتياطي المخصص أو منطق الأرشفة
- تحليل محتويات الملف واستخراج البيانات المنظمة
- تشغيل سير العمل عند تحميل ملفات محددة
تحذير: ملاحظة أمنية هامة
Edge functions تجاوز التحكم في الوصول العادي. عندما تصل وظيفتك إلى الملفات، فهي لا تكون مقيدة بقواعد "العامة" أو "المالك" التي تنطبق على المستخدمين. وهذا يعني أنه يجب عليك تنفيذ عمليات التحقق من الصلاحيات الخاصة بك في كود الوظيفة للتأكد من أنه لا يمكن للمستخدمين الوصول إلا إلى الملفات التي يجب عليهم رؤيتها.
على سبيل المثال، إذا قام مستخدم باستدعاء وظيفتك لطلب ملف، فستحتاج إلى التحقق من أنه يمتلك هذا الملف أو لديه إذن للوصول إليه قبل إرجاع المحتويات. يتعامل الذكاء الاصطناعي مع هذا الأمر عند إنشاء وظائفك، ولكن من المهم أن تفهم أن كود الوظيفة يعمل بصلاحيات مرتفعة.
تنظيم التخزين
يقوم الذكاء الاصطناعي بتنظيم الملفات في مجلدات منطقية بناءً على ما تقوم بإنشائه. لا تحتاج إلى إنشاء بنيات المجلدات يدويًا — ما عليك سوى وصف ما تحتاجه، وسيقوم الذكاء الاصطناعي بإعداد المسارات المناسبة.
أنماط التنظيم الشائعة
/content/uploads/— تحميلات المستخدم العامة/content/avatars/— صور الملف الشخصي للمستخدم/content/documents/— ملفات PDF والمستندات/content/gallery/— صور معرض الصور/content/private/— ملفات المستخدم الخاصة/content/public/— الملفات التي يمكن الوصول إليها بشكل عام/content/temp/— الملفات المؤقتة التي يمكن حذفها
يستطيع الذكاء الاصطناعي إنشاء مجلدات متداخلة مثل /content/uploads/2024/ أو /content/users/[username]/ عندما يكون ذلك مناسبًا لحالة الاستخدام الخاصة بك. يتم تعقب الملفات من خلال مسارها الكامل، لذا فإن نقل الملفات أو إعادة تسميتها يؤدي إلى تحديث جميع المراجع تلقائيًا.
المراقبة والتصحيح
يتم تسجيل جميع عمليات الملف - التحميلات والتنزيلات ورفض الوصول والأخطاء. يمكنك عرض هذه السجلات في واجهة المسؤول لفهم كيفية استخدام تخزين الملفات الخاصة بك:
- معرفة الملفات التي تُرفع بشكل متكرر
- تحديد عمليات الرفع الفاشلة والخطأ الذي حدث
- تتبع أنماط التنزيل والملفات الشائعة
- مراقبة استخدام التخزين والنمو مع مرور الوقت
- تصحيح مشكلات التحكم في الوصول عندما لا يتمكن المستخدمون من الوصول إلى الملفات التي يتوقعون رؤيتها
يتتبع النظام أيضًا مقاييس التخزين - إجمالي الملفات المخزنة، والحجم الإجمالي، ومعدل النمو، وأكبر الملفات. يساعدك هذا على فهم مساحة تخزين تطبيقك والتخطيط للتوسع.
الحدود والقيود
افتراضيًا، يمكن أن يصل حجم الملفات الفردية إلى 500 ميجابايت. هذا قابل للتكوين - يمكن للذكاء الاصطناعي ضبط الحد بناءً على ما تقوم ببنائه. بالنسبة لمعظم التطبيقات (تحميل الصور ومشاركة المستندات وملفات PDF)، يكون الحد الافتراضي أكثر من كافٍ.
يتم تخزين الملفات بشكل متكرر من أجل الموثوقية. إذا قمت بحذف ملف، فستتم إزالته نهائيًا من النظام — لا توجد سلة مهملات أو سلة محذوفات، لذا يكون الحذف فوريًا ونهائيًا.
العمل مع الذكاء الاصطناعي
عند وصف الميزات التي تحتاج إلى تخزين الملفات، كن محددًا بشأن:
- من يمكنه الوصول إلى الملفات — القواعد العامة أو الخاصة أو المشتركة بين المؤسسة أو المخصصة
- ما هي أنواع الملفات — الصور فقط، وملفات PDF، وأي نوع ملف، وحدود الحجم
- كيفية تنظيم الملفات — المجلدات، واصطلاحات التسمية، وما إذا كان يمكن للمستخدمين إنشاء مجلدات فرعية
- ماذا يحدث بعد التحميل — العرض في المعرض، والإرفاق بسجل، والمعالجة باستخدام وظيفة
يستخدم الذكاء الاصطناعي هذه المعلومات لتكوين التخزين بشكل صحيح، وإعداد سياسات الوصول، وإنشاء واجهة تتوافق مع احتياجاتك.
الوثائق ذات الصلة: