Dosya Depolama ve İçerik Yönetimi
Uygulamanızda resimler, belgeler, PDF'ler ve videolar gibi kullanıcı tarafından yüklenen dosyaları depolamak için özel bir içerik dosya sistemi bulunur. Bu, uygulama kodunuzdan ayrıdır ve kullanıcıların uygulamanızı kullanırken oluşturduğu veya yüklediği dinamik içerik için tasarlanmıştır.
Limitler ve Önemli Notlar
- Tek tek dosyaların boyutu 500 MB'a kadar olabilir
- Dosya silme işlemi kalıcıdır — çöp kutusu veya geri dönüşüm kutusu yoktur
- Depolama alanı kullanımı hesap kotanıza dahil edilir
İçerik Dosya Sistemi Neleri Sağlar?
İçerik dosya sistemi, uygulamanız için güçlü dosya yönetimi yetenekleri sağlar:
- Kullanıcı avatarlarını, profil fotoğraflarını ve resim galerilerini saklayın
- Özgeçmiş, sözleşme veya PDF gibi belge yüklemelerini kabul edin
- Uygulamanızdaki kullanıcılar arasında dosya paylaşım özellikleri oluşturun
- Otomatik optimizasyonla görüntü ağırlıklı uygulamalar oluşturun
- Kullanıcıların yükledikleri veya kendilerine ait dosyaları indirmelerine izin verin
- Dosyaları kullanıcılar adına yönettiğiniz yönetim araçları oluşturun
Nasıl Çalışır?
Yapay zekâya dosya depolaması gerektiren bir özelliği tarif ettiğinizde uygulamanın tamamını otomatik olarak gerçekleştirir:
Yükleme arayüzünü ayarlar — Kullanıcıların cihazlarından dosya seçebileceği formlar veya sürükleyip bırakma bölgeleri oluşturur
Erişim kontrolünü yapılandırır — Oluşturduğunuz şeye bağlı olarak dosyaları kimin görüntüleyebileceğini, yükleyebileceğini veya silebileceğini belirler
Görsel optimizasyonunu uygular — Uygulamanızın hızlı yüklenmesi için görselleri otomatik olarak yeniden boyutlandırır ve verimli bir şekilde sunar
Depolama yapısını oluşturur — Dosyaları /content/uploads/ veya /content/avatars/ gibi mantıksal klasörler halinde düzenler
Arka ucu yönetir — Gerçek dosya depolamayı, almayı ve teslim etmeyi düşünmenize gerek kalmadan yönetir
Dosyalar /content/uploads/photo.jpg gibi yollarda saklanır ve doğrudan uygulamanızdan referans verilebilir. Sistem, her bir dosyayı kimin yüklediğini, ne zaman oluşturulduğunu izler ve erişim kurallarınızı uygular.
Dosyalara Erişim Kontrolü
Veritabanı tabloları ve edge function'lar gibi, dosyalar da onlara kimlerin erişebileceğini denetleyen güvenlik politikalarına sahiptir. Dosyalar varsayılan olarak özeldir — siz izinleri yapılandırana kadar hiç kimse bu dosyalara erişemez. Yapay zekâ bunları, oluşturduğunuz şeye göre ayarlar:
Genel Dosyalar
Oturum açmadan bile bunları herkes görüntüleyebilir. Oturum açmış kullanıcılar yükleme yapabilir ve yalnızca dosyayı yükleyen kişi dosyayı silebilir. Fotoğraf galerileri, genel resim paylaşımı veya kullanıcı tarafından oluşturulan içerik siteleri için mükemmeldir.
Özel Dosyalar
Yalnızca dosyayı yükleyen kullanıcı dosyayı görüntüleyebilir veya silebilir. Hassas belgeler, özel fotoğraflar, tıbbi kayıtlar veya kullanıcıların başkalarının görmesini istemeyeceği herhangi bir şey için kullanılır.
Organizasyonla Paylaşılan Dosyalar
Aynı organizasyondaki kullanıcılar, organizasyonlarındaki herhangi biri tarafından yüklenen dosyaları görüntüleyebilir. Kişiler yalnızca yükledikleri dosyaları silebilir. Ekip belge paylaşımı, şirket kaynakları veya iş birliğine dayalı çalışma alanları için idealdir.
Yalnızca Sahip Erişimi
Bu dosyalara yalnızca siz (uygulamayı oluşturan kişi) erişebilir, son kullanıcılarınız erişemez. Uygulamanıza güç veren ancak kullanıcıya dönük olmaması gereken sistem dosyalarını, şablonları veya yönetim kaynaklarını depolamak için kullanışlıdır.
Gelişmiş Erişim Kontrolü
Yapay zekâ, dosya meta verilerine dayalı olarak karmaşık erişim kuralları oluşturabilir. Örneğin:
- Yayınlanan makaleler herkese açıktır ancak taslaklar yalnızca yazar tarafından görülebilir
- Bir departmanla etiketlenen dosyalar yalnızca o departmandaki kullanıcılar tarafından görülebilir
- Premium içerik, kullanıcının hesabında bir abonelik bayrağı gerektirir
- Paylaşılan dosyalar, dosyanın meta verilerinde listelenen ortak çalışanlar tarafından görülebilir
Görüntü Optimizasyonu
İçerik dosya sistemine yüklenen görseller, hızlı yükleme için otomatik olarak optimize edilir. Bir görseli görüntülediğinizde belirli bir genişlik talep edebilirsiniz, gerisini sistem halleder:
<!-- 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" />
Optimizasyon Nasıl Çalışır?
Aşamalı yükleme — Biri ilk kez optimize edilmiş bir boyut istediğinde, sistem mümkün olan en yakın sürümü sunar ve arka planda tam boyutu oluşturur. Bundan sonraki her istek mükemmel boyutta, optimize edilmiş görüntüye sahip olur. Orijinal dosya her zaman korunur.
Modern format teslimi — Sistem, modern resim formatlarını (AVIF veya WebP) bunları destekleyen tarayıcılara otomatik olarak sunar ve daha eski tarayıcılar için JPEG veya PNG'ye otomatik geri dönüş sağlar. Bu şeffaf bir şekilde gerçekleşir; siz yalnızca genişliği belirtirsiniz ve kullanıcılar, tarayıcılarının kaldırabileceği en hızlı yükleme sürümüne sahip olur.
Performans optimizasyonu — Performansı artırmak için daha küçük genişlikler kullanın. 200 piksellik bir küçük resim, orijinal 4000 piksellik görüntüden çok daha hızlı yüklenir ve daha az bant genişliği kullanır. Resmi görüntüleme şeklinize uygun genişliği seçin.
Uygulamanızda Dosyaları Kullanma
Yapay zekâ, içerik dosya sistemini React uygulamanıza otomatik olarak entegre eder. Dosyalarla ilgili özellikler istediğinizde kullanıcı arayüzü bileşenlerini oluşturur, yükleme/indirme mantığını birbirine bağlar ve hataları yönetir.
Yapay zekânın uyguladığı yaygın kalıplar
Avatar Yükleme — Resim türlerini doğrulayan, yükleme ilerlemesini gösteren, resmin ön izlemesini yapan ve kullanıcının profiline giden yolu kaydeden bir profil fotoğrafı yükleme arayüzü.
Belge Galerisi — Yüklenen belgeleri listeleyen, görsellerin küçük resimlerini gösteren, indirme bağlantıları sağlayan ve filtrelemeye veya aramaya izin veren bir dosya tarayıcısı.
Sürükle ve Bırak Yükleme — Kullanıcıların dosyaları masaüstünden sürükleyebileceği, yükleme ilerlemesini görebileceği, devam eden yüklemeleri iptal edebileceği ve geçersiz dosyalar için hata mesajları alabileceği sezgisel bir yükleme alanı.
Dosya Seçici — Kullanıcının daha önce yüklediği dosyaları gösteren, yeniden kullanmak üzere bir dosya seçmesine olanak tanıyan ve küçük resimler ile dosya adlarını görüntüleyen bir modal veya kenar çubuğu.
Edge Function Entegrasyonu
Edge functions (sunucu tarafı kodunuz) dosyaları işlemek, dosyaları programlı olarak oluşturmak veya özel dosya işleme mantığını uygulamak için içerik dosya sistemine erişebilir.
Edge Functions Dosyalarla Neler Yapabilir?
- PDF raporları oluşturun ve bunları kullanıcıların indirmesi için kaydedin
- Yüklenen görselleri işleyin (filigran uygulayın, küçük resimler oluşturun, meta verileri çıkarın)
- Yüklenen belgeleri kabul etmeden önce hassas veriler açısından tarayın
- Özel yedekleme veya arşivleme mantığını uygulayın
- Dosya içeriğini analiz edin ve yapılandırılmış verileri çıkarın
- Belirli dosyalar yüklendiğinde iş akışlarını tetikleyin
Uyarı: Önemli Güvenlik Notu
Edge functions normal erişim kontrolünü atlar. İşleviniz dosyalara eriştiğinde, bu, kullanıcılar için geçerli olan "genel" veya "sahip" kurallarıyla sınırlı değildir. Bu, kullanıcıların yalnızca görmeleri gereken dosyalara erişebilmelerini sağlamak için işlev kodunda kendi yetkilendirme kontrollerinizi uygulamanız gerektiği anlamına gelir.
Örneğin, bir kullanıcı bir dosya istemek için işlevinizi çağırırsa, içeriği döndürmeden önce o dosyanın sahibi olduğunu veya dosyaya erişim iznine sahip olduğunu doğrulamanız gerekir. Yapay zekâ, işlevlerinizi oluştururken bunu halleder ancak işlev kodunun yükseltilmiş ayrıcalıklarla çalıştığını anlamak önemlidir.
Depolama Düzeni
Yapay zekâ, oluşturduğunuz şeye göre dosyaları mantıksal klasörler halinde düzenler. Klasör yapılarını manuel olarak oluşturmanıza gerek yoktur; yalnızca neye ihtiyacınız olduğunu tanımlayın ve yapay zekâ uygun yolları ayarlar.
Yaygın düzen kalıpları
/content/uploads/— Genel kullanıcı yüklemeleri/content/avatars/— Kullanıcı profili fotoğrafları/content/documents/— PDF'ler ve belgeler/content/gallery/— Fotoğraf galerisi görüntüleri/content/private/— Özel kullanıcı dosyaları/content/public/— Herkese açık olarak erişilebilen dosyalar/content/temp/— Silinebilen geçici dosyalar
Yapay zekâ, kullanım durumunuza uygun olduğunda /content/uploads/2024/ veya /content/users/[username]/ gibi iç içe klasörler de oluşturabilir. Dosyalar tam yollarına göre izlenir, dolayısıyla dosyaların taşınması veya yeniden adlandırılması tüm referansları otomatik olarak günceller.
İzleme ve Hata Ayıklama
Tüm dosya işlemleri (yüklemeler, indirmeler, erişim reddi ve hatalar) günlüğe kaydedilir. Dosya depolama alanınızın nasıl kullanıldığını anlamak için bu günlükleri yönetici arayüzünde görüntüleyebilirsiniz:
- En sık hangi dosyaların yüklendiğini görün
- Başarısız yüklemeleri ve neyin yanlış gittiğini belirleyin
- İndirme modellerini ve popüler dosyaları takip edin
- Depolama kullanımını ve zaman içindeki büyümeyi izleyin
- Kullanıcılar görmeyi bekledikleri dosyalara erişemediğinde erişim kontrolü sorunlarında hata ayıklama
Sistem aynı zamanda depolama ölçümlerini de (depolanan toplam dosyalar, toplam boyut, büyüme oranı ve en büyük dosyalar) izler. Bu, uygulamanızın depolama alanını anlamanıza ve ölçeklendirme planınızı yapmanıza yardımcı olur.
Sınırlar ve Kısıtlamalar
Varsayılan olarak, tek tek dosyalar 500 MB'a kadar olabilir. Bu yapılandırılabilir; yapay zekâ, oluşturduğunuz şeye göre sınırı ayarlayabilir. Çoğu uygulama için (görüntü yükleme, belge paylaşımı, PDF'ler) varsayılan sınır fazlasıyla yeterlidir.
Güvenilirlik için dosyalar yedekli olarak depolanır. Bir dosyayı silerseniz, sistemden kalıcı olarak kaldırılır; çöp kutusu veya geri dönüşüm kutusu yoktur, dolayısıyla silme işlemi anında ve nihaidir.
Yapay zekâ ile çalışma
Dosya depolama gerektiren özellikleri açıklarken aşağıdaki konularda net olun:
- Dosyalara kimler erişebilir — Genel, özel, organizasyon içinde paylaşılan veya özel kurallar
- Hangi dosya türleri — Yalnızca görseller, PDF'ler, tüm dosya türleri, boyut sınırları
- Dosyalar nasıl düzenlenir — Klasörler, adlandırma kuralları, kullanıcıların alt klasör oluşturup oluşturamayacağı
- Yüklemeden sonra ne olur — Galeride görüntüleme, kayda ekleme, işlevle işleme
Yapay zekâ, depolamayı doğru şekilde yapılandırmak, erişim politikalarını ayarlamak ve ihtiyaçlarınıza uygun bir arayüz oluşturmak için bu bilgileri kullanır.
İlgili Belgeler: