Archiviazione di file e gestione dei contenuti

La tua applicazione dispone di un file system di contenuti dedicato per l'archiviazione di file caricati dagli utenti come immagini, documenti, PDF e video. Questo è separato dal codice dell'applicazione ed è progettato per il contenuto dinamico che gli utenti creano o caricano durante l'utilizzo della tua app.

Limiti e note importanti

  • I singoli file possono avere una dimensione massima di 500 MB
  • L'eliminazione dei file è permanente: non c'è alcun cestino
  • L'utilizzo dello spazio di archiviazione viene conteggiato nella quota del tuo account

Cosa consente il file system del contenuto

Il filesystem dei contenuti fornisce potenti funzionalità di gestione dei file per la tua applicazione:

  • Memorizza avatar utente, foto del profilo e gallerie di immagini
  • Accetta caricamenti di documenti come curriculum, contratti o PDF
  • Crea funzionalità di condivisione file tra gli utenti nella tua app
  • Crea applicazioni con un elevato utilizzo di immagini con ottimizzazione automatica
  • Consenti agli utenti di scaricare i file che hanno caricato o che appartengono a loro
  • Crea strumenti amministrativi in cui gestisci i file per conto degli utenti

Come funziona

Quando descrivi una funzionalità che richiede l'archiviazione di file all'AI, questa gestisce automaticamente l'intera implementazione:

Configura l'interfaccia di caricamento: crea moduli o zone drag-and-drop in cui gli utenti possono selezionare file dal proprio dispositivo

Configura il controllo degli accessi: determina chi può visualizzare, caricare o eliminare file in base a ciò che stai creando

Implementa l'ottimizzazione delle immagini: ridimensiona e serve automaticamente le immagini in modo efficiente in modo che la tua app si carichi velocemente

Crea la struttura di archiviazione: organizza i file in cartelle logiche come /content/uploads/ o /content/avatars/

Gestisce il backend: si occupa dell'archiviazione, il recupero e la consegna dei file senza che tu debba pensarci

I file vengono archiviati in percorsi come /content/uploads/photo.jpg e possono essere referenziati direttamente nella tua app. Il sistema tiene traccia di chi ha caricato ciascun file, quando è stato creato e applica le tue regole di accesso.

Controllo dell'accesso ai file

Proprio come le tabelle del database e le edge function, i file hanno policy di sicurezza che controllano chi può accedervi. I file sono privati per impostazione predefinita: nessuno può accedervi finché non configuri le autorizzazioni. L'intelligenza artificiale li imposta in base a ciò che stai costruendo:

File pubblici

Chiunque può visualizzarli, anche senza effettuare l'accesso. Gli utenti che hanno effettuato l'accesso possono caricarli e solo la persona che ha caricato un file può eliminarlo. Perfetto per gallerie fotografiche, condivisione pubblica di immagini o siti di contenuti generati dagli utenti.

File privati

Solo l'utente che ha caricato un file può visualizzarlo o eliminarlo. Utilizzato per documenti sensibili, foto private, cartelle cliniche o qualsiasi cosa gli utenti non vorrebbero che gli altri vedessero.

File condivisi dall'organizzazione

Gli utenti della stessa organizzazione possono visualizzare i file caricati da chiunque nella loro organizzazione. Gli individui possono eliminare solo i file che hanno caricato. Ottimo per la condivisione di documenti del team, risorse aziendali o spazi di lavoro collaborativi.

Accesso riservato al proprietario

