# PROJECT_STATE.md

## Project
OTB Cloud

## Current version
v0.2.2

## 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
- Checkbox selection actions
- Soft-delete to 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 also be hard-deleted immediately by the user
- 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 single-file download buttons in more places
2. Add basename-only rename flow
3. Add searchable file listing
4. Add bulk folder upload
5. Add media processing jobs
6. Add derived/original filtering