Stockage de fichiers et gestion de contenu

Votre application dispose d'un système de fichiers de contenu dédié pour stocker les fichiers téléversés par les utilisateurs : images, documents, PDF et vidéos. Il est distinct du code de votre application et conçu pour le contenu dynamique que les utilisateurs créent ou téléversent pendant qu'ils utilisent votre application.

Limites et remarques importantes

  • Chaque fichier peut peser jusqu'à 500 Mo
  • La suppression d'un fichier est définitive : il n'y a ni corbeille ni bac de récupération
  • L'espace de stockage utilisé compte dans le quota de votre compte

Ce que permet le système de fichiers de contenu

Le système de fichiers de contenu offre de puissantes capacités de gestion de fichiers à votre application :

  • Stocker des avatars, photos de profil et galeries d'images
  • Accepter des documents téléversés comme des CV, des contrats ou des PDF
  • Créer des fonctionnalités de partage de fichiers entre les utilisateurs de votre application
  • Créer des applications riches en images avec optimisation automatique
  • Permettre aux utilisateurs de télécharger les fichiers qu'ils ont téléversés ou qui leur appartiennent
  • Créer des outils d'administration pour gérer des fichiers au nom des utilisateurs

Comment cela fonctionne

Quand vous décrivez à l'IA une fonctionnalité qui nécessite du stockage de fichiers, elle se charge automatiquement de toute l'implémentation :

Met en place l'interface de téléversement — crée des formulaires ou des zones de glisser-déposer où les utilisateurs sélectionnent des fichiers depuis leur appareil

Configure le contrôle d'accès — détermine qui peut consulter, téléverser ou supprimer des fichiers selon ce que vous construisez

Applique l'optimisation des images — redimensionne et sert automatiquement les images de façon efficace pour que votre application se charge vite

Crée la structure de stockage — organise les fichiers dans des dossiers logiques comme /content/uploads/ ou /content/avatars/

Gère le back-end — s'occupe du stockage, de la récupération et de la distribution des fichiers sans que vous ayez à y penser

Les fichiers sont stockés à des chemins comme /content/uploads/photo.jpg et peuvent être référencés directement dans votre application. Le système enregistre qui a téléversé chaque fichier et quand il a été créé, et applique vos règles d'accès.

Contrôle d'accès aux fichiers

Comme les tables de base de données et les edge functions, les fichiers ont des politiques de sécurité qui contrôlent qui peut y accéder. Les fichiers sont privés par défaut : personne n'y a accès tant que vous n'avez pas configuré les permissions. L'IA les met en place selon ce que vous construisez :

Fichiers publics

Tout le monde peut les consulter, même sans être connecté. Les utilisateurs connectés peuvent en téléverser, et seule la personne qui a téléversé un fichier peut le supprimer. Idéal pour les galeries photo, le partage public d'images ou les sites de contenu généré par les utilisateurs.

Fichiers privés

Seul l'utilisateur qui a téléversé un fichier peut le consulter ou le supprimer. Utilisé pour les documents sensibles, les photos privées, les dossiers médicaux ou tout ce que les utilisateurs ne voudraient pas montrer aux autres.

Fichiers partagés au sein d'une organisation

Les utilisateurs d'une même organisation peuvent consulter les fichiers téléversés par n'importe quel membre de leur organisation. Chacun ne peut supprimer que les fichiers qu'il a téléversés. Idéal pour le partage de documents en équipe, les ressources de l'entreprise ou les espaces de travail collaboratifs.

Accès réservé au propriétaire

