feat(review): High quality playback switch and per-version ProRes download
Deploy / deploy (push) Successful in 3m23s

Worker 1.7.0 (preview.highQuality, default on) now, after the AE render:
- encodes a High quality MP4 from the delivery MOV (full-res H.264 High,
  CRF 14 capped at 100 Mbps) -> Version.hqFileUrl
- uploads the MOV itself -> Version.highResKey/Filename/Size
Both best-effort (the preview never fails over them), with a lease
keep-alive during the long encode/uploads; the export timeline records
what was attached.

Player: HQ switch when a High quality source exists; keeps frame, play
state, speed and zoom, remembered per browser, falls back to Standard if
the file won't load. ProRes itself stays download-only (browser support).

Downloads: the client portal's High Res button serves the version's
ProRes (client-code filename), falling back to the shot's manual file;
staff get a ProRes button on the review page.

Housekeeping (lib/render-pipeline/high-res.ts): HQ MP4 + ProRes are kept
while a version is latest, client-shared, approved or younger than
preview.highResRetentionDays (14); otherwise deleted from storage. Runs
per task after finalize and hourly from the reaper; deleting a version or
a reslate removes its files. The Standard MP4 is never touched.

Also: ProRes/Handles top-bar buttons go icon-only below lg so they don't
overlap the version selector.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
twotalesanimation
2026-09-22 16:32:18 +02:00
parent bae46c2968
commit 9660cdc21c
27 changed files with 793 additions and 18 deletions
@@ -0,0 +1,9 @@
-- Per-version high-quality media, uploaded by the render worker: a high
-- bitrate review MP4 for the player's quality switch, and the delivery MOV
-- (ProRes) as the version's High Res download. Housekeeping prunes both from
-- versions nobody can need any more (see lib/render-pipeline/high-res.ts).
ALTER TABLE "versions" ADD COLUMN "hqFileUrl" TEXT;
ALTER TABLE "versions" ADD COLUMN "highResKey" TEXT;
ALTER TABLE "versions" ADD COLUMN "highResFilename" TEXT;
ALTER TABLE "versions" ADD COLUMN "highResSize" BIGINT;
ALTER TABLE "versions" ADD COLUMN "highResPrunedAt" TIMESTAMP(3);
+10
View File
@@ -548,6 +548,16 @@ model Version {
/// Frames of slate before the picture in this media. Null = not recorded
/// (the player infers it from the media length vs frameCount).
pictureStartFrame Int?
/// High-quality review MP4 (full res, high bitrate) encoded from the
/// delivery MOV — the player's "High" quality. Null = Standard only.
hqFileUrl String?
/// The delivery MOV (ProRes) itself, downloadable as this version's High
/// Res file. Supersedes the shot-level manual highResKey where present.
highResKey String?
highResFilename String?
highResSize BigInt?
/// Set when housekeeping removed hqFileUrl/highResKey from storage.
highResPrunedAt DateTime?
notes String? @db.Text
approvalStatus ApprovalStatus @default(PENDING_REVIEW)
reviewStatus ReviewStatus @default(PENDING)