# 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