Update README to v0.2.3 and align with current project state

README.md

@@ -1,68 +1,77 @@
 # OTB Cloud
 
-## v0.2.3 - 2026-04-12
+## v0.2.3 — Recovery + Zip Workflow Phase
-- Added Recover action for soft-deleted files
+**Build Date:** 2026-04-13  
-- Recovered files now return to the device originals area
+**Backend Port:** 5000  
-- Recovered files append `-recovered` to the user-facing filename
+**Install Location:** /opt/otb_cloud  
-- Added audit logging for file recovery
+
-
+### Added
-## v0.2.2 - 2026-04-12
+- Deleted file recovery system
-- Added checkbox selection to device file browser
+- Files can be restored from `deleted/` → `originals/`
-- Added soft-delete selected files workflow
+- Automatic rename on recovery:
-- Added single-selection download action
+  - `file.png` → `file-recovered.png`
-- Added zip workspace staging flow
+- Recovery updates DB state correctly
-- Added zip creation into tenant exports directory
+- Recovery actions logged in audit system
-- Added exports listing page
+
-- Added deleted files page with hard delete option
+### Improved
-- Added 24-hour deleted-file retention note and purge-on-view behavior
+- Delete → Recover lifecycle now fully reversible (within retention window)
-
+- Storage integrity maintained (originals never overwritten)
-## v0.2.1 - 2026-04-12
+- Audit logging extended to include recovery events
-- Added device file browser page
+
-- Added Browse Files action per device
+### Current Status
-- File browser lists DB-backed files by device and tenant
+- Upload system complete (multi-file)
-- Added file count and device summary on browser page
+- Device-based file browser operational (DB-backed)
-
+- Safe delete system (soft + hard delete)
-## v0.2.0 - 2026-04-12
+- 24-hour retention policy active
-- Added first browser upload flow for user-created devices
+- Recovery system working end-to-end
-- Added Upload Files action per device
+
-- Added multi-file upload form
+### In Progress
-- Files now save into device `originals/` storage
+- Zip workflow UX (backend complete, UI remaining)
-- Uploads are recorded in MariaDB with SHA-256, size, and original filename
+  - staging → zip → export flow functional
-- Added upload audit logging
+  - UI controls pending
-
+
-## v0.1.4 - 2026-04-12
+---
-- Added Remove Device flow
+
-- Device removal is POST-only
+## v0.2.2 — Safe Delete System
-- Devices can only be removed when no files are linked to them
+**Build Date:** 2026-04-12  
-- Added audit logging for device removal
+
-- Added device directory cleanup for empty devices
+### Added
-
+- Soft delete system (moves files to `deleted/`)
-## v0.1.3 - 2026-04-12
+- Hard delete option (immediate removal)
-- Removed automatic default device creation for new tenants
+- 24-hour retention policy (documented)
-- Added real Add Device flow
+- Audit logging for delete actions
-- Updated dashboard to show empty state when no devices exist
+
-- Device directories are now created only when a user adds a device
+---
-
+
-## v0.1.2 - 2026-04-12
+## v0.2.1 — Device File Browser
-- Cleaned up unauthenticated OTB Cloud pages
+**Build Date:** 2026-04-12  
-- Hid Dashboard/Logout navigation when not authenticated
+
-- Updated portal-required messaging for production-style flow
+### Added
-- Updated handoff error page wording
+- DB-backed file listing per device
-- Updated test handoff helper to load `.env` automatically
+- File browser UI for each device
-
+- File count and summaries
-## v0.1.1 - 2026-04-12
+
-- Added app config module and MariaDB connection helper
+---
-- Added signed portal handoff placeholder routes
+
-- Added authenticated dashboard route
+## v0.2.0 — Upload + Device System
-- Added default tenant bootstrap logic
+**Build Date:** 2026-04-11  
-- Added local temporary `portal_base.html` so app renders now
+
-- Added MariaDB bootstrap script
+### Added
-- Updated project docs for next implementation stage
+- Device-based storage structure
-
+- Multi-file upload system
-## v0.1.0 - 2026-04-12
+- SHA-256 hashing for uploads
-- Initial scaffold created on vault3 at /opt/otb_cloud
+- File metadata stored in database
-- MariaDB-backed architecture selected
+- Upload audit logging
-- Modular Flask app structure created
+
-- Device-based tenant storage model defined
+---
-- Shared OTB portal template architecture planned
+
-- Core project documentation files added
+## Notes
+- OTB Cloud is a multi-tenant storage system
+- Raw uploads are immutable and stored in `originals/`
+- All file operations are logged
+- System designed for safe recovery and audit tracking
+
+---
+
+## License
+Internal project — Outsidethebox.top