Retour a la doc Bibliothèque média
Live

Bibliothèque média

Le dépôt unique de tous tes assets. Tu uploades une fois, tu réutilises partout: Studio, Pages, Produits, Présentations, Ads. Chaque fichier garde son alt-text, ses tags, son historique d'usage et sa filiation quand il vient d'une génération.

Vue d'ensemble

La bibliothèque média est la source de vérité des fichiers d'un workspace. Une image, un logo, une icône, une image Open Graph, un avatar, une vidéo, un document PDF. Chaque item porte son type MIME, sa taille, ses dimensions, un checksum, et des métadonnées éditoriales: type, collection, tags, alt-text, légende. Tu ranges tes assets dans des collections nommées (persona, marque, inspiration, images produit, OG) et tu les retrouves par filtre ou par recherche.

Les fichiers vivent dans un bucket de stockage, servis par URL signée à durée courte pour les assets privés, par URL publique pour ceux rangés sous un préfixe public. Un upload calcule un checksum et dédoublonne dans la foulée: si le même fichier existe déjà non archivé dans le workspace, tu récupères l'existant au lieu d'un doublon. Un workspace peut avoir un quota d'octets, vérifié avant chaque upload.

La partie qui compte pour un usage réel: le suivi d'usage et la filiation. Quand un autre module pose une image (une page, un draft Studio, un visuel d'annonce, un avatar de booking), il enregistre l'usage. Tu vois sur chaque fichier qui le référence et combien de fois. Les images générées gardent la trace de leurs parents (les images de référence qui ont servi à la génération) et de leurs enfants (ce qui a été généré à partir d'elles). Un fichier sans aucun usage depuis un moment ressort comme orphelin pour être purgé.

Ce que le module fait

Types de fichiers et collections

Chaque item a un type qui gouverne son affichage et ses filtres. La page principale filtre par type et par collection, avec une recherche full-text sur l'alt-text, la légende et le prompt de génération. Les collections sont des dossiers nommés, avec leurs propres pages dédiées.

  • Types: photo, logo, icône, Open Graph, avatar, image générée, vidéo, document, autre
  • Collections livrées: persona, marque, inspiration, images produit, OG
  • Recherche full-text sur alt-text, légende et prompt de génération
  • Chaque fichier porte des tags libres, éditables à tout moment

Upload, dédup et quota

Un upload calcule un checksum SHA-256 et cherche un doublon dans le workspace. Si le fichier existe déjà et n'est pas archivé, tu récupères l'existant, pas une copie. Avant d'écrire, le workspace vérifie son quota d'octets: si l'upload le dépasse, il est refusé. Un passage de dédoublonnage cross-workspace tourne aussi en tâche planifiée: pour un même checksum, il garde le plus ancien et archive les autres.

URL signées et assets publics

Les fichiers privés sont servis par URL signée à durée courte, une heure par défaut. Les fichiers rangés sous un préfixe public sortent par URL publique stable. Le détail d'un fichier régénère une URL signée fraîche à chaque ouverture, donc un lien copié expire, c'est voulu.

Suivi d'usage entre modules

Quand un autre module pose un fichier sur une entité, il enregistre l'usage: le type d'entité, son identifiant, et le champ concerné. L'enregistrement est idempotent sur le triplet fichier, entité, champ, donc pas de double comptage. Sur la fiche d'un fichier tu lis la liste des entités qui le référencent, et le compteur d'usage remonte sur la vignette.

  • Studio: visuels de posts et miniatures YouTube générés
  • Pages: images posées dans un bloc de page
  • Ads: visuels d'annonce et kit de marque
  • Booking: avatar de la page de réservation

Filiation des images générées

Une image générée par IA garde ses parents (les images de référence passées au modèle) et enregistre son modèle, son prompt et ses métadonnées de génération. La fiche du fichier montre les images sources en haut et les images dérivées en dessous. Tu remontes ainsi d'un visuel final jusqu'aux références qui l'ont produit.

Personas de référence

Un workspace peut marquer une petite sélection de fichiers comme personas actifs. Ce sont les images que la génération Studio passe par défaut comme références au modèle, pour garder un visage ou un style cohérent. La sélection est validée: chaque identifiant doit appartenir au workspace.

Orphelins et purge

Un fichier sans aucun usage enregistré, plus vieux qu'un seuil, ressort dans un rapport d'orphelins trié par taille. Côté plateforme, des outils MCP donnent l'usage par workspace, la liste des orphelins, le réglage du quota, et la purge définitive des fichiers archivés depuis assez longtemps.

Comment on l'utilise

  1. 01

    Uploade tes assets

    Depuis /media, tu glisses tes fichiers dans la zone d'upload. Le checksum dédoublonne, le quota est vérifié, l'item apparaît dans la grille.

  2. 02

    Range et décris

    Tu ouvres un fichier, tu poses un type, une collection, des tags, un alt-text et une légende. La recherche full-text s'appuie sur ces champs.

  3. 03

    Réutilise ailleurs

    Depuis Studio, Pages ou Ads, tu choisis un fichier de la bibliothèque au lieu de ré-uploader. L'usage est enregistré sur le fichier.

  4. 04

    Marque tes personas

    Tu sélectionnes les images de référence à passer par défaut à la génération Studio, pour garder un style cohérent.

  5. 05

    Suis l'usage et la filiation

    Sur la fiche d'un fichier, tu vois qui le référence, ses images sources et ses images dérivées.

  6. 06

    Nettoie les orphelins

    Tu repères les fichiers sans usage depuis un moment et tu les archives, ou tu les purges définitivement côté plateforme.

Connexions