Solo tu (il creatore dell'app) puoi accedere a questi file, non i tuoi utenti finali. Utile per archiviare file di sistema, modelli o risorse amministrative che alimentano la tua app ma non devono essere rivolte all'utente.

Controllo accessi avanzato

L'intelligenza artificiale può creare sofisticate regole di accesso basate sui metadati dei file. Per esempio:

  • Gli articoli pubblicati sono pubblici, ma le bozze sono visibili solo all'autore
  • I file contrassegnati con un dipartimento sono visibili solo agli utenti di quel dipartimento
  • I contenuti premium richiedono un flag di abbonamento sull'account dell'utente
  • I file condivisi sono visibili ai collaboratori elencati nei metadati del file

Ottimizzazione delle immagini

Le immagini caricate nel file system dei contenuti vengono automaticamente ottimizzate per un caricamento rapido. Quando visualizzi un'immagine, puoi richiedere una larghezza specifica e il sistema si occuperà del resto:

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

Come funziona l'ottimizzazione

Caricamento progressivo: la prima volta che qualcuno richiede una dimensione ottimizzata, il sistema fornisce la versione disponibile più vicina e genera la dimensione esatta in background. Ogni richiesta successiva ottiene l'immagine ottimizzata e di dimensioni perfette. Il file originale viene sempre conservato.

Consegna di formati moderni: il sistema fornisce automaticamente formati di immagine moderni (AVIF o WebP) ai browser che li supportano, con fallback automatico a JPEG o PNG per i browser meno recenti. Ciò avviene in modo trasparente: basta specificare la larghezza e gli utenti ottengono la versione con il caricamento più veloce che il loro browser può gestire.

Ottimizzazione delle prestazioni: utilizza larghezze più piccole per migliorare le prestazioni. Una miniatura da 200 px viene caricata molto più velocemente dell'immagine originale da 4000 px e utilizza meno larghezza di banda. Scegli la larghezza che corrisponde al modo in cui stai visualizzando l'immagine.

Utilizzo dei file nell'applicazione

L'intelligenza artificiale integra automaticamente il file system del contenuto nella tua applicazione React. Quando richiedi funzionalità che coinvolgono file, crea i componenti dell'interfaccia utente, collega la logica di caricamento/download e gestisce gli errori.

Modelli comuni implementati dall'intelligenza artificiale

Caricamento avatar: un'interfaccia di caricamento della foto del profilo che convalida i tipi di immagine, mostra l'avanzamento del caricamento, visualizza l'anteprima dell'immagine e salva il percorso del profilo dell'utente.

Galleria documenti: un browser di file che elenca i documenti caricati, mostra le miniature delle immagini, fornisce collegamenti per il download e consente di filtrare o effettuare ricerche.

Caricamento tramite trascinamento: un'area di caricamento intuitiva in cui gli utenti possono trascinare file dal desktop, visualizzare l'avanzamento del caricamento, annullare i caricamenti in corso e ricevere messaggi di errore per file non validi.

Selettore file: una barra modale o laterale che mostra i file caricati in precedenza dall'utente, consente di selezionarne uno per il riutilizzo e visualizza miniature e nomi di file.

Integrazione con le edge function

Le edge function (il tuo codice lato server) possono accedere al file system del contenuto per elaborare file, generare file a livello di codice o implementare una logica di gestione dei file personalizzata.

Cosa possono fare le edge function con i file

  • Genera report PDF e salvali affinché gli utenti possano scaricarli
  • Elaborare le immagini caricate (applicare filigrane, creare miniature, estrarre metadati)
  • Scansiona i documenti caricati alla ricerca di dati sensibili prima di accettarli
  • Implementare una logica di backup o archiviazione personalizzata
  • Analizza il contenuto dei file ed estrai dati strutturati
  • Attiva workflow quando vengono caricati file specifici

Attenzione: nota importante sulla sicurezza

Le edge function aggirano il normale controllo degli accessi. Quando la tua funzione accede ai file, non è limitata dalle regole "pubblico" o "proprietario" che si applicano agli utenti. Ciò significa che devi implementare i tuoi controlli di autorizzazione nel codice funzione per garantire che gli utenti possano accedere solo ai file che dovrebbero vedere.

Ad esempio, se un utente chiama la tua funzione richiedendo un file, devi verificare che sia il proprietario del file o che abbia l'autorizzazione per accedervi prima di restituire i contenuti. L'intelligenza artificiale gestisce questo problema durante la creazione delle funzioni, ma è importante comprendere che il codice della funzione viene eseguito con privilegi elevati.

Organizzazione dell'archiviazione

L'intelligenza artificiale organizza i file in cartelle logiche in base a ciò che stai creando. Non è necessario creare manualmente strutture di cartelle: descrivi semplicemente ciò di cui hai bisogno e l'intelligenza artificiale imposta i percorsi appropriati.

Modelli di organizzazione comuni

  • /content/uploads/: caricamenti utente generali
  • /content/avatars/ — Foto del profilo utente
  • /content/documents/: PDF e documenti
  • /content/gallery/ — Immagini della galleria fotografica
  • /content/private/: file utente privati
  • /content/public/: file accessibili pubblicamente
  • /content/temp/: file temporanei che possono essere eliminati

L'intelligenza artificiale può creare cartelle nidificate come /content/uploads/2024/ o /content/users/[username]/ quando appropriato per il tuo caso d'uso. I file vengono tracciati in base al percorso completo, quindi lo spostamento o la ridenominazione dei file aggiorna automaticamente tutti i riferimenti.

Monitoraggio e debug

Tutte le operazioni sui file vengono registrate: caricamenti, download, accessi negati ed errori. Puoi visualizzare questi log nell'interfaccia di amministrazione per capire come viene utilizzato l'archivio file:

  • Scopri quali file vengono caricati più frequentemente
  • Identifica i caricamenti non riusciti e cosa è andato storto
  • Tieni traccia dei modelli di download e dei file più popolari
  • Monitorare l'utilizzo e la crescita dello spazio di archiviazione nel tempo
  • Eseguire il debug dei problemi di controllo dell'accesso quando gli utenti non riescono ad accedere ai file che si aspettano di vedere

Il sistema tiene traccia anche delle metriche di archiviazione: file totali archiviati, dimensione totale, tasso di crescita e file più grandi. Questo ti aiuta a comprendere lo spazio di archiviazione della tua app e a pianificare la scalabilità.

Limiti e vincoli

Per impostazione predefinita, i singoli file possono avere una dimensione massima di 500 MB. Questo è configurabile: l'intelligenza artificiale può regolare il limite in base a ciò che stai costruendo. Per la maggior parte delle applicazioni (caricamento di immagini, condivisione di documenti, PDF), il limite predefinito è più che sufficiente.

I file vengono archiviati in modo ridondante per garantire affidabilità. Se elimini un file, verrà rimosso definitivamente dal sistema: non c'è alcun cestino, quindi l'eliminazione è immediata e definitiva.

Lavorare con l'intelligenza artificiale

Quando descrivi le funzionalità che richiedono l'archiviazione di file, sii specifico su:

  • Chi può accedere ai file: regole pubbliche, private, condivise dall'organizzazione o personalizzate
  • Quali tipi di file: solo immagini, PDF, qualsiasi tipo di file, limiti di dimensione
  • Come sono organizzati i file: cartelle, convenzioni di denominazione, possibilità per gli utenti di creare sottocartelle
  • Cosa succede dopo il caricamento: visualizza in una galleria, allega a un record, elabora con una funzione

L'intelligenza artificiale utilizza queste informazioni per configurare correttamente lo spazio di archiviazione, impostare le politiche di accesso e creare un'interfaccia che soddisfi le tue esigenze.


Documentazione correlata: