File Storage dan Manajemen Konten

Aplikasi Anda memiliki filesystem konten khusus untuk menyimpan file yang diunggah pengguna seperti gambar, dokumen, PDF, dan video. Ini terpisah dari kode aplikasi dan dirancang untuk konten dinamis yang dibuat atau diunggah pengguna saat memakai aplikasi.

Limit dan Catatan Penting

  • File individual dapat berukuran hingga 500MB
  • Penghapusan file bersifat permanen — tidak ada trash atau recycle bin
  • Penggunaan storage dihitung terhadap kuota akun Anda

Yang Dimungkinkan Content Filesystem

Content filesystem menyediakan kemampuan manajemen file yang kuat untuk aplikasi Anda:

  • Menyimpan avatar pengguna, foto profil, dan galeri gambar
  • Menerima unggahan dokumen seperti resume, kontrak, atau PDF
  • Membangun fitur file-sharing antar pengguna di aplikasi
  • Membuat aplikasi berat gambar dengan optimisasi otomatis
  • Membiarkan pengguna mengunduh file yang mereka unggah atau yang menjadi milik mereka
  • Membangun alat administratif tempat Anda mengelola file atas nama pengguna

Cara Kerjanya

Saat Anda menjelaskan fitur yang membutuhkan file storage kepada AI, AI otomatis menangani seluruh implementasi:

Menyiapkan antarmuka upload — Membuat formulir atau area drag-and-drop tempat pengguna dapat memilih file dari perangkat

Mengonfigurasi kontrol akses — Menentukan siapa yang dapat melihat, mengunggah, atau menghapus file berdasarkan yang Anda bangun

Mengimplementasikan optimisasi gambar — Otomatis mengubah ukuran dan menyajikan gambar secara efisien agar aplikasi dimuat cepat

Membuat struktur storage — Mengatur file ke folder logis seperti /content/uploads/ atau /content/avatars/

Menangani backend — Mengelola penyimpanan, pengambilan, dan pengiriman file sebenarnya tanpa Anda perlu memikirkannya

File disimpan di path seperti /content/uploads/photo.jpg dan dapat direferensikan langsung di aplikasi. Sistem melacak siapa yang mengunggah tiap file, kapan dibuat, dan menerapkan aturan akses Anda.

Kontrol Akses untuk File

Sama seperti tabel database dan edge functions, file memiliki kebijakan keamanan yang mengontrol siapa yang dapat mengaksesnya. File bersifat privat secara default — tidak ada yang dapat mengaksesnya sampai Anda mengonfigurasi izin. AI menyiapkan ini berdasarkan yang Anda bangun:

File Publik

Siapa pun dapat melihatnya, bahkan tanpa login. Pengguna yang masuk dapat mengunggah, dan hanya orang yang mengunggah file yang dapat menghapusnya. Cocok untuk galeri foto, berbagi gambar publik, atau situs konten buatan pengguna.

File Privat

Hanya pengguna yang mengunggah file yang dapat melihat atau menghapusnya. Digunakan untuk dokumen sensitif, foto privat, rekam medis, atau apa pun yang tidak ingin dilihat pengguna lain.

File Berbagi Organisasi

Pengguna dari organisasi yang sama dapat melihat file yang diunggah siapa pun di org mereka. Individu hanya dapat menghapus file yang mereka unggah. Bagus untuk berbagi dokumen tim, sumber daya perusahaan, atau workspace kolaboratif.

Akses Owner-Only

Hanya Anda (pembuat aplikasi) yang dapat mengakses file ini, bukan end user Anda. Berguna untuk menyimpan file sistem, template, atau resource administratif yang menggerakkan aplikasi tetapi tidak seharusnya menghadap pengguna.

Kontrol Akses Lanjutan

AI dapat membuat aturan akses canggih berdasarkan metadata file. Misalnya:

  • Artikel yang dipublikasikan bersifat publik, tetapi draft hanya terlihat oleh penulis
  • File yang ditag dengan departemen hanya terlihat oleh pengguna di departemen itu
  • Konten premium membutuhkan flag langganan pada akun pengguna
  • File bersama terlihat oleh kolaborator yang tercantum di metadata file

Optimisasi Gambar

Gambar yang diunggah ke content filesystem otomatis dioptimalkan untuk pemuatan cepat. Saat menampilkan gambar, Anda dapat meminta lebar tertentu dan sistem menangani sisanya:

<!-- 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" />

Cara Optimisasi Bekerja

Progressive loading — Pertama kali seseorang meminta ukuran yang dioptimalkan, sistem menyajikan versi terdekat yang tersedia dan menghasilkan ukuran persisnya di background. Setiap request setelah itu mendapat gambar yang berukuran tepat dan dioptimalkan. File asli selalu dipertahankan.

Pengiriman format modern — Sistem otomatis menyajikan format gambar modern (AVIF atau WebP) ke browser yang mendukungnya, dengan fallback otomatis ke JPEG atau PNG untuk browser lama. Ini terjadi transparan. Anda hanya menentukan lebar, dan pengguna mendapat versi dengan pemuatan tercepat yang dapat ditangani browser mereka.

Optimisasi performa — Gunakan lebar lebih kecil untuk meningkatkan performa. Thumbnail 200px dimuat jauh lebih cepat daripada gambar asli 4000px dan memakai bandwidth lebih kecil. Pilih lebar yang cocok dengan cara Anda menampilkan gambar.

Memakai File di Aplikasi

