otb-cloud/PROJECT_STATE.md

OTB Cloud Project State

v2.1.1 - 20260502-051352

Patch release: Archive Workspace export cleanup improvements.

• Added Flush Workspace button for staged Archive Workspace files.
• Fixed Download + Remove so exports are deleted after download response completes.
• Added individual Delete button for processed export files.
• Confirmed PDF Report Workshop image compression works after ImageOps import fix.

---

v2.1.0 - 20260502-005134

Feature release: PDF Report Workshop (interactive document builder).

• Added PDF Report Workshop accessible from Archive Workspace.
• Users can view staged images and add per-image captions and notes.
• Added report-level metadata (job title, customer, address, technician, date).
• Added secure staged image preview route for workshop UI.
• PDF output now supports structured job reports, not just image dumps.

---

v2.0.0 - 20260501-063031

Milestone release: Archive Workspace now supports PDF Job Report generation.

• Added PDF output option alongside ZIP, TAR, and TAR.GZ.
• PDF Job Reports are generated from staged image files.
• Job reports include title, UTC generation timestamp, image count, filenames, and scaled images.
• This turns Archive Workspace from internal export tooling into a client-facing deliverable workflow.
• Current limitation: PDF reports are image-only.

---

v2.0.0 - 20260501-062745

Milestone release: Archive Workspace now supports PDF Job Report generation.

• Added PDF output option alongside ZIP, TAR, and TAR.GZ.
• PDF Job Reports are generated from staged image files.
• Job reports include title, UTC generation timestamp, image count, filenames, and scaled images.
• This turns Archive Workspace from internal export tooling into a client-facing deliverable workflow.
• Current limitation: PDF reports are image-only.

---

Fixes

• Fixed /health route crash (Path import + indentation issue)
• Version now dynamically sourced from VERSION file
• Health page now displays: OTB Cloud Health:

Notes

• No functional changes to core systems
• Stability + visibility improvement only

[v1.5.0-beta] - Stable beta milestone

Major Systems

• Android uploader (streaming + batching + Last X)
• Image workshop (resize + format conversion)
• Video pipeline (multi-profile GPU processing)
• Device browser (gallery + rename + batch actions)
• Health metrics + system visibility

Status

System is now stable and usable as a real-world service platform.

PROJECT_STATE.md

Project: OTB Cloud Version: v1.5.1-beta Updated: 2026-04-26 Location: /opt/otb_cloud

Current State

OTB Cloud is now operating as a live multi-profile, dual-GPU media processing/storage platform.

Confirmed Working

• Dashboard, device browser, and workshop flow
• File-ID based workshop queueing
• Multi-profile processing:
  • default
  • compress
  • hq
• Manual rotation override
• Processed outputs written to:
  • devices//video/
• Completed job actions:
  • View
  • Send to LTS
  • Download Output
  • Delete
• Failed job delete
• LTS routing for:
  • lts/video
  • lts/archived
  • lts/pictures
• Health page with cumulative GPU time that remains after visible job deletion
• Queue summary visible in workshop:
  • queued jobs
  • active users
• Global video jobs functionality present
• Intel + AMD worker threads active in production use

Current Observed GPU Behavior

• Both intel and amd workers are active
• Both GPUs are successfully processing jobs
• AMD and Intel are both taking work from the queue in live operation
• Current observed job records still show batch_id as NULL on recent jobs, so full batch-aware fairness logic should be treated as not yet proven active

Notes on Fair Use / Scheduler

• Fair-use scheduler direction is defined
• Per-tenant one-GPU fairness under contention is still an active implementation/testing area
• Current system is functional and stable enough to continue development while that is finalized

Recommended Next Step

Proceed to Android app update:

• allow app-side selection for images, videos, or both

[v1.1.0-alpha4.2] - Storage structure + Android alignment

✅ Storage restructuring

• Unified storage under:
  • originals/images
  • originals/video
• Eliminated previous split:
  • devices/phone/images
  • devices/phone/video

✅ Android upload route fix

• MIME-based routing now writes to:
  • originals/images
  • originals/video
• DB paths now match filesystem paths

✅ Device browser fix

• Browser rooted correctly at:
  • devices//originals
• Folder discovery now correctly shows:
  • images
  • video

🔧 Data repair

• Migrated existing device 37 file records:
  • images → originals/images
  • video → originals/video

⚠️ Notes

• Previous mismatch between DB paths and filesystem caused invisible folders
• Permission issues on new directories corrected (otbcloud ownership)

🧠 Next

• Improve Android upload stability (OOM handling)
• Add per-user GPU fairness scheduling (queued)