تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

التخزين والوسائط

كل ملفّ يحفظه uMarker (اللقطات ومصغّراتها، وشعارات الودجت، والصور الشخصية، وصور تذاكر الدعم) يُقرأ ويُكتب عبر قرص Laravel filesystem وحده، أبداً بمسار نظام ملفّات خام ولا عبر SDK المزوّد. هذا الدرز الواحد مبدأ تأسيسي: الوسائط دائماً منطّقة بالحساب ومحروسة عند الوصول، بدل ما تُبلَغ بمسار خام أو رابط عام.

الوسائط تُكتب تحت بادئات ثابتة على القرص المضبوط، وكل ملفّ يُسمّى بـUUID عشوائي، فالأسماء ما تُخمَّن وما تتصادم:

  • Directoryfeedback/
    • Directoryscreenshots/ لقطة التقرير، وجنبها مصغّرتها بصيغة WebP
      • …
    • Directoryattachments/ تاريخية فقط: الودجت ما عاد يجمع مرفقات
      • …
    • Directoryrecordings/ تاريخية فقط: تسجيل الشاشة أُلغي
      • …

قاعدة البيانات تخزّن المسار لكل ملفّ فقط، مو البايتات. وبيانات الالتقاط المُهيكلة (سجلّ الكونسول، والبيانات الوصفية، ومسار التنقّل، والطلبات الفاشلة، وهندسة الدبابيس) تعيش كأعمدة JSON في MySQL، مو على القرص.

قبل الرفع: يُقاس ويُرمَّز على الجهاز

Section titled “قبل الرفع: يُقاس ويُرمَّز على الجهاز”

اللقطة تُجهَّز داخل متصفّح المُبلِّغ، عبر مُرمِّز واحد مشترك يستخدمه السنيبت والأداة والإضافة، لأن نسختين من المُرمِّز هي الطريقة اللي يصير فيها سطح يخزّن ضعف اللي يخزّنه الثاني بصمت.

  • ميزانية بكسلات. أي رسم أكبر من 8 ميغابكسل يُصغَّر لين يدخل الميزانية، بحدّ أدنى نصف المقياس، لأن لقطة غير مقروءة مو لقطة أرخص.
  • WebP، مفحوص لا مفترَض. الكانفس يُرمَّز WebP بجودة 0.85 وتُفحص النتيجة أنها فعلاً WebP، لأن متصفّحاً تُعطيه نوعاً ما يدعمه يرجّع PNG بصمت، وهي أكبر بمرّات من الـJPEG اللي كنا نحاول نتفوّق عليها. والمتصفّحات اللي ما ترمّز WebP ترجع لـJPEG.

كيف تُفحص الوسائط عند الدخول

Section titled “كيف تُفحص الوسائط عند الدخول”

التخزين حدّ ثقة. لمّا تفكّ نقطة الإدخال ترميز data URL مرفوع، ما توثق في كلام العميل عن نوع الملفّ:

  1. الحجم يُفحص قبل فكّ الترميز. طول الـbase64 يُحدّ أولاً (حارس ضد إنهاك الخدمة)، وبعدها يُفحص طول البايتات المفكوكة مقابل السقف.

  2. الصور لازم تكون صوراً فعلاً. اللقطة تُفكّ وتُفحص: لازم تكون صورة نقطية حقيقية، والنوع المُخزَّن هو النوع المُكتشَف من البايتات، مو المُعلَن من العميل. وهذا يرفض تزوير HTML أو SVG على أنه PNG، اللي كان ممكن يصير XSS مخزَّناً لمّا تُقدَّم الصورة داخل الصفحة.

  3. ما يُخزَّن إلا نوع معروف. الامتداد على القرص يُختار من قائمة سماح وحدة مفتاحها النوع المُكتشَف، ونفس الجدول يُقرأ بالعكس عشان يقول للمعرض وش نوع الملفّ المخزَّن، فما يقدر الاتجاهان يفترقان.

  4. الكتابة المرفوضة تفشل بصوت عالٍ. طبقة القرص ترمي بدل ما ترجّع false، لأن النسخة الصامتة كانت تخزّن مساراً لملفّ ما كُتب أبداً: أثناء أي عطل تخزين يُقبل كل تقرير بـ200 ويعرض صورة مكسورة للأبد، وما يمكن إعادة التقاطه لأن الزائر راح من زمان.

الوسيط السقف
لقطة التقرير 12 ميغابايت بعد فكّ الترميز
صورة تذكرة دعم 5 ميغابايت، صور فقط، وبحد أقصى 3 لكل رسالة

حجم كل لقطة بالبايت يُسجَّل على التقرير، وكل حساب يحمل عدّاداً جارياً storage_bytes. والعدّاد يُعامَل كذاكرة مؤقّتة مو كحقيقة: الحذف الجماعي يتجاوز أحداث النموذج والمهامّ تفشل، فعدّاد ما يقدر إلا يُعدَّل هو عدّاد يغلط في النهاية. ومهمّة ليلية storage:reconcile تجمع الصفوف وتصحّحه.