AI mengintegrasikan content filesystem ke aplikasi React Anda secara otomatis. Saat Anda meminta fitur yang melibatkan file, AI membuat komponen UI, menghubungkan logika upload/download, dan menangani error.

Pola Umum yang Diimplementasikan AI

Upload Avatar — Antarmuka upload foto profil yang memvalidasi jenis gambar, menampilkan progress upload, mempratinjau gambar, dan menyimpan path ke profil pengguna.

Galeri Dokumen — Browser file yang mencantumkan dokumen terunggah, menampilkan thumbnail untuk gambar, menyediakan link download, dan memungkinkan filtering atau pencarian.

Upload Drag-and-Drop — Area upload intuitif tempat pengguna dapat menyeret file dari desktop, melihat progress upload, membatalkan upload yang sedang berjalan, dan mendapat pesan error untuk file tidak valid.

File Picker — Modal atau sidebar yang menampilkan file yang pernah diunggah pengguna, memungkinkan mereka memilih salah satu untuk dipakai ulang, serta menampilkan thumbnail dan nama file.

Integrasi Edge Function

Edge functions (kode sisi server Anda) dapat mengakses content filesystem untuk memproses file, menghasilkan file secara programatis, atau mengimplementasikan logika penanganan file kustom.

Yang Dapat Dilakukan Edge Functions dengan File

  • Menghasilkan laporan PDF dan menyimpannya agar dapat diunduh pengguna
  • Memproses gambar terunggah (menerapkan watermark, membuat thumbnail, mengekstrak metadata)
  • Memindai dokumen terunggah untuk data sensitif sebelum menerimanya
  • Mengimplementasikan logika backup atau archival kustom
  • Menganalisis isi file dan mengekstrak data terstruktur
  • Memicu workflow saat file tertentu diunggah

Peringatan: Catatan Keamanan Penting

Edge functions melewati kontrol akses normal. Saat function Anda mengakses file, function tidak dibatasi oleh aturan "public" atau "owner" yang berlaku untuk pengguna. Artinya Anda harus mengimplementasikan pemeriksaan otorisasi sendiri dalam kode function untuk memastikan pengguna hanya dapat mengakses file yang seharusnya mereka lihat.

Misalnya, jika pengguna memanggil function Anda untuk meminta file, Anda perlu memverifikasi bahwa mereka memiliki file itu atau punya izin untuk mengaksesnya sebelum mengembalikan isinya. AI menangani ini saat membangun function Anda, tetapi penting untuk memahami bahwa kode function berjalan dengan hak istimewa lebih tinggi.

Organisasi Storage

AI mengatur file ke folder logis berdasarkan yang Anda bangun. Anda tidak perlu membuat struktur folder manual. Cukup jelaskan yang Anda butuhkan, dan AI menyiapkan path yang sesuai.

Pola Organisasi Umum

  • /content/uploads/ — Upload pengguna umum
  • /content/avatars/ — Foto profil pengguna
  • /content/documents/ — PDF dan dokumen
  • /content/gallery/ — Gambar galeri foto
  • /content/private/ — File pengguna privat
  • /content/public/ — File yang dapat diakses publik
  • /content/temp/ — File sementara yang dapat dihapus

AI dapat membuat folder bersarang seperti /content/uploads/2024/ atau /content/users/[username]/ saat sesuai untuk use case Anda. File dilacak berdasarkan full path, sehingga memindahkan atau mengganti nama file memperbarui semua referensi secara otomatis.

Monitoring dan Debugging

Semua operasi file dicatat: upload, download, penolakan akses, dan error. Anda dapat melihat log ini di antarmuka admin untuk memahami bagaimana file storage digunakan:

  • Lihat file mana yang paling sering diunggah
  • Identifikasi upload gagal dan apa yang salah
  • Lacak pola download dan file populer
  • Pantau penggunaan storage dan pertumbuhan seiring waktu
  • Debug masalah kontrol akses saat pengguna tidak dapat mengakses file yang mereka harapkan

Sistem juga melacak metrik storage: total file tersimpan, total ukuran, laju pertumbuhan, dan file terbesar. Ini membantu Anda memahami jejak storage aplikasi dan merencanakan scaling.

Limit dan Batasan

Secara default, file individual dapat berukuran hingga 500MB. Ini dapat dikonfigurasi. AI dapat menyesuaikan limit berdasarkan yang Anda bangun. Untuk sebagian besar aplikasi (upload gambar, berbagi dokumen, PDF), limit default lebih dari cukup.

File disimpan secara redundan untuk keandalan. Jika Anda menghapus file, file dihapus permanen dari sistem. Tidak ada trash atau recycle bin, jadi penghapusan langsung dan final.

Bekerja dengan AI

Saat menjelaskan fitur yang membutuhkan file storage, spesifiklah tentang:

  • Siapa yang dapat mengakses file — Publik, privat, dibagikan organisasi, atau aturan kustom
  • Jenis file apa — Hanya gambar, PDF, jenis file apa pun, limit ukuran
  • Bagaimana file diatur — Folder, konvensi nama, apakah pengguna dapat membuat subfolder
  • Yang terjadi setelah upload — Tampil di galeri, ditempelkan ke record, diproses dengan function

AI menggunakan informasi ini untuk mengonfigurasi storage dengan benar, menyiapkan kebijakan akses, dan membuat antarmuka yang sesuai dengan kebutuhan Anda.


Dokumentasi Terkait: