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