واللي يغطّيه العدّاد هو الوسائط اللي تكبر مع الاستعمال: لقطات التقارير، والمرفقات والتسجيلات اللي تحملها التقارير القديمة، والصور اللي ترفقها أنت بتذكرة دعم. أما الصور اللي يرسلها لك الدعم فهي تكلفتنا مو تكلفتك، وما تُحسب عليك أبداً. وشعارات الودجت وصور الإعلانات ملفّ صغير واحد لكل مشروع أو لكل منشور، وحسابها كان بيصعّب شرح الرقم بلا ما يخلّيه أدقّ.

كيف تنتهي صلاحية الوسائط

Section titled “كيف تنتهي صلاحية الوسائط”

فيه مهمّتان مجدولتان تحذفان الوسائط، والفرق بينهما مقصود:

سياسة الاحتفاظ حقّك

feedback:purge-expired تشتغل كل ليلة وتحذف تقارير كاملة أقدم من النافذة اللي ضبطها حسابك، ومعها وسائطها. هذا وعد خصوصية تقطعه أنت، فما تشتغل إلا للحسابات اللي ضبطت نافذة وباقتها تتضمّن قدرة الاحتفاظ المخصّص.

نافذة الوسائط حق الباقة

media:purge-expired تمسح البايتات فقط بعد نافذة الوسائط في باقتك وتبقي التقرير: عنوانه ووصفه ودبابيسه وتعليقاته وتسمياته وحالته وسياقه التقني كلها تبقى. المجاني 30 يوماً، البداية 180، الاحترافي 365، الوكالات 730.

وفيه كنس أسبوعي كمان يشيل الملفّات اللي ما عاد أي صفّ يدّعيها، لأن مهمّة حذف فاشلة تترك بايتات ما أحد يقدر يلقاها من صفّ وما أحد يوقف دفع تكلفتها.

كيف تُقدَّم الوسائط عند القراءة

Section titled “كيف تُقدَّم الوسائط عند القراءة”

قراءة الملفّ مُخوَّلة، ومنطّقة بالحساب، ومحصّنة ضد ألاعيب نوع المحتوى:

  • ربط منطّق بالحساب. اللقطة تُحلّ عبر نموذج منطّق بالحساب، فطلب ملفّ مستأجر ثاني يرجع 404 بدل البايتات، ولازم القارئ يوصل المشروع اللي يتبعه التقرير كمان.
  • التنزيل حقّ مستقل. على النقاط اللي تتوثّق بجلستك — اللقطة الكاملة في صفحة التقرير، والتسجيل، والمرفق — تقديم الملفّ يتطلّب صلاحية feedback.download المنفصلة فوق حقّ قراءة التقرير. اللقطة صورة لشاشة شخص في منتصف جلسته، وهي أكثر شي في هذا المنتج احتمالاً أن يحمل شيئاً ما قصد أحد يرسله. عشان كذا انفصلت قراءة التقرير عن أخذ ملفّاته. والروابط الموقّعة تحت باب ثاني بقاعدته: هناك التوقيع هو الاعتماد كلّه، وهذي الطريقة اللي تُقدَّم بها مصغّرات لوحة الوارد والمعرض.
  • نافذة تاريخ الباقة تنطبق. التقرير اللي خارج تاريخ باقتك المرئي ما يقدّم وسائطه من اللوحة كمان. أما الرابط الموقّع اللي صدر من قبل فيمشي على ساعة الوسائط بدلها، والاثنتان يقدر يختلفان بشكل حادّ: في المجاني التاريخ 7 أيام ونافذة الوسائط 30.
  • بلا استشمام نوع. كل استجابة وسائط تضع X-Content-Type-Options: nosniff، فما يعيد المتصفّح تفسير الملفّ كنوع ثانٍ قابل للتنفيذ.
  • روابط موقّعة للقارئ الخارجي. تذكرة المتتبّع — GitHub أو Linear أو Jira — تحمل اللقطة كرابط موقّع، لأن اللي يفتحها هناك ما له جلسة عندنا. وانتهاؤه يُحسب من ساعة احتفاظ الوسائط للتقرير نفسه، فما يدّعي الرابط عمراً أطول من عمر الملفّ. والتقرير اللي تجاوز نافذته ما يُنتج رابطاً أصلاً بدل رابط يرجّع 404. أما رسائل سلاك وTeams وتيليجرام والـwebhook فما تحمل أي صورة: بس رابط يرجّعك للتقرير في uMarker، وهذا يحتاج جلسة.
  • منطقة الاستضافة غير معلَنة. هي إعداد نشر، وما تقرّرت وأُعلنت. لا تُقرأ أي جملة في هذي الصفحة كالتزام بإقامة البيانات.
  • النسخ الاحتياطية تحتفظ بالبايتات المحذوفة أطول منك. نسخ قاعدة البيانات تُحفظ 30 يوماً افتراضياً، فالتقرير الممسوح يبقى داخلها لين تنقضي تلك النافذة. ووعد احتفاظ يتجاهل النسخ وعد كاذب.
  • إذا كان دلو الوسائط مفعّلاً عليه versioning، فاللقطة المحذوفة تبقى نسخةً غير حالية لين تُنهيها قاعدة دورة حياة. وتلك القاعدة إعداد على الدلو لا كود في التطبيق، ولازم تكون موجودة عشان يكتمل وعد الاحتفاظ من طرف لطرف.