Rankion OS — Storage & Files

Rankion OS es la capa de archivos y assets a nivel de plataforma. En lugar de que cada módulo gestione su propia ruta de upload, todo se reúne aquí: imágenes del AI Content Editor, artworks generados, reports, uploads manuales, assets compartidos del team. OS ofrece una jerarquía de archivos con folders, búsqueda Spotlight, una vista Desktop para quick access y mecanismos de sharing granulares. El módulo es team-scoped y se comporta como un híbrido ligero macOS-/Drive con acceso API-First.

Qué puede hacer

• Files & Folders — jerarquía de folders arbitrariamente profunda por team. Los files se pueden mover, compartir, renombrar, borrar.
• Move-Operations — mueve un file o folder a otro folder vía endpoint move. Los permisos se heredan.
• Sharing — compartir un file genera un share-link público o team-scoped. Revócalo con DELETE.
• Desktop-View — GET /os/desktop entrega los items de quick access (Pinned, Recents, compartido conmigo).
• Búsqueda Spotlight — GET /os/spotlight?q=... busca filenames y metadatos en todo el team.
• Mode & Preferences — PUT /os/mode cambia entre modos UI (p.ej. List/Grid). preferences persiste settings por usuario (orden, view, pinned).
• Trash — los files borrados aterrizan en Trash y son recuperables hasta el purge definitivo.

Cuándo usarlo

• Necesitas un sitio central para assets de team que no esté escondido en módulos individuales.
• Quieres reusar imágenes generadas del módulo Images en otro artículo o report.
• Quieres almacenar reports o exports de forma persistente, en lugar de perderlos tras la descarga.
• Quieres compartir un file con un revisor externo sin meterlo en el team.

Workflow

1. Crea estructura de folders — POST /os/folders con {name, parent_id?}. Folder raíz sin parent_id.
2. Sube file — POST /os/files con body multipart (file, folder_id?, name?). La response devuelve id, url, mime, size.
3. Mover — POST /os/files/{id}/move con {folder_id}. Folder análogamente: POST /os/folders/{id}/move.
4. Compartir — POST /os/files/{id}/share genera un share-token. DELETE /os/files/{id}/share lo revoca.
5. Buscar — GET /os/spotlight?q=report o usa Desktop-Quick-Access.
6. Borrar — DELETE /os/files/{id} lo mueve a Trash. El hard-delete se aplica según política de quota/retention.

API

Ejemplo — subir file.

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

Ejemplo — Spotlight.

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

Créditos y límites

• Sin coste — las operaciones de storage no consumen créditos.
• Quota — por team rige un storage-limit (ver plan / settings). Upload por encima de la quota: 413 o 422 con quota_exceeded.
• MIME-Whitelist — formatos comunes de imagen, documento, CSV, PDF, Markdown. Los ejecutables se rechazan.
• Max File Size — típicamente 50 MB por file (depende del plan).
• Sharing — los public share-links están basados en token, opcional con expiry. Pérdida de token = revocar y regenerar.

Módulos relacionados

• AI Content Editor — featured images de artículo e imágenes inline se almacenan en OS.
• Images — las imágenes IA generadas aterrizan automáticamente en OS y se pueden seguir usando allí.
• Blog Admin — las featured images para los blog posts vienen de OS.