Rankion OS — Storage & Files

Rankion OS ist die plattformweite Datei- und Asset-Schicht. Statt jedes Modul mit eigenem Upload-Pfad zu betreiben, kommt alles hier zusammen: Bilder aus dem AI Content Editor, generierte Artworks, Reports, manuelle Uploads, geteilte Team-Assets. OS bietet eine Datei-Hierarchie mit Folders, Spotlight-Suche, einen Desktop-View für Quick-Access und granulare Sharing-Mechanismen. Das Modul ist team-scoped und verhält sich wie ein leichter macOS-/Drive-Hybrid mit API-First-Zugriff.

Was es kann

• Files & Folders — beliebig tiefe Folder-Hierarchie pro Team. Files können verschoben, geteilt, umbenannt, gelöscht werden.
• Move-Operations — File oder Folder per move-Endpoint in einen anderen Folder verschieben. Permissions werden vererbt.
• Sharing — File teilen erzeugt einen public-or-team-scoped Share-Link. Per DELETE wieder revoken.
• Desktop-View — GET /os/desktop liefert die Quick-Access-Items (Pinned, Recents, geteilt-mit-mir).
• Spotlight-Suche — GET /os/spotlight?q=... durchsucht Filenames und Metadaten teamweit.
• Mode & Preferences — PUT /os/mode schaltet zwischen UI-Modi (z.B. List/Grid). preferences persistiert pro-User-Settings (Sortierung, View, Pinned).
• Trash — gelöschte Files landen im Trash und sind wiederherstellbar bis zum endgültigen Purge.

Wann nutzen

• Du brauchst einen zentralen Ort für Team-Assets, der nicht in einzelnen Modulen versteckt ist.
• Du willst generierte Bilder aus dem Images-Modul nochmal verwenden in einem Artikel oder Report.
• Du willst Reports oder Exports persistent ablegen, statt sie nach Download zu verlieren.
• Du willst ein File mit einem externen Reviewer teilen, ohne ihn ins Team zu holen.

Workflow

1. Folder-Struktur anlegen — POST /os/folders mit {name, parent_id?}. Wurzelordner ohne parent_id.
2. File hochladen — POST /os/files mit Multipart-Body (file, folder_id?, name?). Response liefert id, url, mime, size.
3. Verschieben — POST /os/files/{id}/move mit {folder_id}. Folder analog POST /os/folders/{id}/move.
4. Teilen — POST /os/files/{id}/share erzeugt einen Share-Token. DELETE /os/files/{id}/share revoked.
5. Suchen — GET /os/spotlight?q=report oder Desktop-Quick-Access nutzen.
6. Löschen — DELETE /os/files/{id} schiebt in Trash. Hard-Delete passiert nach Quota-/Retention-Policy.

API

Beispiel — File hochladen.

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

Beispiel — Spotlight.

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

Credits & Limits

• Kostenfrei — Storage-Operationen kosten keine Credits.
• Quota — pro Team gilt ein Storage-Limit (siehe Plan / Settings). Upload jenseits Quota: 413 oder 422 mit quota_exceeded.
• MIME-Whitelist — gängige Bild-, Dokument-, CSV-, PDF-, Markdown-Formate. Executables werden abgelehnt.
• Max File Size — typischerweise 50 MB pro File (Plan-abhängig).
• Sharing — public Share-Links sind Token-basiert, optional mit Expiry. Token-Verlust = revoke und neu erzeugen.

Verwandte Module

• AI Content Editor — Artikel-Featured-Images und Inline-Bilder werden in OS abgelegt.
• Images — generierte KI-Bilder landen automatisch in OS und sind dort weiter verwendbar.
• Blog Admin — Featured-Images für Blog-Posts kommen aus OS.