Seul vous (le créateur de l'application) pouvez accéder à ces fichiers, pas vos utilisateurs finaux. Utile pour stocker des fichiers système, des modèles ou des ressources d'administration qui font fonctionner votre application mais ne sont pas destinés aux utilisateurs.

Contrôle d'accès avancé

L'IA peut créer des règles d'accès sophistiquées fondées sur les métadonnées des fichiers. Par exemple :

  • Les articles publiés sont publics, mais les brouillons ne sont visibles que de leur auteur
  • Les fichiers étiquetés avec un service ne sont visibles que des utilisateurs de ce service
  • Le contenu premium exige un indicateur d'abonnement sur le compte de l'utilisateur
  • Les fichiers partagés sont visibles des collaborateurs listés dans les métadonnées du fichier

Optimisation des images

Les images téléversées dans le système de fichiers de contenu sont automatiquement optimisées pour se charger rapidement. Quand vous affichez une image, vous pouvez demander une largeur précise et le système s'occupe du reste :

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

Comment fonctionne l'optimisation

Chargement progressif — la première fois que quelqu'un demande une taille optimisée, le système sert la version disponible la plus proche et génère la taille exacte en arrière-plan. Toutes les demandes suivantes reçoivent l'image optimisée à la taille exacte. Le fichier original est toujours conservé.

Distribution de formats modernes — le système sert automatiquement des formats d'image modernes (AVIF ou WebP) aux navigateurs compatibles, avec repli automatique sur JPEG ou PNG pour les navigateurs plus anciens. Tout se fait de façon transparente : vous indiquez simplement la largeur, et les utilisateurs reçoivent la version la plus rapide que leur navigateur peut gérer.

Optimisation des performances — utilisez des largeurs plus petites pour améliorer les performances. Une vignette de 200 px se charge bien plus vite que l'image originale de 4000 px et consomme moins de bande passante. Choisissez la largeur qui correspond à la façon dont vous affichez l'image.

Utiliser des fichiers dans votre application

L'IA intègre automatiquement le système de fichiers de contenu dans votre application React. Quand vous demandez des fonctionnalités liées aux fichiers, elle crée les composants d'interface, branche la logique de téléversement et de téléchargement, et gère les erreurs.

Modèles courants mis en œuvre par l'IA

Téléversement d'avatar — une interface de téléversement de photo de profil qui valide les types d'image, affiche la progression, présente un aperçu de l'image et enregistre le chemin dans le profil de l'utilisateur.

Galerie de documents — un navigateur de fichiers qui liste les documents téléversés, affiche des vignettes pour les images, fournit des liens de téléchargement et permet de filtrer ou de rechercher.

Téléversement par glisser-déposer — une zone de téléversement intuitive où les utilisateurs peuvent glisser des fichiers depuis leur bureau, voir la progression, annuler un téléversement en cours et recevoir des messages d'erreur pour les fichiers non valides.

Sélecteur de fichiers — une fenêtre modale ou un panneau latéral qui affiche les fichiers déjà téléversés par l'utilisateur, lui permet d'en choisir un pour le réutiliser et affiche vignettes et noms de fichiers.

Intégration avec les edge functions

Les edge functions (votre code côté serveur) peuvent accéder au système de fichiers de contenu pour traiter des fichiers, en générer par programmation ou mettre en œuvre une logique de gestion de fichiers personnalisée.

Ce que les edge functions peuvent faire avec les fichiers

  • Générer des rapports PDF et les enregistrer pour que les utilisateurs les téléchargent
  • Traiter les images téléversées (ajouter des filigranes, créer des vignettes, extraire des métadonnées)
  • Analyser les documents téléversés pour détecter des données sensibles avant de les accepter
  • Mettre en œuvre une logique de sauvegarde ou d'archivage personnalisée
  • Analyser le contenu des fichiers et en extraire des données structurées
  • Déclencher des workflows lorsque certains fichiers sont téléversés

Attention : note de sécurité importante

Les edge functions contournent le contrôle d'accès habituel. Quand votre fonction accède à des fichiers, elle n'est pas limitée par les règles « public » ou « propriétaire » qui s'appliquent aux utilisateurs. Vous devez donc mettre en œuvre vos propres vérifications d'autorisation dans le code de la fonction pour vous assurer que les utilisateurs n'accèdent qu'aux fichiers qu'ils ont le droit de voir.

Par exemple, si un utilisateur appelle votre fonction pour demander un fichier, vous devez vérifier qu'il en est le propriétaire ou qu'il a la permission d'y accéder avant de renvoyer le contenu. L'IA s'en charge quand elle construit vos fonctions, mais il est important de comprendre que le code des fonctions s'exécute avec des privilèges élevés.

Organisation du stockage

L'IA organise les fichiers dans des dossiers logiques selon ce que vous construisez. Vous n'avez pas à créer manuellement les arborescences : décrivez simplement ce dont vous avez besoin, et l'IA met en place les chemins appropriés.

Schémas d'organisation courants

  • /content/uploads/ — téléversements généraux des utilisateurs
  • /content/avatars/ — photos de profil des utilisateurs
  • /content/documents/ — PDF et documents
  • /content/gallery/ — images de galerie photo
  • /content/private/ — fichiers privés des utilisateurs
  • /content/public/ — fichiers accessibles publiquement
  • /content/temp/ — fichiers temporaires qui peuvent être supprimés

L'IA peut créer des dossiers imbriqués comme /content/uploads/2024/ ou /content/users/[username]/ quand cela convient à votre cas d'usage. Les fichiers sont identifiés par leur chemin complet : déplacer ou renommer un fichier met donc à jour toutes les références automatiquement.

Surveillance et débogage

Toutes les opérations sur les fichiers sont journalisées : téléversements, téléchargements, accès refusés et erreurs. Vous pouvez consulter ces journaux dans l'interface d'administration pour comprendre comment votre stockage de fichiers est utilisé :

  • Voir quels fichiers sont téléversés le plus souvent
  • Repérer les téléversements échoués et la cause de l'échec
  • Suivre les schémas de téléchargement et les fichiers populaires
  • Surveiller l'utilisation et la croissance du stockage au fil du temps
  • Diagnostiquer les problèmes de contrôle d'accès lorsque des utilisateurs ne peuvent pas accéder à des fichiers qu'ils s'attendent à voir

Le système suit aussi des indicateurs de stockage : nombre total de fichiers, taille totale, taux de croissance et plus gros fichiers. Cela vous aide à comprendre l'empreinte de stockage de votre application et à planifier sa montée en charge.

Limites et contraintes

Par défaut, chaque fichier peut peser jusqu'à 500 Mo. Cette limite est configurable : l'IA peut l'ajuster selon ce que vous construisez. Pour la plupart des applications (téléversement d'images, partage de documents, PDF), la limite par défaut est largement suffisante.

Les fichiers sont stockés de manière redondante pour garantir leur fiabilité. Si vous supprimez un fichier, il est retiré définitivement du système : il n'y a ni corbeille ni bac de récupération, la suppression est donc immédiate et définitive.

Travailler avec l'IA

Quand vous décrivez des fonctionnalités qui nécessitent du stockage de fichiers, soyez précis sur :

  • Qui peut accéder aux fichiers — règles publiques, privées, partagées au sein d'une organisation ou personnalisées
  • Quels types de fichiers — images uniquement, PDF, tout type de fichier, limites de taille
  • Comment les fichiers sont organisés — dossiers, conventions de nommage, possibilité ou non pour les utilisateurs de créer des sous-dossiers
  • Ce qui se passe après le téléversement — affichage dans une galerie, rattachement à un enregistrement, traitement par une fonction

L'IA utilise ces informations pour configurer correctement le stockage, mettre en place les politiques d'accès et créer une interface adaptée à vos besoins.


Documentation associée :