otb-cloud/PROJECT_STATE.md

PROJECT_STATE.md

Project

OTB Cloud

Current version

v0.2.3

Build date

2026-04-12

Host

vault3

App path

/opt/otb_cloud

Purpose

Portal-authenticated secure backup and storage platform for customer files, including images, videos, documents, and other uploaded data.

Current implemented scaffold

• Portal handoff from OTB Billing
• Branded OTB portal shell styling
• User-created devices
• Device add/remove
• Browser upload to device originals
• Device file browser
• Selection actions
• Soft-delete to deleted folder
• Recover from deleted folder
• Zip workspace staging and zip export
• Deleted files page with hard delete
• Exports page

Retention and safety notes

• Original files are stored as immutable originals
• Deleted files are retained in the deleted area for up to 24 hours
• Deleted files can be recovered during that hold window
• Deleted files can also be hard-deleted immediately by the user
• Recovered files return to originals with -recovered appended to filename
• Zip staging copies are temporary working copies
• Successful zip creation clears staged copies but does not affect original source files

Immediate next tasks

1. Add basename-only rename flow
2. Add searchable file listing
3. Add bulk folder upload
4. Add media processing jobs
5. Add derived/original filtering
6. Add better single-file actions in browser

Current update: v0.2.5

• Added inline image serving route for browser previews
• Added device browser view toggle: list or gallery
• Added gallery cards with thumbnails, preview modal, rename, download, and checkbox actions
• Existing bulk delete, download, and zip staging continue to work in both views

v0.2.5 — Gallery View + Image Preview

Added

• Gallery view toggle for device file browser
• Image thumbnail rendering (inline file route)
• Click-to-preview full image modal
• Gallery cards with:
  • checkbox selection
  • rename input
  • download button
  • preview button

Improved

• File browsing now supports both:
  • list (management)
  • gallery (visual)
• Bulk actions work in both views
• Display filename system fully integrated across UI

Notes

• Originals remain immutable
• Thumbnails currently use original images (no derived images yet)
• Foundation ready for future media processing pipeline

Current update: v0.2.8

• Added folder-tree browser scoped by current path
• Added clickable breadcrumbs for direct jumps to any parent folder
• Added folders-first navigation while preserving list/gallery modes for files in the current folder
• Browser now reflects preserved backup folder structure instead of flattening all files into one device-wide listing

v1.1.0-alpha1 — Video System Foundation

• Added video_jobs table (processing queue)
• Added tenant_usage_metrics table (dashboard metrics)
• Added video service scaffolding (jobs, metrics, gpu select, profiles)
• Extended device structure to include:
  • video
  • video-workshop
  • archive
  • lts
• Prepared system for background worker architecture

Next step:

• Build video worker processing engine