Rankion OS — Storage & Files

Rankion OS est la couche fichiers et assets à l'échelle de la plateforme. Au lieu d'opérer chaque module avec son propre chemin d'upload, tout converge ici : images de l'AI Content Editor, artworks générés, rapports, uploads manuels, assets d'équipe partagés. OS offre une hiérarchie de fichiers avec folders, recherche Spotlight, une vue desktop pour quick-access et des mécanismes de partage granulaires. Le module est team-scoped et se comporte comme un hybride léger macOS/Drive avec accès API-First.

Ce qu'il peut faire

• Files & folders — hiérarchie de folders à profondeur arbitraire par équipe. Les fichiers peuvent être déplacés, partagés, renommés, supprimés.
• Move operations — déplacer un file ou folder vers un autre folder via l'endpoint move. Les permissions sont héritées.
• Sharing — partager un fichier crée un lien de partage public-or-team-scoped. Revoke via DELETE.
• Vue desktop — GET /os/desktop livre les items quick-access (Pinned, Recents, partagés-avec-moi).
• Recherche Spotlight — GET /os/spotlight?q=... parcourt les filenames et métadonnées à l'échelle de l'équipe.
• Mode & preferences — PUT /os/mode bascule entre modes UI (par ex. List/Grid). preferences persiste les settings par utilisateur (tri, vue, pinned).
• Trash — les fichiers supprimés atterrissent dans la corbeille et sont restaurables jusqu'au purge définitif.

Quand l'utiliser

• Tu as besoin d'un endroit central pour les assets d'équipe qui ne soit pas caché dans des modules individuels.
• Tu veux réutiliser les images générées du module Images dans un article ou un rapport.
• Tu veux ranger des rapports ou exports de manière persistante, plutôt que de les perdre après téléchargement.
• Tu veux partager un fichier avec un reviewer externe sans l'inviter dans l'équipe.

Workflow

1. Créer la structure de folders — POST /os/folders avec {name, parent_id?}. Folders racine sans parent_id.
2. Uploader un file — POST /os/files avec body multipart (file, folder_id?, name?). La réponse livre id, url, mime, size.
3. Déplacer — POST /os/files/{id}/move avec {folder_id}. Folders idem POST /os/folders/{id}/move.
4. Partager — POST /os/files/{id}/share génère un share token. DELETE /os/files/{id}/share revoke.
5. Chercher — GET /os/spotlight?q=report ou utiliser le quick-access desktop.
6. Supprimer — DELETE /os/files/{id} pousse en corbeille. Le hard-delete arrive selon la politique de quota/rétention.

API

Exemple — uploader un file.

curl -X POST $BASE/os/files \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@./report-april.pdf" \
  -F "folder_id=12"

Exemple — Spotlight.

curl "$BASE/os/spotlight?q=report" -H "Authorization: Bearer $TOKEN"

Crédits et limites

• Gratuit — les opérations de storage ne coûtent pas de crédits.
• Quota — par équipe une limite de storage s'applique (voir plan / settings). Upload au-delà du quota : 413 ou 422 avec quota_exceeded.
• Whitelist MIME — formats courants image, document, CSV, PDF, Markdown. Les exécutables sont refusés.
• Max file size — typiquement 50 MB par fichier (selon plan).
• Sharing — les liens de partage public sont basés sur token, expiry optionnel. Perte de token = revoke et regénérer.

Modules associés

• AI Content Editor — les featured images d'article et images inline sont déposées dans OS.
• Images — les images IA générées atterrissent automatiquement dans OS et y sont réutilisables.
• Blog Admin — les featured images pour les blog posts viennent d'OS.