From c38a4cc195810feadebbbd8e028afbecc6bccc25 Mon Sep 17 00:00:00 2001 From: Don Kingdon Date: Mon, 13 Apr 2026 05:58:37 +0000 Subject: [PATCH] Update README to v0.2.3 and align with current project state --- README.md | 141 +++++++++++++++++++++++++++++------------------------- 1 file changed, 75 insertions(+), 66 deletions(-) diff --git a/README.md b/README.md index f6ffe16..634826f 100644 --- a/README.md +++ b/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