# 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